YouTube搜索

技能简介

YouTube Search 通过 TranscriptAPI.com 提供 YouTube 视频和频道的搜索能力，支持在特定频道内检索内容，并可获取视频字幕文本。

业务背景

帮助业务人员快速定位YouTube上的目标视频与频道，无需手动浏览海量内容。支持在特定创作者频道内精准检索，配合字幕获取能力，可将视频内容转化为可编辑的文本资产，适用于竞品调研、行业趋势追踪及内容素材收集等场景。

落地案例：市场部策划海外推广方案时，输入关键词搜索同类产品的官方频道与热门测评视频，筛选近三个月发布的优质内容；针对某KOL的@用户名，先转换为频道ID再限定其频道内搜索合作案例视频，批量获取视频元数据与字幕文本，用于分析竞品话术结构与用户反馈热点。

能做什么

• 全局搜索 YouTube 视频或频道
• 在指定频道内搜索视频
• 将 @用户名 转换为频道 ID
• 获取视频字幕文本（需配合转录接口）

使用说明

安装准备

1. 确保已安装 Node.js 环境
2. 设置环境变量 TRANSCRIPT_API_KEY，或完成以下注册流程

注册获取 API Key（100 免费额度，无需信用卡）

Step 1 — 注册：向用户提供邮箱后执行

node ./scripts/tapi-auth.js register --email USER_EMAIL

→ 系统发送 6 位验证码至邮箱，提示用户查收邮件

Step 2 — 验证：获得用户提供的验证码后执行

node ./scripts/tapi-auth.js verify --token TOKEN_FROM_STEP_1 --otp CODE

API Key 自动保存至 ~/.openclaw/openclaw.json，原文件备份为 .bak。手动注册可访问 transcriptapi.com/signup。

基础调用示例

搜索视频：

curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

频道内搜索：

curl -s "https://transcriptapi.com/api/v2/youtube/channel/search?channel=@TED&q=climate+change&limit=30" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

输入与输出

见下方输入与输出表格。

风险提示

• API 调用按次数计费，搜索操作消耗 1 credit/次
• API Key 存储于本地配置文件，注意文件权限安全
• 字幕可用性取决于视频本身是否开启 CC 字幕
• 免费额度用尽后需付费充值

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/therohitdas/youtube-search/SKILL.md
来源类型：GitHub 仓库