x-developer 2.4.7 → 2.4.8

package/README.md

@@ -8,7 +8,7 @@
 [![x-twitter-scraper 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)
 [![smithery badge](https://smithery.ai/badge/xquik/x-twitter-scraper)](https://smithery.ai/servers/xquik/x-twitter-scraper)
 
-An [AI agent skill](https://skills.sh) that gives coding agents deep knowledge of the [Xquik](https://xquik.com) X (Twitter) real-time data platform. 112 REST API endpoints, 2 MCP tools, HMAC webhooks, 23 bulk extraction tools, and write actions.
+An [AI agent skill](https://skills.sh) that gives coding agents deep knowledge of the [Xquik](https://xquik.com) X (Twitter) real-time data platform. 113 REST API endpoints, 2 MCP tools, HMAC webhooks, 23 bulk extraction tools, and write actions.
 
 **The cheapest X data API on the market** - post reads from $0.00015/call (about 33x cheaper than official X API post reads).
 
@@ -42,7 +42,7 @@ Source: [official X API pricing](https://docs.x.com/x-api/getting-started/pricin
 | Read (user profile, verified followers, followers you know) | 1 | $0.00015 |
 | Read (favoriters) | 1 | $0.00015 |
 | Read (trends) | 3 | $0.00045 |
-| Follow check, article | 7 | $0.00105 |
+| Follow check, article | 5 | $0.00075 |
 | Write (tweet, like, retweet, follow, DM, etc.) | 10 | $0.0015 |
 | Extraction (tweets, replies, quotes, mentions, posts, likes, media, search, favoriters, retweeters, community members, people search, list members, list followers) | 1/result | $0.00015/result |
 | Extraction (followers, following, verified followers) | 1/result | $0.00015/result |
@@ -54,7 +54,7 @@ Source: [official X API pricing](https://docs.x.com/x-api/getting-started/pricin
 
 Two options for pay-per-use without a monthly subscription:
 
-- **Credits**: Top up credits via `POST /credits/topup` ($10 minimum). 1 credit = $0.00015. Works with all 112 endpoints.
+- **Credits**: Top up credits via `POST /credits/topup` ($10 minimum). 1 credit = $0.00015. Works with all 113 endpoints.
 - **MPP**: 32 X-API endpoints accept anonymous on-chain payments via Machine Payments Protocol. No account needed. SDK: `npm i mppx viem`.
 
 ## Installation
@@ -156,14 +156,14 @@ When installed, this skill gives your AI coding assistant deep knowledge of the
 - **Tweet composition**: Algorithm-optimized tweet composer with scoring (free)
 - **Credits & billing**: Check balance, top up credits, manage subscription
 - **Support tickets**: Open and manage support tickets via API
-- **MCP server**: 2 tools covering 112 endpoints for AI agent integration
+- **MCP server**: 2 tools covering 113 endpoints for AI agent integration
 - **Pay-per-use (MPP)**: Anonymous access to 32 endpoints via on-chain payments, no account needed
 
 ## Capabilities
 
 | Area | Details |
 |------|---------|
-| **REST API** | 112 endpoints across 10 categories with retry logic and pagination |
+| **REST API** | 113 endpoints across 10 categories with retry logic and pagination |
 | **MCP Server** | 2 tools (explore + xquik). StreamableHTTP, configs for 10 platforms |
 | **Data Extraction** | 23 bulk extraction tools (replies, retweets, quotes, favoriters, threads, articles, user likes, user media, communities, lists, Spaces, people search, tweet search, mentions, posts) |
 | **X Lookups** | Tweet, user, article, search, user tweets, user likes, user media, favoriters, mutual followers, bookmarks, notifications, timeline, DM history |

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "x-developer",
   "name": "X Developer API",
-  "description": "X (Twitter) data platform skill for AI coding agents. 112 REST API endpoints, 2 MCP tools, 23 extraction types, HMAC webhooks.",
-  "version": "2.4.7",
+  "description": "X (Twitter) data platform skill for AI coding agents. 113 REST API endpoints, 2 MCP tools, 23 extraction types, HMAC webhooks.",
+  "version": "2.4.8",
   "skills": ["./skills"],
   "providerAuthEnvVars": {
     "xquik": ["XQUIK_API_KEY"]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "x-developer",
-  "version": "2.4.7",
-  "description": "X (Twitter) data platform skill for AI coding agents. 112 REST API endpoints, 2 MCP tools, 23 extraction types, HMAC webhooks.",
+  "version": "2.4.8",
+  "description": "X (Twitter) data platform skill for AI coding agents. 113 REST API endpoints, 2 MCP tools, 23 extraction types, HMAC webhooks.",
   "author": {
     "name": "Xquik",
     "url": "https://xquik.com"
@@ -10,7 +10,7 @@
   "homepage": "https://xquik.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Xquik-dev/x-twitter-scraper"
+    "url": "git+https://github.com/Xquik-dev/x-twitter-scraper.git"
   },
   "keywords": [
     "twitter",

package/skills/post-tweets/SKILL.md

@@ -102,4 +102,4 @@ This skill assumes an account is already connected. New connections are performe
 
 ## Related
 
-For the full 112-endpoint reference including reads, analytics, extraction, and monitoring, see [x-twitter-scraper](../x-twitter-scraper/SKILL.md) in the same repo.
+For the full 113-endpoint reference including reads, analytics, extraction, and monitoring, see [x-twitter-scraper](../x-twitter-scraper/SKILL.md) in the same repo.

package/skills/tweet-analytics/SKILL.md

@@ -114,7 +114,7 @@ Returns rolling per-tweet metrics for that account.
 
 ## Cost control
 
-Metrics endpoints are Read tier (1-7 credits per call). Bulk `favoriters` can list thousands of accounts at per-result pricing - always estimate first and show the user the expected cost.
+Metrics endpoints are Read tier (1-5 credits per call). Bulk `favoriters` can list thousands of accounts at per-result pricing - always estimate first and show the user the expected cost.
 
 ## Errors
 

package/skills/x-twitter-scraper/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: x-twitter-scraper
-description: "Use when the user needs to interact with X (Twitter) - searching tweets, looking up users/followers, posting tweets/replies, liking, retweeting, following/unfollowing, removing followers, sending DMs, downloading media, monitoring accounts in real time, or extracting bulk data. Provides 112 REST API endpoints, 2 MCP tools, and HMAC webhooks. The skill authenticates only with a Xquik API key (xq_...) and NEVER asks for, transmits, stores, or logs any X account login material - X account connection is done by the user in the Xquik dashboard. Use even if the user says 'Twitter' instead of 'X', or asks about social media automation, tweet analytics, or follower analysis."
+description: "Use when the user needs to interact with X (Twitter) - searching tweets, looking up users/followers, posting tweets/replies, liking, retweeting, following/unfollowing, removing followers, sending DMs, downloading media, monitoring accounts in real time, or extracting bulk data. Provides 113 REST API endpoints, 2 MCP tools, and HMAC webhooks. The skill authenticates only with a Xquik API key (xq_...) and NEVER asks for, transmits, stores, or logs any X account login material - X account connection is done by the user in the Xquik dashboard. Use even if the user says 'Twitter' instead of 'X', or asks about social media automation, tweet analytics, or follower analysis."
 compatibility: Requires internet access to call the Xquik REST API (https://xquik.com/api/v1)
 license: MIT
 metadata:
   author: Xquik
-  version: "2.4.7"
+  version: "2.4.8"
   openclaw:
     requires:
       env:
@@ -120,7 +120,7 @@ When this skill and the docs disagree on **endpoint parameters, rate limits, or
 | **Auth** | `x-api-key: xq_...` header (64 hex chars after `xq_` prefix) |
 | **MCP endpoint** | `https://xquik.com/mcp` (StreamableHTTP, same API key) |
 | **Rate limits** | Read: 120/60s, Write: 30/60s, Delete: 15/60s (fixed window per method tier) |
-| **Endpoints** | 112 across 10 categories |
+| **Endpoints** | 113 across 10 categories |
 | **MCP tools** | 2 (explore + xquik) |
 | **Extraction tools** | 23 types |
 | **Pricing** | $20/month base (reads from $0.00015). Pay-per-use also available |
@@ -129,7 +129,7 @@ When this skill and the docs disagree on **endpoint parameters, rate limits, or
 
 ## Pricing Summary
 
-$20/month base plan. 1 credit = $0.00015. Read operations: 1-7 credits. Write operations: 10 credits. Extractions: 1-5 credits/result. Draws: 1 credit/participant. Monitors, webhooks, radar, compose, drafts, and support are free. Pay-per-use credit top-ups also available.
+$20/month base plan. 1 credit = $0.00015. Read operations: 1-5 credits. Write operations: 10 credits. Extractions: 1-5 credits/result. Draws: 1 credit/participant. Monitors, webhooks, radar, compose, drafts, and support are free. Pay-per-use credit top-ups also available.
 
 For full pricing breakdown, comparison vs official X API, and pay-per-use details, see [references/pricing.md](references/pricing.md).
 
@@ -281,7 +281,7 @@ If building a webhook handler, read [references/webhooks.md](references/webhooks
 | Tool | Description | Cost |
 |------|-------------|------|
 | `explore` | Search the API endpoint catalog (read-only) | Free |
-| `xquik` | Send structured API requests (112 endpoints, 10 categories) | Varies |
+| `xquik` | Send structured API requests (113 endpoints, 10 categories) | Varies |
 
 ### First-Party Trust Model
 
@@ -293,7 +293,7 @@ The MCP server at `xquik.com/mcp` is a **first-party service** operated by Xquik
 - **API key injection**: The server injects the user's API key into outbound requests automatically - the agent does not need to include the API key in individual tool call parameters.
 - **No persistent state**: Each tool invocation is stateless. No data persists between calls.
 - **Scoped access**: The `xquik` tool can only call Xquik REST API endpoints. It cannot access the agent's filesystem, environment variables, network, or other tools.
-- **Fixed endpoint set**: The server accepts only the 112 pre-defined REST API endpoints. It rejects any request that does not match a known route. There is no mechanism to call arbitrary URLs or inject custom endpoints.
+- **Fixed endpoint set**: The server accepts only the 113 pre-defined REST API endpoints. It rejects any request that does not match a known route. There is no mechanism to call arbitrary URLs or inject custom endpoints.
 
 If configuring the MCP server in an IDE or agent platform, read [references/mcp-setup.md](references/mcp-setup.md). If calling MCP tools, read [references/mcp-tools.md](references/mcp-tools.md) for selection rules and common mistakes.
 

package/skills/x-twitter-scraper/metadata.json

@@ -1,8 +1,8 @@
 {
-  "version": "2.4.7",
+  "version": "2.4.8",
   "organization": "Xquik",
   "date": "April 2026",
-  "abstract": "Integration guide for the Xquik X (Twitter) real-time data platform. Covers the REST API (112 endpoints across tweet search, user lookup, user tweets/likes/media, favoriters, mutual followers, bookmarks, notifications, timeline, DM history, media download, extractions, monitors, events, webhooks, trends, radar, compose, style analysis, drafts, draws, X account management, write actions, credits, and support tickets), HMAC webhook verification, MCP server setup for 10 IDEs and AI agents (2 structured API tools: explore + xquik), all 23 extraction tools, tweet composition with algorithm scoring, credit-based billing, pay-per-use via MPP, and complete TypeScript type definitions. Code examples in JavaScript, Python, Go, and cURL.",
+  "abstract": "Integration guide for the Xquik X (Twitter) real-time data platform. Covers the REST API (113 endpoints across tweet search, user lookup, user tweets/likes/media, favoriters, mutual followers, bookmarks, notifications, timeline, DM history, media download, extractions, monitors, events, webhooks, trends, radar, compose, style analysis, drafts, draws, X account management, write actions, credits, and support tickets), HMAC webhook verification, MCP server setup for 10 IDEs and AI agents (2 structured API tools: explore + xquik), all 23 extraction tools, tweet composition with algorithm scoring, credit-based billing, pay-per-use via MPP, and complete TypeScript type definitions. Code examples in JavaScript, Python, Go, and cURL.",
   "references": [
     "https://docs.xquik.com",
     "https://docs.xquik.com/api-reference/overview",

package/skills/x-twitter-scraper/references/api-endpoints.md

@@ -1281,6 +1281,14 @@ POST /credits/topup
 
 Get a checkout URL to purchase credits ($10 minimum). Free.
 
+### Get Top-Up Status
+
+```
+GET /credits/topup/status
+```
+
+Poll a checkout session after starting a credit top-up. Query: `session_id`. Free.
+
 ---
 
 ## Support

package/skills/x-twitter-scraper/references/mcp-setup.md

@@ -182,7 +182,7 @@ The MCP server (v2) at `https://xquik.com/mcp` provides 2 structured API tools:
 | `explore` | Search the API endpoint catalog (read-only, no network calls) | Free |
 | `xquik` | Execute API calls against your account | Varies by endpoint |
 
-The agent sends structured API requests through the MCP server, which handles authentication and execution within the same first-party infrastructure as the REST API. All 112 REST API endpoints across 10 categories are accessible: account, composition, credits, extraction, media, monitoring, support, twitter, x-accounts, and x-write.
+The agent sends structured API requests through the MCP server, which handles authentication and execution within the same first-party infrastructure as the REST API. All 113 REST API endpoints across 10 categories are accessible: account, composition, credits, extraction, media, monitoring, support, twitter, x-accounts, and x-write.
 
 ## After Setup
 

package/skills/x-twitter-scraper/references/pricing.md

@@ -39,7 +39,7 @@ Xquik is the most affordable X data API available. All metered operations deduct
 |-----------|------|
 | Trends | per call |
 
-### Read operations - 7 credits ($0.00105)
+### Read operations - 5 credits ($0.00075)
 
 | Operation | Unit |
 |-----------|------|
@@ -83,7 +83,7 @@ Source: [official X API pricing](https://docs.x.com/x-api/getting-started/pricin
 
 Two options without a monthly subscription:
 
-**Credits**: Top up credits via `POST /credits/topup` ($10 minimum). 1 credit = $0.00015. Works with all 112 endpoints.
+**Credits**: Top up credits via `POST /credits/topup` ($10 minimum). 1 credit = $0.00015. Works with all 113 endpoints.
 
 **MPP**: 32 X-API endpoints accept anonymous on-chain payments. No account needed.