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，为每条结果获取整洁、结构化的 JSON：包含原始尺寸图片的 URL 及其宽度和高度、缩略图、来源网站和域名、图片所在页面，以及 Google 参考 URL。一次传入多个查询，按国家和语言本地化，并导出数千张图片。按返回的图片数量付费，每 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 数据成本最低的方式。每张图片的固定费用为 $0.0001，也就是每 1,000 张 $0.10，无设置费，也无单次运行费用。价格大约比最便宜的主流替代方案低 10 倍。

它返回整洁、可预测的 JSON。每条结果都是包含一组稳定字段的一行，因此无需重新整理格式，即可直接加载到数据框、数据库或 AI 流水线中。

它快速且可靠。API 调用的是结构化数据服务，而不是运行缓慢、容易出问题的无头浏览器，因此运行快速且稳定。

它专为批量处理而设计。传入查询列表和每个查询的结果数量，API 会自动分页，并为每一行标注其所属查询。

它已支持 MCP。AI Agent 可以通过托管的 Apify MCP 服务发现并调用此工具，让助手一步即可获取图片结果。

功能

核心能力

• 批量搜索：单次运行可传入一个或多个查询
• 控制每个查询返回的图片数量
• 按国家（gl）和语言（hl）本地化结果
• 自动处理分页，并为每个查询的结果添加标记

数据质量

• 原始尺寸的 imageUrl，以及 imageWidth 和 imageHeight
• 带有自身尺寸信息的 thumbnailUrl，便于快速预览
• 来源网站 source、domain，以及图片所在页面的 link
• 稳定、扁平的 JSON 结构：每张图片一行，可轻松加载到任何位置

使用示例

基本示例

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

高级示例

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

输入参数

参数	类型	必填	默认值	描述
queries	list[str]	是	-	一个或多个图片搜索查询。每个查询都会单独搜索，并在输出中标注。
maxResultsPerQuery	int	否	100	每个查询返回的图片数量（最少 1 张，最多 1,000 张）。
gl	str	否	"us"	用于本地化的两字母国家代码，例如 us、gb、de。
hl	str	否	"en"	两字母界面语言代码，例如 en、es、de。

输出格式

数据集中的每一项都是一条图片结果：

{
  "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 桌面应用中安装

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

1. 打开 Claude 桌面应用，然后前往 Settings → Connectors（或前往 Settings → Developer → Edit Config，直接编辑 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-images-api"
      ]
    }
  }
}

3. 重启应用。Cowork 首次调用工具时，请在浏览器中完成 OAuth 提示，或在连接器设置中添加 Apify API 令牌以跳过 OAuth。
4. 在 Cowork 聊天中确认工具可用，然后让它运行 Google Images 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/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. 点击个人资料图标，然后前往 Settings > Apps。如果看不到 Create app 按钮，请打开 Advanced settings 并启用 Developer mode。
2. 点击 Create app 并填写表单：
   • 名称： Apify
   • MCP 服务 URL： https://mcp.apify.com/?tools=actors,docs,johnvc/google-images-api
   • 身份验证： OAuth
3. 点击 Create，并通过 Apify 授权连接。
4. 要在对话中使用该应用，请点击聊天中的 +，选择 Developer mode，然后选择 Apify。

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

---

用心打造

使用 Google Images API，通过可靠、结构化的结果为数据工作流提供支持。

精选任务

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

• 将 Google Images 结果导出为 CSV

🤖 向 AI 助手咨询此 Actor

打开一条现成的提示词，在你选择的 AI 中了解 Google Images API：

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

最后更新：2026.10.27