clawbus-youtube-unified-api — 爪巴士YouTube统一API

YouTube Unified API 技能 ⚠️ 身份验证 — 首先检查 在进行任何 API 调用之前，验证用户是否提供了 Mybrandmetrics API-KEY。如果没有提供密钥，说明：要使用 YouTube API，我需要您的 Mybrandmetrics API-KEY。您可以在 Mybrandmetrics 仪表板中找到此密钥。请分享它，我将继续处理请求。一旦您拥有密钥，请将其作为 X-API-KEY: <密钥> 传递。不要要求用户提供 YouTube API 密钥或 OAuth 令牌 — 代理内部处理身份验证。

托管代理基 URL https://mcp.imagineapp.co 路由前缀 /youtube_api 完整示例 https://mcp.imagineapp.co/youtube_api/youtube/v3/videos

如何调用 API（步骤） 步骤 1 — 找到正确的端点 对于大多数任务，首先阅读 references/endpoints_summary.md。它列出了所有 99 个端点，按域（视频、频道、分析等）分组，内联显示所需和可选参数。这是最快的路径 — 您可以仅从此文件构造请求，而无需触摸发现缓存。当您需要特定方法的完整参数模式（类型、枚举、默认值）时，使用 references/youtube_endpoint_catalog.json。仅当您需要完整的请求/响应正文模式时，才回退到 references/discovery_cache/.json。

步骤 2 — 构造请求 GET 端点：所有参数都在查询字符串中 POST / PUT 端点：使用 params 进行查询参数，使用 requestBody 进行 JSON 正文（catalog 中的 request_schema_ref 字段告诉您正文模式名称） part 参数：仅请求实际需要的部分（请参阅下面的 Part 策略） 路径参数：直接将 {id}、{channelId} 等替换到 URL 中

步骤 3 — 发送到代理 curl -G "https://mcp.imagineapp.co/youtube_api/youtube/v3/videos" \ -H "X-API-KEY: USER_KEY" \ --data-urlencode "part=snippet,statistics" \ --data-urlencode "id=VIDEO_ID"

步骤 4 — 处理分页 如果响应包含 nextPageToken，请将其作为 pageToken 传回，以获取下一页。使用 maxResults（最多 50）控制页面大小。

Part 参数策略 仅请求实际需要的 part 值 — 每个值都会增加配额成本： part 包含 id 资源 ID（最便宜） snippet 标题、描述、缩略图、日期、标签 statistics 观看次数、喜欢次数、评论次数 contentDetails 持续时间、定义、字幕可用性 status 隐私、上传状态、许可 localizations 翻译标题/描述 player 嵌入式播放器 HTML

Token / LLM 效率提示 每个任务只读取一次 endpoints_summary.md，而不是每个 API 调用 — 它包含构建大多数请求所需的所有内容。 除非需要 OpenAPI 格式的工具模式，否则不要加载 openapi_proxy.json — 它很大（242 KB），摘要更快。 除非需要完整的请求正文模式，否则不要加载 discovery_cache/.json — 这些文件非常大。 批量相关读取：如果您需要在同一个域中获取两个端点的信息，请在一次传递中读取摘要的相关部分，而不是进行两次单独的查找。 从用户的请求中推断 part 值，而不是询问澄清问题 — 如果用户想要“视频标题和观看次数”，它直接映射到 part=snippet,statistics。

快速端点索引 任务 方法 代理路径 获取视频详细信息 GET /youtube_api/youtube/v3/videos 搜索视频/频道 GET /youtube_api/youtube/v3/search 获取频道信息 GET /youtube_api/youtube/v3/channels 列出播放列表 GET /youtube_api/youtube/v3/playlists 列出播放列表项 GET /youtube_api/youtube/v3/playlistItems 列出评论 GET /youtube_api/youtube/v3/commentThreads 获取订阅 GET /youtube_api/youtube/v3/subscriptions 列出直播广播 GET /youtube_api/youtube/v3/liveBroadcasts 上传和发布视频（简单多部分） POST /youtube_api/upload/youtube/v3/videos 上传视频（可恢复） POST /youtube_api/resumable/upload/youtube/v3/videos 查询分析 GET /youtube_api/v2/reports 列出报告类型 GET /youtube_api/v1/reportTypes 创建报告作业 POST /youtube_api/v1/jobs

对于完整的列表（包括参数），请参阅 references/endpoints_summary.md。

文件 目的 何时阅读 references/endpoints_summary.md 所有端点及其参数，按域分组 默认 — 首先阅读此文件 references/youtube_endpoint_catalog.json 完整的参数模式（类型、枚举、所需） 当您需要精确的参数详细信息时 references/openapi_proxy.json OpenAPI 3.1 规范，用于工具/函数调用 仅当构建工具模式时 references/discovery_cache/*.json 原始 Google 发现文档 仅用于请求/响应正文模式

重新生成文件 当 Google 更新发现文档时，刷新所有文件： python scripts/sync_discovery.py

环境覆盖： YOUTUBE_PROXY_BASE_URL — 覆盖托管基 URL YOUTUBE_PROXY_ROUTE_PREFIX — 覆盖路由前缀（默认 /youtube_api）