用途:YouTube SERP 是面向自主智能体的 YouTube 搜索技能,基于 AIsa 服务,通过单一 API 密钥返回视频搜索结果,帮助完成排名发现、内容研究、竞品追踪、趋势发现、主题分析与频道发现。
主要能力:
- 基础 YouTube 搜索,可返回视频 ID、标题、链接、频道名与链接、描述、播放量、发布时间、时长、缩略图。
- 国家过滤(gl,如 us、jp、uk、cn)与界面语言过滤(hl,如 en、ja、zh-CN)。
- 使用 sp 筛选/分页令牌进行分页或高级筛选。
- 提供 Python 客户端脚本进行封装调用。
使用方式:需要 Python 3、POSIX shell 与 AISA_API_KEY(在 aisa.one 获取)。先设置环境变量:export AISA_API_KEY="your-key"。API 端点 /youtube/search(GET),必填参数 engine=youtube、q;可选 gl、hl、sp。命令行调用示例:python3 {baseDir}/scripts/youtube_client.py search --query "AI agents tutorial" --country us --lang en。调用示例:curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+agents+tutorial" -H "Authorization: Bearer $AISA_API_KEY"。
适用场景:内容缺口分析、竞品监控、关键词研究、受众研究(分区域语言)、SEO 排名分析。
兼容性:兼容任何实现 Agent Skills 规范的 harness,包括 Claude Code 与 Claude(Anthropic)、OpenAI Codex、Cursor、Gemini CLI(Google)、OpenCode、Goose、OpenClaw、Hermes 等。
限制:需要自行注册并充值(按量付费,YouTube 搜索约 $0.002/次);具体配额与完整端点文档以官方 API Reference 为准。