x-developer 2.6.3 → 2.6.5

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Xquik Skill for 128 REST operations and 120 MCP catalog routes. Two MCP tools support 119 JSON or text operations. Not affiliated with X Corp.",
-    "version": "2.6.3"
+    "version": "2.6.5"
   },
   "plugins": [
     {
       "name": "x-twitter-scraper",
       "source": "./",
       "description": "128 REST operations, 120 MCP catalog routes, 23 extraction types, SDKs, webhooks, exports, and confirmation-gated writes. Two MCP tools support 119 JSON or text operations. Not affiliated with X Corp.",
-      "version": "2.6.3",
+      "version": "2.6.5",
       "author": {
         "name": "Xquik"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "x-twitter-scraper",
-  "version": "2.6.3",
+  "version": "2.6.5",
   "description": "Xquik Skill and plugin bundle. Includes 128 REST operations. MCP has 120 catalog routes through 2 tools; 119 support JSON or text. Not affiliated with X Corp.",
   "author": {
     "name": "Xquik",
@@ -38,6 +38,8 @@
   "mcpServers": "./.mcp.json",
   "userConfig": {
     "api_key": {
+      "type": "string",
+      "title": "Xquik API key",
       "description": "Xquik API key (get one at dashboard.xquik.com/account)",
       "sensitive": true
     }

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "x-twitter-scraper",
-  "version": "2.6.3",
+  "version": "2.6.5",
   "description": "Xquik Skill and plugin bundle. Includes 128 REST operations. MCP has 120 catalog routes through 2 tools; 119 support JSON or text. Not affiliated with X Corp.",
   "author": {
     "name": "Xquik",

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable public changes appear in this file.
 
+## [2.6.5] - 2026-08-13
+
+### Fixed
+
+- Add Claude Code user configuration metadata for API key setup.
+
+## [2.6.4] - 2026-08-12
+
+- Align public Error docs with the 112-code OpenAPI contract.
+
 ## [2.6.3] - 2026-08-12
 
 ### Fixed
@@ -60,6 +70,8 @@ All notable public changes appear in this file.
 - Return follow relationships only from explicit relationship checks.
 - Refresh SkillSpector v2.3.7 evidence with 0 findings.
 
+[2.6.5]: https://github.com/Xquik-dev/x-twitter-scraper/releases/tag/v2.6.5
+[2.6.4]: https://github.com/Xquik-dev/x-twitter-scraper/releases/tag/v2.6.4
 [2.6.3]: https://github.com/Xquik-dev/x-twitter-scraper/releases/tag/v2.6.3
 [2.6.2]: https://github.com/Xquik-dev/x-twitter-scraper/releases/tag/v2.6.2
 [2.6.1]: https://github.com/Xquik-dev/x-twitter-scraper/releases/tag/v2.6.1

package/README.md

@@ -5,7 +5,6 @@
 
 [![Apify Actor](https://apify.com/actor-badge?actor=xquik/x-tweet-scraper)](https://apify.com/xquik/x-tweet-scraper)
 [![npm downloads](https://img.shields.io/npm/dt/x-developer?style=for-the-badge&logo=npm&label=downloads)](https://www.npmjs.com/package/x-developer)
-[![npm monthly downloads](https://img.shields.io/npm/dm/x-developer?style=for-the-badge&logo=npm&label=downloads%2Fmonth)](https://www.npmjs.com/package/x-developer)
 [![npm version](https://img.shields.io/npm/v/x-developer?style=for-the-badge&logo=npm&label=npm)](https://www.npmjs.com/package/x-developer)
 
 [![CI](https://github.com/Xquik-dev/x-twitter-scraper/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/Xquik-dev/x-twitter-scraper/actions/workflows/ci.yml)
@@ -30,11 +29,9 @@
 
 [Xquik](https://docs.xquik.com) provides 128 REST API operations for structured X data and approved account automation. It includes search, profiles, followers, media, communities, trends, monitors, webhooks, exports, MCP, and SDKs.
 
-This repository packages Xquik as an [AI agent Skill](https://skills.sh). It works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf, and compatible agents. It routes tasks to REST, MCP, SDKs, webhooks, extractions, or exports.
-
 The npm package `x-developer` contains this Skill and plugin bundle. The separate `x-twitter-scraper` package is the TypeScript SDK.
 
-The `x-developer` bundle is v2.6.3. Hosted MCP v2.6.0 exposes 120 catalog
+The `x-developer` bundle is v2.6.4. Hosted MCP v2.6.0 exposes 120 catalog
 routes through 2 tools.
 Of these, 119 support JSON or text. Binary support downloads use REST. Add
 `https://xquik.com/mcp`. Current clients negotiate MCP `2026-07-28` through
@@ -70,13 +67,6 @@ Compare alternatives with the same query, filters, fields, and row count. Use
 - [Xquik pricing, filters, and access](skills/x-twitter-scraper/references/best-x-api-alternative.md)
 - [Twitter scraper API selection and safety](skills/x-twitter-scraper/references/twitter-scraper-api-guide.md)
 
-## Usage Control, Rate Limits, and High-Volume Workflows
-
-Use bounded jobs, cursor pagination, and exports for larger workloads. Per
-account, reads allow 300 requests per second, writes allow 120 per minute, and
-deletes allow 60 per minute. Use extraction estimates before bulk work. Prefer
-monitors and HMAC webhooks over repeated polling.
-
 ## Agent Safety And Account Boundary: Xquik X Account Rules
 
 - Agents use only `XQUIK_API_KEY`. They never need X passwords, 2FA codes,

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "x-developer",
   "name": "X Developer API",
   "description": "Xquik Skill with 128 REST operations and 120 MCP catalog routes. Two MCP tools support 119 JSON or text operations. Includes SDKs, webhooks, exports, and gated actions. Not affiliated with X Corp.",
-  "version": "2.6.3",
+  "version": "2.6.5",
   "skills": ["./skills"],
   "providerAuthEnvVars": {
     "xquik": ["XQUIK_API_KEY"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x-developer",
-  "version": "2.6.3",
+  "version": "2.6.5",
   "description": "Xquik agent skill & plugin bundle for REST, MCP, webhooks, exports & confirmation-gated X workflows. Not affiliated with X Corp.",
   "author": {
     "name": "Xquik",

package/scripts/release-guard/content-policy.mjs

@@ -57,7 +57,7 @@ export const contentChecks = [
   {
     path: "CHANGELOG.md",
     required: [
-      "## [2.6.3] - 2026-08-12",
+      "## [2.6.4] - 2026-08-12",
       "## [2.6.2] - 2026-08-11",
       "## [2.6.0] - 2026-07-30",
       "## [2.6.1] - 2026-08-03",

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

@@ -3,13 +3,13 @@ name: x-twitter-scraper
 description: "Use Xquik for X/Twitter REST, MCP, SDKs, search, filtered exports, monitoring & approved publishing. Not affiliated with X Corp. Trigger for X API alternatives, pricing comparisons, tweet search, user lookup, timelines, follower exports, media, webhooks, bulk extraction, giveaways, or MCP setup. Read-only by default. Require explicit approval for writes, private reads, monitors, webhooks & metered bulk jobs."
 allowed-tools: WebFetch
 argument-hint: "[Xquik task, target, or setup goal]"
-version: "2.6.3"
+version: "2.6.5"
 author: Xquik <support@xquik.com>
 license: MIT
 compatibility: Requires internet access to call the first-party Xquik REST API.
 tags: [twitter, x, social-media, api-development, scraping]
 metadata:
-  version: "2.6.3"
+  version: "2.6.5"
   author: Xquik
   compatibility: Requires internet access to call the first-party Xquik REST API.
   tags: [twitter, x, social-media, api-development, scraping]

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

@@ -1,5 +1,5 @@
 {
-  "version": "2.6.3",
+  "version": "2.6.5",
   "organization": "Xquik",
   "homepage": "https://docs.xquik.com",
   "repository": "https://github.com/Xquik-dev/x-twitter-scraper",

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

@@ -2,8 +2,9 @@
 
 Default v1 responses put a legacy string code in `error`. Send
 `xquik-api-contract: 2026-04-29` to receive an object with `message`, `type`,
-and `code`. The current OpenAPI schema enumerates all 109 codes. This table
-highlights common codes.
+and `code`. OpenAPI enumerates 112 codes, including `closed`, `expired`,
+`missing_url`, and `user_not_found`. This table highlights common codes.
+`closed` and `expired` map to 410. `missing_url` maps to 502.
 
 | Status | Code | Meaning |
 |--------|------|---------|

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

@@ -11,7 +11,7 @@ API keys.
 | Endpoint | `https://xquik.com/mcp` |
 | Authentication | OAuth 2.1 discovery; API key fallback |
 | Hosted MCP version | `2.6.0` |
-| Skill bundle version | `2.6.3` |
+| Skill bundle version | `2.6.4` |
 
 Current clients negotiate MCP `2026-07-28` through `server/discover`.
 Use a current MCP SDK. It adds request `_meta` and protocol headers.

package/skills/x-twitter-scraper/references/types-error.md

@@ -1,8 +1,6 @@
 # Xquik TypeScript Types: Error
 
 ```typescript
-type ApiErrorCode = string;
-
 type ApiErrorType =
   | "api_error"
   | "authentication_error"
@@ -14,8 +12,8 @@ type ApiErrorType =
 
 interface ApiError {
   error:
-    | ApiErrorCode
-    | { message: string; type: ApiErrorType; code: ApiErrorCode };
+    | string
+    | { message: string; type: ApiErrorType; code: string };
   message?: string;
   reason?: string;
   retryAfter?: number;
@@ -23,9 +21,9 @@ interface ApiError {
 }
 ```
 
-OpenAPI enumerates all 109 `ApiErrorCode` values, including
-`user_not_found`. Generated SDKs expose that exhaustive enum. The handwritten
-type remains a string for forward compatibility.
+OpenAPI enumerates 112 codes, including `closed`, `expired`, `missing_url`, and
+`user_not_found`. Generated SDKs use that enum. This reference keeps strings
+forward-compatible.
 
 Default v1 errors use the string form. Send
 `xquik-api-contract: 2026-04-29` to receive the structured form.

package/skills/x-twitter-scraper/skill-card.md

@@ -69,7 +69,7 @@ Other properties: The skill performs no shell execution, no local file access, n
 
 ## Skill Version
 
-2.6.3
+2.6.4
 
 ## Ethical Considerations
 

package/stub-server.mjs

@@ -12,7 +12,7 @@ import { pathToFileURL } from "node:url";
 
 const SERVER_INFO = {
   name: "xquik",
-  version: "2.6.3",
+  version: "2.6.5",
 };
 
 const CAPABILITIES = {

package/task-guides/check-mutuals.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/clean-followers.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/export-tweets-csv.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/extract-followers.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/find-bangers.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/find-influencers.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/find-viral-tweets.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/follow-unfollow.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/for-you-feed.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/going-viral.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/grow-followers.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/monitor-accounts.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/optimize-tweets.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/post-tweets.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/run-giveaway.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/search-tweets.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/send-dms.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/top-replies.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/track-competitors.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/track-hashtags.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/track-mentions.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/trending-news.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/tweet-analytics.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/tweet-ideas.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/tweet-replies.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/tweet-style.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/tweet-webhooks.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/update-x-profile.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/user-tweets.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/who-liked.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/who-quoted.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/who-retweeted.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/write-threads.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/write-tweets.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/x-articles.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/x-bookmarks.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/x-communities.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/x-lists.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/x-spaces.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env:

package/task-guides/x-trends.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.6.3"
+  version: "2.6.5"
   openclaw:
     requires:
       env: