baidu-search

name	baidu-search
description	百度联网检索。search 按关键词搜索网页返回摘要/链接；extract 阅读指定网页提取正文。 用户要搜索、查资料时用 search；要读某篇文章、看某个链接内容时用 extract。
version	1.1.0

baidu-search

百度搜索 + 网页正文提取，两个命令按需选用：

• search：按关键词联网检索，返回标题/链接/摘要/时间。用户要"搜索""查一下""找文章"时使用。
• extract：抓取指定网页并提取正文，返回标题/正文/日期/作者。用户要"读一下这篇文章""看看这个链接"时使用。search 返回的 url 可直接传给 extract。

调用

通过 run_skill_script 执行 baidu_search_cli.py。

search

使用 search 联网搜索发现关键词相关的网页

{
  "skill_name": "baidu-search",
  "script_name": "baidu_search_cli.py",
  "script_args": ["search", "关键词", "--num", "30"]
}

参数	说明
keyword	搜索关键词（位置参数）
--num N	返回条数，1~50，默认 30
--client	curl_cffi（默认，模拟 Chrome 指纹）或 requests。curl_cffi 不兼容时换 requests

search 返回结果中的 results 的 url 就是需要调用 extract 提取url正文。如果某个result对你有用，你必须使用它的 url 来调用 extract。禁止完全只通过 search 的摘要就回答用户问题。

extract

使用extract提取指定url网页的正文内容

{
  "skill_name": "baidu-search",
  "script_name": "baidu_search_cli.py",
  "script_args": ["extract", "https://example.com/article"]
}

参数	说明
url	网页 URL（位置参数），可直接传 search 返回的result中的百度跳转链接url
--max-chars N	正文最大字符数，默认 20000，传 0 不截断
--client	同 search

！！注意： 很多网站直接extract的http请求主url拿不到正文，例如有的是js动态渲染页面， 如果你当前有playwright的mcp工具，你使用浏览器来打开url， 禁止每次使用完后你主动关闭浏览器，你不需要关闭浏览器。

返回格式

stdout 输出 JSON，退出码 0 表示成功。

search 返回 results 数组，每条含 title/url/abstract/date/site/is_advertisement。url 是百度跳转链接（302 到目标页），需要真实 URL 或正文时对它调 extract。site 是来源站点（自然结果多数是真实域名如 www.langchain.com，少数是站点备案名如"腾讯云计算"；广告结果是广告主公司名）。is_advertisement=true 表示广告，应跳过。先读 abstract 和 site 判断相关性，只对确认需要的非广告链接调 extract。

extract 返回 title/content/date/author/sitename/length/truncated。truncated=true 表示正文已截断，需要更多内容时调大 --max-chars 重试。

出错应对

search 一次返回多条结果（默认 30 条），每条都带 abstract/url/site。先读 abstract 判断相关性，只对真正需要的那几条调 extract。 某一条 extract 失败很正常，不要死磕单条 url —— 先看 site 是否匹配 references/ 里的站点策略（如知乎），命中就 read_skill_resource 加载对应文档按其步骤抓；没命中就换 search 结果里下一条相关 url 继续。只有所有相关链接都失败时，才向用户说明并退回用 abstract 摘要回答。

需要区分的错误类型：

• HTTP 4xx/5xx（如"HTTP 403 访问失败: https://真实url"）：404/410 说明页面已失效，直接换下一条；403 如果这条 url 确实关键，可换 --client requests 重试一次，否则也换下一条。
• 提取失败（"提取失败: https://真实url（页面无正文）"）：页面是 JS 动态渲染或强反爬站，换下一条相关 url。
• 知乎等强反爬站：site 命中知乎时不要 extract（100% 返回 403），直接 read_skill_resource 读 zhihu-browser-access.md，按其中的 playwright 步骤抓。
• 反爬拦截（stderr 含"百度安全验证"）：这是全局拦截，换 url 也没用 —— 立即停止所有搜索/抓取，告知用户"搜索频率过高，稍后再试"。连续调用间隔 5 秒以上可预防。
• 依赖缺失（ImportError）：告知用户安装对应包（requests/beautifulsoup4/trafilatura/curl_cffi）。

其他注意：

• date 字段百度不保证提供，缺失时如实说明，不编造发布时间。
• 广告结果已用 is_advertisement=true 标记（url 含 baidu.php?url=），优先采用 is_advertisement=false 的非广告来源。

关于 references 文件夹

把特定反扒或者http请求拿不到内容的网站的url，用户需要把相关提示词写到 references 文件夹下的对应文件中。 因为有些网站反扒，有些网站是需要ajax请求具体的接口拿到正文内容，所以很多网站直接 http协议去请求主url拿不到真正的详细正文内容。