X（推特）数据助手 okdata

--- name: okdata-x description: X（推特）数据助手：用 okdata 接口读X（推特）的公开数据，包括X 帖子详情、X 帖子搜索、X 账号信息、X 账号帖子列表、X 趋势、X 帖子回复、X 帖子引用、X 帖子转推用户等，不用登录、不用 Cookie，按次付费、失败不收费。适用于搜推特帖子，支持 X 的搜索语法、读一条推文的内容和互动数据、查账号和它最近发的帖子、看各国家和地区的 X 趋势。 X (Twitter) public data for AI agents through the okdata API (remote MCP or HTTP), paid per call. license: MIT metadata: openclaw: primaryEnv: OKDATA_API_KEY requires: env: - OKDATA_API_KEY homepage: https://okdata.online/zh/apis/x/ --- <!-- Generated by scripts/platform-skills.mjs from the okdata catalog. Do not edit by hand. --> # X（推特）数据助手（okdata） 用 okdata 的接口读X（推特）的公开数据：帖子、账号、搜索和趋势。 不用登录X（推特），也不用 Cookie，按次付费，调用失败不收费。 ## 什么时候用 - 搜推特帖子，支持 X 的搜索语法 - 读一条推文的内容和互动数据 - 查账号和它最近发的帖子 - 看各国家和地区的 X 趋势 - 用户发来推文链接，想看内容、数据或评论 ## 能拿到的数据 目录版本 2128c2e84655fc1f，价目表 1b273c48fea9634e。价格单位是美元，调用失败不收费。 | 接口 | 能拿到什么 | 需要传 | 每次返回 | 价格 | |---|---|---|---|---| | `x.posts.get` | X 帖子详情：按 ID 或链接取一条帖子：正文、媒体、浏览、点赞、转发和回复。 | `id` 或 `url` | 一条 | 每次 $0.0003 | | `x.posts.search` | X 帖子搜索：按查询词搜帖子（支持 X 的搜索语法），可按最新或热门。 | `query` | 一页约 20 条 | 每次 $0.002 | | `x.users.get` | X 账号信息：按用户名或数字 ID 取一个账号，或一次按 ID 取最多 100 个：粉丝、关注、发帖数、简介和认证。没找到的 ID 列在 data.missing 里，不收费。 | `id` 或 `username` 或 `ids` | 一条 | 每条 $0.0004，单次最多 $0.04 | | `x.users.posts.list` | X 账号帖子列表：账号发布的帖子，从新到旧。 | `username` | 一页约 20 条 | 每次 $0.002 | | `x.trends.list` | X 趋势：全球或某个国家的趋势话题。 | 不用传 | 一页约 30 条 | 每次 $0.009 | | `x.posts.replies.list` | X 帖子回复：一条帖子下面的回复，按 X 自己的相关度排，每页最多约 60 条。X 的回复本身就是帖子，所以按帖子返回：正文、作者、发布时间、浏览、点赞和它自己的回复数。 | `id` | 一页约 35 条 | 每次 $0.002 | | `x.posts.quotes.list` | X 帖子引用：引用了某条帖子的帖子，按最新或最热排，每页 20 条：别人加了什么话、是谁、传播得怎样。 | `id` | 一页约 20 条 | 每条 $0.0003，单次最多 $0.006 | | `x.posts.retweeters.list` | X 帖子转推用户：转推了某条帖子的账号，每页约 100 个：用户名、名称、简介和粉丝数。 | `id` | 一页约 100 条 | 每次 $0.002 | | `x.posts.article.get` | X 长文：按帖子 ID 取它所附的 X 长文（Article）：标题、全文、作者、发布时间、浏览、点赞和回复。 | `id` | 一条 | 每次 $0.002 | | `x.threads.posts.list` | X 对话串：给对话串里任意一条帖子的 ID，取整串帖子：起头的主帖、作者的续帖和其间的回复。每页多少由 X 决定，最多约 50 条。 | `id` | 一页约 20 条 | 每条 $0.0003，单次最多 $0.015 | | `x.users.search` | X 账号搜索：按关键词找账号，每页 20 个：用户名、名称、简介、粉丝、关注、发帖数和认证。 | `query` | 一页约 20 条 | 每条 $0.0004，单次最多 $0.008 | | `x.users.followers.list` | X 账号粉丝：关注了某个账号的人，最新关注的在前，每页 200 个：用户名、名称、简介、粉丝数和发帖数。 | `username` | 一页约 200 条 | 每条 $0.0001，单次最多 $0.02 | | `x.users.following.list` | X 账号关注：某个账号关注的人，最近关注的在前，每页 200 个：用户名、名称、简介、粉丝数和发帖数。 | `username` | 一页约 200 条 | 每条 $0.0001，单次最多 $0.02 | | `x.users.mentions.list` | X 账号被提及：提及了某个账号的帖子，从新到旧，每页 20 条：正文、作者、发布时间、浏览、点赞和转推。 | `username` | 一页约 20 条 | 每条 $0.0003，单次最多 $0.006 | | `x.lists.posts.list` | X 列表帖子：某个列表的时间线，从新到旧，每页约 100 条：正文、作者、发布时间、浏览、点赞和转推。 | `id` | 一页约 100 条 | 每次 $0.002 | | `x.lists.members.list` | X 列表成员：某个列表收录的账号，每页 20 个：用户名、名称、简介、粉丝数和认证。 | `id` | 一页约 20 条 | 每条 $0.0004，单次最多 $0.008 | | `x.lists.followers.list` | X 列表关注者：关注了某个列表的账号，最多 20 个：用户名、名称、简介、粉丝数和认证。只有这一页，不能往后翻。 | `id` | 一页约 20 条 | 每条 $0.0004，单次最多 $0.008 | | `x.communities.get` | X 社群资料：按 ID 取一个社群：名称、简介、成员数、创建时间，ext 里还有管理员人数、加入方式和主题。 | `id` | 一条 | 每次 $0.0004 | | `x.communities.posts.list` | X 社群帖子：一个社群里的帖子，从新到旧，每页 20 条：正文、作者、发布时间、浏览、点赞和转推。 | `id` | 一页约 20 条 | 每条 $0.0003，单次最多 $0.006 | | `x.communities.members.list` | X 社群成员：加入了某个社群的账号，每页 20 个：用户名、名称、简介、粉丝数和认证。 | `id` | 一页约 20 条 | 每条 $0.0004，单次最多 $0.008 | ## 怎么调用 **用 MCP（已接上 `okdata` MCP 服务时优先用）**：先用 `describe` 看一个接口的参数、返回字段和价格（免费），再用 `call` 调用， `capability` 填接口 id，参数跟在旁边，例如 `{"capability": "x.posts.search", "query": "\"claude code\" lang:zh", "max_price": "0.05", "idempotency_key": "<uuid>"}`。 `find` 能用中文或英文描述找接口，`read_more` 取长结果的剩余部分，这两个也免费。 还没接上的话，远程 MCP 地址是 `https://api.okdata.online/mcp`，认证头是 `Authorization: Bearer <key>`，详见 `okdata-setup` 技能。 **用 HTTP（没有 MCP 时）**：路径是接口 id 把点换成斜杠、放在 `/v1` 下面，参数放在查询串里，key 从环境变量读，不要贴进对话： ```bash curl -sG "https://api.okdata.online/v1/x/posts/search" \ -H "Authorization: Bearer $OKDATA_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ --data-urlencode 'query="claude code" lang:zh' ``` 每个返回都带 `code`。`"ok"` 时数据在 `data.items`（列表，翻页看 `page.next_cursor`）或 `data.item` 里， `meta.billing.amount` 是这次花了多少钱。其他 `code` 都是出错，会说明 `charged` 和 `retry`：`not_found` 不要重试， `rate_limited` 等 `retry_after_seconds` 再试，`timeout` 用同一个 `Idempotency-Key` 重发，不会重复扣费。 ## 用法建议 1. 先用搜索类接口找到内容或账号，再查详情、评论或作品列表。用户直接发来推文链接时，表格里「需要传」写着 `url` 的接口可以直接传链接，不用自己拆 id。 2. 列表接口一次返回一页。要更多就带上 `page.next_cursor` 再调一次，在 MCP 里也可以用 `read_more`。 3. 调用前先算一下要调几次、大概多少钱，告诉用户再动手。给 `call` 设 `max_price`：这次可能花得比它多时，调用会被拒绝，不扣钱。 4. 只读公开数据：不发帖、不点赞、不评论、不私信。 5. 还没有 key：到 https://okdata.online/zh/signup/?src=skill-okdata-x 注册，在控制台创建 key，设成环境变量 `OKDATA_API_KEY`。不要让用户把 key 贴进对话。 ## 相关技能 - `okdata-setup`：接入 MCP、保存 key、查价格和余额、排查报错 - `okdata-comments`：跨平台读评论，做口碑分析 - `okdata-competitors`：竞品账号监控和对比 - `okdata-creators`：按领域找达人、筛博主 - `okdata-trends`：各平台热搜热榜 - `okdata-content-research`：爆款内容调研 接口说明和价格：https://okdata.online/zh/apis/x/

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本