用途：在本地搭建并运行网络搜索，作为 Claude Code 等智能体的搜索能力，基于 Bright Data SERP API 与 unfancy-search 管线。重要限制：仅使用本地版本，不要使用托管端点。
前置条件：具备 SERP API 权限的 Bright Data 账户；Anthropic API 密钥（用于查询扩展，可选）；Docker（推荐）或 Node.js 18+ 与 pnpm。
安装步骤：git clone https://github.com/yaronbeen/unfancy-search.git，进入目录后 cp .env.example .env；在 .env 中设置 BRIGHT_DATA_API_TOKEN、BRIGHT_DATA_SERP_ZONE、ANTHROPIC_API_KEY（可选，启用 AI 查询扩展）。令牌从 brightdata.com 的 SERP API 部分获取。启动本地服务：Docker 执行 docker compose up -d，或 Node.js 执行 pnpm install 与 pnpm dev，服务运行在 http://localhost:3000。
接口：POST /api/search 提交搜索任务并返回 jobId；GET /api/search-status/{jobId} 轮询结果；POST /api/baseline 触发基线收集；GET /api/baseline-status/{id} 轮询进度。轮询建议每 3 秒一次，直到状态为 done。
参数：query（必填）；expand（默认 false，启用 Claude 查询扩展）；research（默认 false，研究模式生成 12 个子查询）；engines（默认 all）；geo（地区过滤）；count（默认 10，最多 10）；includeDomains 与 excludeDomains。模式：基础（单查询、最快、无 AI 成本）、扩展（Claude Haiku 生成 3 个子查询）、研究（12 个子查询）。
响应包含带 RRF 分数的排序 URL、域名聚类、按次费用明细、原始与唯一结果数、搜索耗时。集成方式：保持本地服务运行，由智能体使用 curl 或 fetch 请求 http://localhost:3000/api/search 并解析排序结果。
限制与排错：服务无法启动需确认 Docker 运行或 Node.js 18+；无结果检查令牌与 SERP 区域；扩展失败检查 Anthropic 密钥；响应慢可关闭 expand；端口占用可停止其他服务或修改 docker-compose.yml 端口。资料未提供更多收费、平台与效果细节。