核心用法
bocha-web-search 是一款面向中文环境优化的联网搜索 Skill，基于博查（Bocha）Web Search API 构建。该工具专为需要获取实时信息、验证事实准确性的场景设计，能够自动从用户请求中提取搜索关键词、时间范围等参数，向博查服务器发起 API 请求，并返回结构化的搜索结果。
典型调用流程包括：解析用户问题中的核心搜索词与时间描述 → 构造 POST 请求（含 query、freshness、count 等参数）→ 接收 data.webPages.value[] 格式的结果集 → 提取标题、URL、摘要、发布日期等字段 → 按规范格式生成带编号的引用回复。
显著优点
- 时效性精准：支持
freshness参数过滤（1天/1周/1月/1年），特别适合追踪新闻动态、政策更新、市场变化等时效敏感内容 - 引用规范完善：强制要求内联编号引用 + 文末参考资料区，每个来源标注标题、链接、站点名称，满足学术与专业场景的可追溯性需求
- 中文优化：由国内团队开发，对中文搜索场景理解更深，返回结果的相关性优于通用国际搜索引擎
- 安全兼容：明确避免 shell 指令与系统级文件操作，适配 ClawHub 等沙箱环境
- MIT-0 开源协议：无版权顾虑，可自由商用与二次开发
潜在缺点与局限性
- API 依赖风险：服务稳定性完全取决于博查平台，若对方服务中断或调整定价，Skill 将失效
- 配额与成本：需自备
BOCHA_API_KEY，存在调用次数限制与费用问题（403 余额不足为常见错误码） - 结果质量波动：与所有搜索引擎类似，返回内容的权威性、时效性、完整性无法 100% 保证，仍需人工判断
- 地域覆盖：主要优化中文内容，英文及小众语言信息检索能力可能弱于 Google/Bing
适合人群
- 需要为 AI 对话注入实时数据的开发者
- 构建 RAG（检索增强生成）系统的技术团队
- 新闻、金融、法律等对信息时效性与可追溯性要求高的行业用户
- 希望替代自建爬虫、降低合规风险的中小企业
常规风险
- 隐私泄露：搜索关键词可能包含敏感信息，需确认博查平台的隐私政策与数据处理方式
- 引用陷阱：自动生成的引用若来源质量参差不齐，可能导致"幻觉"式错误信息被包装成可信引用
- API Key 管理：密钥泄露可能导致配额被盗用，建议配合环境变量与密钥轮转机制使用