google-shopping

🛍️ Google Shopping API：商品、価格、お買い得情報をクリーンな JSON で取得

Google Shopping API を効率的かつ確実に、開発者に使いやすい形で利用する方法です。

Actor ページ： apify.com/johnvc/google-shopping-api-google-shopping-products-prices-deals 入力スキーマ： apify.com/johnvc/google-shopping-api-google-shopping-products-prices-deals/input-schema

Google Shopping API は、検索クエリに対する Google Shopping の商品一覧を、タイトル、販売元、現在の価格と通常価格、評価、レビュー数、セールタグ、配送条件、商品 ID を含む、クリーンで構造化された JSON として返します。価格帯、並び順、送料無料、セール中かどうかで絞り込み、国、言語、Google ドメインに合わせてローカライズできます。価格比較、お買い得情報の追跡、競合の監視、AI エージェントのワークフロー向けに構築されています。

動画による解説

クイックスタート

前提条件

• Python 3.11 以降
• Apify アカウントと API キー（こちらから無料キーを取得）

1. リポジトリをクローンする

   git clone https://github.com/johnisanerd/Apify-Google-Shopping-API.git
   cd Apify-Google-Shopping-API
   

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 google-shopping-api-example.py
   

別の方法：API キーを直接設定する

export APIFY_API_TOKEN="your_api_key_here"
uv run python google-shopping-api-example.py

Google Shopping API を使う理由

販売元をまたいだ価格。 クエリに対して Google Shopping が表示する商品を取得できます。各商品には販売元、現在の価格、割引がある場合は通常価格が含まれます。

お買い得情報を示す組み込みシグナル。 セールタグ（例：16% OFF）、通常価格、セール中の商品を絞り込む機能により、お買い得情報を簡単に追跡できます。

評価と配送情報。 各商品には評価、レビュー数、配送条件が含まれるため、価格以外の基準でも順位付けできます。

柔軟な絞り込み。 min_price と max_price で絞り込み、価格順に並べ替え、送料無料またはセール中の商品に限定できます。

ローカライズ対応。 location、国（gl）、言語（hl）、Google ドメインで対象を指定し、デスクトップ、タブレット、モバイルをエミュレートできます。

予測しやすい従量課金制。 課金は処理したページ単位（各ページ約 40 商品）で、実行ごとの料金は少額です。

機能

主な機能

• 価格帯、並び順、送料無料、セール中の商品で絞り込める商品検索
• 商品ごとの販売元、現在の価格と通常価格、セールタグ
• 評価、レビュー数、配送条件
• 地域、国、言語、Google ドメインによるローカライズ
• 設定可能なページ上限を備えたページネーション

データ品質

• ページごとに 1 件のアイテムを返し、それぞれに shopping_results 配列を含みます
• 書式付きの price と数値形式の extracted_price
• 商品が割引中の場合のセール関連フィールド（old_price、tag）
• ページごとに返される、利用可能な絞り込み条件 filters

使用例

基本検索

{
  "q": "wireless headphones",
  "max_pages": 1
}

価格帯を指定し、セール中の商品を安い順に並べる

{
  "q": "4k monitor",
  "min_price": 200,
  "max_price": 500,
  "on_sale": true,
  "sort_by": 1
}

入力パラメーター

パラメーター	型	必須	デフォルト	説明
q	str	はい	-	検索する商品またはキーワード。例：wireless headphones。
location	str	いいえ	-	地理的な場所。例：Austin, Texas, United States。
gl	str	いいえ	-	国コード。例：us、uk、de。
hl	str	いいえ	-	言語コード。例：en、es。
google_domain	str	いいえ	google.com	Google のドメイン。例：google.co.uk。
device	str	いいえ	desktop	desktop、tablet、または mobile。
min_price	number	いいえ	-	この価格を上回る商品のみ。
max_price	number	いいえ	-	この価格を下回る商品のみ。
sort_by	int	いいえ	-	1 は価格の安い順、2 は価格の高い順、空欄は関連度順です。
free_shipping	bool	いいえ	false	送料無料の商品のみ。
on_sale	bool	いいえ	false	セール中または割引中の商品のみ。
max_pages	int	いいえ	1	取得するページ数（1ページあたり約40商品）。0 は無制限です。ページごとに課金されます。

出力形式

