---

name: openclaw-youtube description: “YouTube SERP 侦察工具，专为智能体设计。搜索排名靠前的视频、频道和趋势，用于内容研究和竞争对手追踪。” homepage: https://openclaw.ai metadata: {“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+智能体+教程" \
  -H "Authorization: Bearer $AISA_API_KEY"

带国家/地区过滤的搜索

# 在特定国家/地区搜索（美国）
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=机器学习&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+教程&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 "AI 趋势 2025"

---

使用案例

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 端点参考

端点	方法	描述
/youtube/search	GET	搜索 YouTube SERP

请求参数

参数	类型	必填	描述
engine	string	是	必须为 youtube
q	string	是	搜索查询
gl	string	否	国家/地区代码（例如 us、jp、uk、cn）
hl	string	否	界面语言（例如 en、ja、zh-CN）
sp	string	否	用于分页/过滤的 YouTube 过滤令牌

响应格式

{
  "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": "125K 次观看",
      "published_date": "2 周前",
      "duration": "45:30",
      "thumbnail": "https://i.ytimg.com/vi/abc123xyz/hqdefault.jpg"
    }
  ]
}

---

国家/地区代码 (gl)

代码	国家/地区
us	美国
uk	英国
jp	日本
cn	中国
de	德国
fr	法国
kr	韩国
in	印度
br	巴西
au	澳大利亚

语言代码 (hl)

代码	语言
en	英语
ja	日语
zh-CN	中文（简体）
zh-TW	中文（繁体）
ko	韩语
de	德语
fr	法语
es	西班牙语
pt	葡萄牙语
ru	俄语

---

定价

API	成本
YouTube 搜索	~$0.002

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

---

开始使用

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

完整 API 参考

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