核心用法
SerpAPI 是一个封装 Google 搜索生态的付费 API 服务，本 skill 将其能力简化为命令行工具，支持三大引擎：
- Google Search（默认）：抓取网页搜索结果，返回标题、链接、摘要、排名位置等
- Google News：专精新闻源检索，获取时效性资讯
- Google Local：本地商家与地点搜索，支持地理坐标与地址描述
使用上通过 {baseDir}/scripts/search.sh 统一入口，配合 --engine、--country、--lang、--location 等参数实现多维度定向搜索。结果默认可读文本输出，加 --json 可获取原始结构化数据便于二次处理。
显著优点
1. 反爬无忧：SerpAPI 负责处理 Google 的反爬虫机制，用户无需维护代理池或验证码方案
2. 多地区模拟：通过 country+lang+location 组合，可精准模拟巴西葡萄牙语、日本日语等本地搜索环境
3. 三引擎合一：网页、新闻、本地商户统一接口，降低多工具切换成本
4. 结构化输出：JSON 模式便于与数据处理管道（Python、jq 等）对接
潜在缺点与局限性
- 付费门槛：SerpAPI 为商业服务，免费额度有限（通常 100 次/月），高频使用需订阅
- 数据延迟：非实时抓取，结果可能滞后数分钟至数小时
- Google 依赖：若 Google 调整页面结构或 SerpAPI 解析失效，工具将中断
- 隐私合规：搜索行为经第三方服务器中转，敏感查询存在数据泄露风险
- 功能边界：不支持 Google Scholar、Images、Shopping 等垂直搜索
适合人群
- 市场研究员：跨国竞品监控与舆情追踪
- SEO/SEM 从业者：多地区排名监测与关键词分析
- 开发者：需要程序化获取搜索结果构建数据管道
- 新闻从业者：快速聚合多语言热点资讯
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| API 密钥泄露 | 密钥存储于本地文件，权限配置不当易被读取 | 严格设置 `chmod 600`，避免提交至版本库 |
| 成本失控 | 高频调用易触发超额计费 | 设置用量告警，本地做结果缓存 |
| 合规争议 | 自动化抓取可能违反目标网站 ToS | 仅用于公开信息，遵守 robots.txt 精神 |