@xquik/tweetclaw 1.3.0 → 1.4.1

package/README.md

@@ -1,8 +1,54 @@
 # TweetClaw
 
+[![npm](https://img.shields.io/npm/v/@xquik/tweetclaw)](https://www.npmjs.com/package/@xquik/tweetclaw)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+![GitHub stars](https://img.shields.io/github/stars/Xquik-dev/tweetclaw)
+
 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.
+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
 
@@ -12,24 +58,28 @@ openclaw plugins install @xquik/tweetclaw
 
 ## Configure
 
-### Option A: API key (full access, 97 endpoints)
+### 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/en/account?tab=x-accounts](https://dashboard.xquik.com/en/account?tab=x-accounts).
+Get a key at [dashboard.xquik.com](https://dashboard.xquik.com/).
+
+### Option B: Credits (pay-per-use via Stripe, no subscription)
 
-### Option B: MPP pay-per-use (no account needed, 7 read-only endpoints)
+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.tempoPrivateKey '0xYOUR_TEMPO_KEY'
 ```
 
-MPP (Machine Payments Protocol) lets agents pay per API call via Tempo (USDC). No account, no API key, no subscription. Get a Tempo wallet at [tempo.xyz](https://tempo.xyz).
+MPP (Machine Payments Protocol) lets agents pay per API call via Tempo (USDC). No account, no API key, no subscription. 16 read-only endpoints. Get a Tempo wallet at [tempo.xyz](https://tempo.xyz).
 
-MPP-eligible endpoints: tweet lookup ($0.0003), tweet search ($0.0003/tweet), user lookup ($0.00036), follower check ($0.002), article lookup ($0.002), media download ($0.0003/media), trends ($0.0009).
+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
 
@@ -78,7 +128,7 @@ Instant responses, no LLM needed:
 
 | Command | Description |
 |---------|-------------|
-| `/xstatus` | Account info, subscription status, usage |
+| `/xstatus` | Account info, subscription status, usage, credit balance |
 | `/xtrends` | Trending topics from curated sources |
 | `/xtrends tech` | Trending topics filtered by category |
 
@@ -97,45 +147,30 @@ You: "Monitor @elonmusk for new tweets and follower changes"
 
 ## API Coverage
 
-97 endpoints across these categories:
-
-| Category | Examples |
-|----------|---------|
-| **Write Actions** | Post tweets, reply, like, retweet, follow, unfollow, DM, update profile & avatar |
-| **Media** | Upload media via URL, download tweet media, get gallery links |
-| **Twitter** | Search tweets, look up users, check follow relationships, get articles |
-| **Composition** | Compose, refine, score tweets; manage drafts; analyze writing styles |
-| **Extraction** | Run extraction jobs (reply-extractor, community-explorer, etc.) |
-| **Draws** | Run giveaway draws on tweets, export results |
-| **Monitoring** | Create monitors, view events, manage webhooks |
-| **Automations** | Create flows, add steps, test runs, inbound webhooks |
-| **Account** | Manage API keys, subscription, connected X accounts |
-| **Trends** | X trending topics, curated radar from multiple sources |
-| **Support** | Create tickets, reply, track status |
-
-## Pricing
-
-**MPP pay-per-use** (no account needed):
-- 7 read-only X-API endpoints via Tempo (USDC)
-- Tweet/user/article lookup, search, follower check, media download, trends
-
-**Free tier** (API key, no subscription needed):
-- Tweet composition, style analysis, drafts
-- Curated trending radar
-- Account management, API keys
-- Integrations management
-- Flow automations (create, test, inbound webhooks)
-- Support tickets
-
-**Subscription ($20/month)** for full access:
-- Write actions (post, reply, like, retweet, follow, DM, update profile)
-- Tweet search, user lookup, article lookup, media download
-- Extractions, giveaway draws
-- Account monitors, events, webhooks
-- X trending topics
-- Flow activation (free: 2 flows, subscriber: 10)
-
-When a paid endpoint returns 402, TweetClaw provides a checkout URL (API key mode) or auto-pays via Tempo (MPP mode).
+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
 

package/openclaw.plugin.json

@@ -1,14 +1,14 @@
 {
   "id": "tweetclaw",
   "name": "TweetClaw",
-  "version": "1.3.0",
-  "description": "Post tweets, reply, like, retweet, follow, DM from your chat - full X/Twitter automation powered by Xquik",
+  "version": "1.4.0",
+  "description": "Post tweets, reply, like, retweet, follow, DM from your chat - full X/Twitter automation powered by Xquik. 120 endpoints, reads from $0.00015/call.",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
-      "apiKey": { "type": "string", "minLength": 1, "description": "Xquik API key (get one at dashboard.xquik.com/en/account?tab=x-accounts). Required for full access." },
-      "tempoPrivateKey": { "type": "string", "minLength": 1, "description": "Tempo wallet private key for MPP pay-per-use mode. No account needed. Only 7 read-only X-API endpoints." },
+      "apiKey": { "type": "string", "minLength": 1, "description": "Xquik API key (get one at dashboard.xquik.com). Required for full access to all 120 endpoints." },
+      "tempoPrivateKey": { "type": "string", "minLength": 1, "description": "Tempo wallet private key for MPP pay-per-use mode. No account needed. 16 read-only X-API endpoints." },
       "baseUrl": { "type": "string", "default": "https://xquik.com" },
       "pollingInterval": { "type": "number", "default": 60, "description": "Event polling interval in seconds" },
       "pollingEnabled": { "type": "boolean", "default": true }
@@ -19,8 +19,8 @@
     ]
   },
   "uiHints": {
-    "apiKey": { "label": "Xquik API Key", "sensitive": true, "placeholder": "xq_...", "help": "Full access to all 97 endpoints. Generate at dashboard.xquik.com/en/account?tab=x-accounts." },
-    "tempoPrivateKey": { "label": "Tempo Private Key (MPP)", "sensitive": true, "placeholder": "0x...", "help": "Pay-per-use mode via Machine Payments Protocol. No account needed. 7 read-only X-API endpoints only. Requires mppx and viem packages." },
+    "apiKey": { "label": "Xquik API Key", "sensitive": true, "placeholder": "xq_...", "help": "Full access to all 120 endpoints. Generate at dashboard.xquik.com." },
+    "tempoPrivateKey": { "label": "Tempo Private Key (MPP)", "sensitive": true, "placeholder": "0x...", "help": "Pay-per-use mode via Machine Payments Protocol. No account needed. 16 read-only X-API endpoints only. Requires mppx and viem packages." },
     "baseUrl": { "label": "API Base URL", "placeholder": "https://xquik.com", "advanced": true, "help": "Only change if using a self-hosted Xquik instance." },
     "pollingInterval": { "label": "Event Poll Interval (seconds)", "advanced": true, "help": "How often to check for new monitor events. Default: 60 seconds." },
     "pollingEnabled": { "label": "Enable Event Notifications", "advanced": true, "help": "Deliver monitor alerts and extraction completions to your chat." }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xquik/tweetclaw",
-  "version": "1.3.0",
-  "description": "Post tweets, reply, like, retweet, follow, DM & more from OpenClaw - full X/Twitter automation via Xquik",
+  "version": "1.4.1",
+  "description": "Post tweets, reply, like, retweet, follow, DM & more from OpenClaw - full X/Twitter automation via Xquik. 120 endpoints, reads from $0.00015/call.",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -31,7 +31,24 @@
     "x",
     "automation",
     "tweetclaw",
-    "xquik"
+    "xquik",
+    "twitter-api",
+    "x-api",
+    "social-media",
+    "scraper",
+    "mcp",
+    "ai-agent",
+    "data-extraction",
+    "giveaway",
+    "monitoring",
+    "tweet",
+    "twitter-scraper",
+    "twitter-bot",
+    "x-twitter",
+    "tweet-api",
+    "twitter-automation",
+    "openclaw",
+    "mcp-server"
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -50,8 +67,12 @@
     "viem": ">=2.0.0"
   },
   "peerDependenciesMeta": {
-    "mppx": { "optional": true },
-    "viem": { "optional": true }
+    "mppx": {
+      "optional": true
+    },
+    "viem": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/skills/tweetclaw/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tweetclaw
-description: "OpenClaw plugin for X/Twitter automation. Post tweets, reply, like, retweet, follow, DM, search, extract data, run giveaways, monitor accounts, automate flows via Xquik. 97 endpoints, 2 tools (explore + tweetclaw), 2 commands (/xstatus, /xtrends), background event poller."
+description: "OpenClaw plugin for X/Twitter automation. Post tweets, reply, like, retweet, follow, DM, search, extract data, run giveaways, monitor accounts, automate flows via Xquik. 120 endpoints, 2 tools (explore + tweetclaw), 2 commands (/xstatus, /xtrends), background event poller. Reads from $0.00015/call - 33x cheaper than the official X API."
 homepage: https://xquik.com
 read_when:
   - Posting, replying, liking, retweeting, or following on X/Twitter
@@ -11,17 +11,55 @@ read_when:
   - Extracting bulk data from X/Twitter (followers, replies, communities)
   - Downloading tweet media or uploading images
   - Sending DMs or updating X/Twitter profile
-metadata: {"openclaw":{"emoji":"🐦","primaryEnv":"XQUIK_API_KEY","requires":{"env":["XQUIK_API_KEY"]},"tags":["twitter","x","automation","social-media","tweets","scraping","giveaway","monitoring","rest-api"]}}
+  - Checking credit balance or topping up credits
+  - Browsing bookmarks, notifications, timeline, or DM history
+metadata: {"openclaw":{"emoji":"🐦","primaryEnv":"XQUIK_API_KEY","requires":{"env":["XQUIK_API_KEY"]},"tags":["twitter","x","automation","social-media","tweets","scraping","giveaway","monitoring","rest-api","cheap-api"]}}
 ---
 
 # TweetClaw
 
-OpenClaw plugin for X/Twitter automation powered by Xquik. Install via:
+OpenClaw plugin for X/Twitter automation powered by Xquik. **Reads from $0.00015/call - 33x cheaper than the official X API.**
 
 ```bash
 openclaw plugins install @xquik/tweetclaw
 ```
 
+## Pricing
+
+TweetClaw uses Xquik's credit-based pricing. 1 credit = $0.00015.
+
+### Per-Operation Costs
+
+| Operation | Credits | Cost |
+|-----------|---------|------|
+| Read (tweet, search, timeline, bookmarks, etc.) | 1 | $0.00015 |
+| Read (user profile) | 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** |
+
+### vs Official X API
+
+| | Xquik | 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 |
+
+### Pay-Per-Use (No Subscription)
+
+- **Credits (Stripe)**: Top up via `POST /api/v1/credits/topup` ($10 minimum). Works with all 120 endpoints.
+- **MPP (USDC)**: 16 read-only endpoints accept anonymous Tempo payments. No account needed. SDK: `npm i mppx`.
+
+MPP pricing: tweet lookup ($0.00015), tweet search ($0.00015/tweet), user lookup ($0.00015), user tweets ($0.00015/tweet), follower check ($0.00105), article ($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).
+
 ## When to Use
 
 Use TweetClaw when the user wants to:
@@ -32,6 +70,9 @@ Use TweetClaw when the user wants to:
 - Update their X profile, avatar, or banner
 - Upload media and tweet with images
 - Search tweets or look up user profiles
+- Get user's recent tweets, liked tweets, or media tweets
+- See who liked a tweet (favoriters) or mutual followers
+- Browse bookmarks, notifications, timeline, or DM history
 - Extract bulk data (followers, replies, communities, spaces)
 - Run giveaway draws from tweet replies
 - Monitor X accounts for new activity
@@ -41,6 +82,7 @@ Use TweetClaw when the user wants to:
 - Download tweet media (images, videos, GIFs)
 - Set up Telegram alerts for monitor events
 - Create and manage automation flows (triggers, steps, test runs)
+- Check credit balance or top up credits
 - Open and manage support tickets
 - Read X Articles (long-form posts)
 
@@ -54,7 +96,7 @@ Do NOT use TweetClaw for browsing X in a browser, analytics dashboards, scheduli
 openclaw config set plugins.entries.tweetclaw.config.apiKey 'xq_YOUR_KEY'
 ```
 
-Get a key at [dashboard.xquik.com/en/account?tab=x-accounts](https://dashboard.xquik.com/en/account?tab=x-accounts).
+Get a key at [dashboard.xquik.com](https://dashboard.xquik.com/).
 
 ### MPP mode (no account, pay-per-use via Tempo/USDC)
 
@@ -63,11 +105,11 @@ npm i mppx viem
 openclaw config set plugins.entries.tweetclaw.config.tempoPrivateKey '0xYOUR_KEY'
 ```
 
-MPP gives agents access to 7 read-only X-API endpoints without any account or subscription. The mppx SDK handles HTTP 402 payment challenges automatically.
+MPP gives agents access to 16 read-only X-API endpoints without any account or subscription. The mppx SDK handles HTTP 402 payment challenges automatically.
 
 ## Tools
 
-TweetClaw registers 2 tools that cover the entire Xquik API (97 endpoints):
+TweetClaw registers 2 tools that cover the entire Xquik API (120 endpoints):
 
 ### `explore` (free, no network)
 
@@ -101,7 +143,7 @@ async () => {
 
 | Command | Description |
 |---------|-------------|
-| `/xstatus` | Account info, subscription status, usage |
+| `/xstatus` | Account info, subscription status, usage, credit balance |
 | `/xtrends` | Trending topics from curated sources |
 | `/xtrends tech` | Trending topics filtered by category |
 
@@ -163,6 +205,27 @@ You: "Search tweets about AI agents"
 Agent uses tweetclaw -> calls search endpoint with query
 ```
 
+### Get user activity
+
+```
+You: "Show me @elonmusk's recent tweets"
+Agent uses tweetclaw -> GET /api/v1/x/users/{id}/tweets
+```
+
+### Check who liked a tweet
+
+```
+You: "Who liked this tweet?"
+Agent uses tweetclaw -> GET /api/v1/x/tweets/{id}/favoriters
+```
+
+### Browse bookmarks and timeline
+
+```
+You: "Show my bookmarks" or "What's on my timeline?"
+Agent uses tweetclaw -> GET /api/v1/x/bookmarks or GET /api/v1/x/timeline
+```
+
 ### Run a giveaway draw
 
 ```
@@ -212,6 +275,13 @@ You: "What's trending on X right now?"
 Agent uses tweetclaw -> returns curated trending topics from 7 sources
 ```
 
+### Check credits and top up
+
+```
+You: "How many credits do I have?" or "Top up my credits"
+Agent uses tweetclaw -> GET /api/v1/credits or POST /api/v1/credits/topup
+```
+
 ### Create an automation flow (free)
 
 ```
@@ -235,30 +305,21 @@ Agent uses tweetclaw -> creates ticket with subject and description
 
 ## API Categories
 
-| Category | Examples | Free |
+| Category | Examples | Cost |
 |----------|---------|------|
-| Write Actions | Post tweets, reply, like, retweet, follow, DM, update profile | No |
-| Media | Upload media, download tweet media | No |
-| Twitter | Search tweets, look up users, check follows | No |
-| Composition | Compose, refine, score tweets; manage drafts | Yes |
+| Write Actions | Post tweets, reply, like, retweet, follow, DM, update profile, avatar, banner | 2 credits |
+| Media | Upload media, download tweet media | 1-2 credits |
+| Twitter | Search tweets, look up users, user tweets/likes/media, favoriters, mutual followers, bookmarks, notifications, timeline, DM history | 1-7 credits |
+| Composition | Compose, refine, score tweets; manage drafts | Free |
 | Styles | Analyze tweet styles, compare, performance | Mixed |
-| Extraction | Reply/follower/community extraction (20 tools) | No |
-| Draws | Giveaway draws, export results | No |
-| Monitoring | Create monitors, view events, webhooks | No |
-| Automations | Create flows, add steps, test runs, inbound webhooks | Yes |
-| Account | API keys, subscription, connected X accounts | Yes |
-| Trends | X trending topics, curated radar from 7 sources | Mixed |
-| Support | Create tickets, reply, track status | Yes |
-
-## Pricing
-
-MPP pay-per-use (no account): 7 read-only X-API endpoints via Tempo (USDC) - tweet lookup ($0.0003), tweet search ($0.0003/tweet), user lookup ($0.00036), follower check ($0.002), article ($0.002), media download ($0.0003/media), trends ($0.0009).
-
-Free tier (API key, no subscription): tweet composition, style analysis, drafts, curated radar, account management, integrations, automations (create/test), support tickets.
-
-Subscription ($20/month): write actions, search, article lookup, media, extractions, draws, monitors, X trending, flow activation (2 free, 10 subscriber).
-
-When a paid endpoint returns 402, TweetClaw provides a checkout URL.
+| Extraction | Reply/follower/community extraction (23 tools) | 1-7 credits/result |
+| Draws | Giveaway draws, export results | 1 credit/entry |
+| Monitoring | Create monitors, view events, webhooks | Free |
+| Automations | Create flows, add steps, test runs, inbound webhooks | Free |
+| Account | API keys, subscription, connected X accounts | Free |
+| Credits | Check balance, top up | Free |
+| Trends | X trending topics, curated radar from 7 sources | 3 credits / Free |
+| Support | Create tickets, reply, track status | Free |
 
 ## Tips
 
@@ -268,5 +329,6 @@ When a paid endpoint returns 402, TweetClaw provides a checkout URL.
 - For write actions (post, like, follow, DM), always pass the `account` parameter with the X username
 - Follow/unfollow/DM require a numeric user ID - look up the user first via `/api/v1/x/users/:username`
 - On 402 errors, call `POST /api/v1/subscribe` to get a checkout URL instead of giving up
-- Use `/xstatus` to quickly check subscription and usage without invoking the AI agent
+- Use `/xstatus` to quickly check subscription, usage, and credit balance without invoking the AI agent
 - The compose workflow (compose/refine/score) is free and helps draft high-engagement tweets
+- Top up credits via `POST /api/v1/credits/topup` for pay-per-use without a subscription

package/src/index.ts

@@ -94,7 +94,7 @@ export default function register(api: OpenClawApi, fetchFunction?: FetchFunction
         api.logger.error(`TweetClaw: MPP init failed - ${error instanceof Error ? error.message : String(error)}`);
       }
     })();
-    api.logger.info('TweetClaw: MPP mode - pay-per-use via Tempo (7 X-API endpoints, no subscription needed)');
+    api.logger.info('TweetClaw: MPP mode - pay-per-use via Tempo (16 X-API endpoints, no subscription needed)');
   }
 
   const request = createProxiedRequest(baseUrl, credential, fetchFunction);

package/src/tools/tweetclaw.ts

@@ -206,11 +206,12 @@ async () => {
     body: { toolType: 'follower_explorer', targetUsername: 'elonmusk', resultsLimit: 1000 }
   });
   return job;
-  // 20 tool types: reply_extractor, repost_extractor, quote_extractor, thread_extractor,
+  // 23 tool types: reply_extractor, repost_extractor, quote_extractor, thread_extractor,
   // article_extractor, follower_explorer, following_explorer, verified_follower_explorer,
   // mention_extractor, post_extractor, community_extractor, community_moderator_explorer,
   // community_post_extractor, community_search, list_member_extractor, list_post_extractor,
-  // list_follower_explorer, space_explorer, people_search, tweet_search_extractor
+  // list_follower_explorer, space_explorer, people_search, tweet_search_extractor,
+  // favoriters, user_likes, user_media
 }
 \`\`\`
 
@@ -297,11 +298,11 @@ async () => {
 
 ## Cost
 - Free: /api/v1/compose, /api/v1/styles (cached lookup/save/delete/compare), /api/v1/drafts, /api/v1/radar, /api/v1/subscribe, /api/v1/account, /api/v1/api-keys, /api/v1/bot/*, /api/v1/integrations/*, /api/v1/x/accounts, /api/v1/automations/*, /api/v1/support/*
-- MPP pay-per-use (no account/subscription needed, 7 endpoints): GET /api/v1/x/tweets/:id ($0.0003/call), GET /api/v1/x/tweets/search ($0.0003/tweet), GET /api/v1/x/users/:username ($0.00036/call), GET /api/v1/x/followers/check ($0.002/call), GET /api/v1/x/articles/:tweetId ($0.002/call), POST /api/v1/x/media/download ($0.0003/media), GET /api/v1/trends ($0.0009/call)
+- MPP pay-per-use (no account/subscription needed, 16 endpoints): GET /api/v1/x/tweets/:id ($0.00015/call), GET /api/v1/x/tweets/search ($0.00015/tweet), GET /api/v1/x/users/:username ($0.00015/call), GET /api/v1/x/users/:id/tweets ($0.00015/tweet), GET /api/v1/x/followers/check ($0.00105/call), GET /api/v1/x/articles/:tweetId ($0.00105/call), POST /api/v1/x/media/download ($0.00015/media), GET /api/v1/trends ($0.00045/call), GET /api/v1/x/trends ($0.00045/call), GET /api/v1/x/tweets/:id/quotes ($0.00015/tweet), GET /api/v1/x/tweets/:id/replies ($0.00015/tweet), GET /api/v1/x/tweets/:id/retweeters ($0.00015/user), GET /api/v1/x/tweets/:id/favoriters ($0.00015/user), GET /api/v1/x/tweets/:id/thread ($0.00015/tweet), GET /api/v1/x/users/:id/likes ($0.00015/tweet), GET /api/v1/x/users/:id/media ($0.00015/tweet)
 - Subscription required: /api/v1/styles (X API refresh when cache >7 days), /api/v1/x/profile, /api/v1/x/communities, /api/v1/x/dm, /api/v1/extractions, /api/v1/draws, /api/v1/monitors, /api/v1/events, /api/v1/webhooks, /api/v1/styles/:username/performance, /api/v1/trending/:source
 - Write actions (subscription required): POST /api/v1/x/tweets, DELETE /api/v1/x/tweets/:id, POST|DELETE /api/v1/x/tweets/:id/like, POST /api/v1/x/tweets/:id/retweet, POST|DELETE /api/v1/x/users/:id/follow, POST /api/v1/x/dm/:userId, POST /api/v1/x/media, PATCH /api/v1/x/profile, PATCH /api/v1/x/profile/avatar, PATCH /api/v1/x/profile/banner, POST|DELETE /api/v1/x/communities, POST|DELETE /api/v1/x/communities/:id/join
 - IMPORTANT: Always attempt the request. Never assume subscription status. The API returns a clear error if subscription is missing.
-- MPP MODE: When configured with tempoPrivateKey (no API key), the mppx SDK auto-handles 402 challenges by paying via Tempo (USDC). Only the 7 MPP-eligible endpoints work in this mode.
+- MPP MODE: When configured with tempoPrivateKey (no API key), the mppx SDK auto-handles 402 challenges by paying via Tempo (USDC). Only the 16 MPP-eligible endpoints work in this mode.
 
 ## Error handling
 - If response contains "subscription is inactive" or status 402, call POST /api/v1/subscribe to get checkout URL