用途:在 fetcher.sh 上以按次付费方式获取 YouTube 数据,无需开发者控制台项目、OAuth 授权页或每日配额。基础地址 https://youtube.fetcher.sh。
主要能力:共 15 个 GET 接口,每次调用 $0.005。包括视频/频道/播放列表搜索(支持上传日期、时长、排序过滤),按 ID、@handle 或自定义路径查频道,频道的视频、短裤与直播,视频或短裤详情,视频评论,播放列表内容,标签 feed,以及可选按地区的趋势视频。{id}/{handle}/{tag} 为路径参数,可选 cursor/lang/geo 细化结果。
使用方式:两种付费均可,数据相同。1)预付额度,在 https://fetcher.sh/topup 获取密钥后设置 export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx",请求带 Authorization: Bearer $FETCHER_API_KEY。2)x402 按次付费,省略该头,无支付的 GET 返回 402 及机器可读支付要求(USDC,支持 Base、Polygon、Arbitrum、Monad 或 Solana),@x402/fetch 可自动签名重试。响应统一为 { "status": number, "message": string, "data": ... },HTTP 状态与 status 一致。也提供 MCP 接入:{"mcpServers":{"youtube":{"url":"https://youtube.fetcher.sh/mcp","headers":{"Authorization":"Bearer bby_live_..."}}}}。MCP 中免费工具为 search_endpoints、describe_endpoint、check_balance,付费工具为 fetch_data、topup_credits 及快捷 youtube_search_video。
限制:错误码 400 参数缺失或无效,401 密钥未知或轮换,402 需支付或额度耗尽,404 非计价路径;无速率限制,上游失败不退款(结算先于交付)。参考文档:https://youtube.fetcher.sh/skill.md、openapi.json、llms.txt。