x-developer 2.6.5 → 2.6.7

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

@@ -1,33 +1,33 @@
-# Xquik REST API Endpoints: Compose
+# Xquik REST API endpoints: compose
 
-### Compose Tweet
+### Compose tweet
 
 ```
 POST /compose
 ```
 
-Compose, refine, and score tweets with Xquik style signals. Three-step workflow.
+Compose, refine, and score tweets with Xquik style signals. Run each step separately.
 
-**Body:**
+Send this body:
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
 | `step` | string | Yes | `compose`, `refine`, or `score` |
-| `topic` | string | No | Tweet topic (compose, refine) |
+| `topic` | string | No | Tweet topic for compose or refine |
 | `goal` | string | No | `engagement`, `followers`, `authority`, `conversation` |
-| `styleUsername` | string | No | Cached style username for voice matching (compose) |
-| `tone` | string | No | Desired tone (refine) |
-| `additionalContext` | string | No | Extra context or URLs (refine) |
-| `callToAction` | string | No | Desired CTA (refine) |
-| `mediaType` | string | No | `photo`, `video`, `none` (refine) |
-| `draft` | string | No | Tweet text to evaluate (score) |
-| `hasLink` | boolean | No | Link attached (score) |
-| `hasMedia` | boolean | No | Media attached (score) |
+| `styleUsername` | string | No | Cached style username for compose |
+| `tone` | string | No | Desired tone for refine |
+| `additionalContext` | string | No | Extra context or URLs for refine |
+| `callToAction` | string | No | Desired call to action for refine |
+| `mediaType` | string | No | `photo`, `video`, or `none` for refine |
+| `draft` | string | No | Tweet text to evaluate for score |
+| `hasLink` | boolean | No | Whether score evaluates a link |
+| `hasMedia` | boolean | No | Whether score evaluates media |
 
-**Response (step=compose):** Returns `contentRules`, `scorerWeights`, `followUpQuestions`, `algorithmInsights`, `engagementMultipliers`, `topPenalties`.
+For `step=compose`, the API returns `contentRules`, `scorerWeights`, `followUpQuestions`, `algorithmInsights`, `engagementMultipliers`, and `topPenalties`.
 
-**Response (step=refine):** Returns `compositionGuidance`, `examplePatterns`.
+For `step=refine`, the API returns `compositionGuidance` and `examplePatterns`.
 
-**Response (step=score):** Returns `totalChecks`, `passedCount`, `topSuggestion`, `checklist[]` with `factor`, `passed`, `suggestion`.
+For `step=score`, the API returns `totalChecks`, `passedCount`, `topSuggestion`, and `checklist[]`. Each checklist item contains `factor`, `passed`, and `suggestion`.
 
 ---

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

@@ -1,11 +1,11 @@
-# Xquik REST API Endpoints: Credits
+# Xquik REST API endpoints: credits
 
-### Get Credit Balance
+### Get credit balance
 
 ```
 GET /credits
 ```
 
-Get credit balance and lifetime usage fields. Plan and credit changes are dashboard-only and intentionally omitted from this installable skill.
+Get the credit balance and lifetime usage fields. Plan and credit changes are dashboard-only. This installable Skill omits those routes.
 
 ---

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

@@ -1,31 +1,31 @@
-# Xquik REST API Endpoints: Drafts
+# Xquik REST API endpoints: drafts
 
-## Safety Boundary
+## Require approval for drafts
 
 `GET` operations expose private saved content. State the exact draft scope and
-obtain explicit approval immediately before each read. `POST` and delete
+obtain explicit approval immediately before each read. `POST` and `DELETE`
 operations are non-default writes. Show the exact draft text or draft ID and
 obtain explicit approval immediately before each write. Never infer approval
 from an earlier request or retry a failed write automatically.
 
-### Create Draft
+### Create draft
 
 `POST /drafts`
 
 Save a tweet draft for later.
 
-**Approval required:** Preview the complete text and metadata. Create the draft
+Get approval first. Preview the complete text and metadata. Create the draft
 only after the user explicitly approves that exact payload.
 
