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.
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
Markdown
[](/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
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.
- # TweetClaw, the OpenClaw X (Twitter) Bot Plugin
- Use this OpenClaw Twitter plugin by Xquik to search tweets, export followers & post.
- Every write waits for your approval.
- Xquik is the world's fastest and cheapest X (Twitter) scraper service with the most complete X (Twitter) data.
- Most other Apify Actors charge before filtering or deduplication.
- Xquik charges only for delivered, unique, filter-matching results and never pads rows.
- Xquik is independent and not affiliated with X Corp.
- <!-- trust:win:start -->
- 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.
- <!-- trust:win:end -->
- ## Install the OpenClaw Twitter plugin
- ```bash
- openclaw plugins install clawhub:@xquik/tweetclaw
- ```
- OpenClaw records the verified ClawHub publisher scope and package as the update source.
- Create an API key for account-backed X (Twitter) automation at [dashboard.xquik.com](https://dashboard.xquik.com/).
- Then store it through OpenClaw.
- ```bash
- openclaw config set plugins.entries.tweetclaw.config.apiKey "$XQUIK_API_KEY"
- ```
- Add both tools without replacing the current profile.
- ```bash
- openclaw config set tools.alsoAllow '["explore", "tweetclaw"]'
- ```
- ## Run a Twitter bot & X (Twitter) automation from OpenClaw
- Ask your agent in plain words.
- The bot posts only what you approve.
- ```text
- Reply to my latest post with a thank-you note
- Post "Launch day" from my connected X account
- ```
- Next, read the [TweetClaw guide](https://docs.xquik.com/guides/tweetclaw) or the [OpenClaw setup guide](docs/openclaw-setup.md).
- <!-- trust:start -->
- ## Benchmarks & usage
- [](https://www.npmjs.com/package/@xquik/tweetclaw)
- [](https://clawhub.ai/xquik/skills/tweetclaw)
- [](https://skills.sh/xquik-dev/tweetclaw)
- [](https://www.bestpractices.dev/projects/13730)
- - 12,000+ downloads of @xquik/tweetclaw on npm ([source](https://www.npmjs.com/package/@xquik/tweetclaw)) <!-- trust:npm-xquik-tweetclaw 12641 -->
- - 2,900+ downloads of tweetclaw on ClawHub ([source](https://clawhub.ai/xquik/skills/tweetclaw)) <!-- trust:clawhub-tweetclaw 2958 -->
- - 83 installs of this repo's Skills on skills.sh ([source](https://skills.sh/xquik-dev/tweetclaw)) <!-- trust:skills-tweetclaw 83 -->
- - This repo meets the OpenSSF Best Practices passing criteria ([source](https://www.bestpractices.dev/projects/13730)) <!-- trust:openssf-tweetclaw 1 -->
- 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).
- <!-- trust:end -->
- ## Scrape tweets & export followers
- Reads run through the same `tweetclaw` tool.
- Extractions export followers and following accounts.
- ```text
- Search tweets about "AI agents" from the last day
- Export the followers of @NASA
- ```
- ## Common OpenClaw tasks
- Use `explore` before every live call.
- It returns the current supported route.
- | Customer question | Catalog query | Next step |
- | --- | --- | --- |
- | How can I search tweets? | `search tweets by query` | Call the listed read route. |
- | How can I read an X (Twitter) timeline? | `list recent tweets posted by a user` | Approve private timelines. |
- | How can I export followers? | `run extraction` | Choose followers, then approve. |
- | How can I scrape following accounts? | `run extraction` | Choose following, then approve. |
- | How can I monitor an account or keyword? | `create monitor` | Approve recurring usage. |
- | How can I post or reply? | `create tweet` | Approve each write. |
- See the [agent workflow guide](docs/agent-workflows.md) for longer jobs.
- ## Install options
- Use `openclaw plugins install npm:@xquik/tweetclaw` when you need the npm fallback.
- For normal upgrades, reuse the tracked install source.
- ```bash
- openclaw plugins update tweetclaw
- ```
- Pin a published npm version for reproducible production installs.
- ```bash
- 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.
- `OPENCLAW_NIX_MODE=1` turns off the plugin install and update commands.
- Install or update TweetClaw through your Nix OpenClaw source instead.
- Install TweetClaw before you add credentials if you want.
- The free `explore` catalog works at once.
- 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.
- ```bash
- 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 [client compatibility guide](https://docs.xquik.com/mcp/overview#client-compatibility).
- ## Configure
- Keep API keys out of chats, documentation, logs & shell history.
- ### Credits for pay per use without a subscription
- Top up credits from the Xquik dashboard.
- An API key can spend prepaid credits on public paid reads without a subscription.
- TweetClaw does not create checkout sessions or charge saved payment methods from the agent.
- ### Direct MPP for accountless pay per use
- Machine Payments Protocol (MPP) pays for single lookups with no account or API key.
- Create an MPP account with `mppx account create`.
- ```bash
- npm i mppx@0.13.4 viem@2.57.5
- openclaw config set plugins.entries.tweetclaw.config.tempoSigningKey "$MPP_SIGNING_KEY"
- ```
- Keep the signing key in local OpenClaw config.
- Never put it in prompts or logs.
- `explore` marks each MPP route with its price per call.
- [API coverage](#api-coverage) counts them.
- Other paid reads use prepaid credits.
- Media downloads and galleries require account-backed access.
- ### Optional settings
- ```bash
- openclaw config set plugins.entries.tweetclaw.config.baseUrl "https://xquik.com"
- openclaw config set plugins.entries.tweetclaw.config.pollingEnabled true
- openclaw config set plugins.entries.tweetclaw.config.pollingInterval 60
- ```
- Change `baseUrl` only for a self-hosted Xquik-compatible API.
- TweetClaw requires an HTTPS base URL with no embedded credentials.
- ## OpenClaw trust model
- TweetClaw uses 2 OpenClaw gates, which stop unattended publishing.
- - 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`.
- - 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.
- ## Tools
- ### `explore` (free, no network)
- Search the bundled API catalog without a network request.
- ### `tweetclaw` (invoke API endpoints)
- Invoke catalog-listed endpoints with structured fields.
- The runtime injects authentication.
- X (Twitter) writes also require `idempotencyKey`.
- Can your agent see the skill but not call TweetClaw tools?
- Add `explore` and `tweetclaw` to `tools.alsoAllow`.
- OpenClaw shows an approval prompt before each write-like `tweetclaw` call.
- Review the structured request before you approve a post, DM, monitor, extraction or webhook.
- ## Commands
- These commands answer at once, without the LLM.
- | Command | Description |
- | --- | --- |
- | `/xstatus` | Account info, subscription status, usage & credit balance |
- | `/xtrends` | Curated topics with an API key. Worldwide X (Twitter) trends with MPP. |
- | `/xtrends tech` | API-key mode shows curated topics in 1 category. |
- | `/xtrends 23424977` | MPP mode shows X (Twitter) trends for 1 WOEID. |
- ## Event notifications
- With polling on, TweetClaw checks your monitors every 60 seconds.
- It delivers new tweet, reply, quote & retweet events.
- Set up a monitor first.
- Ask your agent in plain words.
- ```text
- Monitor @elonmusk for new tweets, replies, and retweets
- ```
- ## Read response fields
- TweetClaw keeps every allowed Xquik response field.
- Optional fields stay absent when X (Twitter) omits them.
- Request `next_cursor` while `has_next_page` is true.
- Bookmark, like, follow, block, mute & notification state of the fetching account stays private.
- See [Read Data Richness](https://docs.xquik.com/guides/tweet-profile-api-fields) for exact tweet, profile & media fields.
- ## Pricing & access
- TweetClaw uses Xquik billing for account-backed automation and optional MPP reads.
- See [Billing & Pricing](https://docs.xquik.com/guides/billing) for current plans, eligible endpoints, and live prices.
- ## API coverage
- <!-- api-coverage:start (npm run generate-api-contract writes this block) -->
- The live [Xquik OpenAPI spec](https://xquik.com/openapi.json) lists 223 operations. An operation is 1 method on 1 path.
- Agents can call 192 of them through `tweetclaw`. TweetClaw leaves out the other 31.
- | Left out | Operations |
- | --- | --- |
- | API keys, checkout & X account connection, which stay in the dashboard | 13 |
- | X account connection, guest wallet checkout & support file downloads | 10 |
- | Documentation search outside `/api/v1` | 8 |
- 21 of the 192 accept MPP. Run `explore` with `mpp` set to `true` to list them.
- <!-- api-coverage:end -->
- | Category | Examples | Access |
- | --- | --- | --- |
- | Account | Account status | Account-backed |
- | Analysis | Sentiment, brand, news, market signals, viral score, custom questions | Account-backed |
- | Composition | Compose, drafts, writing styles, radar | Account-backed |
- | Credits | Check balance | Account-backed |
- | Extraction | Extraction tools, giveaway draws, exports | Account-backed |
- | Media | Authenticated media download, gallery links | Account-backed |
- | Monitoring | Create monitors, view events, manage webhooks, Telegram links | Account-backed |
- | X (Twitter) | Search, lookups, timelines, articles, trends, lists, communities, Spaces, jobs, bookmarks, notifications | Account-backed or MPP where eligible |
- | X (Twitter) accounts | List connected account handles for explicit user-selected actions | Account-backed |
- | X (Twitter) write | Post, reply, like, retweet, follow, remove follower, DM, upload media, profile, communities | Account-backed with approval |
- ## Questions
- ### Do I need an X (Twitter) developer account?
- No. Public reads need only an Xquik API key.
- Private reads & X (Twitter) account actions need a connected account.
- ### Is TweetClaw the official X API?
- No. Xquik runs its own REST API.
- TweetClaw calls that API, not the official X API.
- ## More Xquik tools
- - [X (Twitter) scraper API & X (Twitter) MCP server](https://github.com/Xquik-dev/x-twitter-scraper) with REST, MCP & Skill setup.
- - 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).
- - 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).
- - [Twitter CLI & X CLI](https://github.com/Xquik-dev/x-twitter-scraper-cli) for terminal workflows.
- - [Twitter advanced search operators](https://github.com/Xquik-dev/x-twitter-advanced-search) with tested examples.
- - [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).
- - 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).
- - 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).
- - 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).
- - [Xquik X API & Twitter scraper](https://xquik.com) and the [X (Twitter) API documentation](https://docs.xquik.com/api-reference/overview).
- ## License
- [MIT](LICENSE)
- 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 inFree to use. If it’s helped, pass it on.