百度搜索能做什么

百度搜索能根据问题查找实时信息，并返回网页标题、来源网站、链接、摘要及网页日期。把它接入 AI 助手后，助手可以用搜索结果补充回答，你也能顺着链接核对原文。它适合查近期新闻与活动、搜集学习和写作资料，或为旅行规划寻找公开信息。

除网页外，百度搜索的标准版 API 还支持配置图片、视频等结果类型。你也可以按需要指定返回数量、限定网站或筛选网页发布时间。具体可用能力与所选版本、接入方式有关；具体参数见百度搜索 API 文档的“请求参数”。

可以通过哪些方式接入

百度搜索提供 Skill、MCP 和 API 接入。选择与你使用的工具相符的一种方式即可：

Skill 是把搜索能力安装到 AI 助手中；MCP 是让 AI 工具连接搜索服务；API 适合直接发起请求。下文的 Skill 参数和脚本示例以本次提供的 baidu-search 压缩包为准；不同 AI 工具的导入界面和 MCP 配置格式可能不同。

所有方式共用的准备工作

不论选择哪种方式，都先准备百度智能云账号和千帆 API Key，并了解免费额度与计费规则。

1. 确认账号与搜索资源

登录百度智能云，在资源额度确认百度 AI 搜索资源状态。已实名用户进入千帆 Agent 开发平台时，平台会按用户协议自动开通专享资源；

未实名用户需要先在账号管理完成实名认证，再到资源额度页面开通后付费。

2. 获取 API Key

打开千帆 API Key 管理控制台，创建并复制 API Key。后面安装 Skill、连接 MCP 或调用 API 时，都需要用它完成鉴权。妥善保存 Key，不要放进公开聊天、截图或共享文件；怀疑泄露时，可在控制台删除旧 Key。

3. 了解额度与费用

百度搜索每月提供 1,500 次免费调用，按天发放约 50 次，调用时优先抵扣免费资源。开通后付费后，免费额度之外的调用可能产生费用；如果额度用完且未开通后付费，请求会返回额度不足。工具调试也是一次真实调用，可能消耗额度或产生费用。

方式一：直接调用 API

如果你在开发自己的应用，或想先确认 Key 与搜索资源可用，可直接调用百度搜索 API。接口为 POST https://qianfan.baidubce.com/v2/ai_search/web_search，请求体是 JSON，鉴权头为 Authorization: Bearer <API Key>。

最简网页搜索示例（将占位文字换成自己的 Key）：

1curl --location 'https://qianfan.baidubce.com/v2/ai_search/web_search' \
2  --header 'Authorization: Bearer <你的百度API_Key>' \
3  --header 'Content-Type: application/json' \
4  --data '{
5    "messages": [{"role": "user", "content": "北京有哪些旅游景区"}],
6    "search_source": "baidu_search_v2",
7    "edition": "standard",
8    "resource_type_filter": [{"type": "web", "top_k": 5}]
9  }'

请求成功后，可在返回的 references 中查看每条结果的 title、website、url、snippet、date 等字段。API 默认版本为标准版。标准版支持配置网页、视频、图片等结果类型；例如 resource_type_filter 可指定 web、video、image 及相应的 top_k。按网页发布时间筛选时，可使用 search_recency_filter 的 week、month、semiyear、year。完整参数和结果字段见百度搜索 API 文档。

千帆也提供API 在线调试平台，可查看请求和返回结果、复制示例代码。调试请求会计入真实调用。

方式二：从百度工具中心下载 Skill

这条路径是从百度工具中心取得 Skill，再导入自己所用 AI 助手的用户。

1. 打开百度搜索工具详情页，登录后下载页面提供的 Skill 压缩包。

2. 在 AI 助手中使用其“安装或导入本地 Skill”功能，选择下载的压缩包，或先解压再选择 Skill 目录。具体入口由所用工具决定。
3. 将上文获取的 API Key 配置为该 Skill 使用的环境变量 BAIDU_API_KEY。变量名填 BAIDU_API_KEY，变量值填你的 Key。
4. 重新加载或重启 AI 助手，再用下文的 验证问题 试一次。

如果你使用 OpenClaw，也可以把下载的包解压到当前工作空间的 skills/baidu-search 目录（默认工作空间路径为 ~/.openclaw/workspace/skills/），确认该目录下能直接看到 SKILL.md。然后按 方式四的第 4、5 步 配置 API Key 并重启网关。这样无需再从 ClawHub 安装一次。

解压 baidu-search Skill 后，目录中包含 SKILL.md、scripts/search.py 和 references/apikey-fetch.md。脚本使用 Python 3 与 requests 模块；如果工具提示缺少运行环境，检查这两项。该 Skill 接收以下参数：

