Skip to content
Back to search

tweetclaw

OpenClaw plugin for Twitter search, follower exports, monitoring & approved X actions. Not affiliated with X Corp.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Xquik-dev/tweetclaw with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Xquik-dev/tweetclaw'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xquik-dev--tweetclaw/badge.svg)](/listings/xquik-dev--tweetclaw)

HTML

<a href="/listings/xquik-dev--tweetclaw"><img src="/api/listings/xquik-dev--tweetclaw/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

openclaw plugins install clawhub:@xquik/tweetclaw

OpenClaw records the verified ClawHub publisher scope and package as the update source.

Use `openclaw plugins install npm:@xquik/tweetclaw` when you need the npm fallback.

For normal upgrades, reuse the tracked install source:

openclaw plugins update tweetclaw

For reproducible production installs, pin a published npm version:

openclaw plugins install npm:@xquik/tweetclaw@<version> --pin

Pinned installs stay pinned during updates. Run `openclaw plugins update @xquik/tweetclaw` to return to the stable release line.

Source builds require OpenClaw `2026.7.1` or newer.

If your OpenClaw install runs with `OPENCLAW_NIX_MODE=1`, plugin lifecycle mutators are disabled. Install or update TweetClaw through your Nix OpenClaw source instead of `openclaw plugins install` or `openclaw plugins update`.

Install TweetClaw before adding credentials if needed. The free `explore` catalog works immediately; live calls return setup guidance.

