google-ai-overview

🔎 Google AI Overview API：以 JSON 获取 Google 的 AI 回答及其来源

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

Actor 页面： apify.com/johnvc/Google-AI-Overview-API 输入架构： apify.com/johnvc/Google-AI-Overview-API/input-schema

发送任意搜索查询，即可获取 Google 的 AI Overview——显示在 Google 搜索结果顶部的 AI 生成回答——并以结构化 JSON 返回：回答文本块以及引用的来源（标题、链接、摘要和来源名称）。当 Google 延迟生成并仅返回短期有效令牌时，此 API 会自动为你解析完整回答，让你始终获得整洁、可直接使用的数据。

视频演示

快速开始

前置条件

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

1. 克隆仓库

   git clone https://github.com/johnisanerd/Apify-Google-AI-Overview-API.git
   cd Apify-Google-AI-Overview-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-ai-overview-api-example.py
   

备选方案：直接设置 API 密钥

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

为什么使用此 Google AI Overview API？

只取回答，并以结构化形式返回。 你会获得 AI Overview 内容及其引用来源的整洁 JSON，可直接放入数据库、报告或大模型工作流。无需解析 HTML。

自动处理 Google 的延迟响应。 Google 有时会立即返回 AI Overview，有时则会通过短期有效令牌延迟返回。此 API 会在一次运行中自动解析后续响应，因此你无需管理一分钟内就会过期的令牌。

支持单个或多个查询。 传入单个 query 或 queries 列表。每个查询都会返回一行结果，便于轻松进行批量查询和 GEO/AEO 监控。

只为实际获取的内容付费。 按检索次数计费：标准的内联回答需检索一次，只有在 Google 延迟响应且需要后续请求时才需检索两次。输出会准确告知使用了多少次检索。

按国家和语言定位。 选择国家（gl）和语言（hl），或进一步缩小到特定的 location。

支持 MCP。 将其作为工具加载到 Claude Cowork、Claude Code、网页端 Claude 和 Cursor 中（见下文），然后用自然语言请求 AI Overview。

功能

核心能力

• 将 AI Overview 回答作为有序的 text_blocks 返回（段落、标题、列表）
• 返回每个回答引用的 references（标题、链接、摘要、来源）
• 自动解析 Google 延迟生成的内容（基于令牌）
• 支持单个查询和批量（queries）输入，每个查询返回一行
• 支持按国家、语言和地点定位

数据质量

• 整洁、类型明确的 JSON 输出，每个查询一行，并带有稳定的 result_type 字段
• 清晰的 ai_overview_present 标记；Google 未显示概览时会提供 note
• 透明显示 retrievals_used 次数，费用绝不出乎意料

使用示例

基本示例

{
  "query": "what is the Siliconimist podcast?"
}

高级示例

{
  "queries": [
    "best practices for prompt engineering",
    "how does vector search work"
  ],
  "gl": "us",
  "hl": "en",
  "location": "Austin, Texas, United States"
}

输入参数

参数	类型	必填	默认值	描述
query	str	query / queries 二选一	-	要获取 AI Overview 的单个搜索查询。
queries	list[str]	query / queries 二选一	-	一次运行中的多个查询；每个查询返回一行结果。与 query 合并处理。
gl	str	否	us	国家代码（ISO 3166-1），例如 us、gb、ca。
hl	str	否	en	语言代码（ISO 639-1）。目前 AI Overviews 仅支持英语。
location	str	否	-	可选地点，用于缩小结果范围，例如 Austin, Texas, United States。

必须提供 query 或 queries 中的至少一项。

输出格式

每个查询占一行。每项的 result_type 为 ai_overview 或 error。下方的回答文本和来源仅作示例；你的运行会返回实时的 AI Overview 内容及其真实引用。

{
  "result_type": "ai_overview",
  "query": "what is retrieval augmented generation",
  "ai_overview_present": true,
  "used_dedicated_api": false,
  "retrievals_used": 1,
  "text_blocks": [
    {
      "type": "paragraph",
      "snippet": "<AI Overview answer paragraph for the query>"
    }
  ],
  "references": [
    {
      "title": "<cited source title>",
      "link": "https://www.example.com/source",
      "snippet": "<short snippet from the cited source>",
      "source": "Example",
      "index": 1
    }
  ],
  "gl": "us",
  "hl": "en",
  "fetched_at": "2026-05-28T08:33:58.988871+00:00"
}

当 Google 未针对某个查询显示 AI Overview 时，该行会返回 "ai_overview_present": false，并附上一条简短的 note 说明原因。

---

用作 MCP 工具

你可以将 Google AI Overview API 加载为 MCP 工具，让助手代你调用。MCP 服务 URL 会预加载这一个 Actor：

https://mcp.apify.com/?tools=actors,docs,johnvc/Google-AI-Overview-API

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

在 Claude Cowork Desktop 中安装

Cowork 是桌面应用的自动化模式。若要将 Google AI Overview 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. 添加 Apify MCP 服务，仅预加载此 Actor：

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/Google-AI-Overview-API"
      ]
    }
  }
}

3. 重启应用。Cowork 首次调用该工具时，请在浏览器中完成 OAuth 提示，或在连接器设置中添加 Apify API 令牌以跳过 OAuth。
4. 在 Cowork 聊天中确认工具已可用，然后让它运行 Google AI Overview 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-AI-Overview-API"

如需使用令牌而非浏览器 OAuth：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/Google-AI-Overview-API" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

然后运行 claude mcp list 进行验证，或在会话中运行 /mcp。让 Claude Code 调用 Google AI Overview 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-AI-Overview-API。
3. 在任意聊天中，打开 + → Connectors 并启用 Apify。
4. 或者，选择 Add custom connector 并粘贴完整的 MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/Google-AI-Overview-API，并在出现提示时使用 OAuth。
5. 让 Claude 运行 Google AI Overview 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-AI-Overview-API"
    }
  }
}

2. 如果你希望使用令牌身份验证，而非浏览器 OAuth，请添加一个标头：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/Google-AI-Overview-API",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. 打开 Cursor → Settings → MCP，确认 apify 服务已连接（绿色圆点）。
4. 在 Composer 或 Chat 中，让 Cursor 调用 Google AI Overview 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/Google-AI-Overview-API
   • Authentication： OAuth
3. 点击 Create，并通过 Apify 授权连接。
4. 若要在对话中使用该应用，请点击聊天中的 +，选择 Developer mode，然后选择 Apify。

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

---

用心打造

使用 Google AI Overview API，以可靠、结构化的结果支持 GEO/AEO 监控、研究和内容工作流。

🤖 向 AI 助手咨询此 Actor

在你选择的 AI 中打开一条可直接发送的提示词，了解 Google AI Overview API：

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

最后更新：2026.10.27