google-images

🖼️ Google Images API：高速・低コストで、画像を一括検索して整形済み JSON を返します

Google Images API を利用する、最も効率的で信頼性が高く、開発者に使いやすい方法です。

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

Google Images を一括検索し、各結果について、幅と高さを含むフルサイズ画像の URL、サムネイル、ソースのサイトとドメイン、画像が表示されているページ、Google の参照 URL を含む、整形済みの構造化 JSON を取得できます。一度に複数のクエリを渡し、国と言語を指定して、数千件の画像をエクスポートできます。料金は取得した画像1件ごとに発生し、1,000件あたり $0.10 からご利用いただけます。

動画での解説

クイックスタート

前提条件

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

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

   git clone https://github.com/johnisanerd/Google-Images-API.git
   cd Google-Images-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-images-api-example.py
   

代替方法：API キーを直接設定する

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

この Google Images API を使う理由

Google Images のデータを最も低コストで取得できます。セットアップ料金や実行ごとの料金はなく、画像1件あたり一律 $0.0001、つまり1,000件あたり $0.10 です。これは、主要な代替サービスの最安料金のおよそ10分の1です。

整形済みで予測可能な JSON が返されます。各結果は、安定したフィールドセットを持つ1行のデータなので、形を整え直さずにデータフレーム、データベース、AI パイプラインへ直接読み込めます。

高速で信頼性があります。低速で壊れやすいヘッドレスブラウザーを操作するのではなく、構造化データサービスに接続するため、実行を迅速かつ安定して完了できます。

一括処理向けに設計されています。クエリのリストとクエリごとの結果数を渡すと、API がページネーションを処理し、各行にその行の取得元クエリをタグ付けします。

MCP に対応しています。AI エージェントは、ホストされた Apify MCP サーバーを通じてツールとして検出し、呼び出せるため、アシスタントは1回の手順で画像検索結果を取得できます。

機能

主な機能

• 一括検索：1回の実行で1つ以上のクエリを渡せます
• クエリごとに返す画像数を指定できます
• 国（gl）と言語（hl）で検索結果を地域化できます
• ページネーションは自動で処理され、クエリごとに結果へタグが付けられます

データ品質

• フルサイズの imageUrl と imageWidth、imageHeight
• 高速なプレビュー用に、独自の寸法情報を持つ thumbnailUrl
• ソースのサイトを示す source、domain、ホスティングページへの link
• 安定したフラットな JSON 形式：画像ごとに1行で、どこにでも簡単に読み込めます

使用例

基本的な例

{
  "queries": ["golden retriever puppy"],
  "maxResultsPerQuery": 10
}

高度な例

{
  "queries": ["golden retriever puppy", "eiffel tower at night"],
  "maxResultsPerQuery": 100,
  "gl": "us",
  "hl": "en"
}

入力パラメーター

パラメーター	型	必須	デフォルト	説明
queries	list[str]	はい	-	1つ以上の画像検索クエリです。それぞれ個別に検索され、出力でタグ付けされます。
maxResultsPerQuery	int	いいえ	100	クエリごとに返す画像数です（最小1、最大1000）。
gl	str	いいえ	"us"	地域化に使用する2文字の国コードです。例：us、gb、de。
hl	str	いいえ	"en"	インターフェース言語を指定する2文字のコードです。例：en、es、de。

出力形式

データセット内の各項目は、1件の画像検索結果です。

{
  "query": "golden retriever puppy",
  "position": 1,
  "title": "Golden Retriever Puppy",
  "imageUrl": "https://images.example.com/products/57215/golden-retriever-puppy.jpg",
  "imageWidth": 1047,
  "imageHeight": 699,
  "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9Gc...",
  "thumbnailWidth": 275,
  "thumbnailHeight": 183,
  "source": "Photowall",
  "domain": "www.photowall.com",
  "link": "https://www.photowall.com/us/golden-retriever-puppy-wallpaper",
  "googleUrl": "https://www.google.com/imgres?imgurl=..."
}

---

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

Cowork はデスクトップアプリの自動化モードです。Google Images API をツールとして使えるようにするには、Apify MCP サーバーをコネクターとして追加します。

1. Claude デスクトップアプリを開き、Settings → Connectors に移動します（または、claude_desktop_config.json を直接編集するには Settings → Developer → Edit Config に移動します）。
   • 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-images-api"
      ]
    }
  }
}

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

ブラウザーの OAuth の代わりにトークンを使う場合：

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

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

2. ブラウザーの OAuth の代わりにトークン認証を使う場合は、ヘッダーを追加します。

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

3. Cursor → Settings → MCP を開き、apify サーバーが接続されていること（緑色の点）を確認します。
4. Composer または Chat で、Cursor に Google Images API の呼び出しを依頼します。

Cursor を初めてお使いですか？こちらから入手してください：https://cursor.com/referral?code=XQP4VBLI3NNX

---

ChatGPT にインストールする

ChatGPT は開発者モードを通じて Apify MCP サーバーに接続します（ChatGPT Pro、Plus、Business、Enterprise、Education プランで利用できます）。

1. プロフィールアイコンをクリックし、設定 > アプリに移動します。アプリを作成ボタンが表示されない場合は、詳細設定を開いて開発者モードを有効にします。
2. アプリを作成をクリックし、フォームに入力します。
   • 名前： Apify
   • MCP サーバー URL： https://mcp.apify.com/?tools=actors,docs,johnvc/google-images-api
   • 認証： OAuth
3. 作成をクリックし、Apify との接続を認証します。
4. 会話でアプリを使用するには、チャットで**＋**をクリックし、開発者モードを選択して、Apifyを選びます。

詳しくはこちら：https://docs.apify.com/platform/integrations/mcp

---

心を込めて作成

信頼性の高い構造化された結果を活用し、Google Images API でデータワークフローを強化しましょう。

注目のタスク

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

• Google Images の検索結果を CSV にエクスポート

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

お好みの AI で Google Images API についてすぐに送信できるプロンプトを開きます。

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

最終更新日：2026.10.27