Agents with skill directories can install the packaged `SKILL.md` through [Skills.sh](https://www.skills.sh/xquik-dev/tweetclaw). Use the OpenClaw command above for the plugin runtime.

npx skills add xquik-dev/tweetclaw

TweetClaw is an OpenClaw plugin, not an MCP server. For remote MCP clients, add `https://xquik.com/mcp`, then follow the [current client compatibility path](https://docs.xquik.com/mcp/overview#client-compatibility). OAuth-capable clients complete OAuth 2.1. Clients that support custom bearer headers can use an Xquik API key. ChatGPT custom apps require OAuth.

> **Codex OAuth compatibility:** Affected Codex releases discard the RFC 9207 > `iss` callback value even though Xquik returns it. If Codex reports > `Authorization server response missing required issuer: expected https://xquik.com`, > use `XQUIK_API_KEY` through the Codex `bearer_token_env_var` setting. Follow the > [Codex OAuth troubleshooting guide](https://docs.xquik.com/guides/troubleshooting#codex-oauth-issuer-validation-error) > and track [openai/codex#31573](https://github.com/openai/codex/issues/31573).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 293 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # TweetClaw, the OpenClaw X (Twitter) Bot Plugin
  2. Use this OpenClaw Twitter plugin by Xquik to search tweets, export followers & post.
  3. Every write waits for your approval.
  4. Xquik is the world's fastest and cheapest X (Twitter) scraper service with the most complete X (Twitter) data.
  5. Most other Apify Actors charge before filtering or deduplication.
  6. Xquik charges only for delivered, unique, filter-matching results and never pads rows.
  7. Xquik is independent and not affiliated with X Corp.
  8. <!-- trust:win:start -->
  9. The Xquik REST API read 45 tweets per second on 2026-10-15. That cost $0.15 per 1,000. The fastest of 4 rival Actors read 12.5 per second. The cheapest cost $0.173 per 1,000. [Compare each run](https://xquik.com/benchmarks#benchmark-x-tweet-scraper). Most rival Actors charge before they filter or dedup. Xquik charges only for delivered, unique, filter-matching results.
  10. <!-- trust:win:end -->
  11. ## Install the OpenClaw Twitter plugin
  12. ```bash
  13. openclaw plugins install clawhub:@xquik/tweetclaw
  14. ```
  15. OpenClaw records the verified ClawHub publisher scope and package as the update source.
  16. Create an API key for account-backed X (Twitter) automation at [dashboard.xquik.com](https://dashboard.xquik.com/).
  17. Then store it through OpenClaw.
  18. ```bash
  19. openclaw config set plugins.entries.tweetclaw.config.apiKey "$XQUIK_API_KEY"
  20. ```
  21. Add both tools without replacing the current profile.
  22. ```bash
  23. openclaw config set tools.alsoAllow '["explore", "tweetclaw"]'
  24. ```
  25. ## Run a Twitter bot & X (Twitter) automation from OpenClaw
  26. Ask your agent in plain words.
  27. The bot posts only what you approve.
  28. ```text
  29. Reply to my latest post with a thank-you note
  30. Post "Launch day" from my connected X account
  31. ```
  32. Next, read the [TweetClaw guide](https://docs.xquik.com/guides/tweetclaw) or the [OpenClaw setup guide](docs/openclaw-setup.md).
  33. <!-- trust:start -->
  34. ## Benchmarks & usage
  35. [![@xquik/tweetclaw downloads on npm](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fnpm-xquik-tweetclaw.json)](https://www.npmjs.com/package/@xquik/tweetclaw)
  36. [![tweetclaw downloads on ClawHub](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fclawhub-tweetclaw.json)](https://clawhub.ai/xquik/skills/tweetclaw)
  37. [![tweetclaw Skill installs on skills.sh](https://img.shields.io/endpoint?url=https%3A%2F%2Fxquik.com%2Fbadges%2Fskills-tweetclaw.json)](https://skills.sh/xquik-dev/tweetclaw)
  38. [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/13730/badge)](https://www.bestpractices.dev/projects/13730)
  39. - 12,000+ downloads of @xquik/tweetclaw on npm ([source](https://www.npmjs.com/package/@xquik/tweetclaw)) <!-- trust:npm-xquik-tweetclaw 12641 -->
  40. - 2,900+ downloads of tweetclaw on ClawHub ([source](https://clawhub.ai/xquik/skills/tweetclaw)) <!-- trust:clawhub-tweetclaw 2958 -->
  41. - 83 installs of this repo's Skills on skills.sh ([source](https://skills.sh/xquik-dev/tweetclaw)) <!-- trust:skills-tweetclaw 83 -->
  42. - This repo meets the OpenSSF Best Practices passing criteria ([source](https://www.bestpractices.dev/projects/13730)) <!-- trust:openssf-tweetclaw 1 -->
  43. Checked on 2026-11-16. See each number with its date & source on [xquik.com/benchmarks](https://xquik.com/benchmarks) or as [JSON](https://xquik.com/trust.json).
  44. <!-- trust:end -->
  45. ## Scrape tweets & export followers
  46. Reads run through the same `tweetclaw` tool.
  47. Extractions export followers and following accounts.
  48. ```text
  49. Search tweets about "AI agents" from the last day
  50. Export the followers of @NASA
  51. ```
  52. ## Common OpenClaw tasks
  53. Use `explore` before every live call.
  54. It returns the current supported route.
  55. | Customer question | Catalog query | Next step |
  56. | --- | --- | --- |
  57. | How can I search tweets? | `search tweets by query` | Call the listed read route. |
  58. | How can I read an X (Twitter) timeline? | `list recent tweets posted by a user` | Approve private timelines. |
  59. | How can I export followers? | `run extraction` | Choose followers, then approve. |
  60. | How can I scrape following accounts? | `run extraction` | Choose following, then approve. |
  61. | How can I monitor an account or keyword? | `create monitor` | Approve recurring usage. |
  62. | How can I post or reply? | `create tweet` | Approve each write. |
  63. See the [agent workflow guide](docs/agent-workflows.md) for longer jobs.
  64. ## Install options
  65. Use `openclaw plugins install npm:@xquik/tweetclaw` when you need the npm fallback.
  66. For normal upgrades, reuse the tracked install source.
  67. ```bash
  68. openclaw plugins update tweetclaw
  69. ```
  70. Pin a published npm version for reproducible production installs.
  71. ```bash
  72. openclaw plugins install npm:@xquik/tweetclaw@<version> --pin
  73. ```
  74. Pinned installs stay pinned during updates.
  75. Run `openclaw plugins update @xquik/tweetclaw` to return to the stable release line.
  76. Source builds require OpenClaw `2026.7.1` or newer.
  77. `OPENCLAW_NIX_MODE=1` turns off the plugin install and update commands.
  78. Install or update TweetClaw through your Nix OpenClaw source instead.
  79. Install TweetClaw before you add credentials if you want.
  80. The free `explore` catalog works at once.
  81. Live calls return setup guidance.
  82. Agents with skill directories can install the packaged `SKILL.md` through [Skills.sh](https://www.skills.sh/xquik-dev/tweetclaw).
  83. Use the OpenClaw command above for the plugin runtime.
  84. ```bash
  85. npx skills add xquik-dev/tweetclaw
  86. ```
  87. TweetClaw is an OpenClaw plugin, not an MCP server.
  88. For remote MCP clients, add `https://xquik.com/mcp`.
  89. Then follow the [client compatibility guide](https://docs.xquik.com/mcp/overview#client-compatibility).
  90. ## Configure
  91. Keep API keys out of chats, documentation, logs & shell history.
  92. ### Credits for pay per use without a subscription
  93. Top up credits from the Xquik dashboard.
  94. An API key can spend prepaid credits on public paid reads without a subscription.
  95. TweetClaw does not create checkout sessions or charge saved payment methods from the agent.
  96. ### Direct MPP for accountless pay per use
  97. Machine Payments Protocol (MPP) pays for single lookups with no account or API key.
  98. Create an MPP account with `mppx account create`.
  99. ```bash
  100. npm i mppx@0.13.4 viem@2.57.5
  101. openclaw config set plugins.entries.tweetclaw.config.tempoSigningKey "$MPP_SIGNING_KEY"
  102. ```
  103. Keep the signing key in local OpenClaw config.
  104. Never put it in prompts or logs.
  105. `explore` marks each MPP route with its price per call.
  106. [API coverage](#api-coverage) counts them.
  107. Other paid reads use prepaid credits.
  108. Media downloads and galleries require account-backed access.
  109. ### Optional settings
  110. ```bash
  111. openclaw config set plugins.entries.tweetclaw.config.baseUrl "https://xquik.com"
  112. openclaw config set plugins.entries.tweetclaw.config.pollingEnabled true
  113. openclaw config set plugins.entries.tweetclaw.config.pollingInterval 60
  114. ```
  115. Change `baseUrl` only for a self-hosted Xquik-compatible API.
  116. TweetClaw requires an HTTPS base URL with no embedded credentials.
  117. ## OpenClaw trust model
  118. TweetClaw uses 2 OpenClaw gates, which stop unattended publishing.
  119. - Optional tool exposure. `explore` is a safe local catalog search that OpenClaw always loads. `tweetclaw` can read private data, spend credits or change X (Twitter) accounts. It stays off until you add it to `tools.alsoAllow`.
  120. - Per-call approval. Writes, private reads, paid calls & account-scoped calls trigger a plugin approval prompt. Recurring jobs do too. TweetClaw offers one-time approval or deny for those calls.
  121. ## Tools
  122. ### `explore` (free, no network)
  123. Search the bundled API catalog without a network request.
  124. ### `tweetclaw` (invoke API endpoints)
  125. Invoke catalog-listed endpoints with structured fields.
  126. The runtime injects authentication.
  127. X (Twitter) writes also require `idempotencyKey`.
  128. Can your agent see the skill but not call TweetClaw tools?
  129. Add `explore` and `tweetclaw` to `tools.alsoAllow`.
  130. OpenClaw shows an approval prompt before each write-like `tweetclaw` call.
  131. Review the structured request before you approve a post, DM, monitor, extraction or webhook.
  132. ## Commands
  133. These commands answer at once, without the LLM.
  134. | Command | Description |
  135. | --- | --- |
  136. | `/xstatus` | Account info, subscription status, usage & credit balance |
  137. | `/xtrends` | Curated topics with an API key. Worldwide X (Twitter) trends with MPP. |
  138. | `/xtrends tech` | API-key mode shows curated topics in 1 category. |
  139. | `/xtrends 23424977` | MPP mode shows X (Twitter) trends for 1 WOEID. |
  140. ## Event notifications
  141. With polling on, TweetClaw checks your monitors every 60 seconds.
  142. It delivers new tweet, reply, quote & retweet events.
  143. Set up a monitor first.
  144. Ask your agent in plain words.
  145. ```text
  146. Monitor @elonmusk for new tweets, replies, and retweets
  147. ```
  148. ## Read response fields
  149. TweetClaw keeps every allowed Xquik response field.
  150. Optional fields stay absent when X (Twitter) omits them.
  151. Request `next_cursor` while `has_next_page` is true.
  152. Bookmark, like, follow, block, mute & notification state of the fetching account stays private.
  153. See [Read Data Richness](https://docs.xquik.com/guides/tweet-profile-api-fields) for exact tweet, profile & media fields.
  154. ## Pricing & access
  155. TweetClaw uses Xquik billing for account-backed automation and optional MPP reads.
  156. See [Billing & Pricing](https://docs.xquik.com/guides/billing) for current plans, eligible endpoints, and live prices.
  157. ## API coverage
  158. <!-- api-coverage:start (npm run generate-api-contract writes this block) -->
  159. The live [Xquik OpenAPI spec](https://xquik.com/openapi.json) lists 223 operations. An operation is 1 method on 1 path.
  160. Agents can call 192 of them through `tweetclaw`. TweetClaw leaves out the other 31.
  161. | Left out | Operations |
  162. | --- | --- |
  163. | API keys, checkout & X account connection, which stay in the dashboard | 13 |
  164. | X account connection, guest wallet checkout & support file downloads | 10 |
  165. | Documentation search outside `/api/v1` | 8 |
  166. 21 of the 192 accept MPP. Run `explore` with `mpp` set to `true` to list them.
  167. <!-- api-coverage:end -->
  168. | Category | Examples | Access |
  169. | --- | --- | --- |
  170. | Account | Account status | Account-backed |
  171. | Analysis | Sentiment, brand, news, market signals, viral score, custom questions | Account-backed |
  172. | Composition | Compose, drafts, writing styles, radar | Account-backed |
  173. | Credits | Check balance | Account-backed |
  174. | Extraction | Extraction tools, giveaway draws, exports | Account-backed |
  175. | Media | Authenticated media download, gallery links | Account-backed |
  176. | Monitoring | Create monitors, view events, manage webhooks, Telegram links | Account-backed |
  177. | X (Twitter) | Search, lookups, timelines, articles, trends, lists, communities, Spaces, jobs, bookmarks, notifications | Account-backed or MPP where eligible |
  178. | X (Twitter) accounts | List connected account handles for explicit user-selected actions | Account-backed |
  179. | X (Twitter) write | Post, reply, like, retweet, follow, remove follower, DM, upload media, profile, communities | Account-backed with approval |
  180. ## Questions
  181. ### Do I need an X (Twitter) developer account?
  182. No. Public reads need only an Xquik API key.
  183. Private reads & X (Twitter) account actions need a connected account.
  184. ### Is TweetClaw the official X API?
  185. No. Xquik runs its own REST API.
  186. TweetClaw calls that API, not the official X API.
  187. ## More Xquik tools
  188. - [X (Twitter) scraper API & X (Twitter) MCP server](https://github.com/Xquik-dev/x-twitter-scraper) with REST, MCP & Skill setup.
  189. - X (Twitter) API SDKs for [TypeScript](https://github.com/Xquik-dev/x-twitter-scraper-typescript), [Python](https://github.com/Xquik-dev/x-twitter-scraper-python), [Go](https://github.com/Xquik-dev/x-twitter-scraper-go) & [Ruby](https://github.com/Xquik-dev/x-twitter-scraper-ruby).
  190. - X (Twitter) API SDKs for [Java](https://github.com/Xquik-dev/x-twitter-scraper-java), [Kotlin](https://github.com/Xquik-dev/x-twitter-scraper-kotlin), [C#](https://github.com/Xquik-dev/x-twitter-scraper-csharp) & [PHP](https://github.com/Xquik-dev/x-twitter-scraper-php).
  191. - [Twitter CLI & X CLI](https://github.com/Xquik-dev/x-twitter-scraper-cli) for terminal workflows.
  192. - [Twitter advanced search operators](https://github.com/Xquik-dev/x-twitter-advanced-search) with tested examples.
  193. - [Hermes Agent Twitter plugin](https://github.com/Xquik-dev/hermes-tweet) and the [X (Twitter) API documentation source](https://github.com/Xquik-dev/xquik-docs).
  194. - Twitter integrations for [n8n](https://github.com/Xquik-dev/n8n-nodes-xquik), [Prefect](https://github.com/Xquik-dev/prefect-xquik), [Haystack](https://github.com/Xquik-dev/xquik-haystack) & [Paperclip](https://github.com/Xquik-dev/paperclip-plugin-xquik).
  195. - Twitter integrations for [Terraform](https://github.com/Xquik-dev/terraform-provider-x-twitter-scraper), [Convex](https://github.com/Xquik-dev/xquik-convex), [Supabase](https://github.com/Xquik-dev/xquik-supabase) & [Strapi](https://github.com/Xquik-dev/strapi-plugin-xquik).
  196. - X (Twitter) MCP for [AI agents](https://github.com/Xquik-dev/xquik-mcp), [VS Code](https://github.com/Xquik-dev/xquik-vscode) & [Raycast](https://github.com/Xquik-dev/xquik-raycast).
  197. - [Xquik X API & Twitter scraper](https://xquik.com) and the [X (Twitter) API documentation](https://docs.xquik.com/api-reference/overview).
  198. ## License
  199. [MIT](LICENSE)
  200. Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.