baidu-search

English | 中文

🔍 Baidu API：以简洁 JSON 获取结构化百度搜索结果

使用 Baidu API 最高效、可靠且对开发者友好的方式。

Actor 页面： apify.com/johnvc/Baidu-Search-Scraper 输入架构： apify.com/johnvc/Baidu-Search-Scraper/input-schema

Baidu API（百度）可针对任意关键词执行百度搜索，并返回简洁、结构化的 JSON。每次运行都会返回自然搜索结果（标题、链接、摘要、排名）、答案框、相关视频、“大家还在搜”建议、相关搜索和热门搜索，以及每页元数据和分页详情。它支持桌面、移动设备和平板电脑的搜索结果，简体中文和繁体中文本地化、时间范围筛选和多页分页。

视频演示

快速开始

前提条件

• Python 3.11 或更高版本
• Apify 账号和 API 密钥（在此免费获取密钥）

1. 克隆仓库

   git clone https://github.com/johnisanerd/Apify-Baidu-Search-Scraper.git
   cd Apify-Baidu-Search-Scraper
   

2. 使用 UV 安装依赖

   # Install UV if you do not have it:
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Install project dependencies:
   uv sync
   

3. 配置 API 密钥

   cp .env.example .env
   # Edit .env and add your Apify API key
   # Get your free API key at: https://apify.com?fpr=9n7kx3
   

4. 运行示例

   uv run python baidu-search-scraper.py
   

其他方式：直接设置 API 密钥

export APIFY_API_TOKEN="your_api_key_here"
uv run python baidu-search-scraper.py

为什么使用这个 Baidu API？

全面覆盖搜索结果页。 一次调用即可将完整的百度搜索结果页作为结构化数据返回：自然搜索结果、答案框、相关视频、“大家还在搜”、相关搜索和热门搜索。你获取的是整个页面，而不仅仅是十条蓝色链接。

专为中国市场研究打造。 你可以针对简体中文或繁体中文搜索结果，在桌面、移动设备和平板电脑之间切换，并按精确日期范围筛选。因此，它适用于中文市场的 SEO、市场研究和品牌监测。

价格清晰，按使用量付费。 费用按运行次数和处理的页面数计算，不收取月租。你只需为实际执行的搜索付费，并可通过页面数量上限直接控制成本。

简洁、一致的 JSON。 每个响应都采用相同的结构，因此只需解析一次结果，即可在不同查询中复用代码。每页元数据和分页详情让你可以轻松翻阅较大的结果集。

易于自动化。 只需几行 Python 代码即可调用，也可以将其加载为 MCP 工具，让 Claude 和 Cursor 等助手按需为你执行百度搜索。

功能

核心功能

• 关键词搜索：在百度上搜索并提取完整的搜索结果页
• 设备定位：获取桌面、移动设备和平板电脑的搜索结果
• 语言本地化：支持所有语言、简体中文或繁体中文
• 时间范围筛选：使用 Unix 时间戳范围筛选
• 多页分页：可配置页面数量上限

数据质量

• 结构化自然搜索结果：包含标题、链接、摘要、排名和丰富数据
• 丰富的结果区块：答案框、相关视频、“大家还在搜”、相关搜索和热门搜索
• 每页元数据：包含结果数量和分页详情
• 所有查询采用一致的 JSON 结构
• 按页计费：让大规模搜索的费用保持透明

使用示例

基本示例

针对一个关键词执行单页桌面搜索。这是体验 API 成本最低的方式。

{
  "query": "machine learning",
  "device": "desktop",
  "max_pagination": 1
}

高级示例

包含多个字段的搜索，使用简体中文本地化、每页返回更多结果，并按日期范围筛选。

{
  "query": "机器学习",
  "device": "desktop",
  "localization": 2,
  "page": 1,
  "num_results": 20,
  "time_period": "stf=1748994000,1749600000|stftype=1",
  "max_pagination": 3
}

输入参数

