google-jobs-per-result

💼 Google Jobs API（按结果付费）：以简洁 JSON 获取职位列表

只为获取的结果付费。以开发者友好的方式使用 Google Jobs API。

Actor 页面： apify.com/johnvc/google-jobs-scraper---pay-per-result 输入架构： apify.com/johnvc/google-jobs-scraper---pay-per-result/input-schema

此版本的 Google Jobs API 按返回结果计费，因此费用会随着你保留的职位列表数量直接变化。它会搜索 Google Jobs，并为每条职位列表返回一条简洁、结构化的 JSON 记录。每个职位都包含职位名称、公司、地点、来源平台、完整描述、解析后的元数据（发布日期、工作安排类型、福利），以及各个平台（LinkedIn、Indeed、公司网站等）的直接申请链接。内置的公司和来源筛选器可以在你付费前剔除不需要的结果。支持按地点搜索、地点半径搜索、国家和语言筛选，以及分页。

更倾向于按页付费，而不是按结果付费？请查看按页付费版本。

视频演示

快速开始

前提条件

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

1. 克隆仓库

   git clone https://github.com/johnisanerd/Apify-Google-Jobs-Pay-Per-Result.git
   cd Apify-Google-Jobs-Pay-Per-Result
   

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-jobs-pay-per-result-scraper.py
   

替代方式：直接设置 API 密钥

export APIFY_API_TOKEN="your_api_key_here"
uv run python google-jobs-pay-per-result-scraper.py

为什么使用这个 Google Jobs API？

只为结果付费。 按返回结果计费，无需订阅。你可以决定保留多少条职位列表，费用也完全取决于此。

付费前筛选。 内置的公司和职位来源筛选器（支持可选的正则表达式匹配）可以排除招聘机构、聚合平台或特定雇主，避免为不需要的结果付费。

每个职位一条完整记录。 每条职位列表都包含职位名称、公司、地点、来源、完整描述和解析后的元数据，可直接载入 ATS、仪表板或分析工作流。

直接申请链接。 每个职位都包含各个平台（LinkedIn、Indeed、公司招聘网站等）的申请选项及直接 URL。

定向搜索。 按地点、国家、语言和 Google 域名筛选，也可使用地点半径搜索来聚焦特定区域。

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

功能

核心能力

• 职位搜索，支持按地点、国家、语言和 Google 域名定向搜索
• 地点半径搜索，聚焦特定区域的结果
• 公司筛选器，排除特定雇主（单个值、列表或正则表达式）
• 职位来源筛选器，排除聚合平台等特定平台
• 分页控制，可配置页面上限
• 直接申请链接，每个职位均提供多个平台的链接

数据质量

• 每个职位一条记录，结构稳定
• 完整描述文本，以及解析后的元数据（发布日期、工作安排类型、福利）
• 申请选项，包含平台名称和直接 URL
• 每条记录均附带搜索元数据
• 统一的 JSON 结构，适用于每次查询

使用示例

基本搜索

{
  "query": "Software Engineer",
  "location": "Austin, TX",
  "num_results": 10
}

排除职位来源和某家公司，并设置本地化选项

{
  "query": "Data Scientist",
  "location": "Berlin, Germany",
  "country": "de",
  "language": "de",
  "num_results": 20,
  "via_filter_list": ["ZipRecruiter"],
  "company_filter": "Staffing Agency A"
}

输入参数

参数	类型	必填	默认值	描述
query	string	是	-	职位搜索查询，例如 Software Engineer、Data Scientist。
location	string	否	-	职位所在地（建议使用城市级别），例如 Austin, TX。留空则搜索全球范围。
country	string	否	None	国家/地区代码（ISO 3166-1 alpha-2），例如 us、de。
language	string	否	None	结果的语言代码，例如 en。
google_domain	string	否	google.com	用于搜索的 Google 域名。
num_results	integer	否	100	要返回的职位结果数上限。最低可接受值为 10。每条返回的结果都会计费。
max_pagination	integer	否	0	要获取的最大页数（每页约 10 条结果）；0 = 不限。
include_lrad	boolean	否	false	启用按位置半径筛选。
lrad_value	string	否	5	include_lrad 为 true 时的半径，单位为英里。
max_delay	integer	否	1	请求之间的延迟秒数，以避免触发速率限制。
company_filter	string	否	-	排除特定公司的职位；可填写单个名称或逗号分隔的列表。
company_filter_list	array	否	-	以列表形式排除公司；优先于 company_filter。
company_filter_regex	boolean	否	false	将公司筛选条件视为正则表达式，以便灵活匹配。
via_filter	string	否	-	排除特定来源/平台的职位；可填写单个名称或逗号分隔的列表。
via_filter_list	array	否	-	以列表形式排除来源；优先于 via_filter。
output_file	string	否	-	用于保存结果的可选文件名。

输出格式

Austin, TX 的 Software Engineer 搜索实际结果（每个职位一项；此处为便于阅读，省略了完整的 description、extensions 和 detected_extensions，并截短了 job_id）。

{
  "title": "Senior Software Engineer",
  "company_name": "Southwest Airlines",
  "location": "Austin, TX",
  "via": "Southwest Careers - Southwest Airlines",
  "apply_options": [
    {
      "title": "Southwest Careers - Southwest Airlines",
      "link": "https://careers.southwestair.com/us/en/job/R-2026-68331/Senior-Software-Engineer"
    }
  ],
  "job_id": "eyJqb2JfdGl0bGUiOiJTZW5pb3IgU29mdHdhcmUgRW5naW5lZXIiLCJjb21wYW55X25hbWUiOi...",
  "query": "Software Engineer",
  "country": "us",
  "language": "en",
  "google_domain": "google.com",
  "search_timestamp": "2026-05-29T11:21:31",
  "total_jobs_found": 10,
  "pages_processed": 1
}

每条职位记录还包含完整的 description 文本、包含原始标签（例如 Full-time）的 extensions 数组、包含已解析字段（例如发布日期和工作安排类型）的 detected_extensions 对象，以及 share_link、source_link 和 job_title。

---

用作 MCP 工具

你可以将 Google Jobs API 加载为 MCP 工具，让助手代你调用它。MCP 服务 URL 预加载的仅有这个 Actor：

https://mcp.apify.com/?tools=actors,docs,johnvc/google-jobs-scraper---pay-per-result

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

在 Claude Cowork Desktop 中安装

Cowork 是桌面应用的自动化模式。若要将 Google Jobs 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-jobs-scraper---pay-per-result"
      ]
    }
  }
}

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

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

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/google-jobs-scraper---pay-per-result" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

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

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

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/google-jobs-scraper---pay-per-result",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. 打开 Cursor → Settings → MCP，确认 apify 服务已连接（显示绿点）。
4. 在 Composer 或 Chat 中，让 Cursor 调用 Google Jobs 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-jobs-scraper---pay-per-result
   • Authentication： OAuth
3. 点击 Create，并通过 Apify 授权连接。
4. 如需在对话中使用此应用，请点击聊天中的 +，选择 Developer mode，然后选择 Apify。

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

---

用心打造

使用 Google Jobs API，为招聘工具、市场研究和分析提供可靠、结构化的结果。

精选任务

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

• 将 Google Jobs 职位列表导出为 CSV

🤖 向 AI 助手咨询此 Actor

在你选择的 AI 中打开一条关于 Google Jobs Scraper API 的即用提示词：

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

最后更新：2026.10.27