{"id":47359228,"url":"https://github.com/Xquik-dev/tweetclaw","last_synced_at":"2026-04-01T17:01:16.498Z","repository":{"id":344181220,"uuid":"1180792440","full_name":"Xquik-dev/tweetclaw","owner":"Xquik-dev","description":"Post tweets, reply, like, retweet, follow, DM \u0026 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.","archived":false,"fork":false,"pushed_at":"2026-03-29T17:01:22.000Z","size":591,"stargazers_count":26,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-29T19:01:37.462Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://xquik.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Xquik-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-13T12:18:27.000Z","updated_at":"2026-03-29T17:01:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Xquik-dev/tweetclaw","commit_stats":null,"previous_names":["xquik-dev/tweetclaw"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Xquik-dev/tweetclaw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xquik-dev%2Ftweetclaw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xquik-dev%2Ftweetclaw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xquik-dev%2Ftweetclaw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xquik-dev%2Ftweetclaw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Xquik-dev","download_url":"https://codeload.github.com/Xquik-dev/tweetclaw/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xquik-dev%2Ftweetclaw/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31172561,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-29T21:28:10.185Z","status":"online","status_checked_at":"2026-03-30T02:00:06.831Z","response_time":138,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-03-18T12:00:34.520Z","updated_at":"2026-04-01T17:01:16.483Z","avatar_url":"https://github.com/Xquik-dev.png","language":"TypeScript","funding_links":[],"categories":["Skills \u0026 Plugins","Sponsors ❤️","Skills vs Plugins: What's the Difference?","Other","Tools"],"sub_categories":["Notable Skills \u0026 Plugins","Community Skills","Bundled Plugins","Notable Skills"],"readme":"# TweetClaw\n\n[![npm](https://img.shields.io/npm/v/@xquik/tweetclaw)](https://www.npmjs.com/package/@xquik/tweetclaw)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n![GitHub stars](https://img.shields.io/github/stars/Xquik-dev/tweetclaw)\n\nPost tweets, reply, like, retweet, follow, DM \u0026 more - directly from your chat. Full X/Twitter automation for [OpenClaw](https://github.com/openclaw/openclaw).\n\nPowered by [Xquik](https://xquik.com), the all-in-one X automation platform. **Reads from $0.00015/call - 33x cheaper than the official X API.**\n\n## Pricing\n\nTweetClaw uses Xquik's credit-based pricing. 1 credit = $0.00015.\n\n### vs Official X API\n\n| | Xquik (via TweetClaw) | X API Basic | X API Pro |\n|---|---|---|---|\n| **Monthly cost** | **$20** | $100 | $5,000 |\n| **Cost per tweet read** | **$0.00015** | ~$0.01 | ~$0.005 |\n| **Cost per user lookup** | **$0.0003** | ~$0.01 | ~$0.005 |\n| **Write actions** | **$0.0003** | Limited | Limited |\n| **Bulk extraction** | **$0.00015/result** | Not available | Not available |\n| **Monitoring + webhooks** | **Free** | Not available | Not available |\n| **Giveaway draws** | **$0.00015/entry** | Not available | Not available |\n\n### Per-Operation Costs\n\n| Operation | Credits | Cost |\n|-----------|---------|------|\n| Read (tweet, search, timeline, bookmarks, etc.) | 1 | $0.00015 |\n| Read (user profile, favoriters, followers you know, verified followers) | 2 | $0.0003 |\n| Read (trends) | 3 | $0.00045 |\n| Follow check, article | 7 | $0.00105 |\n| Write (tweet, like, retweet, follow, DM, etc.) | 2 | $0.0003 |\n| Extraction (tweets, replies, quotes, mentions, posts, likes, media, search) | 1/result | $0.00015/result |\n| Extraction (followers, following, verified followers, favoriters, retweeters, community members, people search, list members, list followers) | 2/result | $0.0003/result |\n| Extraction (articles) | 7/result | $0.00105/result |\n| Draw | 1/entry | $0.00015/entry |\n| Monitors, webhooks, radar, compose, drafts, integrations | 0 | **Free** |\n\n### Pay-Per-Use (No Subscription)\n\nTwo options:\n\n- **Credits (Stripe)**: Top up credits via the API ($10 minimum). 1 credit = $0.00015. Works with all 120 endpoints.\n- **MPP (USDC)**: 16 read-only X-API endpoints accept anonymous payments via Machine Payments Protocol. No account needed. SDK: `npm i mppx`.\n\n### Free Operations\n\nTweet composition, style analysis, drafts, curated radar (7 sources), account management, integrations, automations, support tickets - all free, no credits consumed.\n\n## Install\n\n```bash\nopenclaw plugins install @xquik/tweetclaw\n```\n\n## Configure\n\n### Option A: API key (full access, 120 endpoints)\n\n```bash\nopenclaw config set plugins.entries.tweetclaw.config.apiKey 'xq_YOUR_KEY'\n```\n\nGet a key at [dashboard.xquik.com](https://dashboard.xquik.com/).\n\n### Option B: Credits (pay-per-use via Stripe, no subscription)\n\nTop up credits from the Xquik dashboard or via `POST /credits/topup`. All 120 endpoints available. 1 credit = $0.00015.\n\n### Option C: MPP pay-per-use (no account needed, 16 read-only endpoints)\n\n```bash\nnpm i mppx viem\nopenclaw config set plugins.entries.tweetclaw.config.tempoSigningKey '0xYOUR_TEMPO_ACCOUNT_KEY'\n```\n\nMPP (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.\n\nMPP-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).\n\n### Optional settings\n\n```bash\nopenclaw config set plugins.entries.tweetclaw.config.pollingEnabled true\nopenclaw config set plugins.entries.tweetclaw.config.pollingInterval 60\n```\n\n## Tools\n\nTweetClaw uses Xquik's 2-tool approach to cover the entire API:\n\n### `explore` (free, no network)\n\nSearch the API spec to find endpoints. No API calls are made.\n\n```\nYou: \"What endpoints are available for tweet composition?\"\n\nAI uses explore → filters spec by category \"composition\"\n→ Returns matching endpoints with parameters and response shapes\n```\n\n### `tweetclaw` (execute API calls)\n\nExecute authenticated API calls. Auth is injected automatically - the LLM never sees your API key.\n\n```\nYou: \"Post a tweet saying 'Hello from TweetClaw!'\"\n\nAI uses tweetclaw → finds connected account, posts tweet\n→ Returns { tweetId, success: true }\n```\n\n```\nYou: \"Search tweets about AI agents\"\n\nAI uses explore → finds /api/v1/x/tweets/search\nAI uses tweetclaw → calls the endpoint with auth\n→ Returns tweet results\n```\n\n## Commands\n\nInstant responses, no LLM needed:\n\n| Command | Description |\n|---------|-------------|\n| `/xstatus` | Account info, subscription status, usage, credit balance |\n| `/xtrends` | Trending topics from curated sources |\n| `/xtrends tech` | Trending topics filtered by category |\n\n## Event Notifications\n\nWhen polling is enabled (default), TweetClaw checks for new events every 60 seconds and delivers them to your chat:\n\n- **Monitor alerts**: New tweets, replies, quotes, retweets from monitored accounts\n- **Follower changes**: Gained or lost followers on monitored accounts\n\nSet up a monitor first:\n\n```\nYou: \"Monitor @elonmusk for new tweets and follower changes\"\n```\n\n## API Coverage\n\n120 endpoints across 12 categories:\n\n| Category | Examples | Cost |\n|----------|---------|------|\n| **Write Actions** | Post tweets, reply, like, retweet, follow, unfollow, DM, update profile, avatar, banner | 2 credits |\n| **Media** | Upload media via URL, download tweet media, get gallery links | 1-2 credits |\n| **Twitter** | Search tweets, look up users, user tweets/likes/media, favoriters, mutual followers, check follows, articles, bookmarks, notifications, timeline, DM history | 1-7 credits |\n| **Composition** | Compose, refine, score tweets; manage drafts; analyze writing styles | Free |\n| **Extraction** | Run extraction jobs (23 tool types: replies, followers, communities, favoriters, user_likes, user_media, etc.) | 1-7 credits/result |\n| **Draws** | Run giveaway draws on tweets, export results | 1 credit/entry |\n| **Monitoring** | Create monitors, view events, manage webhooks | Free |\n| **Automations** | Create flows, add steps, test runs, inbound webhooks | Free |\n| **Account** | Manage API keys, subscription, connected X accounts | Free |\n| **Credits** | Check balance, top up credits | Free |\n| **Trends** | X trending topics, curated radar from 7 sources | 3 credits / Free |\n| **Support** | Create tickets, reply, track status | Free |\n\n## Links\n\n- [Xquik Platform](https://xquik.com)\n- [API Documentation](https://docs.xquik.com)\n- [Billing \u0026 Pricing](https://docs.xquik.com/guides/billing)\n- [npm Package](https://www.npmjs.com/package/@xquik/tweetclaw)\n- [OpenClaw](https://github.com/openclaw/openclaw)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXquik-dev%2Ftweetclaw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FXquik-dev%2Ftweetclaw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXquik-dev%2Ftweetclaw/lists"}