微博数据助手 okdata

--- name: okdata-weibo description: 微博数据助手：用 okdata 接口读微博的公开数据，包括微博搜索、微博热搜、微博账号信息、微博详情、微博评论、微博评论回复、微博点赞用户、微博用户微博等，不用登录、不用 Cookie，按次付费、失败不收费。适用于看微博热搜和话题、按关键词搜微博做舆情监测、查微博账号和它发的内容、读微博评论区。 Weibo 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/weibo/ --- <!-- Generated by scripts/platform-skills.mjs from the okdata catalog. Do not edit by hand. --> # 微博数据助手（okdata） 用 okdata 的接口读微博的公开数据：微博、账号和热搜。 不用登录微博，也不用 Cookie，按次付费，调用失败不收费。 ## 什么时候用 - 看微博热搜和话题 - 按关键词搜微博做舆情监测 - 查微博账号和它发的内容 - 读微博评论区 - 用户发来微博链接，想看内容、数据或评论 ## 能拿到的数据 目录版本 2128c2e84655fc1f，价目表 1b273c48fea9634e。价格单位是美元，调用失败不收费。 | 接口 | 能拿到什么 | 需要传 | 每次返回 | 价格 | |---|---|---|---|---| | `weibo.posts.search` | 微博搜索：按关键词搜微博，可按实时或热门，带转发、评论和点赞。 | `query` | 一页约 10 条 | 每次 $0.002 | | `weibo.trends.list` | 微博热搜：微博热搜榜，带排名和热度。 | 不用传 | 一页约 50 条 | 每次 $0.002 | | `weibo.users.get` | 微博账号信息：账号的粉丝数、微博数、认证和简介。 | `id` | 一条 | 每次 $0.002 | | `weibo.posts.get` | 微博详情：按 ID 或链接取一条微博：全文（长微博也是全文）、作者、点赞、评论、转发、阅读数（视频微博是播放数）、图片、话题和 IP 属地。 | `id` 或 `url` | 一条 | 每次 $0.002 | | `weibo.posts.comments.list` | 微博评论：按 ID 或链接取微博评论，按热度排：内容、评论者、点赞、回复数、发布时间和 IP 属地。 | `id` 或 `url` | 一页约 20 条 | 每次 $0.002 | | `weibo.comments.replies.list` | 微博评论回复：按评论 ID 取它下面的回复：内容、回复者、点赞、回复的是哪一条（parent_id）、发布时间和 IP 属地。 | `id` | 一页约 20 条 | 每次 $0.002 | | `weibo.posts.likers.list` | 微博点赞用户：按 ID 或链接取最近给这条微博点赞的账号，约 50 个：昵称、简介、头像、认证和认证类型、粉丝、关注、微博数，以及资料里填的性别和地区。 | `id` 或 `url` | 一页约 50 条 | 每次 $0.002 | | `weibo.users.posts.list` | 微博用户微博：按用户 ID 取账号主页上的微博（原创和转发），从新到旧：正文（长微博在这里是截短的，ext.text_truncated 标明）、点赞、评论、转发、视频播放数、图片和话题。 | `id` | 一页约 20 条 | 每次 $0.002 | | `weibo.users.followers.list` | 微博用户粉丝列表：关注这个用户的账号，每页 20 个：昵称、简介、头像、认证和认证类型、粉丝、关注、微博数、注册时间，以及资料里填的性别和地区。微博只给前几页。 | `id` | 一页约 20 条 | 每次 $0.002 | | `weibo.users.search` | 微博用户搜索：按关键词搜微博账号：用户 ID、昵称、头像和主页链接。 | `query` | 一页约 20 条 | 每次 $0.002 | | `weibo.backup.trends.list` | 微博热搜榜（备用版）：微博热搜榜（weibo.trends.list）的备用版，原接口取不到时改调：走另一条数据通道（App 端）取微博热搜，价格略高。50 个上榜话题、名次和热度；不含置顶话题和推广位。 | 不用传 | 一页约 50 条 | 每次 $0.0025 | ## 怎么调用 **用 MCP（已接上 `okdata` MCP 服务时优先用）**：先用 `describe` 看一个接口的参数、返回字段和价格（免费），再用 `call` 调用， `capability` 填接口 id，参数跟在旁边，例如 `{"capability": "weibo.posts.search", "query": "新品发布", "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/weibo/posts/search" \ -H "Authorization: Bearer $OKDATA_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ --data-urlencode 'query=新品发布' ``` 每个返回都带 `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-weibo 注册，在控制台创建 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/weibo/

存档时间线

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

下载存档内容副本