参数	类型	必填	默认值	说明
query	string	是	-	要在 Baidu 上查询的搜索词。
device	string	否	desktop	要模拟的设备：desktop、mobile 或 tablet。
localization	integer	否	1	语言筛选：1 = 所有语言，2 = 简体中文，3 = 繁体中文。
page	integer	否	1	结果的起始页码。
num_results	integer	否	10	每页获取的结果数（最多 50 条）。
time_period	string	否	（无）	使用 Unix 时间戳筛选日期范围，格式为 `stf=START_UNIX,END_UNIX
max_pagination	integer	否	3	最多获取的页数（0 = 不限）。
output_file	string	否	（无）	可选的结果保存文件名；若省略则自动生成。

输出格式

查询词为 machine learning 时的代表性响应。为便于阅读，此处省略了部分相关数组内容；返回的数据中，这些内容与 organic_results 的每项结构相同。

{
  "query": "machine learning",
  "device": "desktop",
  "localization": 1,
  "page": 1,
  "num_results": 10,
  "filter_results": null,
  "time_period": null,
  "max_pagination": 3,
  "total_results_found": 29,
  "pages_processed": 3,
  "search_metadata": {
    "device": "desktop",
    "localization": 1,
    "filter_results": null,
    "time_period": null,
    "max_pagination": 3,
    "pagination_limit_reached": true
  },
  "pagination_info": {
    "total_pages": 3,
    "current_page": 1,
    "max_pagination_set": 3,
    "pagination_stopped_by_limit": true
  },
  "organic_results": [
    {
      "position": 2,
      "title": "机器学习 - 百度百科",
      "link": "https://baike.baidu.com/item/机器学习/217599",
      "displayed_brand": "百度百科",
      "snippet": "机器学习是一门多领域交叉学科，涉及概率论、统计学、逼近论、凸分析、算法复杂度理论等多门学科。"
    },
    {
      "position": 6,
      "title": "MACHINE LEARNING Definition & Meaning - Merriam-Webster",
      "link": "https://www.merriam-webster.com/dictionary/machine%20learning",
      "snippet": "machine learning noun: a computational method that is a subfield of artificial intelligence and that enables a computer to learn to perform tasks by analyzing a large dataset."
    }
  ],
  "answer_box": [],
  "related_videos": [],
  "people_also_search_for": [],
  "related_searches": [],
  "top_searches": []
}

---

用作 MCP 工具

你可以将 Baidu API 加载为 MCP 工具，让助手代你调用。MCP 服务 URL 仅预加载了此 Actor：

https://mcp.apify.com/?tools=actors,docs,johnvc/Baidu-Search-Scraper

出现提示时，请在浏览器中使用 OAuth 进行身份验证，或使用你的 Apify API 令牌（与 Python 示例中使用的 APIFY_API_TOKEN 相同）。请前往 https://console.apify.com/settings/integrations 获取令牌，并在 https://apify.com?fpr=9n7kx3 免费注册 Apify 账号。

在 Claude Cowork Desktop 中安装

Cowork 是桌面应用的自动化模式。要将 Baidu API 添加为工具，请将 Apify MCP 服务添加为连接器。

1. 打开 Claude 桌面应用，前往 设置 → 连接器（或前往 设置 → 开发者 → 编辑配置，直接编辑 claude_desktop_config.json）。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. 添加仅预加载此 Actor 的 Apify MCP 服务：

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/Baidu-Search-Scraper"
      ]
    }
  }
}

3. 重启应用。Cowork 首次调用工具时，请在浏览器中完成 OAuth 提示，或在连接器设置中添加 Apify API 令牌以跳过 OAuth。
4. 在 Cowork 聊天中，确认工具可用，并让它运行 Baidu API。

下载桌面应用并开始免费试用：https://claude.ai/referral/uIlpa7nPLg 更多帮助：https://docs.apify.com/platform/integrations/claude-desktop

在 Claude Code 中安装

Claude Code 是命令行工具。使用一条命令添加 Actor 的 MCP 服务：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/Baidu-Search-Scraper"

要使用令牌而不是浏览器 OAuth：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/Baidu-Search-Scraper" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

然后使用 claude mcp list 验证，或在会话中运行 /mcp。让 Claude Code 调用 Baidu API。

免费试用 Claude Code：https://claude.ai/referral/uIlpa7nPLg Claude Code MCP 文档：https://code.claude.com/docs/en/mcp

在 Claude（网站版）中安装

在 claude.ai 上，将 Apify 添加为连接器，然后仅启用此 Actor 的工具。

1. 前往 Settings → Connectors → Browse connectors，搜索 Apify MCP server。安装它（如有提示，请启用或更新）。
2. 连接时，使用 Apify API 令牌进行身份验证，并启用工具 johnvc/Baidu-Search-Scraper。
3. 在任意聊天中，打开 + → Connectors，然后启用 Apify。
4. 或者，选择 Add custom connector，并粘贴完整的 MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/Baidu-Search-Scraper，出现提示时使用 OAuth。
5. 让 Claude 运行 Baidu API。

在网页上打开 Claude：https://claude.ai/referral/uIlpa7nPLg

在 Cursor 中安装

Cursor 会从项目文件 .cursor/mcp.json 读取 MCP 服务。

1. 在项目中创建 .cursor/mcp.json：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/Baidu-Search-Scraper"
    }
  }
}

2. 如果你更倾向于使用令牌身份验证，而不是浏览器 OAuth，请添加一个标头：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/Baidu-Search-Scraper",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. 打开 Cursor → Settings → MCP，确认 apify 服务已连接（显示绿点）。
4. 在 Composer 或 Chat 中，让 Cursor 调用 Baidu API。

刚开始使用 Cursor？在这里获取：https://cursor.com/referral?code=XQP4VBLI3NNX

在 ChatGPT 中安装

ChatGPT 通过开发者模式连接 Apify MCP 服务（ChatGPT Pro、Plus、Business、Enterprise 和 Education 套餐可用）。

1. 点击个人资料图标，然后前往 Settings > Apps。如果看不到 Create app 按钮，请打开 Advanced settings 并启用 Developer mode。
2. 点击 Create app 并填写表单：
   • Name： Apify
   • MCP Server URL： https://mcp.apify.com/?tools=actors,docs,johnvc/Baidu-Search-Scraper
   • Authentication： OAuth
3. 点击 Create，并授权与 Apify 的连接。
4. 如要在对话中使用此应用，请点击聊天中的 +，选择 Developer mode，然后选择 Apify。

更多帮助：https://docs.apify.com/platform/integrations/mcp

---

用心打造

使用 Baidu API，以可靠、结构化的结果为搜索和 SEO 工作流提供支持。

精选任务

Apify Store 中可直接运行的示例。

• 将 Baidu 搜索结果导出为 CSV

🤖 向 AI 助手咨询此 Actor

在你选择的 AI 中打开一条关于百度 Baidu Actor 的即发提示词：

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

最后更新：2026.10.27