Openclaw Cn 百度搜索

封装百度智能云千帆 AI 搜索 API，以本地 HTTP 服务暴露搜索接口，接受关键词、返回数量、时间过滤和限定网站等参数，返回含标题、链接、摘要与站点名称的 JSON 结果；需配置 BAIDU_API_KEY，用 uv 安装依赖并以指定 PYTHONPATH 启动服务。

yky3489

热度 63.54

最近更新 2026-05-11 17:32:13

分类：搜索依赖：代码执行 / 第三方 API / 读写文件应用场景：研究 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add openclaw-cn

Metadata

name: 百度搜索
version: 1.0.1
description: 通过百度 AI 搜索 API 进行网页搜索，获取实时信息和搜索结果。
homepage: https://cloud.baidu.com/doc/WENXINWORKSHOP/s/2m0u2qdmd
metadata: {"clawdbot":{"emoji":"🔍","requires":{"bins":["uv"],"env":["BAIDU_API_KEY"]},"primaryEnv":"BAIDU_API_KEY","install":[{"id":"brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv via Homebrew"}]}}

🔍 百度搜索

Search the web with Baidu AI

通过百度 AI 搜索 API 进行网页搜索，获取中文互联网的实时信息。

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

访问百度智能云控制台
创建应用获取 API Key

启动服务 (推荐)

# 方法1: 直接使用 python -m uvicorn (推荐)
cd /home/node/.openclaw/workspace/skills/openclaw-cn-百度搜索
PYTHONPATH=src .venv/bin/python -m uvicorn baidu_search.main:app --host 127.0.0.1 --port 8001

# 后台运行
PYTHONPATH=src .venv/bin/python -m uvicorn baidu_search.main:app --host 127.0.0.1 --port 8001 &

快速启动 (已验证)

cd /home/node/.openclaw/workspace/skills/openclaw-cn-百度搜索
PYTHONPATH=src .venv/bin/python -m uvicorn baidu_search.main:app --host 127.0.0.1 --port 8001

⚠️ 注意：不要使用 source .venv/bin/activate (sh 环境不支持)，直接用绝对路径调用 .venv/bin/python

带时间过滤的搜索:

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 获取结果
整理并展示相关信息
可根据需要深入查看某个结果

使用场景

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

已修复问题

响应解析: 百度 API 返回数据在 references 字段而非 search_results
启动方式: 使用 PYTHONPATH=src .venv/bin/python -m uvicorn 而非直接调用 uvicorn