youtube-content-researchlisted
Install: claude install-skill DevinChen2014/socialdatax-skills
<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->
# YouTube内容研究
## 适用场景
当用户需要做 YouTube 内容研究、频道内容观察、竞品内容对比、趋势判断或素材整理时使用。面向内容运营、品牌调研和创作者。
## 快速开始
- 先给出当前 skill 支持的输入:关键词或选题方向。
- 如果你只想先看样本,先取 1 页;要继续扩大,再按参数说明使用分页或 `--max-items`。
- 你通常会得到:相关标题、作者或账号、链接或内容 ID,以及可继续追问的角度。
## API Key 获取
获取或管理 API Key:访问 <https://socialdatax.com/ai?from=modelscope>,按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`;不要引导用户使用其他域名。
## 直接调用命令
优先使用 direct CLI;能运行 shell 命令的 Agent 不需要额外配置 MCP server:
```bash
npx -y socialdatax-skills@latest youtube search \
--keyword "<keyword>" --pretty --source-client socialdatax-skills \
--source-platform modelscope --source-skill youtube-content-research
```
## 参数说明
搜索:
- 说明:YouTube `search --keyword <text>`:使用 `youtube search` 时必填;使用用户真实意图,去掉多余空格,并保持关键词聚焦。
- 可选:`--max-items <n>`:收集到 N 条搜索结果后停止。
- 说明:YouTube `--sort-type <general|time_descending|view_count_descending|rating>`:可选排序参数;不传就使用默认排序。
- 说明:YouTube `--publish-time-range <all|last_hour|today|this_week|this_month|this_year>`:可选发布时间筛选;不传表示不限制发布时间。
- 说明:YouTube `--duration-range <all|under_4_min|between_4_and_20_min|over_20_min>`:可选时长筛选;不传表示不限制时长。
- 说明:YouTube `--pages <n>`:从当前起点继续获取并合并 N 页搜索结果;如果返回了 `next_page_token`,可继续续页。
通用:
- 可选:`--pretty`:只影响输出格式,不改变实际请求结果。
- 说明:YouTube `--page-token <next_page_token>`:这是不透明的分页 token;第一页不要传。继续同一条搜索链路时,只能原样传回完整返回的 `next_page_token`。
- 说明:YouTube `--video-type <all|video|movie>`:可