📦 Official Baidu Search — 官方 Baidu 搜索

🔍 百度搜索 V2 使用 Baidu AI（V2 API）搜索网页，获取中文互联网实时信息。 ⚠️ 本版本为魔改版，适配千帆 V2 API。V2 API 使用 IAM 认证，与旧版 API Key 不兼容。

Setup cd {baseDir} echo "BAIDU_API_KEY=your-api-key" > .env uv venv && uv pip install -e ".[dev]" uv run --env-file .env uvicorn baidu_search.main:app --host 127.0.0.1 --port 8001

需在 .env 或环境变量中设置 BAIDU_API_KEY。

获取 API Key（V2 版本） ⚠️ V2 API 与旧版 API Key 不兼容，请使用千帆 V2 控制台创建的应用。

• 访问百度千帆 V2 控制台（/v2/ 路径）
• 点击「创建应用」，填写应用名称
• 在应用详情页获取 API Key（格式如 bce-v3/ALTAK-xxx/签名）
• 写入 .env：BAIDU_API_KEY=bce-v3/ALTAK-xxx/你的签名

Quick Start 检查服务： curl http://127.0.0.1:8001/ping

搜索网页： curl -X POST http://127.0.0.1:8001/search \ -H "Content-Type: application/json" \ -d '{ "query": "北京有哪些旅游景区", "top_k": 10 }'

带时间过滤： curl -X POST http://127.0.0.1:8001/search \ -H "Content-Type: application/json" \ -d '{ "query": "最新科技新闻", "top_k": 5, "recency_filter": "week" }'

限定网站： curl -X POST http://127.0.0.1:8001/search \ -H "Content-Type: application/json" \ -d '{ "query": "天气预报", "top_k": 5, "site_filter": ["www.weather.com.cn"] }'

API 参数 query string 必填 搜索关键词 top_k int 10 返回数量 (1-20) recency_filter string null 时间过滤：day/week/month/year site_filter list null 限定网站列表

Response Format { "results": [ { "title": "北京十大必去景点", "url": "https://example.com/beijing-attractions", "snippet": "北京作为中国的首都，拥有众多著名景点...", "site_name": "旅游网" } ], "total": 10 }

Conversation Flow

• 用户提问需搜索内容
• 判断是否需要时间过滤
• 调用搜索 API
• 整理展示结果
• 可深入查看某条结果

使用场景

• 查询实时信息（新闻、天气、股票等）
• 搜索中文互联网内容
• 获取特定网站信息
• 时效性要求高的查询