YouTube 数据助手 okdata

--- name: okdata-youtube description: YouTube 数据助手：用 okdata 接口读YouTube的公开数据，包括YouTube 视频搜索、YouTube 视频详情、YouTube 视频评论、YouTube 视频字幕、YouTube 评论回复、YouTube 频道帖子、YouTube 帖子详情、YouTube 频道资料等，不用登录、不用 Cookie，按次付费、失败不收费。适用于取 YouTube 视频字幕，交给 AI 总结、搜 YouTube 视频和频道、查视频的播放和点赞数据、读视频评论区。 YouTube 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/youtube/ --- <!-- Generated by scripts/platform-skills.mjs from the okdata catalog. Do not edit by hand. --> # YouTube 数据助手（okdata） 用 okdata 的接口读YouTube的公开数据：视频、评论和字幕。 不用登录YouTube，也不用 Cookie，按次付费，调用失败不收费。 ## 什么时候用 - 取 YouTube 视频字幕，交给 AI 总结 - 搜 YouTube 视频和频道 - 查视频的播放和点赞数据 - 读视频评论区 - 用户发来YouTube 视频链接，想看内容、数据或评论 ## 能拿到的数据 目录版本 2128c2e84655fc1f，价目表 1b273c48fea9634e。价格单位是美元，调用失败不收费。 | 接口 | 能拿到什么 | 需要传 | 每次返回 | 价格 | |---|---|---|---|---| | `youtube.videos.search` | YouTube 视频搜索：按关键词搜视频，带播放量、时长和频道。 | `query` | 一页约 20 条 | 每次 $0.004 | | `youtube.videos.get` | YouTube 视频详情：按 ID 或链接取一个视频：标题、简介、播放、点赞和频道。 | `id` 或 `url` | 一条 | 每次 $0.002 | | `youtube.videos.comments.list` | YouTube 视频评论：视频评论，按热门或最新。 | `id` | 一页约 20 条 | 每次 $0.002 | | `youtube.videos.transcript.get` | YouTube 视频字幕：视频字幕，带时间戳，原语言或指定语言。 | `id` | 一条 | 每次 $0.004 | | `youtube.comments.replies.list` | YouTube 评论回复：用评论的回复标识取这条评论下的回复，每次约 10 条：内容、回复者（用户名、头像、认证）、点赞，以及大约的发布时间（YouTube 只说“6 年前”）。post_id 和 parent_id 从回复标识里读出。 | `id` | 一页约 10 条 | 每次 $0.002 | | `youtube.channels.posts.list` | YouTube 频道帖子：频道“帖子”栏（原“社区”）里的帖子，从新到旧，每页约 10 条，按频道 ID 或用户名取：正文、图片、点赞、帖子分享的视频（ext.video_id，封面在 images 里），以及大约的发布时间（YouTube 只说“4 天前”）。不存在的频道 ID 和没有帖子的频道一样，返回空结果。 | `id` 或 `username` | 一页约 10 条 | 每次 $0.002 | | `youtube.posts.get` | YouTube 帖子详情：按 ID 或链接取一条频道帖子（原“社区”帖）：正文、频道、图片、点赞、帖子分享的视频（ext.video_id，封面在 images 里），以及大约的发布时间。 | `id` 或 `url` | 一条 | 每次 $0.002 | | `youtube.channels.get` | YouTube 频道资料：按频道 ID 或用户名取一个频道：名称、简介、头像、认证、订阅数和视频数（按 YouTube 显示的取整），ext 里还有总播放量、注册日期、“关于”里列的链接、国家和横幅图。按用户名查时会带回用户名。 | `id` 或 `username` | 一条 | 每次 $0.002 | | `youtube.channels.search` | YouTube 频道搜索：按关键词找频道，每页 20 个，按 YouTube 的顺序：频道 ID、名称、简介开头、头像和订阅数（按 YouTube 显示的取整）。这里没有用户名和认证标识，认证标识可用 youtube.channels.get 查。 | `query` | 一页约 20 条 | 每次 $0.004 | | `youtube.channels.videos.list` | YouTube 频道视频：按频道 ID 或用户名取频道的视频或 Shorts，从新到旧，每页约 30 条：标题、播放数、封面，普通视频还有时长和大约的发布时间（YouTube 只说“3 周前”）。不存在的频道 ID 和没有这类视频的频道一样，返回空结果。 | `id` 或 `username` | 一页约 30 条 | 每次 $0.002 | ## 怎么调用 **用 MCP（已接上 `okdata` MCP 服务时优先用）**：先用 `describe` 看一个接口的参数、返回字段和价格（免费），再用 `call` 调用， `capability` 填接口 id，参数跟在旁边，例如 `{"capability": "youtube.videos.search", "query": "claude code tutorial", "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/youtube/videos/search" \ -H "Authorization: Bearer $OKDATA_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ --data-urlencode 'query=claude code tutorial' ``` 每个返回都带 `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. 先用搜索类接口找到内容或账号，再查详情、评论或作品列表。用户直接发来YouTube 视频链接时，表格里「需要传」写着 `url` 的接口可以直接传链接，不用自己拆 id。 2. 列表接口一次返回一页。要更多就带上 `page.next_cursor` 再调一次，在 MCP 里也可以用 `read_more`。 3. 调用前先算一下要调几次、大概多少钱，告诉用户再动手。给 `call` 设 `max_price`：这次可能花得比它多时，调用会被拒绝，不扣钱。 4. 只读公开数据：不发帖、不点赞、不评论、不私信。 5. 还没有 key：到 https://okdata.online/zh/signup/?src=skill-okdata-youtube 注册，在控制台创建 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/youtube/

存档时间线

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

下载存档内容副本

相关资产