@xquik/tweetclaw 1.6.27 → 1.6.28

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.
Files changed (3) hide show
  1. package/README.md +38 -60
  2. package/openclaw.plugin.json +1 -1
  3. package/package.json +3 -51
package/README.md CHANGED
@@ -6,61 +6,23 @@
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
8
  [![Context7](https://img.shields.io/badge/Context7-agent_docs-059669)](https://context7.com/xquik-dev/tweetclaw)
9
+ [![Skills.sh](https://skills.sh/b/xquik-dev/tweetclaw)](https://skills.sh/xquik-dev/tweetclaw)
10
+ [![Skills.sh x-twitter-scraper Skill](https://skills.sh/b/xquik-dev/x-twitter-scraper)](https://skills.sh/xquik-dev/x-twitter-scraper)
9
11
  [![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)
10
12
  [![Smithery](https://smithery.ai/badge/xquik/x-twitter-scraper)](https://smithery.ai/servers/xquik/x-twitter-scraper)
13
+ <a href="https://nothumansearch.ai/site/xquik.com" target="_blank" rel="noopener"><img src="https://nothumansearch.ai/badge/xquik.com.svg" alt="NHS Agentic Readiness Score" height="28"></a>
11
14
  [![Apify Actor](https://apify.com/actor-badge?actor=xquik/x-tweet-scraper)](https://apify.com/xquik/x-tweet-scraper)
12
15
 
13
- Post tweets, reply, like, retweet, follow, DM & more - directly from your chat. Full X/Twitter automation for [OpenClaw](https://github.com/openclaw/openclaw).
16
+ Post tweets, reply, like, retweet, follow, DM & more - directly from your
17
+ chat. Full X/Twitter automation for [OpenClaw](https://github.com/openclaw/openclaw).
14
18
 
15
19
  Hermes Agent users should use [Hermes Tweet](https://github.com/Xquik-dev/hermes-tweet), the native Python plugin for the same Xquik API contract.
16
20
 
17
- Powered by [Xquik](https://xquik.com), the all-in-one X automation platform. **Post reads from $0.00015/call - about 33x cheaper than official X API post reads.**
18
-
19
- ## Pricing
20
-
21
- TweetClaw uses Xquik's credit-based pricing. 1 credit = $0.00015.
22
-
23
- ### vs Official X API
24
-
25
- | | Xquik (via TweetClaw) | Official X pay-per-usage | Notes |
26
- |---|---|---|---|
27
- | **Access model** | **$20/month full API, plus pay-per-use options** | No subscriptions or commitments | Basic and Pro are legacy package names |
28
- | **Cost per post read** | **$0.00015** | $0.005 per resource | Xquik is about 33x cheaper |
29
- | **Cost per user lookup** | **$0.00015** | $0.010 per resource | Xquik is about 67x cheaper |
30
- | **Cost per trend read** | **$0.00045** | $0.010 per resource | Xquik is about 22x cheaper |
31
- | **Write actions** | **$0.0015** | $0.015 content or interaction create; $0.200 content create with URL | Xquik is 10x cheaper for matching $0.015 write classes |
32
- | **Bulk extraction** | **$0.00015/result** | Charged per returned resource | Built-in extraction jobs are included with Xquik |
33
- | **Monitoring + webhooks** | **Free** | No direct monitor product in pricing table | Real-time delivery is included |
34
- | **Giveaway draws** | **$0.00015/entry** | No comparable draw product | Draw engine is included |
35
-
36
- Source: [official X API pricing](https://docs.x.com/x-api/getting-started/pricing), which lists current pay-per-usage read and write rates.
37
-
38
- ### Per-Operation Costs
39
-
40
- | Operation | Credits | Cost |
41
- |-----------|---------|------|
42
- | Read (tweet, search, timeline, bookmarks, etc.) | 1 | $0.00015 |
43
- | Read (user profile, verified followers, followers you know) | 1 | $0.00015 |
44
- | Read (favoriters) | 1 | $0.00015 |
45
- | Read (trends) | 3 | $0.00045 |
46
- | Follow check, article | 5 | $0.00075 |
47
- | Write (tweet, like, retweet, follow, DM, etc.) | 10 | $0.0015 |
48
- | Extraction (tweets, replies, quotes, mentions, posts, likes, media, search, favoriters, retweeters, community members, people search, list members, list followers) | 1/result | $0.00015/result |
49
- | Extraction (followers, following, verified followers) | 1/result | $0.00015/result |
50
- | Extraction (articles) | 5/result | $0.00075/result |
51
- | Draw | 1/entry | $0.00015/entry |
52
- | Monitors, webhooks, radar, compose, drafts | 0 | **Free** |
53
-
54
- ### Pay-Per-Use (No Subscription)
55
-
56
- Two options:
57
-
58
- - **Credits**: Top up credits in the Xquik dashboard. The plugin can read the current balance.
59
- - **MPP**: 31 read-only X-API endpoints accept anonymous on-chain payments via Machine Payments Protocol. No account needed. SDK: `npm i mppx viem`.
60
-
61
- ### Free Operations
62
-
63
- Tweet composition, style analysis, drafts, curated radar (7 sources), and account status checks are free.
21
+ Search tweets, search tweet replies, post tweets, post tweet replies, export
22
+ followers, look up users, upload media, download media, send direct messages,
23
+ monitor tweets, deliver webhooks, and run giveaway draws through structured
24
+ agent tools. Powered by [Xquik](https://xquik.com), the all-in-one X automation
25
+ platform.
64
26
 
65
27
  ## Install
66
28
 
@@ -72,8 +34,20 @@ OpenClaw resolves this package through [ClawHub](https://clawhub.ai/kriptoburak/
72
34
 
73
35
  TweetClaw can be installed before credentials are configured. Until you add an API key or MPP signing key, the free `explore` catalog remains available and live API calls return setup guidance instead of failing plugin installation.
74
36
 
37
+ Agent-skill installers can also discover TweetClaw through [Skills.sh](https://skills.sh/xquik-dev/tweetclaw). This installs the packaged `SKILL.md` for agents that use skills directories; use the OpenClaw command above for the plugin runtime.
38
+
39
+ ```bash
40
+ npx skills add xquik-dev/tweetclaw
41
+ ```
42
+
75
43
  > **Note:** `@xquik/tweetclaw` is the only official npm package. Any other scope (for example `@intentsolutionsio/tweetclaw`) is an unofficial redistribution and may ship stale metadata or outdated endpoint counts.
76
44
 
45
+ ## Pricing
46
+
47
+ TweetClaw uses Xquik billing for account-backed automation, credit top-ups, and
48
+ optional MPP pay-per-use reads. See [Billing & Pricing](https://docs.xquik.com/guides/billing)
49
+ for the current plans, eligible endpoints, and operation costs.
50
+
77
51
  ## Configure
78
52
 
79
53
  ### Option A: API key (account-backed X automation)
@@ -101,7 +75,11 @@ openclaw config set plugins.entries.tweetclaw.config.tempoSigningKey "$MPP_SIGNI
101
75
 
102
76
  **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.
103
77
 
104
- 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).
78
+ MPP-eligible read endpoints include tweet lookup, tweet search, user lookup,
79
+ user tweets, follower checks, articles, trends, quotes, replies, retweeters,
80
+ favoriters, threads, user likes, user media timeline reads, communities, lists,
81
+ users batch lookup, people search, followers, following, mentions, and verified
82
+ followers. See the billing guide for current endpoint eligibility and costs.
105
83
 
106
84
  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.
107
85
 
@@ -196,17 +174,17 @@ You: "Monitor @elonmusk for new tweets, replies, and retweets"
196
174
 
197
175
  99 agent-callable endpoints across 9 categories. Dashboard-only account-admin, billing, support, and raw credential flows are excluded from the tool catalog and blocked at runtime.
198
176
 
199
- | Category | Examples | Cost |
200
- |----------|---------|------|
201
- | **Account** | Account status | Free |
202
- | **Composition** | Compose, drafts, writing styles, radar | Free / Mixed |
203
- | **Credits** | Check balance | Free |
204
- | **Extraction** | 23 extraction tools, giveaway draws, exports | 1-5 credits/result |
205
- | **Media** | Upload media via URL, authenticated media download, gallery links | 1-2 credits |
206
- | **Monitoring** | Create monitors, view events, manage webhooks | Free |
207
- | **Twitter** | Search, lookups, timelines, articles, trends, bookmarks, notifications | 1-5 credits |
208
- | **X Accounts** | List connected account handles for explicit user-selected actions | Free |
209
- | **X Write** | Post, reply, like, retweet, follow, remove follower, DM, profile, communities | 10 credits |
177
+ | Category | Examples | Access |
178
+ |----------|---------|--------|
179
+ | **Account** | Account status | Account-backed |
180
+ | **Composition** | Compose, drafts, writing styles, radar | Account-backed |
181
+ | **Credits** | Check balance | Account-backed |
182
+ | **Extraction** | 23 extraction tools, giveaway draws, exports | Account-backed |
183
+ | **Media** | Upload media via URL, authenticated media download, gallery links | Account-backed |
184
+ | **Monitoring** | Create monitors, view events, manage webhooks | Account-backed |
185
+ | **Twitter** | Search, lookups, timelines, articles, trends, bookmarks, notifications | Account-backed or MPP where eligible |
186
+ | **X Accounts** | List connected account handles for explicit user-selected actions | Account-backed |
187
+ | **X Write** | Post, reply, like, retweet, follow, remove follower, DM, profile, communities | Account-backed with approval |
210
188
 
211
189
  Media download requires authenticated access and is not MPP-eligible. MPP only includes media-tweet timeline reads, not file download or gallery creation.
212
190
 
package/openclaw.plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "id": "tweetclaw",
3
3
  "name": "TweetClaw",
4
- "version": "1.6.27",
4
+ "version": "1.6.28",
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.27",
3
+ "version": "1.6.28",
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.27",
36
- "npmSpec": "@xquik/tweetclaw@1.6.27",
35
+ "clawhubSpec": "clawhub:@xquik/tweetclaw@1.6.28",
36
+ "npmSpec": "@xquik/tweetclaw@1.6.28",
37
37
  "minHostVersion": ">=2026.5.4"
38
38
  }
39
39
  },
@@ -68,23 +68,6 @@
68
68
  "openclaw",
69
69
  "mcp-server"
70
70
  ],
71
- "scripts": {
72
- "build": "tsc -p tsconfig.json",
73
- "typecheck": "tsc --noEmit",
74
- "lint": "eslint .",
75
- "test": "vitest run",
76
- "test:coverage": "vitest run --coverage",
77
- "knip": "knip --strict --include-libs --treat-config-hints-as-errors",
78
- "cpd": "jscpd .",
79
- "check-suppressions": "tsx check-suppressions.ts",
80
- "check-em-dash": "tsx check-em-dash.ts",
81
- "check-skill-frontmatter": "node scripts/check-skill-frontmatter.mjs",
82
- "check-versions": "node scripts/check-versions.mjs",
83
- "check-package-artifact": "node scripts/check-package-artifact.mjs",
84
- "prepack": "npm run build && npm run check-skill-frontmatter && npm run check-versions",
85
- "prepublishOnly": "npm run check-skill-frontmatter && npm run check-versions && npm run build && npm run check-package-artifact",
86
- "check:all": "npm run typecheck && npm run lint && npm run cpd && npm run knip && npm run check-suppressions && npm run check-em-dash && npm run check-skill-frontmatter && npm run check-versions && npm run build && npm run check-package-artifact && npm run test:coverage"
87
- },
88
71
  "peerDependencies": {
89
72
  "mppx": ">=0.1.0",
90
73
  "openclaw": ">=2026.5.4",
@@ -97,36 +80,5 @@
97
80
  "viem": {
98
81
  "optional": true
99
82
  }
100
- },
101
- "devDependencies": {
102
- "@eslint/js": "^10.0.1",
103
- "@sinclair/typebox": "^0.34.48",
104
- "@types/node": "^25.5.0",
105
- "@typescript-eslint/eslint-plugin": "^8.57.0",
106
- "@typescript-eslint/parser": "^8.57.0",
107
- "@vitest/coverage-v8": "^3.2.4",
108
- "@vitest/eslint-plugin": "^1.6.11",
109
- "eslint": "^10.0.3",
110
- "eslint-config-prettier": "^10.1.8",
111
- "eslint-import-resolver-typescript": "^4.4.4",
112
- "eslint-plugin-import-x": "^4.16.2",
113
- "eslint-plugin-n": "^17.24.0",
114
- "eslint-plugin-no-secrets": "^2.3.3",
115
- "eslint-plugin-promise": "^7.2.1",
116
- "eslint-plugin-regexp": "^3.1.0",
117
- "eslint-plugin-security": "^4.0.0",
118
- "eslint-plugin-sonarjs": "^4.0.2",
119
- "eslint-plugin-unicorn": "^63.0.0",
120
- "globals": "^17.4.0",
121
- "jscpd": "^4.0.8",
122
- "knip": "^5.86.0",
123
- "tsx": "^4.21.0",
124
- "typescript": "^5.8.0",
125
- "vitest": "^3.1.0"
126
- },
127
- "overrides": {
128
- "ip-address": "10.2.0",
129
- "vite": ">=7.3.2",
130
- "postcss": ">=8.5.10"
131
83
  }
132
84
  }