Skip to main content
在 GitHub 上查看 -> 面向自治 Agent 的 YouTube 搜索结果和丰富元数据。 一个 AISA_API_KEY 即可返回排序视频、播放量、发布时间和缩略图，并支持按国家和语言过滤。

​
安装

如果还没有安装 AIsa CLI，请先安装：
然后安装该技能：

​
Agent 可以用它做什么？

内容缺口分析

“找出 ‘AI agent tutorial’ 当前排名靠前、但我们频道还没有覆盖的内容。”

竞品监控

“跟踪这个细分领域前 5 个频道的新上传视频。”

关键词研究

“哪些 ‘RAG’ 变体能带来最高播放量？”

区域趋势

“比较日本（jp/ja）和美国（us/en）的热门机器学习内容。”

受众研究

“哪些缩略图和标题适合 agent demo？”

趋势发现

“标记相对频道基线速度异常的视频。”

​
核心能力

  • 关键词搜索 — 对任意查询返回排序 YouTube 结果
  • 区域定向 — gl（国家：us、jp、cn 等）和 hl（界面语言：en、ja、zh-CN 等）
  • 丰富元数据 — 标题、频道、播放量、发布日期、时长和缩略图
  • 分页 — 使用过滤 token 跳转到第一页之后的结果

​
快速开始

​
基础搜索

​
地区 + 语言

​
分页

响应会包含分页 token，可传回端点抓取下一页：

​
Python 客户端

​
端点参考

常用参数：
  • engine — 固定为 youtube
  • q — 搜索查询（必填）
  • gl — 国家代码（us、jp、cn 等）
  • hl — 语言代码（en、ja、zh-CN 等）
  • sp — 分页 token

​
开始使用

  1. 在 aisa.one 注册（新账户有 $2 免费额度）。
  2. 从控制台生成 API key。
  3. export AISA_API_KEY="your-key" 并安装技能：

​
相关

YouTube Search Endpoint

完整端点参考和交互式 Playground。

多源搜索

将 YouTube 搜索与网页、学术搜索、Tavily 组合使用。

错误码

处理 YouTube API 层错误。