YouTube搜索助手

技能简介

YouTube SERP Scout 是一款面向智能体的 YouTube 搜索结果获取工具，支持检索热门视频、频道和趋势数据，用于内容研究和竞争对手跟踪。

业务背景

内容运营与市场营销人员需持续监测竞品动态与平台趋势，但手动浏览YouTube效率低下且难以结构化分析。该工具支持按国家/语言筛选获取实时搜索排名数据，帮助团队快速定位高表现内容范式，优化自身发布策略与投放计划。

落地案例：某出海品牌进入东南亚市场前，使用国家代码筛选功能获取印尼、越南用户搜索"便携式咖啡机"的头部视频，分析高排名内容的标题结构与时长特征；同时监控竞品频道近90天发布动态，为本地化内容制作与KOL合作提供数据参考。

能做什么

• 内容研究：查找特定主题的高排名视频，分析成功因素
• 竞品跟踪：监控竞争对手频道发布的相关视频
• 趋势发现：获取当前热门话题的头部视频
• 受众分析：按国家和地区筛选，了解区域内容偏好
• 关键词研究：从排名标题中提取高频关键词

使用说明

安装准备

本技能依赖 curl 和 python3，需提前安装。同时需要申请 AISA_API_KEY 作为调用凭证。

配置环境变量

export AISA_API_KEY="your-key"

cURL 调用示例

# 基础搜索
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+agents+tutorial" \
  -H "Authorization: Bearer $AISA_API_KEY"

# 指定国家（美国）
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=machine+learning&gl=us" \
  -H "Authorization: Bearer $AISA_API_KEY"

# 指定语言（中文界面）
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=编程教程&hl=zh-CN&gl=cn" \
  -H "Authorization: Bearer $AISA_API_KEY"

Python 客户端调用

# 基础搜索
python3 {baseDir}/scripts/youtube_client.py search --query "AI agents tutorial"

# 指定国家和语言
python3 {baseDir}/scripts/youtube_client.py search --query "GPT-5 news" --country us --lang en

输入与输出

见下方输入与输出表格。

风险提示

• API 调用受限于 AISA 平台配额，高频请求可能触发限流
• 返回结果为实时搜索快照，不保证长期可访问性
• 部分国家/地区的内容可能因版权或政策原因无法获取
• filter token（sp 参数）为 YouTube 内部格式，稳定性不受官方保障

来源信息

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