x-developer 2.7.0 → 2.7.1

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

@@ -6,7 +6,7 @@ numeric strings.
 
 ## Request example
 
-Send reads through the Python `get_json` helper from [Retries](#retries):
+Send reads through the Python `get_json` helper from [Retries](#retries).
 
 ```python
 page = get_json(
@@ -24,35 +24,35 @@ page = get_json(
 | `GET /x/tweets?ids=` | Up to 100 comma-separated tweet IDs |
 | `GET /x/tweets/{id}/replies` | `pageSize` (1 to 300), `sort` (`relevance`, `latest`, `oldest`, `likes`), `excludeOriginalAuthor`, `includeOriginalPost`, `hasMediaOnly`, `scope`, `cursor` |
 | `GET /x/tweets/{id}/quotes` | `pageSize` (1 to 300), `sinceTime`, `untilTime`, `includeReplies`, `cursor` |
-| `GET /x/tweets/{id}/thread` | Visible posts in the conversation thread, from any author: `pageSize` (1 to 100), `cursor` |
+| `GET /x/tweets/{id}/thread` | Visible posts in the conversation thread, from any author. Takes `pageSize` (1 to 100), `cursor` |
 | `GET /x/tweets/{id}/retweeters` | `pageSize` (1 to 200), profile filters, `cursor` |
 | `GET /x/tweets/{id}/favoriters` | `pageSize` (1 to 200), profile filters, `cursor` |
 | `GET /x/articles/{tweetId}` | Full X Article content |
-| `GET /x/tweets/top` | X's top tweets: `metric` (`likes` default, `replies`, `quotes`, `bookmarks`, `shares`, `views`), `window` (`day` default, `week`, `month`), `country` or `language`, `pageSize` (1 to 100), `cursor`. The list ends at 100 |
-| `GET /x/tweets/{id}/hidden-replies` | Replies the author hid, oldest first: `pageSize` (1 to 100), tweet filters, `cursor` |
-| `GET /x/tweets/{id}/retweeter-ids` | Reposter user IDs only: `pageSize` (1 to 200), `cursor` |
-| `GET /x/tweets/{id}/retweeters/check` | `user` (required): ID, username, or profile URL. Returns `isRetweeted`, `retweetedAt`, and `complete` |
+| `GET /x/tweets/top` | X's top tweets. Takes `metric` (`likes` default, `replies`, `quotes`, `bookmarks`, `shares`, `views`), `window` (`day` default, `week`, `month`), `country` or `language`, `pageSize` (1 to 100), `cursor`. The list ends at 100 |
+| `GET /x/tweets/{id}/hidden-replies` | Replies the author hid, oldest first. Takes `pageSize` (1 to 100), tweet filters, `cursor` |
+| `GET /x/tweets/{id}/retweeter-ids` | Reposter user IDs only. Takes `pageSize` (1 to 200), `cursor` |
+| `GET /x/tweets/{id}/retweeters/check` | `user` (required) takes an ID, username, or profile URL. Returns `isRetweeted`, `retweetedAt`, and `complete` |
 | `GET /x/tweets/{id}/insights` | Engagements per hour, per view, and per follower of the author |
 | `GET /x/tweets/{id}/translation` | `language` (required), such as `en` or `pt-br`. Returns X's own translation |
-| `GET /x/tweets/{id}/subtitles` | Caption tracks of the tweet's videos: language, timed cues, and full text |
-| `GET /x/tweets/{id}/embed` | Embed HTML: `theme` (`light` or `dark`), `hideMedia`, `hideThread`, `omitScript` |
+| `GET /x/tweets/{id}/subtitles` | Caption tracks of the tweet's videos, with language, timed cues, and full text |
+| `GET /x/tweets/{id}/embed` | Embed HTML. Takes `theme` (`light` or `dark`), `hideMedia`, `hideThread`, `omitScript` |
 
 Search, replies, quotes, thread, and user timelines accept the same tweet
-filters as named query parameters. Send only the ones the user asked for:
+filters as named query parameters. Send only the ones the user asked for.
 
-- Authors and targets: `fromUser`, `toUser`, `mentioning`, `verifiedOnly`,
+- Authors and targets use `fromUser`, `toUser`, `mentioning`, `verifiedOnly`,
   `blueVerifiedOnly`
-- Text: `exactPhrase`, `anyWords`, `excludeWords`, `hashtags`, `cashtags`, `url`
-- Time: `sinceDate` and `untilDate` (`YYYY-MM-DD`), `sinceTime` (ISO,
+- Text uses `exactPhrase`, `anyWords`, `excludeWords`, `hashtags`, `cashtags`, `url`
+- Time uses `sinceDate` and `untilDate` (`YYYY-MM-DD`), `sinceTime` (ISO,
   inclusive) and `untilTime` (ISO, exclusive, so end 2023 with
   `2024-01-01T00:00:00Z`), `withinTime` (such as `7d`)
-- Language: `language` (such as `en`)
-- Media: `mediaType` (`images`, `videos`, `gifs`, `media`, `links`, `none`)
-- Engagement: `minLikes`, `minRetweets`, `minReplies`, `minQuotes`,
+- Language uses `language` (such as `en`)
+- Media uses `mediaType` (`images`, `videos`, `gifs`, `media`, `links`, `none`)
+- Engagement uses `minLikes`, `minRetweets`, `minReplies`, `minQuotes`,
   `minViews`, `minBookmarks`, `maxFaves`, `maxRetweets`, `maxReplies`
-- Post types: `replies`, `retweets`, `quotes`, each `include`, `exclude`, or `only`
-- Conversation: `conversationId`, `inReplyToTweetId`, `quotesOfTweetId`
-- Raw operators: `advancedQuery` for a known X search operator string, on search only
+- Post types use `replies`, `retweets`, `quotes`, each `include`, `exclude`, or `only`
+- Conversation uses `conversationId`, `inReplyToTweetId`, `quotesOfTweetId`
+- Raw operators use `advancedQuery` for a known X search operator string, on search only
 
 Tweet responses hold `tweets`, `has_next_page`, and `next_cursor`. Each tweet
 has `id`, `text`, `createdAt`, `lang`, `likeCount`, `retweetCount`,
@@ -67,24 +67,24 @@ username or numeric ID.
 
 | Route | Key parameters |
 | --- | --- |
-| `GET /x/users/{id}` | Profile: `followers`, `following`, `description` (bio), `verified`, `isVerified`, `isBlueVerified`, `verifiedType`, `statusesCount`, `location`, `createdAt` |
+| `GET /x/users/{id}` | Profile with `followers`, `following`, `description` (bio), `verified`, `isVerified`, `isBlueVerified`, `verifiedType`, `statusesCount`, `location`, `createdAt` |
 | `GET /x/users/search` | `q` (required), `pageSize` (1 to 100), profile filters, `cursor` |
 | `GET /x/users/batch` | `ids` (comma-separated user IDs), profile filters |
 | `GET /x/users/{id}/tweets` | `pageSize` (1 to 300, default 20), `sinceTime`, `untilTime`, `includeReplies` (default `false`), tweet filters, `cursor` |
-| `GET /x/users/{id}/replies` | With Replies timeline: `pageSize` (1 to 300), `sinceTime`, `untilTime`, tweet filters, `cursor` |
+| `GET /x/users/{id}/replies` | With Replies timeline. Takes `pageSize` (1 to 300), `sinceTime`, `untilTime`, tweet filters, `cursor` |
 | `GET /x/users/{id}/media` | `pageSize` (1 to 100), tweet filters, `cursor` |
 | `GET /x/users/{id}/mentions` | `pageSize` (1 to 100), `sinceTime`, `untilTime`, tweet filters, `cursor` |
 | `GET /x/users/{id}/likes` | `pageSize` (1 to 100), tweet filters, `cursor`. Needs a connected X account for the owner's likes |
-| `GET /x/users/batch/tweets` | Newest posts of up to 20 users: `ids` or `usernames` (comma-separated, send 1 of the 2), `pageSize` (1 to 20) |
-| `GET /x/users/{id}/articles` | Posts on the Articles tab, newest first: `pageSize` (1 to 100), tweet filters, `cursor`. Read the full text with `GET /x/articles/{tweetId}` |
-| `GET /x/users/{id}/highlights` | Posts on the Highlights tab: `pageSize` (1 to 100), tweet filters, `cursor` |
+| `GET /x/users/batch/tweets` | Newest posts of up to 20 users. Takes `ids` or `usernames` (comma-separated, send 1 of the 2), `pageSize` (1 to 20) |
+| `GET /x/users/{id}/articles` | Posts on the Articles tab, newest first. Takes `pageSize` (1 to 100), tweet filters, `cursor`. Read the full text with `GET /x/articles/{tweetId}` |
+| `GET /x/users/{id}/highlights` | Posts on the Highlights tab. Takes `pageSize` (1 to 100), tweet filters, `cursor` |
 | `GET /x/users/{id}/insights` | Engagement rate, averages per post, and posting rate, from the last 20 posts |
 | `GET /x/users/{id}/translation` | `language` (required). Returns X's own translation of the bio |
 | `GET /x/users/{id}/live` | Whether the user broadcasts live video now, with the latest broadcast |
-| `GET /x/users/{id}/lists` | Public Lists the user created: `pageSize` (1 to 100), `cursor` |
-| `GET /x/users/{id}/list-memberships` | Public Lists that include the user: `pageSize` (1 to 100), `cursor` |
+| `GET /x/users/{id}/lists` | Public Lists the user created. Takes `pageSize` (1 to 100), `cursor` |
+| `GET /x/users/{id}/list-memberships` | Public Lists that include the user. Takes `pageSize` (1 to 100), `cursor` |
 
-Verification: `isBlueVerified` means X shows the blue badge. `isVerified` and
+For verification, `isBlueVerified` means X shows the blue badge. `isVerified` and
 `verified` mean X marks the profile as verified. `verifiedType` names the kind,
 such as `Business`. Report only the values the response returns.
 
@@ -96,13 +96,13 @@ such as `Business`. Report only the values the response returns.
 | `GET /x/users/{id}/following` | Same as followers |
 | `GET /x/users/{id}/verified-followers` | Same as followers |
 | `GET /x/followers/check` | `source` and `target` usernames. Returns `isFollowing` and `isFollowedBy` |
-| `GET /x/users/{id}/follower-ids` | Follower user IDs only, newest first: `pageSize` (1 to 5,000), `cursor` |
-| `GET /x/users/{id}/following-ids` | User IDs of the accounts the user follows: `pageSize` (1 to 5,000), `cursor` |
-| `GET /x/users/{id}/similar` | Accounts X lists as similar: `pageSize` (1 to 200), profile filters, `cursor` |
-| `GET /x/users/{id}/affiliates` | Accounts an organization lists as affiliates: `pageSize` (1 to 200), profile filters, `cursor` |
-| `GET /x/users/{id}/subscriptions` | Creators the user subscribes to: `pageSize` (1 to 200), profile filters, `cursor` |
+| `GET /x/users/{id}/follower-ids` | Follower user IDs only, newest first. Takes `pageSize` (1 to 5,000), `cursor` |
+| `GET /x/users/{id}/following-ids` | User IDs of the accounts the user follows. Takes `pageSize` (1 to 5,000), `cursor` |
+| `GET /x/users/{id}/similar` | Accounts X lists as similar. Takes `pageSize` (1 to 200), profile filters, `cursor` |
+| `GET /x/users/{id}/affiliates` | Accounts an organization lists as affiliates. Takes `pageSize` (1 to 200), profile filters, `cursor` |
+| `GET /x/users/{id}/subscriptions` | Creators the user subscribes to. Takes `pageSize` (1 to 200), profile filters, `cursor` |
 
-Profile filters, applied before billing: `minFollowers`, `maxFollowers`,
+Profile filters, applied before billing, are `minFollowers`, `maxFollowers`,
 `minFollowing`, `maxFollowing`, `minStatuses`, `maxStatuses`,
 `minAccountAgeDays`, `verifiedOnly`, `hasWebsite`, `hasLocation`,
 `bioContains` (any comma-separated term, ignoring case), `locationContains`,
@@ -114,24 +114,24 @@ extraction for a complete follower list.
 
 | Route | Notes |
 | --- | --- |
-| `GET /x/lists/search` | Find public Lists: `q` (required), `pageSize` (1 to 100), `cursor` |
+| `GET /x/lists/search` | Find public Lists with `q` (required), `pageSize` (1 to 100), `cursor` |
 | `GET /x/lists/{id}` | Name, description, counts, and owner. Takes a List ID or a URL-encoded List URL |
 | `GET /x/lists/{id}/members`, `/followers`, `/tweets` | List ID |
-| `GET /x/communities/find` | Find communities by keyword: `q` (required), `pageSize` (1 to 100), `cursor` |
-| `GET /x/communities/topics` | Topics and subtopics X groups communities under: `limit` |
-| `GET /x/communities/popular` | Top communities of a topic: `topicId` or `topic`, `pageSize` (1 to 100), `cursor` |
-| `GET /x/communities/suggested` | Communities X suggests to join: `limit` |
+| `GET /x/communities/find` | Find communities by keyword with `q` (required), `pageSize` (1 to 100), `cursor` |
+| `GET /x/communities/topics` | Topics and subtopics X groups communities under. Takes `limit` |
+| `GET /x/communities/popular` | Top communities of a topic. Takes `topicId` or `topic`, `pageSize` (1 to 100), `cursor` |
+| `GET /x/communities/suggested` | Communities X suggests to join. Takes `limit` |
 | `GET /x/communities/{id}/info`, `/members`, `/moderators`, `/tweets` | Community ID |
-| `GET /x/communities/{id}/media` | Posts with photos or videos on the Media tab, newest first: `pageSize` (1 to 100), tweet filters, `cursor` |
-| `GET /x/communities/{id}/members/search` | Find members by name or username: `q` (required) |
+| `GET /x/communities/{id}/media` | Posts with photos or videos on the Media tab, newest first. Takes `pageSize` (1 to 100), tweet filters, `cursor` |
+| `GET /x/communities/{id}/members/search` | Find members by name or username with `q` (required) |
 | `GET /x/communities/search` | Search posts inside a community |
-| `GET /x/communities/tweets` | Search posts in 1 community with `communityId`, or in every community without it: `q` (required), `queryType`, `pageSize` (1 to 100), tweet filters, `cursor` |
+| `GET /x/communities/tweets` | Search posts in 1 community with `communityId`, or in every community without it. Takes `q` (required), `queryType`, `pageSize` (1 to 100), tweet filters, `cursor` |
 
 ## Spaces, broadcasts, and jobs
 
 | Route | Notes |
 | --- | --- |
-| `GET /x/spaces/search` | `q` (required): words, hashtags, or operators such as `from:solana`. `queryType`, `pageSize` (1 to 100), `cursor` |
+| `GET /x/spaces/search` | `q` (required) takes words, hashtags, or operators such as `from:solana`. `queryType`, `pageSize` (1 to 100), `cursor` |
 | `GET /x/spaces/{id}` | Title, state, times, audience, host, and speakers. Takes a Space ID or a URL-encoded Space URL |
 | `GET /x/spaces/{id}/replay` | HLS playback URL of an ended Space. A live or scheduled Space answers `409` |
 | `GET /x/broadcasts/{id}` | Title, state, times, watch counts, and host of a live video broadcast |
@@ -146,15 +146,16 @@ Use the `space_explorer` extraction for a Space's participants.
 | Route | Notes |
 | --- | --- |
 | `GET /x/trends` | Pick the place by `woeid` (default 1, worldwide), `country`, or `location`. `count` (1 to 50, default 30) |
-| `GET /x/trends/locations` | Places X offers trends for: `country`, `placeType`, `q`, `limit`. Pass a location's `woeid` to `/x/trends` |
-| `GET /radar` | Trending topics from curated sources: `category`, `region`, `hours`, `limit` |
-| `GET /x/search/autocomplete` | Suggestions for a partial query: `q` (required), `types` (comma-separated `users`, `topics`, `hashtags`, `cashtags`), `limit` (1 to 100, default 20) |
+| `GET /x/trends/locations` | Places X offers trends for. Takes `country`, `placeType`, `q`, `limit`. Pass a location's `woeid` to `/x/trends` |
+| `GET /radar` | Trending topics from curated sources. Takes `category`, `region`, `hours`, `limit` |
+| `GET /x/search/autocomplete` | Suggestions for a partial query. Takes `q` (required), `types` (comma-separated `users`, `topics`, `hashtags`, `cashtags`), `limit` (1 to 100, default 20) |
 | `GET /x/places/search` | `q` (required), `limit`. Pass a place `id` as `place` to tweet search |
-| `GET /x/hashflags` | Custom emoji X shows after hashtags: `q`, `activeOnly` (default `true`), `limit` |
-| `GET /x/links/resolve` | `urls` (required): 1 to 100 `https://t.co/` links, comma-separated. Returns each `resolvedUrl` |
+| `GET /x/hashflags` | Custom emoji X shows after hashtags. Takes `q`, `activeOnly` (default `true`), `limit` |
+| `GET /x/links/resolve` | `urls` (required) takes 1 to 100 `https://t.co/` links, comma-separated. Returns each `resolvedUrl` |
 
 A trends request bills 1 credit, however many trends it returns. `woeid` wins
-when a request also names a `country` or `location`. Common WOEIDs:
+when a request also names a `country` or `location`. The table lists common
+WOEIDs.
 
 | Region | WOEID | Region | WOEID |
 | --- | --- | --- | --- |
@@ -200,16 +201,16 @@ JSON body with `POST`. Each analyzed post bills 2 credits, read included.
 | `POST /x/analysis/viral-score` | 8 wording traits, `viralScore` from 0 to 100 & `viralVerdict` |
 | `POST /x/analysis/classify` | 1 to 8 questions you write in `analysis.questions` |
 
-Send exactly 1 source:
+Send exactly 1 source.
 
-- `tweetIds`: up to 100 post IDs or URLs.
-- `texts`: up to 100 texts of the user's, such as drafts. Nothing is read
+- `tweetIds` takes up to 100 post IDs or URLs.
+- `texts` takes up to 100 texts of the user's, such as drafts. Nothing is read
   from X.
-- A search: `query`, `username`, `listId`, `quotesOf`, or `repliesTo`, alone
-  or together, with `sinceTime`, `untilTime`, `queryType`, `limit` (1 to 100,
-  default 20), and `cursor`.
+- A search takes `query`, `username`, `listId`, `quotesOf`, or `repliesTo`,
+  alone or together, with `sinceTime`, `untilTime`, `queryType`, `limit` (1 to
+  100, default 20), and `cursor`.
 
-`analysis` is optional: `targets` (names with `aliases`), `context`,
+`analysis` is optional. It takes `targets` (names with `aliases`), `context`,
 `questions`, or a `preset`. Question IDs and category names are lower case
 with underscores.
 
@@ -236,9 +237,9 @@ They do not verify claims or give investment advice.
 
 ## Private reads
 
-These need a connected X account:
+These need a connected X account.
 
-- `GET /x/dm/{userId}/history?account=<connected handle>`: `userId` is the
+- In `GET /x/dm/{userId}/history?account=<connected handle>`, `userId` is the
   other person's numeric ID. Resolve it with `GET /x/users/{username}`. It
   bills 1 credit per returned message and has no page size, so the last page
   can go past a message target. Give the cost per message, not a hard cap.
@@ -250,16 +251,16 @@ These need a connected X account:
 
 - Follow `next_cursor` while `has_next_page` is true. Stop at the user's bound.
   Never build or decode a cursor.
-- `409 coverage_cursor_unavailable`: wait the exact `Retry-After` seconds,
+- On `409 coverage_cursor_unavailable`, wait the exact `Retry-After` seconds,
   then retry the same cursor. The helper below does this.
-- `410 coverage_cursor_gone` or `400 invalid_coverage_cursor`: restart once
+- On `410 coverage_cursor_gone` or `400 invalid_coverage_cursor`, restart once
   without a cursor and deduplicate by ID. The paging loop below catches
   `XquikError` from the helper and restarts with the remaining budget.
 - Generated paging code keeps one result budget across the entire run. Count
   every returned row before deduplication, including refetched rows after a
   restart. Lower later page sizes to the remaining budget. Persist IDs
   already appended across cron runs. An empty page can still have a cursor.
-- `429`, `5xx`, and failed connections: retry as [Retries](#retries) shows.
+- On `429`, `5xx`, and failed connections, retry as [Retries](#retries) shows.
 
 ## Retries
 
@@ -378,7 +379,7 @@ def get_json(path, params=None, budget_s=300):
 A paging loop on that helper. It restarts once on a gone or invalid cursor.
 It counts every returned tweet toward the user's number, refetched ones
 included, so the bill never passes that cap. Load `seen_ids` from earlier
-output, and make `append_row` save each row before it returns:
+output, and make `append_row` save each row before it returns.
 
 ```python
 def append_search_tweets(q, cap, seen_ids, append_row):

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

@@ -6,8 +6,9 @@ account ID. `GET /x/accounts` lists connected accounts.
 
 ## Preview, confirm, send
 
-- Resolve every field before a preview: account, target ID, exact text,
-  media & reply target. Ask for a missing one instead of guessing.
+- Resolve every field before a preview. That means the account, target ID,
+  exact text, media & reply target. Ask for a missing one instead of
+  guessing.
 - The preview shows the method, full URL, headers, JSON body, cost & effect.
   An effect reads like "a new post appears on @my_brand for its followers".
 - A text post or reply costs 30 credits, plus 2 per started MB of media.
@@ -27,14 +28,15 @@ account ID. `GET /x/accounts` lists connected accounts.
 Every write returns an action record with `status`, `terminal`,
 `safeToRetry`, `statusUrl`, and `pollAfterMs`.
 
-- `200`: the action is terminal. Check `status`, because `failed` and
+- `200` means the action is terminal. Check `status`, because `failed` and
   `expired` are terminal too. A new post's ID is in `tweetId` and `result.id`.
-- `202`: accepted. Poll `statusUrl`, which is `GET /x/write-actions/{id}`,
-  every `pollAfterMs` until `terminal` is true. `statusUrl` is a path that
-  already starts with `/api/v1`, so prefix only `https://xquik.com`.
-- Timeout or lost response: do not send a new request, because the first one
-  may have gone through. Retry the identical request with the same
-  `Idempotency-Key`; Xquik returns the original action instead of acting
+- `202` means the action is accepted. Poll `statusUrl`, which is
+  `GET /x/write-actions/{id}`, every `pollAfterMs` until `terminal` is true.
+  `statusUrl` is a path that already starts with `/api/v1`, so prefix only
+  `https://xquik.com`.
+- After a timeout or lost response, do not send a new request, because the
+  first one may have gone through. Retry the identical request with the same
+  `Idempotency-Key`, and Xquik returns the original action instead of acting
   twice. Or poll the action if you have its `statusUrl`.
 - Start a new attempt with a new key only when a terminal record has
   `safeToRetry: true`, and only after the user agrees.
@@ -95,8 +97,8 @@ an `Idempotency-Key`.
 }
 ```
 
-Other fields: `backupCount`, `mustRetweet`, `mustFollowUsername`, `filterAccountAgeDays`,
-`filterLanguage`, `requiredHashtags`, `requiredKeywords`, `requiredMentions`.
+Other fields are `backupCount`, `mustRetweet`, `mustFollowUsername`, `filterAccountAgeDays`,
+`filterLanguage`, `requiredHashtags`, `requiredKeywords`, and `requiredMentions`.
 Read the result with `GET /draws/{id}` and export it with
 `GET /draws/{id}/export?format=csv`.
 

package/skills/xquik-mcp/SKILL.md

@@ -30,8 +30,8 @@ license: MIT
 | Tool | Input | Output | Cost |
 | --- | --- | --- | --- |
 | `docs` | `query`, up to 500 characters | Matching public documentation | Free |
-| `search` | `code`: an async arrow function over `spec.paths` | The paths, methods & contract fields it returns | Free, no network call |
-| `execute` | `code`: an async arrow function that calls `xquik.request({ path, method, query, body })` | `{ success, status, result, errors, messages }` per request | The called route's price |
+| `search` | `code`, an async arrow function over `spec.paths` | The paths, methods & contract fields it returns | Free, no network call |
+| `execute` | `code`, an async arrow function that calls `xquik.request({ path, method, query, body })` | `{ success, status, result, errors, messages }` per request | The called route's price |
 
 - `path` works with or without `/api/v1`.
 - `execute` adds authentication & an `Idempotency-Key` to writes. It retries

package/skills/xquik-mcp/references/mcp-setup.md

@@ -12,8 +12,8 @@ An API key grants its documented access until revoked.
 |---------|-------|
 | Protocol | Streamable HTTP |
 | Endpoint | `https://xquik.com/mcp` |
-| Authentication | OAuth 2.1 discovery; API key fallback |
-| Skill bundle version | `2.7.0` |
+| Authentication | OAuth 2.1 discovery, with API key fallback |
+| Skill bundle version | `2.7.1` |
 
 Current clients negotiate MCP `2026-07-28` through `server/discover`.
 Use a current MCP SDK. It adds request `_meta` and protocol headers.
@@ -22,12 +22,12 @@ Discovery and tool catalogs include private 5-minute cache hints.
 Reuse cached metadata only with the same authorization context.
 Stateless 2025-era clients remain compatible at the same endpoint.
 
-Xquik publishes these discovery documents:
+Xquik publishes these discovery documents.
 
-- Protected resource metadata: `https://xquik.com/.well-known/oauth-protected-resource/mcp`
-- Authorization server metadata: `https://xquik.com/.well-known/oauth-authorization-server`
-- MCP registry card: `https://xquik.com/.well-known/mcp/server-card.json`
-- Authentication guide: `https://xquik.com/auth.md`
+- The protected resource metadata is at `https://xquik.com/.well-known/oauth-protected-resource/mcp`
+- The authorization server metadata is at `https://xquik.com/.well-known/oauth-authorization-server`
+- The MCP registry card is at `https://xquik.com/.well-known/mcp/server-card.json`
+- The authentication guide is at `https://xquik.com/auth.md`
 
 Xquik supports Client ID Metadata Documents and Dynamic Client Registration.
 Let each client use its documented registration flow. Both
@@ -83,7 +83,7 @@ Check your plan & workspace controls before setup.
 
 ### Codex CLI
 
-Use a current Codex CLI release. Run:
+Use a current Codex CLI release. Run these commands.
 
 ```bash
 codex mcp add xquik --url https://xquik.com/mcp
@@ -104,7 +104,7 @@ below only when OAuth shows the issuer error.
 
 ### API-key fallback for older Codex releases
 
-In Codex Settings, follow [API key fallback](#api-key-fallback) & add:
+In Codex Settings, follow [API key fallback](#api-key-fallback) & add this block.
 
 ```toml
 [mcp_servers.xquik]
@@ -142,7 +142,7 @@ def build_xquik_server(api_key: str) -> MCPServerStreamableHttp:
 
 ### Cursor
 
-Add to `~/.cursor/mcp.json` or `.cursor/mcp.json`:
+Add this to `~/.cursor/mcp.json` or `.cursor/mcp.json`.
 
 ```json
 {
@@ -159,7 +159,7 @@ Cursor starts OAuth after the server returns `401`. You can also run
 
 ### VS Code
 
-Add to `.vscode/mcp.json` or use **MCP: Open User Configuration**:
+Add this to `.vscode/mcp.json` or run the `MCP: Open User Configuration` command.
 
 ```json
 {
@@ -176,7 +176,7 @@ Start the server from the MCP view and follow the OAuth prompt.
 
 ### Windsurf
 
-Add to `~/.codeium/windsurf/mcp_config.json`:
+Add this to `~/.codeium/windsurf/mcp_config.json`.
 
 ```json
 {
@@ -194,7 +194,7 @@ disable MCP or restrict servers to an allowlist.
 
 ### OpenCode
 
-Add to `opencode.json`:
+Add this to `opencode.json`.
 
 ```json
 {
@@ -207,7 +207,7 @@ Add to `opencode.json`:
 }
 ```
 
-Then run:
+Then run these commands.
 
 ```bash
 opencode mcp auth xquik
@@ -216,7 +216,7 @@ opencode mcp list
 
 ### Gemini CLI
 
-Add the remote server:
+Add the remote server.
 
 ```bash
 gemini mcp add --transport http xquik https://xquik.com/mcp

package/stub-server.mjs

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

package/task-guides/check-mutuals.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.7.0"
+  version: "2.7.1"
   openclaw:
     requires:
       env:
@@ -37,12 +37,12 @@ Find mutual follows and followers-you-know between X accounts.
 | GET /x/users/{id}/followers-you-know | Mutual followers the acting account sees | Read tier |
 | GET /x/followers/check?source=<a>&target=<b> | Does A follow B? | Read tier |
 
-Base URL: `https://xquik.com/api/v1`. Auth: `x-api-key: xq_...` header.
+The base URL is `https://xquik.com/api/v1`. Authenticate with the `x-api-key: xq_...` header.
 
 ## Compare the accounts
 
 1. Ask for two handles.
-2. For A vs B mutual check: `GET /x/followers/check?source=<a>&target=<b>` and reverse. `source` and `target` may be handles or numeric IDs.
+2. For an A vs B mutual check, call `GET /x/followers/check?source=<a>&target=<b>` and reverse. `source` and `target` may be handles or numeric IDs.
 3. To find followers shared by A and B, resolve B with `GET /x/users/{id}`. The lookup accepts a username. Then call `GET /x/users/{id}/followers-you-know` through a connected account.
 4. Present as a small list with bios.
 

package/task-guides/clean-followers.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.7.0"
+  version: "2.7.1"
   openclaw:
     requires:
       env:
@@ -36,7 +36,7 @@ Identify likely bots or inactive followers. The API only reports candidates. The
 |---|---|---|
 | POST /extractions with toolType=follower_explorer | Full follower list | Per-row |
 
-Base URL: `https://xquik.com/api/v1`. Auth: `x-api-key: xq_...` header.
+The base URL is `https://xquik.com/api/v1`. Authenticate with the `x-api-key: xq_...` header.
 
 ## Example requests
 
@@ -51,7 +51,7 @@ Poll `GET /extractions/{id}` until `status: "completed"`, then `GET /extractions
 ## Review the followers
 
 1. Get confirmation for the usage, then extract the full follower list.
-2. Flag likely ghosts:
+2. Flag likely ghosts.
    - Flag accounts that match the declared count and age thresholds.
    - Flag missing avatars and copied or empty bios for review.
 3. Show the user a flagged shortlist.

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

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.7.0"
+  version: "2.7.1"
   openclaw:
     requires:
       env:
@@ -39,7 +39,7 @@ Download completed extractions or draw entrant lists in spreadsheet-friendly for
 | GET /extractions/{id}/export?format=xlsx | Excel workbook | Read tier |
 | GET /draws/{id}/export?format=csv | Giveaway entrants/winners | Read tier |
 
-Base URL: `https://xquik.com/api/v1`. Auth: `x-api-key: xq_...` header.
+The base URL is `https://xquik.com/api/v1`. Authenticate with the `x-api-key: xq_...` header.
 
 ## Example requests
 
@@ -53,14 +53,14 @@ GET /extractions/{id}/export?format=csv
 1. Start with a completed extraction or draw. Use the matching guide to create one.
 2. Poll `/extractions/{id}` until `status: "completed"`.
 3. Hit the export endpoint with the desired format.
-4. Save the file; the response streams the raw bytes.
+4. Save the file. The response streams the raw bytes.
 
 ## Format choice
 
-- CSV: broad compatibility, Excel/Sheets open directly
-- XLSX: preserves types, multiple sheets per extraction
-- JSON: structured data for scripts or databases
-- Markdown, PDF, or TXT: human-readable reports
+- CSV has broad compatibility, and Excel/Sheets open it directly
+- XLSX preserves types, with multiple sheets per extraction
+- JSON gives structured data for scripts or databases
+- Markdown, PDF, or TXT give human-readable reports
 
 ## Export filters
 

package/task-guides/extract-followers.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.7.0"
+  version: "2.7.1"
   openclaw:
     requires:
       env:
@@ -38,18 +38,18 @@ Export followers from any visible X account. Filter verified profiles or set a m
 | POST /extractions with toolType=verified_follower_explorer | Verified followers only | Per-row |
 | POST /extractions/estimate | Preview usage before running | Included |
 
-Base URL: `https://xquik.com/api/v1`. Auth: `x-api-key: xq_...` header.
+The base URL is `https://xquik.com/api/v1`. Authenticate with the `x-api-key: xq_...` header.
 
 ## Example requests
 
-Estimate usage first:
+Estimate usage first.
 
 ```
 POST /extractions/estimate
 { "toolType": "follower_explorer", "targetUsername": "handle" }
 ```
 
-Then create the extraction:
+Then create the extraction.
 
 ```
 POST /extractions
@@ -59,7 +59,7 @@ POST /extractions
 
 Send `toolType`, not `tool`. Send a bare handle without `@` in `targetUsername`. Use `verified_follower_explorer` for verified profiles only.
 
-Each result row: `{ username, name, bio, followers_count, following_count, verified, created_at }`.
+Each result row is `{ username, name, bio, followers_count, following_count, verified, created_at }`.
 
 ## Export the followers
 

package/task-guides/find-bangers.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.7.0"
+  version: "2.7.1"
   openclaw:
     requires:
       env:
@@ -38,7 +38,7 @@ Find tweets that outperformed their author's usual engagement by a wide margin.
 | GET /x/users/{id}/tweets | Paginated recent tweets for an author | Read tier |
 | GET /x/tweets/search?q=from:@user+min_faves:X&queryType=Top | Author posts above a like floor | Read tier |
 
-Base URL: `https://xquik.com/api/v1`. Auth: `x-api-key: xq_...` header.
+The base URL is `https://xquik.com/api/v1`. Authenticate with the `x-api-key: xq_...` header.
 
 ## Find the outliers
 

package/task-guides/find-influencers.md

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.7.0"
+  version: "2.7.1"
   openclaw:
     requires:
       env:
@@ -38,7 +38,7 @@ Find active X accounts in a niche by bio/handle search with follower and activit
 | POST /extractions/estimate | Preview usage before running | Included |
 | GET /x/users/{id} | Profile snapshot for shortlisted accounts | Read tier |
 
-Base URL: `https://xquik.com/api/v1`. Auth: `x-api-key: xq_...` header.
+The base URL is `https://xquik.com/api/v1`. Authenticate with the `x-api-key: xq_...` header.
 
 ## Example requests
 

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

@@ -5,7 +5,7 @@ license: MIT
 metadata:
   internal: true
   author: Xquik
-  version: "2.7.0"
+  version: "2.7.1"
   openclaw:
     requires:
       env:
@@ -37,7 +37,7 @@ Show the highest-engagement tweets for a topic, user, or hashtag. Read-only.
 | GET /x/tweets/search | Search with engagement filters | Read tier |
 | POST /extractions with toolType=tweet_search_extractor | Bulk viral tweet extraction | Per-row |
 
-Base URL: `https://xquik.com/api/v1`. Auth: `x-api-key: xq_...` header.
+The base URL is `https://xquik.com/api/v1`. Authenticate with the `x-api-key: xq_...` header.
 
 ## Example requests
 
@@ -48,7 +48,7 @@ GET /x/tweets/search?q=<q+min_faves:1000+min_retweets:100>&queryType=Top
 
 Send the URL-encoded query in `q`. Set `queryType` to `Latest` or `Top`. The route also accepts `cursor`, `sinceTime`, `untilTime`, and `limit`. Put engagement floors inside `q`.
 
-Useful operators inside `q`:
+These operators are useful inside `q`.
 - `min_faves:1000` sets the minimum for this search.
 - `min_retweets:100`
 - `-is:retweet` excludes reposts.
@@ -65,11 +65,11 @@ Useful operators inside `q`:
 
 ## What counts as viral
 
-A rough guide:
-- Niche topic: 500+ likes
-- Tech/business: 1k+ likes
-- Broad audience: 10k+ likes
-- Breakout: 100k+ likes
+Use this rough guide.
+- 500+ likes for a niche topic
+- 1k+ likes for tech/business
+- 10k+ likes for a broad audience
+- 100k+ likes for a breakout
 
 ## Protect tweet data