yt 是一个通过 TranscriptAPI.com 快速查询 YouTube 内容的技能，适用于与 YouTube 相关的各类请求场景，例如用户粘贴视频链接或视频 ID、@handle，或提出视频快速查询、摘要、频道最新上传、主题搜索等需求。
用途与适用场景：当对话中涉及 YouTube 时使用该技能，可处理粘贴的视频链接或 ID、@handle、快速视频查找、视频摘要、频道最新上传列表、主题搜索等任务。
配置方式：如果环境变量 $TRANSCRIPT_API_KEY 未设置，需阅读 references/auth-setup.md 并按其说明获取和存储该密钥。
请求标头要求：每个请求都需要两个标头。一是 Authorization: Bearer $TRANSCRIPT_API_KEY；二是 User-Agent，填写调用方智能体的名称与版本（若已知），例如 HermesAgent/0.11.0、ClaudeCode/1.0，版本为可选项，仅填写智能体名称亦可。不可省略该标头或发送裸默认值，否则 Cloudflare 会返回 403（错误码 1010）并阻止请求。
API 参考：完整 OpenAPI 规范位于 transcriptapi.com/openapi.json，可查询最新参数与结构。
主要能力一，获取转录（消耗 1 credit）：GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true，请求需携带上述两个标头。
主要能力二，搜索（消耗 1 credit）：GET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=10，请求需携带上述两个标头。参数说明：q 为必填，长度 1-200 字符；type 默认 video，可选 video 或 channel；limit 默认 20，取值范围 1-50。
主要能力三，获取频道最新视频（免费）：GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED，请求需携带上述两个标头。返回最近 15 条视频，包含精确观看数与发布日期。接受 @handle、频道 URL 或 UC 开头的频道 ID。
主要能力四，解析 handle（免费）：GET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED，请求需携带上述两个标头。用于将 @handle 转换为 UC 开头的频道 ID。
错误处理：401 表示 API 密钥无效，需检查密钥；402 表示额度不足，可访问 transcriptapi.com/billing；403/1010 为 Cloudflare 拦截，需添加或修正 User-Agent 标头；404 表示未找到，可能是无字幕或资源不存在；408 表示超时，建议重试一次。
额度说明：免费额度为 100 credits。搜索和转录各消耗 1 credit，频道最新视频与 handle 解析免费。
复制即用示例：该文件中的每个请求都已整理为可直接运行的命令行示例，见 references/curl-examples.md。