核心用法
Serper 是一款基于 Serper API 的 Google 深度搜索技能，区别于普通搜索仅返回摘要，它能自动访问结果页面并提取完整正文内容。调用方式为 CLI 命令格式，支持三个关键参数：-q 指定查询语句，--mode 选择搜索模式，--gl/--hl 设置地区语言。
双模式设计：
default模式（默认）：全时段搜索，返回 5 个结果，适合常规研究、技术文档、产品对比等非时效性内容current模式：近一周网页 + Google News 双源搜索，各 3 个结果，专为新闻、实时事件、最新动态设计
关键约束：单次调用即返回多个完整页面内容，严禁重复搜索或连环查询。官方明确限制最多两次调用（仅当用户请求涉及两个 genuinely 独立主题时）。
显著优点
1. 内容深度：集成 trafilatura 库实现正文提取，输出的是可读全文而非碎片化摘要，大幅减少信息损耗
2. 效率设计：3 秒超时 + 并发抓取，流式输出结果，用户体验接近实时
3. 本地化精准：强制要求非英语查询必须配置 --gl 和 --hl 参数，避免全球化搜索的语境偏差
4. 模式清晰：通过关键词信号（如 "latest/news/today"）智能引导模式选择，降低决策成本
潜在局限
- 超时硬性限制：3 秒/页的超时可能导致大型页面或慢速站点内容获取失败（此时回退到搜索摘要）
- 结果数量固定：无法灵活调整返回条数，深度研究场景可能需要人工筛选
- API 依赖：需配置 Serper API key，存在外部服务可用性与成本考量
- 内容提取边界：trafilatura 对某些动态渲染页面或复杂版式网站的提取效果可能不佳
适合人群
- 需要快速获取网页全文的研究者、分析师、内容创作者
- 处理多语言搜索需求的用户（文档对本地化配置要求严格且合理）
- 新闻追踪、竞品监控、技术调研等时效敏感场景
常规风险
- API 密钥泄露：
.env存储方式需确保文件权限与版本控制隔离 - 内容版权：自动提取全文可能涉及版权内容的使用边界
- 信息时效性：
default模式不保证内容新旧，需严格按信号选择current模式 - 过度调用：文档反复强调的查询纪律暗示存在滥用风险，需遵守最多两次调用的硬性约束