web-searchlisted

# Web Search 六个搜索引擎给 Agent 提供实时网络搜索能力。API key 从 `~/.claude/.secrets/web-search.env` 自动读取，配置好直接可用（本仓不含 key，重置电脑后需自备，见「API KEY 配置」）。每个引擎都已封装为独立 Python 脚本（stdlib only，**不装第三方 SDK**），**不再使用 `curl | python3 -c` 管道**（该写法在 curl 超时/输出非 JSON 时抛 JSONDecodeError，在 GBK 终端打印中文抛 UnicodeEncodeError，是历史报错根源）。 - **Tavily** — 英文/通用深度搜索，返回摘要+URL - **Firecrawl** — 网页抓取+结构化搜索，适合读页面、抓仓库结构 - **Firecrawl Developer Index** — 开发者专用索引（2026-08-20 上线）：7000 万+一手 artifact（公共仓库 issue/PR/README、官方文档、OpenAPI spec），语义检索，DevDex 基准 recall@10 0.63 同类最高；查 bug/找仓库/查 API 行为首选 - **知乎站内** — 知乎问答/文章，中文知识、高考复习经验首选 - **全网 (Zhihu global_search)** — 中文全网公开内容，中文语境比 Tavily 更准 - **Exa** — 语义检索 + **深度多步研究（`deep`/`deep-reasoning`）** + **结构化合成（`outputSchema` + 字段级 grounding 引用）**。后两个是现有五引擎都没有的能力：需要跨多源推理对比、或要"列出所有 X / 抽取字段"这种结构化结论时用。Exa API 用 `x-api-key` header，REST 端点 `POST https://api.exa.ai/search`，无需装 `exa-py` ## 什么时候用 - 用户要搜东西、找 GitHub 仓库、查文档、核实事实 - 当前知识可能过时或不确定 - 需要"装 skill"时先确认仓库和安装方式 - 查某个 bug 的 issue/PR、某库的 API 行为、报错信息 → **Developer Index** - 中文问题、知乎问答、高考/学习经验 → 走知乎站内或全网 - 需要跨多个来源做深度对比/研究、多步推理 → **Exa `deep`/`deep-reasoning`** - 需要把搜索结果合成结构化数据（"列出所有提到的公司""抽取每个产品的价格"）→ **Exa + `outputSchema`** - 需要快速查询（聊天/自动补全，要 <1s）→ **Exa `fast`/`instant`** **不用时的情况**：纯代码阅读/编辑/调试、已知事实的常识问答��� ## 六个引擎怎么选 | 引擎 | 擅长 | 中文 | 调用方式 | |---|---|---|---| | **Tavily** | 通用深度搜索，摘要+URL，查概念/找答案 | 一般 | `python3 scripts/tavily-search.py` | | **Firecrawl** | 抓页面、读仓库结构，返回结构化内容 | 一般 | `python3 scripts/firecrawl-search.py` | | **Firecrawl Developer*