OpenClaw YouTube 📺

面向自主智能体的 YouTube 搜索结果页（SERP）侦察工具。由 AIsa 提供支持。

一个 API 密钥，即可实现排名发现、内容研究与竞品追踪。

🔥 你能做什么？

内容研究

"查找关于 'AI agents tutorial' 的高排名视频，了解当前哪些内容表现优异"

竞品追踪

"搜索竞品频道发布的关于 'machine learning' 的视频"

趋势发现

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

主题分析

"查找关于 'autonomous driving' 的热门视频，以理解受众兴趣"

频道发掘

"搜索发布 'crypto trading' 相关内容的频道"

快速开始

export AISA_API_KEY="your-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"

使用筛选令牌（filter token）进行分页

# 使用 sp 参数实现分页或高级筛选
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI&sp=" 
  -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 "machine learning" --country us

# 指定语言搜索
python3 {baseDir}/scripts/youtube_client.py search --query "python tutorial" --lang en

# 全部选项
python3 {baseDir}/scripts/youtube_client.py search --query "GPT-5 news" --country us --lang en

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

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

典型应用场景

1. 内容缺口分析

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

# 在你的垂直领域中搜索高排名视频
results = client.search("AI automation tutorial")
# 分析标题、观看量和频道，挖掘潜在机会

2. 竞品监控

追踪竞品正在发布的内容：

# 搜索竞品品牌 + 主题组合
results = client.search("OpenAI GPT tutorial")
# 长期监测其排名变化

3. 关键词研究

发现当前热门话题：

# 搜索宽泛主题，观察流行趋势
results = client.search("artificial intelligence 2025")
# 从高排名视频标题中提取高频关键词

4. 受众研究

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

# 在特定区域中搜索
results = client.search("coding tutorial", country="jp", lang="ja")
# 分析区域性内容偏好

5. SEO 分析

分析视频在特定关键词下的排名情况：

# 追踪目标关键词的排名位置
keywords = ["AI tutorial", "machine learning basics", "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": "Complete AI Agents Tutorial 2025",
      "link": "https://www.youtube.com/watch?v=abc123xyz",
      "channel_name": "AI Academy",
      "channel_link": "https://www.youtube.com/@aiacademy",
      "description": "Learn how to build AI agents from scratch...",
      "views": "125K views",
      "published_date": "2 weeks ago",
      "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="your-key"

完整 API 参考文档

请查阅 API Reference 获取全部接口的详细说明。