https://github.com/Xquik-dev/tweetclaw
Post tweets, reply, like, retweet, follow, DM & more from OpenClaw. Full X/Twitter automation via Xquik — 120 endpoints, reads from $0.00015/call (66x cheaper than official X API). 2 tools, 2 commands, background event poller.
https://github.com/Xquik-dev/tweetclaw
ai-agent automation cheap-api data-extraction giveaway mcp-server openclaw openclaw-plugin pay-per-use skills social-media tweet tweetclaw twitter twitter-api twitter-automation x x-api xquik
Last synced: about 1 month ago
JSON representation
Post tweets, reply, like, retweet, follow, DM & more from OpenClaw. Full X/Twitter automation via Xquik — 120 endpoints, reads from $0.00015/call (66x cheaper than official X API). 2 tools, 2 commands, background event poller.
- Host: GitHub
- URL: https://github.com/Xquik-dev/tweetclaw
- Owner: Xquik-dev
- License: mit
- Created: 2026-03-13T12:18:27.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2026-03-29T17:01:22.000Z (about 1 month ago)
- Last Synced: 2026-03-29T19:01:37.462Z (about 1 month ago)
- Topics: ai-agent, automation, cheap-api, data-extraction, giveaway, mcp-server, openclaw, openclaw-plugin, pay-per-use, skills, social-media, tweet, tweetclaw, twitter, twitter-api, twitter-automation, x, x-api, xquik
- Language: TypeScript
- Homepage: https://xquik.com
- Size: 577 KB
- Stars: 26
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-agent-skills - Xquik-dev/tweetclaw - 40+ X/Twitter actions: post, extract, monitor, compose (Sponsors ❤️ / Community Skills)
- awesome-openclaw-plugins - tweetclaw - Post tweets, reply, like, retweet, follow, DM & more from your chat. 40+ X/Twitter endpoints via Xquik. By [@Xquik-dev](https://github.com/Xquik-dev). `openclaw plugins install @xquik/tweetclaw` (Skills vs Plugins: What's the Difference? / Bundled Plugins)
- awesome-openclaw - tweetclaw - OpenClaw plugin for X/Twitter automation — post tweets, reply, like, retweet, follow, DM, search, extract data, run giveaways, monitor accounts. 40+ endpoints via Xquik. `openclaw plugins install @xquik/tweetclaw` (Skills & Plugins / Notable Skills)
- awesome-openclaw-skills - Xquik-dev/tweetclaw - | (Other)
- awesome-twitter-tools - TweetClaw - OpenClaw plugin for X/Twitter automation: search tweets, post tweets and replies, export followers, run monitors and webhooks, send DMs, and run giveaway draws through Xquik. (Tools)
README
# TweetClaw
[](https://www.npmjs.com/package/@xquik/tweetclaw)
[](LICENSE)
Post tweets, reply, like, retweet, follow, DM & more - directly from your chat. Full X/Twitter automation for [OpenClaw](https://github.com/openclaw/openclaw).
Powered by [Xquik](https://xquik.com), the all-in-one X automation platform. **Reads from $0.00015/call - 33x cheaper than the official X API.**
## Pricing
TweetClaw uses Xquik's credit-based pricing. 1 credit = $0.00015.
### vs Official X API
| | Xquik (via TweetClaw) | X API Basic | X API Pro |
|---|---|---|---|
| **Monthly cost** | **$20** | $100 | $5,000 |
| **Cost per tweet read** | **$0.00015** | ~$0.01 | ~$0.005 |
| **Cost per user lookup** | **$0.0003** | ~$0.01 | ~$0.005 |
| **Write actions** | **$0.0003** | Limited | Limited |
| **Bulk extraction** | **$0.00015/result** | Not available | Not available |
| **Monitoring + webhooks** | **Free** | Not available | Not available |
| **Giveaway draws** | **$0.00015/entry** | Not available | Not available |
### Per-Operation Costs
| Operation | Credits | Cost |
|-----------|---------|------|
| Read (tweet, search, timeline, bookmarks, etc.) | 1 | $0.00015 |
| Read (user profile, favoriters, followers you know, verified followers) | 2 | $0.0003 |
| Read (trends) | 3 | $0.00045 |
| Follow check, article | 7 | $0.00105 |
| Write (tweet, like, retweet, follow, DM, etc.) | 2 | $0.0003 |
| Extraction (tweets, replies, quotes, mentions, posts, likes, media, search) | 1/result | $0.00015/result |
| Extraction (followers, following, verified followers, favoriters, retweeters, community members, people search, list members, list followers) | 2/result | $0.0003/result |
| Extraction (articles) | 7/result | $0.00105/result |
| Draw | 1/entry | $0.00015/entry |
| Monitors, webhooks, radar, compose, drafts, integrations | 0 | **Free** |
### Pay-Per-Use (No Subscription)
Two options:
- **Credits (Stripe)**: Top up credits via the API ($10 minimum). 1 credit = $0.00015. Works with all 120 endpoints.
- **MPP (USDC)**: 16 read-only X-API endpoints accept anonymous payments via Machine Payments Protocol. No account needed. SDK: `npm i mppx`.
### Free Operations
Tweet composition, style analysis, drafts, curated radar (7 sources), account management, integrations, automations, support tickets - all free, no credits consumed.
## Install
```bash
openclaw plugins install @xquik/tweetclaw
```
## Configure
### Option A: API key (full access, 120 endpoints)
```bash
openclaw config set plugins.entries.tweetclaw.config.apiKey 'xq_YOUR_KEY'
```
Get a key at [dashboard.xquik.com](https://dashboard.xquik.com/).
### Option B: Credits (pay-per-use via Stripe, no subscription)
Top up credits from the Xquik dashboard or via `POST /credits/topup`. All 120 endpoints available. 1 credit = $0.00015.
### Option C: MPP pay-per-use (no account needed, 16 read-only endpoints)
```bash
npm i mppx viem
openclaw config set plugins.entries.tweetclaw.config.tempoSigningKey '0xYOUR_TEMPO_ACCOUNT_KEY'
```
MPP (Machine Payments Protocol) lets agents pay per API call via Tempo (USDC). No account, no API key, no subscription. 16 read-only endpoints. Create a Tempo account with `mppx account create` or at [tempo.xyz](https://tempo.xyz). The key stays local and is only used to sign payment proofs.
MPP-eligible endpoints: tweet lookup ($0.00015), tweet search ($0.00015/tweet), user lookup ($0.00015), user tweets ($0.00015/tweet), follower check ($0.00105), article lookup ($0.00105), media download ($0.00015/media), trends ($0.00045), X trends ($0.00045), quotes ($0.00015/tweet), replies ($0.00015/tweet), retweeters ($0.00015/user), favoriters ($0.00015/user), thread ($0.00015/tweet), user likes ($0.00015/tweet), user media ($0.00015/tweet).
### Optional settings
```bash
openclaw config set plugins.entries.tweetclaw.config.pollingEnabled true
openclaw config set plugins.entries.tweetclaw.config.pollingInterval 60
```
## Tools
TweetClaw uses Xquik's 2-tool approach to cover the entire API:
### `explore` (free, no network)
Search the API spec to find endpoints. No API calls are made.
```
You: "What endpoints are available for tweet composition?"
AI uses explore → filters spec by category "composition"
→ Returns matching endpoints with parameters and response shapes
```
### `tweetclaw` (execute API calls)
Execute authenticated API calls. Auth is injected automatically - the LLM never sees your API key.
```
You: "Post a tweet saying 'Hello from TweetClaw!'"
AI uses tweetclaw → finds connected account, posts tweet
→ Returns { tweetId, success: true }
```
```
You: "Search tweets about AI agents"
AI uses explore → finds /api/v1/x/tweets/search
AI uses tweetclaw → calls the endpoint with auth
→ Returns tweet results
```
## Commands
Instant responses, no LLM needed:
| Command | Description |
|---------|-------------|
| `/xstatus` | Account info, subscription status, usage, credit balance |
| `/xtrends` | Trending topics from curated sources |
| `/xtrends tech` | Trending topics filtered by category |
## Event Notifications
When polling is enabled (default), TweetClaw checks for new events every 60 seconds and delivers them to your chat:
- **Monitor alerts**: New tweets, replies, quotes, retweets from monitored accounts
- **Follower changes**: Gained or lost followers on monitored accounts
Set up a monitor first:
```
You: "Monitor @elonmusk for new tweets and follower changes"
```
## API Coverage
120 endpoints across 12 categories:
| Category | Examples | Cost |
|----------|---------|------|
| **Write Actions** | Post tweets, reply, like, retweet, follow, unfollow, DM, update profile, avatar, banner | 2 credits |
| **Media** | Upload media via URL, download tweet media, get gallery links | 1-2 credits |
| **Twitter** | Search tweets, look up users, user tweets/likes/media, favoriters, mutual followers, check follows, articles, bookmarks, notifications, timeline, DM history | 1-7 credits |
| **Composition** | Compose, refine, score tweets; manage drafts; analyze writing styles | Free |
| **Extraction** | Run extraction jobs (23 tool types: replies, followers, communities, favoriters, user_likes, user_media, etc.) | 1-7 credits/result |
| **Draws** | Run giveaway draws on tweets, export results | 1 credit/entry |
| **Monitoring** | Create monitors, view events, manage webhooks | Free |
| **Automations** | Create flows, add steps, test runs, inbound webhooks | Free |
| **Account** | Manage API keys, subscription, connected X accounts | Free |
| **Credits** | Check balance, top up credits | Free |
| **Trends** | X trending topics, curated radar from 7 sources | 3 credits / Free |
| **Support** | Create tickets, reply, track status | Free |
## Links
- [Xquik Platform](https://xquik.com)
- [API Documentation](https://docs.xquik.com)
- [Billing & Pricing](https://docs.xquik.com/guides/billing)
- [npm Package](https://www.npmjs.com/package/@xquik/tweetclaw)
- [OpenClaw](https://github.com/openclaw/openclaw)
## License
MIT