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（百度）は、任意のキーワードで Baidu 検索を実行し、クリーンで構造化された 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 を使う理由

SERP を網羅的に取得。 1 回の呼び出しで、オーガニック検索結果、回答ボックス、関連動画、「他のユーザーも検索」、関連検索、急上昇中の人気検索を含む、Baidu の検索結果ページ全体を構造化データとして取得できます。10 件の青いリンクだけでなく、ページ全体を取得できます。

中国市場の調査向けに設計。 簡体字中国語または繁体字中国語の検索結果を指定し、デスクトップ、モバイル、タブレットを切り替え、正確な日付範囲で絞り込めます。そのため、中国語圏の市場での SEO、市場調査、ブランドモニタリングに活用できます。

予測しやすい従量課金制。 課金は実行ごとと処理したページごとで、月額料金はありません。実際に行った検索分だけ支払い、ページ数の上限でコストを直接管理できます。

クリーンで一貫性のある JSON。 すべてのレスポンスが同じ形式なので、一度結果をパースすれば、クエリをまたいでコードを再利用できます。ページごとのメタデータとページネーションの詳細により、大きな検索結果も簡単にページを切り替えて取得できます。

簡単に自動化。 Python から数行で呼び出すことも、MCP ツールとして読み込むこともできます。Claude や Cursor などのアシスタントから、必要に応じて Baidu 検索を実行できます。

機能

主な機能

• Baidu でのキーワード検索と、検索結果ページ全体の抽出
• デスクトップ、モバイル、タブレットの検索結果を対象とするデバイス指定
• すべての言語、簡体字中国語、繁体字中国語に対応した言語ローカライズ
• Unix タイムスタンプの範囲を使用した期間フィルター
• 設定可能なページ数の上限による複数ページのページネーション

データ品質

• タイトル、リンク、スニペット、順位、詳細データを含む構造化されたオーガニック検索結果
• リッチ検索結果ブロック：回答ボックス、関連動画、「他のユーザーも検索」、関連検索、人気検索
• 検索結果数とページネーションの詳細を含むページごとのメタデータ
• すべてのクエリで一貫したJSON 形式
• 大規模な検索でも料金が明確なページごとの課金

使用例

基本例

1 つのキーワードをデスクトップで検索する、1 ページのみの例です。API を試す最も安価な方法です。

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

応用例

簡体字中国語のローカライズ、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	1 ページあたりに取得する検索結果数です（最大 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 で取得でき、無料の Apify アカウントは https://apify.com?fpr=9n7kx3 で作成できます。

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 はコマンドラインツールです。1 つのコマンドで 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 は Developer mode を通じて 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

---

心を込めて作成

信頼性の高い構造化された結果を活用して、検索と SEO のワークフローを強化する Baidu API。

注目のタスク

Apify Store ですぐに実行できる例です。

• Baidu 検索結果を CSV にエクスポート

🤖 この Actor について AI アシスタントに質問する

お好きな AI で、百度 Baidu Actor に関するすぐに送信できるプロンプトを開きます。

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

最終更新日：2026.10.27