名称： openclaw-youtube
描述： "面向智能体的 YouTube SERP 侦察工具。搜索排名靠前的视频、频道和趋势，用于内容研究与竞品追踪。"
主页： https://openclaw.ai
元数据： {"openclaw":{"emoji":"📺","requires":{"bins":["curl","python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}

OpenClaw YouTube 📺

面向自主智能体的 YouTube SERP 侦察工具。由 AIsa 驱动。

一个 API 密钥。排名发现。内容研究。竞品追踪。

🔥 核心功能

内容研究

"查找关于 'AI 智能体教程' 的排名靠前视频，了解哪些内容受欢迎"

竞品追踪

"搜索竞品频道中关于 '机器学习' 的视频"

趋势发现

"当前关于 'GPT-5' 的热门 YouTube 视频有哪些？"

主题分析

"查找关于 '自动驾驶' 的热门视频，以了解受众兴趣"

频道发现

"搜索制作 '加密货币交易' 相关内容的频道"

快速开始

export AISA_API_KEY="你的密钥"

核心能力

基础 YouTube 搜索

# 搜索视频
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=AI&gl=jp&hl=ja" \
  -H "Authorization: Bearer $AISA_API_KEY"

按语言筛选搜索

# 使用界面语言搜索
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=python+tutorial&hl=en" \
  -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"

使用筛选令牌进行分页

# 使用 sp 参数进行分页或高级筛选
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI&sp=<filter_token>" \
  -H "Authorization: Bearer $AISA_API_KEY"

Python 客户端

# 基础搜索
python3 {baseDir}/scripts/youtube_client.py search --query "AI 智能体教程"

# 按国家/地区搜索
python3 {baseDir}/scripts/youtube_client.py search --query "机器学习" --country us

# 按语言搜索
python3 {baseDir}/scripts/youtube_client.py search --query "python 教程" --lang en

# 完整选项
python3 {baseDir}/scripts/youtube_client.py search --query "GPT-5 新闻" --country us --lang en

# 竞品研究
python3 {baseDir}/scripts/youtube_client.py search --query "OpenAI 教程"

# 趋势发现
python3 {baseDir}/scripts/youtube_client.py search --query "2025 AI 趋势"

使用场景

1. 内容差距分析

查找排名靠前的内容，以识别自身策略中的空白：

# 搜索您细分领域的热门视频
results = client.search("AI 自动化教程")
# 分析标题、观看量和频道，寻找机会

2. 竞品监控

追踪竞品发布的内容：

# 搜索竞品品牌 + 主题
results = client.search("OpenAI GPT 教程")
# 监控排名随时间的变化

3. 关键词研究

发现热门话题：

# 搜索广泛主题以了解流行趋势
results = client.search("2025 人工智能")
# 从排名靠前的标题中提取常见关键词

4. 受众研究

了解目标受众观看的内容：

# 在特定区域搜索
results = client.search("编程教程", country="jp", lang="ja")
# 分析区域内容偏好

5. SEO 分析

分析视频针对特定关键词的排名情况：

# 追踪目标关键词的排名位置
keywords = ["AI 教程", "机器学习基础", "Python AI"]
for kw in keywords:
    results = client.search(kw)
    # 记录前 10 个视频及其频道

API 端点参考

请求参数

响应格式

{
  "search_metadata": {
    "id": "search_id",
    "status": "Success",
    "created_at": "2025-01-15T12:00:00Z",
    "request_time_taken": 1.23,
    "total_time_taken": 1.45
  },
  "search_results": [
    {
      "video_id": "abc123xyz",
      "title": "2025 年完整 AI 智能体教程",
      "link": "https://www.youtube.com/watch?v=abc123xyz",
      "channel_name": "AI 学院",
      "channel_link": "https://www.youtube.com/@aiacademy",
      "description": "学习如何从零开始构建 AI 智能体...",
      "views": "12.5 万次观看",
      "published_date": "2 周前",
      "duration": "45:30",
      "thumbnail": "https://i.ytimg.com/vi/abc123xyz/hqdefault.jpg"
    }
  ]
}

国家/地区代码 (gl)

语言代码 (hl)

定价

每个响应都包含 usage.cost 和 usage.credits_remaining。

开始使用

1. 在 aisa.one 注册
2. 获取您的 API 密钥
3. 充值（按需付费）
4. 设置环境变量：export AISA_API_KEY="你的密钥"

完整 API 参考

查看 API 参考文档 获取完整的端点文档。