如果你的工具允许直接运行 Skill 脚本，也可在解压后的 Skill 目录执行一次本地验证。下面是压缩包提供的调用形式；运行会发起真实请求：

1python3 scripts/search.py '{"query":"北京有哪些旅游景区","count":5}'

方式三：连接 MCP

百度搜索支持 Streamable HTTP 形式的 MCP 接入，使用百度千帆 API Key 鉴权，并提供 webSearch 工具。MCP 适合使用带有“添加 MCP 服务器”功能的 AI 工具、希望直接在对话中调用搜索的用户。

1. 登录百度搜索工具详情页，找到 MCP 的 Streamable HTTP 配置，复制页面给出的服务地址或配置内容。

2. 在 AI 工具里打开 MCP 服务器管理，新增远程服务器，传输方式选择 Streamable HTTP，填入上一步复制的地址。
3. 按工具的界面添加鉴权信息：

1Authorization: Bearer <你的百度千帆 API Key>

4. 保存并连接，确认工具列表出现 webSearch，再用下文的 验证问题 测试。

webSearch 的必填参数是 query；可选参数有 count（默认 10，范围 1～50）和 freshness（过去 24 小时、7 天、31 天、365 天，或自定义日期区间）。搜索词应简洁明确；复杂问题可拆成多个查询。输入最长按 72 个字符处理，一个汉字占两个字符，超出部分只检索前 72 个字符。

例如，希望查询过去 7 天的相关网页时，可以让支持 MCP 的工具向 webSearch 传入以下参数；这只是工具参数，不是 MCP 服务器的连接配置：

1{"query":"北京周末展览","count":5,"freshness":"pw"}

MCP 服务地址请以百度搜索工具详情页展示的为准。API 接口地址 https://qianfan.baidubce.com/v2/ai_search/web_search 不能用于连接 MCP。

方式四：通过 ClawHub 安装 Skill

如果你使用 OpenClaw，可以通过 ClawHub 安装百度搜索 Skill。先确保已经安装 OpenClaw；如果已安装 ClawHub，可跳过第一条。

1. 安装 ClawHub，并按提示使用 GitHub 账号登录：

1npm i -g clawhub
2clawhub login

2. 搜索并安装百度搜索 Skill：

1clawhub search "baidu-search"
2clawhub install baidu-search

3. ClawHub 默认将 Skill 安装在当前 OpenClaw 工作空间的 skills 目录。安装前可核对搜索结果中的名称和发布者。
4. 在 ~/.openclaw/openclaw.json 的现有配置中合并以下内容，把占位文字替换为自己的 API Key。保留文件里的其他配置，并确认 JSON 格式正确：

1{
2  "skills": {
3    "entries": {
4      "baidu-search": {
5        "enabled": true,
6        "env": {
7          "BAIDU_API_KEY": "你的百度API_Key"
8        }
9      }
10    }
11  }
12}

5. 保存配置并重启网关，然后在 OpenClaw 对话中测试：

1openclaw gateway restart

使用其他支持 Skill 的 AI 工具时，可按方式一下载并导入 Skill；具体安装入口和配置方法以所用工具为准。

安装后如何验证

在已接入的 AI 助手中输入：

请用百度搜索查找“北京有哪些旅游景区”，列出 3 个相关网页的标题、来源网站和链接。 如果工具执行成功，并返回可打开的原网页链接，就说明基本搜索路径已打通。还可以尝试：

自然语言里的“最近 7 天”“给我 5 个结果”需要 AI 助手正确映射到工具参数；如未生效，可明确让助手调用 webSearch 并指定 freshness=pw、count=5，或在直接运行 Skill/API 时填写相应参数。

免费额度、价格与查看用量

免费资源用量可在资源额度查看；专享资源消费可到财务中心的“消费中心—账单明细”查看。预付费用量包、版本抵扣规则等详见计费说明。

常见问题

提示鉴权失败？ 检查是否使用了正确的千帆 API Key、Bearer 后是否有空格，以及 Skill 环境变量或 MCP 鉴权头是否填对。修改配置后重新加载工具；怀疑 Key 泄露时删除旧 Key。

提示额度不足或资源异常？ 到资源额度检查资源状态和剩余额度；若已开通后付费，再到财务总览确认未欠费。免费额度用完且未开通后付费时，API 会返回对应错误。

提示请求过于频繁？ 百度搜索默认限流 3 QPS。降低调用频率后重试；如有更高用量需求，可联系百度。

Skill 已安装但找不到搜索能力？ 检查 Skill 是否已在 AI 工具中启用、BAIDU_API_KEY 是否已配置，并按工具要求重新加载。如果提示脚本运行失败，还需确认 Python 3 和 requests 模块可用。