@xquik/tweetclaw 1.6.23 → 1.6.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -5,6 +5,7 @@
5
5
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
6
6
  ![GitHub stars](https://img.shields.io/github/stars/Xquik-dev/tweetclaw)
7
7
  [![Ask DeepWiki](https://deepwiki.com/badge.svg?url=https%3A%2F%2Fgithub.com%2FXquik-dev%2Ftweetclaw)](https://deepwiki.com/Xquik-dev/tweetclaw)
8
+ [![Context7](https://img.shields.io/badge/Context7-agent_docs-059669)](https://context7.com/xquik-dev/tweetclaw)
8
9
  [![Glama MCP server](https://glama.ai/mcp/servers/Xquik-dev/x-twitter-scraper/badges/score.svg)](https://glama.ai/mcp/servers/Xquik-dev/x-twitter-scraper)
9
10
  [![Smithery](https://smithery.ai/badge/xquik/x-twitter-scraper)](https://smithery.ai/servers/xquik/x-twitter-scraper)
10
11
  [![Apify Actor](https://apify.com/actor-badge?actor=xquik/x-tweet-scraper)](https://apify.com/xquik/x-tweet-scraper)
@@ -98,7 +99,9 @@ openclaw config set plugins.entries.tweetclaw.config.tempoSigningKey "$MPP_SIGNI
98
99
 
99
100
  **Security**: Keep the signing key out of chats, docs, and shell history. Prefer the environment-variable command above so OpenClaw writes the secret to its local config without exposing it in the prompt.
100
101
 
101
- 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), 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), community info ($0.00015), community members ($0.00015/user), community moderators ($0.00015/user), community tweets ($0.00015/tweet), community search ($0.00015/community), communities tweets ($0.00015/tweet), list followers ($0.00015/user), list members ($0.00015/user), list tweets ($0.00015/tweet), users batch ($0.00015/user), users search ($0.00015/user), user followers ($0.00015/user), followers you know ($0.00015/user), user following ($0.00015/user), user mentions ($0.00015/tweet), verified followers ($0.00015/user).
102
+ 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), 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 timeline reads ($0.00015/tweet), community info ($0.00015), community members ($0.00015/user), community moderators ($0.00015/user), community tweets ($0.00015/tweet), community search ($0.00015/community), communities tweets ($0.00015/tweet), list followers ($0.00015/user), list members ($0.00015/user), list tweets ($0.00015/tweet), users batch ($0.00015/user), users search ($0.00015/user), user followers ($0.00015/user), followers you know ($0.00015/user), user following ($0.00015/user), user mentions ($0.00015/tweet), verified followers ($0.00015/user).
103
+
104
+ Media downloads and gallery creation are not MPP-eligible. The user media endpoint returns a user's media-tweet timeline; it does not download files or create gallery links.
102
105
 
103
106
  ### Enable the optional action tool
104
107
 
@@ -197,17 +200,22 @@ You: "Monitor @elonmusk for new tweets, replies, and retweets"
197
200
  | **Composition** | Compose, drafts, writing styles, radar | Free / Mixed |
198
201
  | **Credits** | Check balance | Free |
199
202
  | **Extraction** | 23 extraction tools, giveaway draws, exports | 1-5 credits/result |
200
- | **Media** | Upload media via URL, download tweet media, get gallery links | 1-2 credits |
203
+ | **Media** | Upload media via URL, authenticated media download, gallery links | 1-2 credits |
201
204
  | **Monitoring** | Create monitors, view events, manage webhooks | Free |
202
205
  | **Twitter** | Search, lookups, timelines, articles, trends, bookmarks, notifications | 1-5 credits |
203
206
  | **X Accounts** | List connected account handles for explicit user-selected actions | Free |
204
207
  | **X Write** | Post, reply, like, retweet, follow, remove follower, DM, profile, communities | 10 credits |
205
208
 
209
+ Media download requires authenticated access and is not MPP-eligible. MPP only includes media-tweet timeline reads, not file download or gallery creation.
210
+
206
211
  ## Links
207
212
 
208
213
  - [Xquik Platform](https://xquik.com)
209
214
  - [API Documentation](https://docs.xquik.com)
210
215
  - [Billing & Pricing](https://docs.xquik.com/guides/billing)
216
+ - [Context7 Agent Docs](https://context7.com/xquik-dev/tweetclaw)
217
+ - [OpenClaw Setup Guide](docs/openclaw-setup.md)
218
+ - [Agent Workflow Guide](docs/agent-workflows.md)
211
219
  - Framework guides: [Mastra](https://docs.xquik.com/guides/mastra), [CrewAI](https://docs.xquik.com/guides/crewai), [LangChain](https://docs.xquik.com/guides/langchain), [Pydantic AI](https://docs.xquik.com/guides/pydantic-ai), [Google ADK](https://docs.xquik.com/guides/google-adk), [Microsoft Agent Framework](https://docs.xquik.com/guides/microsoft-agent-framework), [n8n](https://docs.xquik.com/guides/n8n), [Zapier](https://docs.xquik.com/guides/zapier), [Make](https://docs.xquik.com/guides/make), [Pipedream](https://docs.xquik.com/guides/pipedream), [Composio migration](https://docs.xquik.com/guides/composio-migration)
212
220
  - [npm Package](https://www.npmjs.com/package/@xquik/tweetclaw)
213
221
  - [Hermes Tweet for Hermes Agent](https://github.com/Xquik-dev/hermes-tweet)
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "id": "tweetclaw",
3
3
  "name": "TweetClaw",
4
- "version": "1.6.23",
4
+ "version": "1.6.25",
5
5
  "description": "Post tweets, reply, like, retweet, follow, DM, search, and monitor X/Twitter through structured Xquik endpoints.",
6
6
  "activation": {
7
7
  "onStartup": false,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xquik/tweetclaw",
3
- "version": "1.6.23",
3
+ "version": "1.6.25",
4
4
  "description": "Post tweets, reply, like, retweet, follow, DM & more from OpenClaw through structured Xquik endpoints.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -32,8 +32,8 @@
32
32
  },
33
33
  "install": {
34
34
  "defaultChoice": "clawhub",
35
- "clawhubSpec": "clawhub:@xquik/tweetclaw@1.6.23",
36
- "npmSpec": "@xquik/tweetclaw@1.6.23",
35
+ "clawhubSpec": "clawhub:@xquik/tweetclaw@1.6.25",
36
+ "npmSpec": "@xquik/tweetclaw@1.6.25",
37
37
  "minHostVersion": ">=2026.5.4"
38
38
  }
39
39
  },
@@ -68,7 +68,7 @@ Source: [official X API pricing](https://docs.x.com/x-api/getting-started/pricin
68
68
  - **Credits**: Top up credits in the Xquik dashboard. The plugin can read the current balance.
69
69
  - **MPP**: 31 read-only endpoints accept anonymous on-chain payments. No account needed. SDK: `npm i mppx viem`.
70
70
 
71
- 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), 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), community info ($0.00015), community members ($0.00015/user), community moderators ($0.00015/user), community tweets ($0.00015/tweet), community search ($0.00015/community), communities tweets ($0.00015/tweet), list followers ($0.00015/user), list members ($0.00015/user), list tweets ($0.00015/tweet), users batch ($0.00015/user), users search ($0.00015/user), user followers ($0.00015/user), followers you know ($0.00015/user), user following ($0.00015/user), user mentions ($0.00015/tweet), verified followers ($0.00015/user).
71
+ 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), 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 timeline reads ($0.00015/tweet), community info ($0.00015), community members ($0.00015/user), community moderators ($0.00015/user), community tweets ($0.00015/tweet), community search ($0.00015/community), communities tweets ($0.00015/tweet), list followers ($0.00015/user), list members ($0.00015/user), list tweets ($0.00015/tweet), users batch ($0.00015/user), users search ($0.00015/user), user followers ($0.00015/user), followers you know ($0.00015/user), user following ($0.00015/user), user mentions ($0.00015/tweet), verified followers ($0.00015/user).
72
72
 
73
73
  ## Documentation
74
74
 
@@ -118,7 +118,7 @@ Requires an Xquik API key from [dashboard.xquik.com](https://dashboard.xquik.com
118
118
 
119
119
  ### MPP mode (no account, pay-per-use)
120
120
 
121
- MPP (Machine Payments Protocol) is an optional mode for anonymous, pay-per-use access to 31 read-only X-API endpoints - no Xquik account or API key required. The `tempoSigningKey` is a 66-character hex key that signs on-chain micropayment proofs (via the `mppx` SDK) when the runtime receives an HTTP 402 challenge. The signing key stays in the plugin config and is used only to sign payment proofs; it is not an API credential and grants no account access. If you don't use MPP, leave this field unset.
121
+ MPP (Machine Payments Protocol) is an optional mode for anonymous, pay-per-use access to 31 read-only X-API endpoints - no Xquik account or API key required. The `tempoSigningKey` is a 66-character hex key that signs on-chain micropayment proofs (via the `mppx` SDK) when the runtime receives an HTTP 402 challenge. The signing key stays in the plugin config and is used only to sign payment proofs; it is not an API credential and grants no account access. The user media endpoint is a timeline read, not media file download; media downloads require account-backed access and are not MPP-eligible. If you don't use MPP, leave this field unset.
122
122
 
123
123
  ```bash
124
124
  npm i mppx viem
@@ -311,7 +311,7 @@ Agent uses tweetclaw -> calls /api/v1/x/articles/:tweetId, returns title, body,
311
311
  | Composition | Compose, drafts, styles, radar | Free / Mixed |
312
312
  | Credits | Check balance | Free |
313
313
  | Extraction | 23 extraction tools, giveaway draws, exports | 1-5 credits/result |
314
- | Media | Upload media, download tweet media | 1-2 credits |
314
+ | Media | Upload media, authenticated tweet media download | 1-2 credits |
315
315
  | Monitoring | Create monitors, view events, webhooks | Free |
316
316
  | Twitter | Search, lookups, timelines, articles, trends, bookmarks, notifications | 1-5 credits |
317
317
  | X Accounts | List connected account handles for explicit user-selected actions | Free |