B站数据助手 okdata

--- name: okdata-bilibili description: B站数据助手：用 okdata 接口读B站的公开数据，包括B站视频搜索、B站视频详情、B站视频评论、B站热搜榜、B站用户资料、B站用户投稿、B站评论回复、B站综合热门等，不用登录、不用 Cookie，按次付费、失败不收费。适用于搜 B站视频，查播放、投币、弹幕等数据、抓 B站视频评论做口碑分析、看 B站热门榜和热搜、找某个领域的 UP 主。 Bilibili 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/bilibili/ --- <!-- Generated by scripts/platform-skills.mjs from the okdata catalog. Do not edit by hand. --> # B站数据助手（okdata） 用 okdata 的接口读B站的公开数据：视频、评论和热门榜。 不用登录B站，也不用 Cookie，按次付费，调用失败不收费。 ## 什么时候用 - 搜 B站视频，查播放、投币、弹幕等数据 - 抓 B站视频评论做口碑分析 - 看 B站热门榜和热搜 - 找某个领域的 UP 主 - 用户发来B站视频链接或 BV 号，想看内容、数据或评论 ## 能拿到的数据 目录版本 2128c2e84655fc1f，价目表 1b273c48fea9634e。价格单位是美元，调用失败不收费。 | 接口 | 能拿到什么 | 需要传 | 每次返回 | 价格 | |---|---|---|---|---| | `bilibili.videos.search` | B站视频搜索：按关键词搜视频，带播放、弹幕、点赞和投币。 | `query` | 一页约 20 条 | 每次 $0.002 | | `bilibili.videos.get` | B站视频详情：按 BV 号或链接取一个视频。 | `id` 或 `url` | 一条 | 每次 $0.002 | | `bilibili.videos.comments.list` | B站视频评论：视频评论，按最热或最新。 | `id` | 一页约 20 条 | 每次 $0.002 | | `bilibili.trends.list` | B站热搜榜：B站当前的热搜词，最多 50 个，带名次和热度。 | 不用传 | 一页约 50 条 | 每次 $0.002 | | `bilibili.users.get` | B站用户资料：按用户 ID 取 B 站账号：昵称、签名、头像、认证和认证说明、粉丝、关注、投稿视频数、累计获赞、等级和直播间链接。 | `id` | 一条 | 每次 $0.002 | | `bilibili.users.videos.list` | B站用户投稿：账号投稿的视频，从新到旧，每页 30 条：标题、简介、播放、评论、弹幕、时长和发布时间。 | `id` | 一页约 30 条 | 每次 $0.002 | | `bilibili.comments.replies.list` | B站评论回复：按评论 ID 和所在视频的 BV 号取回复：内容、回复者、点赞、回复的是哪一条（parent_id）、发布时间和 IP 属地。 | `id`、`post_id` | 一页约 20 条 | 每次 $0.002 | | `bilibili.videos.trending` | B站综合热门：B站综合热门视频，每页 20 条：标题、简介、UP 主、播放、点赞、投币、收藏、弹幕、时长、分区、IP 属地和推荐理由。 | 不用传 | 一页约 20 条 | 每次 $0.002 | | `bilibili.backup.users.videos.list` | B站用户投稿（备用版）：B站用户投稿（bilibili.users.videos.list）的备用版，原接口取不到时改调：账号投稿的视频，从新到旧，每页 20 条（这条数据通道每页就是 20 条），价格略高。标题、封面、播放、弹幕、时长和发布时间；没有简介、点赞和评论数。用户不存在时和没有投稿一样，返回空结果，不报 404。 | `id` | 一页约 20 条 | 每次 $0.0025 | ## 怎么调用 **用 MCP（已接上 `okdata` MCP 服务时优先用）**：先用 `describe` 看一个接口的参数、返回字段和价格（免费），再用 `call` 调用， `capability` 填接口 id，参数跟在旁边，例如 `{"capability": "bilibili.videos.search", "query": "Claude Code 教程", "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/bilibili/videos/search" \ -H "Authorization: Bearer $OKDATA_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ --data-urlencode 'query=Claude Code 教程' ``` 每个返回都带 `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. 先用搜索类接口找到内容或账号，再查详情、评论或作品列表。用户直接发来B站视频链接或 BV 号时，表格里「需要传」写着 `url` 的接口可以直接传链接，不用自己拆 id。 2. 列表接口一次返回一页。要更多就带上 `page.next_cursor` 再调一次，在 MCP 里也可以用 `read_more`。 3. 调用前先算一下要调几次、大概多少钱，告诉用户再动手。给 `call` 设 `max_price`：这次可能花得比它多时，调用会被拒绝，不扣钱。 4. 只读公开数据：不发帖、不点赞、不评论、不私信。 5. 还没有 key：到 https://okdata.online/zh/signup/?src=skill-okdata-bilibili 注册，在控制台创建 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/bilibili/

存档时间线

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

下载存档内容副本