核心用法
OpenClaw YouTube 是一款面向 AI Agent 的 YouTube 搜索代理工具，通过 AIsa API 提供 SERP（搜索结果页）数据抓取能力。支持基础关键词搜索、国家/地区过滤（gl参数）、界面语言设置（hl参数）以及分页令牌（sp参数）等高级功能。提供原生 curl 命令和 Python 客户端两种调用方式，返回结构化 JSON 数据包含视频ID、标题、频道信息、观看量、发布时间和缩略图等字段。
显著优点
- Agent原生设计：专为自主代理场景优化，API响应格式标准化，便于自动化处理
- 多维度过滤：支持10+国家代码和10+语言代码的交叉过滤，便于全球化内容研究
- 成本可控：单次搜索约$0.002，按量付费无订阅门槛
- 竞品追踪场景成熟：文档提供内容缺口分析、竞品监控、关键词研究等5种典型业务场景示例
潜在缺点与局限性
- 第三方依赖：核心能力完全依赖 AIsa API，存在供应商锁定风险；若 AIsa 服务中断或调价，工具可用性直接受影响
- 数据覆盖有限：仅支持搜索端点，无法获取视频详情、评论、字幕等深层数据
- 反爬与合规：未明确说明是否使用官方 YouTube Data API，存在违反 YouTube ToS 的潜在风险；搜索结果可能受 IP 质量和代理池稳定性影响
- 无实时保证：文档未标注数据延迟，SERP 缓存机制可能导致趋势追踪滞后
适合人群
- 内容创作者/Marketer：进行选题调研和竞品内容分析
- SEO/增长团队：追踪关键词排名和视频 SEO 表现
- AI Agent 开发者：需要集成 YouTube 搜索能力的自动化工作流
常规风险
- API密钥泄露：AISA_API_KEY 以环境变量传递，需妥善保管；泄露可能导致额度被盗刷
- 供应商连续性：AIsa 为新兴服务商，长期运营稳定性待验证
- 合规使用：高频自动化查询可能触发平台风控，建议控制请求频率并遵守 robots.txt 精神