用途
youtube-channels 用于以 YouTube 频道为核心的操作场景：当用户粘贴 @handle 或频道 URL、要求浏览某创作者的投稿、查看频道近期发布内容，或需要频道层面的资料、播放列表、社区帖子和首页内容架时，可使用本工具集。所有频道端点都接受灵活输入——@handle、频道 URL 或 UC... 频道 ID，无需事先解析。
主要能力
- 频道解析（免费）：
GET /api/v2/youtube/channel/resolve将 @handle、URL 或 UC... ID 转换为规范频道 ID。若输入已是 UC[a-zA-Z0-9_-]{22} 格式，则立即返回。 - 最新视频（免费）：
GET /api/v2/youtube/channel/latest通过 RSS 获取频道最新 15 个视频，并附带精确统计数据（如 viewCount、starRating、ISO 时间戳），适合监控频道。 - 频道视频列表（1 积分/页）：
GET /api/v2/youtube/channel/videos分页列出频道内容（约 100 条/页）。可用tab选择 uploads（默认）、Shorts 或直播，用sort将 Videos 标签页按 latest、popular 或 oldest 排序。排序后每页约 30 条，每页均消耗 1 积分。分页时需在每页传递相同的 tab 和 sort。 - 频道内搜索（1 积分）：
GET /api/v2/youtube/channel/search在指定频道内搜索视频，支持 q 与 limit（1-50，默认 30）。 - 频道资料（1 积分）：
GET /api/v2/youtube/channel/info返回频道标题、handle、认证标志、订阅/视频数、描述、标签、缩略图、横幅及可用标签页。计数为展示字符串，YouTube 隐藏时返回 null 而非 0。 - 播放列表（1 积分/页）：
GET /api/v2/youtube/channel/playlists列出频道展示的播放列表，便于获取播放列表 ID 以用于 playlist/videos。 - 社区帖子（1 积分/页）：
GET /api/v2/youtube/channel/posts列出频道社区（Posts 标签页）内容，包括文本、发布时间、点赞数及附件（图片、视频、播放列表或投票）。无社区标签页的频道返回空列表而非错误。 - 首页内容架（1 积分）：
GET /api/v2/youtube/channel/sections返回频道首页（或播客/发布页）的精选内容架，每个内容架包含视频、播放列表、Shorts 或推荐频道，按频道自身顺序排列，不分页。
使用方式
所有请求需两个头：Authorization: Bearer $TRANSCRIPT_API_KEY 和 User-Agent（填写你的 agent 名称与版本，如 HermesAgent/0.11.0；版本可选，但不可省略该头或发送默认值，否则 Cloudflare 会返回 403 错误码 1010 并拦截请求）。若未设置 $TRANSCRIPT_API_KEY，需先阅读 references/auth-setup.md 获取并存储密钥。完整 OpenAPI 规范见 transcriptapi.com/openapi.json。
典型工作流：先调用免费的 channel/latest 检查最新上传（可直接传 @handle），再调用 transcript 端点获取近期视频的文字记录。
适用场景
- 监控频道更新与近期发布内容
- 浏览创作者的投稿、Shorts 或直播
- 在频道内检索特定主题视频
- 获取频道资料、播放列表、社区帖子和首页内容架
- 为后续获取视频文字记录做准备
限制
- 频道视频列表、搜索、资料、播放列表、帖子、内容架等端点消耗积分；免费层提供 100 积分、每分钟 300 次请求。resolve 与 latest 免费但需认证。
- 分页时 channel 与 continuation 只能二选一，且需保持相同的 tab 和 sort。
- 排序页面每页约 30 条，未排序页面约 100 条。
- members_only 仅在 YouTube 标记“Members only”时为 true，此类内容无 viewCountText。
- podcasts 和 releases 标签页仅存在于拥有它们的频道，否则返回空结果，建议先通过 channel/info 的 availableTabs 检查。
- 常见错误：400（参数组合无效）、402（无积分）、403/1010（Cloudflare 拦截，需修正 User-Agent）、404（频道未找到）、408（超时，可重试一次）、422（频道标识无效）。
- 具体收费、价格与更多平台细节暂未提供。