wireless headphones の実際の結果です（1ページあたり1商品。shopping_results は1商品に絞り込まれ、filters には利用可能な絞り込み条件が表示されます）。

{
  "search_parameters": { "q": "wireless headphones", "device": "desktop", "max_pages": 1 },
  "search_metadata": { "results_count": 40, "pages_processed": 1, "max_pages_set": 1, "pagination_limit_reached": true },
  "page_number": 1,
  "shopping_results": [
    {
      "position": 1,
      "title": "JLab Studio 2 Wireless Headphones",
      "product_id": "13340055750063076763",
      "source": "Target",
      "price": "$24.99",
      "extracted_price": 24.99,
      "old_price": "$30",
      "rating": 4.6,
      "reviews": 727,
      "tag": "16% OFF",
      "delivery": "Free delivery on $35+"
    }
  ],
  "filters": [ { "input_type": "link_with_icon", "options": [ "..." ] } ]
}

各ページの項目には search_parameters が含まれ、search_metadata（結果件数と処理済みページ数）が報告されます。また、shopping_results には各商品の順位、タイトル、販売元の source、書式付きおよび数値形式の価格、任意のセール情報（old_price、tag）、評価、レビュー数、配送条件、product_id がすべて表示されます。filters 配列には、Google がこの検索クエリに対して提供する絞り込み条件が返されます。

---

MCP ツールとして使用する

Google Shopping API を MCP ツールとして読み込むと、アシスタントが代わりに呼び出せるようになります。この MCP サーバーの URL には、この Actor のみが事前に読み込まれています。

https://mcp.apify.com/?tools=actors,docs,johnvc/google-shopping-api-google-shopping-products-prices-deals

ブラウザーで OAuth 認証するか、Apify API トークン（Python の例で使用するものと同じ APIFY_API_TOKEN）で認証してください。トークンは https://console.apify.com/settings/integrations で取得できます。無料の Apify アカウントは https://apify.com?fpr=9n7kx3 で作成できます。

Claude Cowork Desktop にインストールする

Cowork は、デスクトップアプリの自動化モードです。Google Shopping 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/google-shopping-api-google-shopping-products-prices-deals"
      ]
    }
  }
}

3. アプリを再起動します。Cowork が初めてツールを呼び出す際に、ブラウザーで OAuth プロンプトを完了するか、コネクターの設定に Apify API トークンを追加して OAuth をスキップします。
4. Cowork のチャットでツールが利用可能であることを確認し、Google Shopping 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/google-shopping-api-google-shopping-products-prices-deals"

ブラウザーでの OAuth の代わりにトークンを使用するには、次のようにします。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/google-shopping-api-google-shopping-products-prices-deals" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

次に claude mcp list で確認するか、セッション内で /mcp を実行します。Claude Code に Google Shopping 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/google-shopping-api-google-shopping-products-prices-deals を有効にします。
3. 任意のチャットで + → Connectors を開き、Apify をオンにします。
4. または、Add custom connector を選択して、MCP URL 全体 https://mcp.apify.com/?tools=actors,docs,johnvc/google-shopping-api-google-shopping-products-prices-deals を貼り付けます。求められた場合は OAuth を使用します。
5. Claude に Google Shopping 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/google-shopping-api-google-shopping-products-prices-deals"
    }
  }
}

2. ブラウザー OAuth ではなくトークン認証を使用する場合は、ヘッダーを追加します：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/google-shopping-api-google-shopping-products-prices-deals",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor → Settings → MCP を開き、apify サーバーが接続済みであること（緑色の点）を確認します。
4. Composer または Chat で、Cursor に Google Shopping 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/google-shopping-api-google-shopping-products-prices-deals
   • Authentication： OAuth
3. Create をクリックし、Apify との接続を承認します。
4. 会話でアプリを使用するには、チャットで + をクリックし、Developer mode を選択して、Apify を選びます。

詳しいヘルプ：https://docs.apify.com/platform/integrations/mcp

---

心を込めて作成

Google Shopping API を使用して、信頼性の高い構造化された結果により、価格比較、セール追跡、競合モニタリングを実現します。

注目のタスク

Apify Store ですぐに実行できるサンプルです。

• Google Shopping の商品を CSV にエクスポート

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

お好きな AI で、Google Shopping API に関する送信準備が整ったプロンプトを開きます。

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

最終更新日：2026.10.27