google-events

🎭 Google Events API：以纯净 JSON 搜索活动

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

Actor 页面： apify.com/johnvc/google-events-api---access-google-events-data 输入架构： apify.com/johnvc/google-events-api---access-google-events-data/input-schema

Google Events API 会根据任意查询搜索活动，并返回整洁、结构化的 JSON。每页结果都包含活动标题和描述、日期及完整的日期／时间范围、包含评分和评论的场地名称、多行地址、票务平台链接（Ticketmaster、Eventbrite、Spotify 等）、地图预览图片和链接，以及 Google 提供的筛选标签。它支持按地点调整搜索偏向、国家和语言本地化、日期和活动类型筛选，以及分页。

视频演示

快速开始

前提条件

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

1. 克隆仓库

   git clone https://github.com/johnisanerd/Apify-Google-Events-API.git
   cd Apify-Google-Events-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-events-api.py
   

其他方式：直接设置 API 密钥

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

为什么使用此 Google Events API？

完整的活动详情。 每条结果都包含标题、描述、日期、场地（含评分和评论）、地址、来自多个平台的票务链接以及地图链接，让你通过一条结构化记录获取 Google Events 显示的全部信息。

汇总的票务链接。 系统会按活动收集 Ticketmaster、Eventbrite、Spotify、AXS 和 SeatGeek 等来源的票务链接，方便展示购票选项。

本地化且可筛选。 可按地点调整搜索偏向，按国家和语言进行本地化（支持 240 多个国家／地区、200 多种语言），并使用 Google 自带的筛选标签进行筛选：日期（今天、本周、周末、本月）和活动类型（线上）。

定价透明，按使用量付费。 费用按运行次数和处理的页面数计算，无需订阅。你可以通过页面数量上限控制成本。

易于自动化。 只需几行 Python 代码即可调用，也可以将其加载为 MCP 工具，让 Claude 和 Cursor 等助手按需为你查找活动。

功能

核心能力

• 自然语言活动搜索，涵盖音乐会、会议、节庆、体育赛事、戏剧和线上活动
• 按地点调整搜索偏向，并按国家（gl）和语言（hl）进行本地化
• 通过 Google 的筛选标签筛选日期和活动类型
• 多页分页，并可配置页面数量上限

数据质量

• 结构化活动数据，包含标题、描述、日期、地址和主链接
• 从多个平台汇总票务链接
• 场地详情，包含名称、评分和评论数
• 每场活动的地图预览（图片和 Google Maps 链接）
• 每页元数据，且不同查询的 JSON 格式一致

使用示例

基本搜索

{
  "q": "concerts in New York",
  "max_pages": 1
}

本地化搜索

{
  "q": "music festivals",
  "location": "Austin, Texas, United States",
  "gl": "us",
  "hl": "en",
  "max_pages": 2
}

今天的线上活动（筛选标签）

{
  "q": "tech conferences",
  "advanced": "event_type:Virtual-Event,date:today",
  "max_pages": 1
}

advanced 参数接受 Google 的筛选标签：date:today、date:tomorrow、date:week、date:weekend、date:next_week、date:month、date:next_month 和 event_type:Virtual-Event。可以传入一个标签、以逗号分隔的字符串或数组。

输入参数

参数	类型	必填	默认值	描述
q	string	是	-	活动搜索查询，例如 concerts in New York、tech conferences this week。
location	string	否	(none)	用于调整结果排序的地理位置，例如 Austin, Texas, United States。
gl	string	否	(none)	国家/地区代码（ISO 3166-1 alpha-2，小写）。支持 240 多个。
hl	string	否	(none)	语言代码（ISO 639-1，小写）。支持 200 多种。
advanced	string or array	否	(none)	筛选标签：date:* 和 event_type:Virtual-Event。
max_pages	integer	否	1	要获取的最大页数（0 = 不限）。每页单独计费。
output_file	string	否	(none)	用于保存结果的可选文件名。

输出格式

concerts in New York 的实际结果（每页一项；为便于阅读，此处删减了活动描述、地图 URL 和日期范围标签）。

{
  "search_parameters": {
    "q": "concerts in New York",
    "location": "New York, NY",
    "gl": "us",
    "hl": "en",
    "max_pages": 1
  },
  "search_metadata": {
    "total_results": 10,
    "events_count": 10,
    "hit_chips_count": 0,
    "filters_count": 0,
    "pages_processed": 1,
    "max_pages_set": 1,
    "pagination_limit_reached": true
  },
  "search_timestamp": "2026-05-29T10:43:56",
  "page_number": 1,
  "events": [
    {
      "title": "O-Zone Concert in New York",
      "date": {
        "start_date": "May 31",
        "when": "Sun, May 31 - Mon, Jun 1"
      },
      "address": [
        "Melrose Ballroom, 36-08 33rd St",
        "Long Island City, NY"
      ],
      "link": "https://www.melroseballroom.com/events/o-zone-concert-in-new-york",
      "description": "The legendary group O-Zone is coming to the United States for the very first time.",
      "event_location_map": {
        "image": "https://www.google.com/maps/vt/data=...",
        "link": "https://www.google.com/maps/place/..."
      },
      "ticket_info": [
        { "source": "melroseballroom.com", "link": "https://www.melroseballroom.com/...", "link_type": "tickets" }
      ],
      "venue": {}
    }
  ],
  "hit_chips": [],
  "filters": []
}

---

用作 MCP 工具

你可以将 Google Events API 加载为 MCP 工具，让助手代你调用。MCP 服务 URL 会预加载且仅包含此 Actor：

https://mcp.apify.com/?tools=actors,docs,johnvc/google-events-api---access-google-events-data

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

在 Claude Cowork Desktop 中安装

Cowork 是桌面应用的自动化模式。若要将 Google Events 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-events-api---access-google-events-data"
      ]
    }
  }
}

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

若要使用令牌而非浏览器 OAuth：

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

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

2. 如果你更倾向于使用令牌身份验证，而非浏览器 OAuth，请添加一个请求头：

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

3. 打开 Cursor → Settings → MCP，确认 apify 服务已连接（绿点）。
4. 在 Composer 或 Chat 中，让 Cursor 调用 Google Events 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-events-api---access-google-events-data
   • 身份验证： OAuth
3. 点击 Create，并通过 Apify 授权连接。
4. 要在对话中使用此应用，请点击聊天中的 +，选择 Developer mode，然后选择 Apify。

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

---

用心打造

使用 Google Events API 获取可靠、结构化的结果，为活动发现、日历和市场研究提供支持。

🤖 向 AI 助手咨询此 Actor

在你选择的 AI 中打开一条关于 Google Events Actor、可直接发送的提示词：

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

最后更新：2026.10.27