-**Request body:**
+Send this request body:
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
 | `text` | string | Yes | The draft tweet text |
 | `topic` | string | No | Topic the tweet is about |
-| `goal` | string | No | Optimization goal: `engagement`, `followers`, `authority`, `conversation` |
+| `goal` | string | No | `engagement`, `followers`, `authority`, or `conversation` |
 
-**Response (201):**
+For a 201 response, the API returns:
 
 ```json
 {
@@ -40,23 +40,23 @@ only after the user explicitly approves that exact payload.
 
 ---
 
-### List Drafts
+### List drafts
 
 `GET /drafts`
 
 List saved tweet drafts with cursor pagination.
 
-**Private read:** Show the requested page size and account scope. List drafts
+This is a private read. Show the requested page size and account scope. List drafts
 only after explicit approval for that exact read.
 
-**Query parameters:**
+Use these query parameters:
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
-| `limit` | number | No | 50 | Results per page (max 50) |
+| `limit` | number | No | 50 | Results per page; maximum 50 |
 | `afterCursor` | string | No | - | Pagination cursor from previous response |
 
-**Response (200):**
+For a 200 response, the API returns:
 
 ```json
 {
@@ -77,29 +77,29 @@ only after explicit approval for that exact read.
 
 ---
 
-### Get Draft
+### Get draft
 
 `GET /drafts/{id}`
 
 Get a specific draft by ID.
 
-**Private read:** Show the draft ID. Fetch it only after explicit approval for
+This is a private read. Show the draft ID. Fetch it only after explicit approval for
 that exact read, including any preview before deletion.
 
-**Response (200):** Single draft object.
+For a 200 response, the API returns 1 draft object.
 
-**Errors:** `400 invalid_id`, `404 draft_not_found`
+Possible errors include `400 invalid_id` and `404 draft_not_found`.
 
 ---
 
-### Delete Draft
+### Delete draft
 
-delete request to `/drafts/{id}`
+Send a delete request to `/drafts/{id}`.
 
-**Destructive action:** Deletion is permanent and cannot be recovered through
+This action is destructive. Deletion is permanent and cannot be recovered through
 this API. Show the draft ID and text, then obtain explicit approval immediately
 before deleting it. Returns `204 No Content`.
 
-**Errors:** `400 invalid_id`, `404 draft_not_found`
+Possible errors include `400 invalid_id` and `404 draft_not_found`.
 
 ---

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

@@ -1,6 +1,6 @@
-# Xquik REST API Endpoints: Draws
+# Xquik REST API endpoints: draws
 
-## Safety Boundary
+## Protect giveaway participant data
 
 Draw creation and participant exports are metered or privacy-sensitive actions.
 Confirm the source tweet, eligibility rules, requested data type, export
@@ -10,20 +10,20 @@ secondary use.
 Draw history and results are account-scoped private reads. Require exact-scope
 approval before listing draws or retrieving winners.
 
-### Create Draw
+### Create draw
 
 ```
 POST /draws
 ```
 
-Run a giveaway draw from a tweet. Picks random winners from replies.
+Run a giveaway draw from a tweet. The draw selects random winners from replies.
 
-**Approval required:** Show the source tweet, winner count, backup count,
+Get approval first. Show the source tweet, winner count, backup count,
 filters, and estimated usage. Also show the lawful purpose, participant-data
 handling, export audience, and retention plan. Record every field before
 persisting participant data.
 
-**Body:**
+Send this body:
 ```json
 {
   "tweetUrl": "https://x.com/user/status/1893456789012345678",
@@ -43,13 +43,13 @@ persisting participant data.
 
 All filter fields are optional. Only `tweetUrl` is required.
 
-**Response:**
+The API returns:
 ```json
 {
   "id": "42",
   "tweetId": "1893456789012345678",
   "tweetUrl": "https://x.com/user/status/1893456789012345678",
-  "tweetText": "Like & RT to enter! Picking 3 winners tomorrow.",
+  "tweetText": "Like and repost to enter. We will select 3 winners tomorrow.",
   "tweetAuthorUsername": "xquik",
   "tweetLikeCount": 4200,
   "tweetRetweetCount": 1800,
@@ -63,7 +63,7 @@ All filter fields are optional. Only `tweetUrl` is required.
 }
 ```
 
-### List Draws
+### List draws
 
 ```
 GET /draws
@@ -71,10 +71,10 @@ GET /draws
 
 Cursor-paginated. Returns compact draw objects.
 
-**Private read:** Show the exact account, requested page scope, and returned
+This is a private read. Show the exact account, requested page scope, and returned
 field scope. List draws only after explicit approval for that exact read.
 
-### Get Draw
+### Get draw
 
 ```
 GET /draws/{id}
@@ -82,18 +82,18 @@ GET /draws/{id}
 
 Returns full draw details including winners.
 
-**Private read:** Show the exact account, draw ID, and returned-data scope.
+This is a private read. Show the exact account, draw ID, and returned-data scope.
 Retrieve details only after explicit approval for that exact read.
 
-### Export Draw
+### Export draw
 
 ```
 GET /draws/{id}/export?format=csv&type=winners
 ```
 
-Formats: `csv`, `json`, `md`, `md-document`, `pdf`, `txt`, `xlsx`. Types: `winners` (default), `entries`. Entry exports capped at 100,000 rows (PDF capped at 10,000).
+Choose `csv`, `json`, `md`, `md-document`, `pdf`, `txt`, or `xlsx`. Choose `winners` or `entries`; the default is `winners`. Entry exports support 100,000 rows, except PDF supports 10,000.
 
-**Approval required:** Full entry exports can contain participant identity and
+Get approval first. Full entry exports can contain participant identity and
 activity data. Show the lawful purpose, exact draw, type, format, audience, and
 retention period. Export only after explicit approval for that exact request.
 Prefer winners-only output. Do not retain data beyond the approved purpose.

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

@@ -1,4 +1,4 @@
-# Xquik REST API Endpoints: Error Codes
+# Xquik REST API endpoints: error codes
 
 Default v1 responses put a legacy string code in `error`. Send
 `xquik-api-contract: 2026-04-29` to receive an object with `message`, `type`,
@@ -21,14 +21,14 @@ and `code`. OpenAPI enumerates 112 codes, including `closed`, `expired`,
 | 400 | `missing_query` | Required query parameter is missing |
 | 400 | `missing_params` | Required query parameters are missing |
 | 400 | `no_media` | Tweet has no downloadable media |
-| 400 | `webhook_inactive` | Webhook is disabled (test-webhook only) |
+| 400 | `webhook_inactive` | Webhook is disabled; applies only to webhook tests |
 | 401 | `unauthenticated` | Missing or invalid API key |
 | 403 | `account_needs_reauth` | X account session expired; use dashboard re-auth flow |
 | 402 | `no_subscription` | No active plan |
 | 402 | `subscription_inactive` | Plan is not active |
 | 402 | `no_credits` | No credit balance record exists |
 | 402 | `insufficient_credits` | Credit balance is too low |
-| 403 | `api_key_limit_reached` | API key limit reached (100 max) |
+| 403 | `api_key_limit_reached` | API key limit reached; maximum 100 |
 | 404 | `not_found` | Resource does not exist |
 | 404 | `user_not_found` | X user not found |
 | 404 | `tweet_not_found` | Tweet not found |
@@ -44,7 +44,7 @@ and `code`. OpenAPI enumerates 112 codes, including `closed`, `expired`,
 | 502 | `x_api_unavailable` | X data source temporarily unavailable |
 | 502 | `x_api_unauthorized` | X data source authentication failed. Retry |
 
-## Cursor Recovery Examples
+## Cursor recovery examples
 
 `409 coverage_cursor_unavailable` requires an integer `Retry-After` response
 header. Wait that many seconds, then retry the same cursor once.

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

@@ -1,22 +1,22 @@
-# Xquik REST API Endpoints: Events
+# Xquik REST API endpoints: events
 
-### List Events
+### List events
 
 ```
 GET /events
 ```
 
-**Query parameters:**
+Use these query parameters:
 
-| Param | Type | Description |
+| Parameter | Type | Description |
 |-------|------|-------------|
 | `monitorId` | string | Filter by monitor ID |
 | `keywordMonitorId` | string | Filter by keyword monitor ID |
 | `eventType` | string | Filter by event type |
-| `limit` | number | Results per page (1-100, default 50) |
+| `limit` | number | Results per page from 1-100; defaults to 50 |
 | `cursor` | string | Previous `nextCursor` |
 
-**Response:**
+The API returns:
 ```json
 {
   "events": [
@@ -39,12 +39,12 @@ GET /events
 }
 ```
 
-### Get Event
+### Get event
 
 ```
 GET /events/{id}
 ```
 
-Returns a single event with full details.
+Returns 1 event.
 
 ---

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

@@ -1,6 +1,6 @@
-# Xquik REST API Endpoints: Extractions
+# Xquik REST API endpoints: extractions
 
-## Safety Boundary
+## Protect extracted data
 
 Extraction creation and export can collect and disclose large datasets. First
 confirm the lawful purpose, exact target, `resultsLimit`, recipients, and
@@ -10,19 +10,19 @@ surveillance, discrimination, harassment, doxxing, or unrelated secondary use.
 Extraction history and results are account-scoped private reads. Require
 exact-scope approval before listing jobs or retrieving results.
 
-### Create Extraction
+### Create extraction
 
 ```
 POST /extractions
 ```
 
-Run a bulk data extraction job. See `references/extractions.md` for all 23 tool types.
+Run a bulk data extraction job. See `references/extractions.md` for all 23 tools.
 
-**Approval required:** Call the estimate endpoint with the same body first.
+Get approval first. Call the estimate endpoint with the same body first.
 Create the job only when the estimate returns `allowed: true`. Then require
 approval for the target, bound, usage, and data-handling plan.
 
-**Body:**
+Send this body:
 ```json
 {
   "toolType": "reply_extractor",
@@ -34,11 +34,12 @@ approval for the target, bound, usage, and data-handling plan.
 The API accepts an omitted `resultsLimit`. This Skill must always send an
 explicit finite positive bound. The bound stops early and limits usage.
 
-The request also accepts current Tweet, profile, collection, and reply filters.
-See [Extraction Tools](extractions.md) and the OpenAPI schema. Send the same
-filters to estimate and create.
+The request accepts single or batch targets, mixed targets, relation targets,
+deduplication controls, output metadata, and current result filters. See
+[Extraction Tools](extractions.md) and the OpenAPI schema. Send the same body
+to estimate and create.
 
-**Response:**
+The API returns:
 ```json
 {
   "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
@@ -47,7 +48,7 @@ filters to estimate and create.
 }
 ```
 
-### Estimate Extraction
+### Estimate extraction
 
 ```
 POST /extractions/estimate
@@ -55,7 +56,7 @@ POST /extractions/estimate
 
 Preview usage before running. Same body as create.
 
-**Response:**
+The API returns:
 ```json
 {
   "allowed": true,
@@ -66,7 +67,7 @@ Preview usage before running. Same body as create.
 }
 ```
 
-### List Extractions
+### List extractions
 
 ```
 GET /extractions
@@ -75,38 +76,38 @@ GET /extractions
 Cursor-paginated. Use `limit`, `cursor`, `status`, and `toolType`. Pass each
 `nextCursor` unchanged while `hasMore` is true.
 
-**Private read:** Show the exact account, purpose, requested filters, and page
-scope. Also show downstream recipients and the retention plan. List jobs only
+This is a private read. Show the exact account, purpose, requested filters, and page
+scope. Also show recipients and the retention plan. List jobs only
 after explicit approval for that exact read.
 
-### Get Extraction
+### Get extraction
 
 ```
 GET /extractions/{id}
 ```
 
-Returns job details with paginated results (up to 1,000 per page).
+Returns job details with up to 1,000 results per page.
 Use `limit` and `cursor`. Optional result-shaping parameters are `outputMode`,
 `outputPreset`, and `fieldStyle`. `includeRaw` is deprecated.
 
-**Private read:** Show the exact account, job ID, purpose, and page scope. Also
-show downstream recipients and the retention plan. Retrieve results only after
+This is a private read. Show the exact account, job ID, purpose, and page scope. Also
+show recipients and the retention plan. Retrieve results only after
 explicit approval for that exact read.
 
-### Export Extraction
+### Export extraction
 
 ```
 GET /extractions/{id}/export?format=csv
 ```
 
-Formats: `csv`, `json`, `md`, `md-document`, `pdf`, `txt`, and `xlsx`.
+Choose `csv`, `json`, `md`, `md-document`, `pdf`, `txt`, or `xlsx`.
 Exports can include enrichment columns not present in paginated API results.
 
 Use documented row filters for follower, following, post, engagement, profile,
 media, language, search, and date fields. The endpoint does not project fields.
 
-**Approval required:** Show the job, filters, format, row count, schema,
-recipients, storage, and retention. Materialize or transmit the export only
+Get approval first. Show the job, filters, format, row count, schema,
+recipients, storage, and retention. Create or send the export only
 after explicit approval.
 
 ---

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

@@ -1,6 +1,6 @@
-# Xquik REST API Endpoints: Monitors
+# Xquik REST API endpoints: monitors
 
-## Safety Boundary
+## Require approval for monitors
 
 Monitor reads expose private configuration and require exact-scope approval.
 Creating, updating, enabling, disabling, or deleting a monitor changes a
@@ -10,17 +10,17 @@ plan, ongoing usage, and disable path. If delivery uses a webhook, show its
 exact URL and HMAC verification plan. Proceed only after explicit approval for
 that exact action. Never create monitoring from an ambiguous request.
 
-### Create Monitor
+### Create monitor
 
 ```http
 POST /monitors
 ```
 
-**Approval required:** This starts persistent monitoring. Confirm the exact
+Get approval first. This starts persistent monitoring. Confirm the exact
 username, event types, delivery plan, ongoing usage, and disable path first.
 Include the exact URL and HMAC verification plan for webhook delivery.
 
-**Body:**
+Send this body:
 ```json
 {
   "username": "elonmusk",
@@ -28,7 +28,7 @@ Include the exact URL and HMAC verification plan for webhook delivery.
 }
 ```
 
-**Response:**
+The API returns:
 ```json
 {
   "id": "7",
@@ -41,63 +41,63 @@ Include the exact URL and HMAC verification plan for webhook delivery.
 }
 ```
 
-Event types include Tweet activity and profile-change events. Use the OpenAPI
+Event types include tweet activity and profile-change events. Use the OpenAPI
 `EventType` enum for the current values. `webhook.test` is only a test payload.
 
 Returns `409 monitor_already_exists` if the username is already monitored.
 
-### List Monitors
+### List monitors
 
 ```
 GET /monitors
 ```
 
-Returns all monitors (up to 200, no pagination). Response includes `monitors` array and `total` count.
+Returns up to 200 monitors without pagination. The response includes `monitors` and `total`.
 
-**Private read:** List monitor targets and delivery configuration only after
+This is a private read. List monitor targets and delivery configuration only after
 explicit approval for that account scope.
 
-### Get Monitor
+### Get monitor
 
 ```http
 GET /monitors/{id}
 ```
 
-**Private read:** Show the monitor ID. Retrieve its configuration only after
+This is a private read. Show the monitor ID. Retrieve its configuration only after
 explicit approval for that exact read.
 
-### Update Monitor
+### Update monitor
 
 ```http
 PATCH /monitors/{id}
 ```
 
-**Approval required:** Show the current and proposed event types and active
+Get approval first. Show the current and proposed event types and active
 state. Apply only the explicitly approved change.
 
-**Body:** `{ "eventTypes": [...], "isActive": true|false }` (both optional)
+Send `{ "eventTypes": [...], "isActive": true|false }`. Both fields are optional.
 
-### Delete Monitor
+### Delete monitor
 
 ```
-delete request to `/monitors/{id}`
+DELETE /monitors/{id}
 ```
 
-**Destructive action:** This permanently stops tracking and deletes associated
+This action is destructive. This permanently stops tracking and deletes associated
 monitor data. Show the monitor ID, target, and lost data. Delete only after
 explicit approval immediately before the call.
 
-### Keyword Monitors
+### Keyword monitors
 
 ```
 GET /monitors/keywords
 POST /monitors/keywords
 GET /monitors/keywords/{id}
 PATCH /monitors/keywords/{id}
-delete request to `/monitors/keywords/{id}`
+DELETE /monitors/keywords/{id}
 ```
 
-Create and manage ongoing keyword monitors. Treat these as persistent resources: confirm the keyword query, event delivery plan, and ongoing usage before creating or enabling one.
+Create and manage ongoing keyword monitors. They are persistent resources. Confirm the query, event delivery, and ongoing usage before creating or enabling one.
 
 Create with `{ "query": "#buildinpublic", "eventTypes": ["tweet.new"] }`.
 Poll its events with `GET /events?keywordMonitorId=<id>`.

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

@@ -1,6 +1,6 @@
-# Xquik REST API Endpoints: Radar
+# Xquik REST API endpoints: radar
 
-### List Radar Items
+### List radar items
 
 ```
 GET /radar
@@ -8,25 +8,25 @@ GET /radar
 
 Get trending topics and news from supported trend and news sources.
 
-**Query parameters:**
+Use these query parameters:
 
-| Param | Type | Description |
+| Parameter | Type | Description |
 |-------|------|-------------|
 | `after` | string | Previous `nextCursor` |
-| `source` | string | Filter by `github`, `google_trends`, `hacker_news`, `polymarket`, `reddit`, `trustmrr`, or `wikipedia` |
-| `category` | string | Filter by category: `general`, `tech`, `dev`, `science`, `culture`, `politics`, `business`, `entertainment` |
-| `limit` | number | Items per page (1-100, default 50) |
-| `hours` | number | Look-back window in hours (1-72, default 6) |
-| `region` | string | Region code: `US`, `GB`, `TR`, `ES`, `DE`, `FR`, `JP`, `IN`, `BR`, `CA`, `MX`, `global` (default) |
+| `source` | string | `github`, `google_trends`, `hacker_news`, `polymarket`, `reddit`, `trustmrr`, or `wikipedia` |
+| `category` | string | `general`, `tech`, `dev`, `science`, `culture`, `politics`, `business`, or `entertainment` |
+| `limit` | number | Items per page from 1-100; defaults to 50 |
+| `hours` | number | Look-back window from 1-72 hours; defaults to 6 |
+| `region` | string | `US`, `GB`, `TR`, `ES`, `DE`, `FR`, `JP`, `IN`, `BR`, `CA`, `MX`, or `global`; defaults to `global` |
 
-**Response:**
+The API returns:
 ```json
 {
   "items": [
     {
       "id": "12345",
-      "title": "Claude 4.6 Released",
-      "description": "Anthropic releases Claude 4.6...",
+      "title": "Claude 4.6 released",
+      "description": "Anthropic releases Claude 4.6.",
       "url": "https://example.com/article",
       "imageUrl": "https://example.com/image.png",
       "source": "hacker_news",
@@ -45,6 +45,6 @@ Get trending topics and news from supported trend and news sources.
 }
 ```
 
-Fields: `id`, `title`, `description?`, `url?`, `imageUrl?`, `source`, `sourceId`, `category`, `region`, `language`, `score`, `metadata`, `publishedAt`, `createdAt`. Response includes `hasMore` and `nextCursor` for pagination.
+Each item contains `id`, `title`, `source`, `sourceId`, `category`, `region`, `language`, `score`, `metadata`, `publishedAt`, and `createdAt`. It may include `description`, `url`, and `imageUrl`. The response also returns `hasMore` and `nextCursor`.
 
 ---