linkedin-jobs

💼 LinkedIn Jobs API：将职位列表转换为结构化 JSON

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

Actor 页面： apify.com/johnvc/linkedin-jobs-api 输入架构： apify.com/johnvc/linkedin-jobs-api/input-schema

按关键词、地点、资历级别和职位类型搜索 LinkedIn 上的公开职位列表，或获取特定职位发布 URL，并为每个职位返回一行整洁的 JSON 数据：职位名称、公司、地点、薪资、资历级别、雇佣类型、申请链接等。它以 API 为先进行构建，并支持 MCP，因此你可以通过 Python 调用，也可以将其作为工具交由 AI Agent 使用。

视频演示

快速开始

前置条件

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

1. 克隆代码库

   git clone https://github.com/johnisanerd/Apify-LinkedIn-Jobs-API.git
   cd Apify-LinkedIn-Jobs-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 linkedin-jobs-api-example.py
   

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

export APIFY_API_TOKEN="your_api_key_here"
uv run python linkedin-jobs-api-example.py

为什么使用这个 LinkedIn Jobs API？

输入搜索条件，输出结构化数据。 你无需接触数据采集基础设施。传入关键词和地点（或职位 URL 列表），即可获得扁平、可预测的字段，直接载入电子表格、数据库或 ATS。

精准筛选你想要的职位。 按资历级别、职位类型、远程办公、公司和发布日期缩小范围，并使用 maxJobs 限制每次搜索的结果数，避免宽泛的查询超出预算。

按职位付费。 按返回的职位数计费，不收取每次运行的设置费，因此你只需为实际交付的内容付费。

可靠且可预测。 每个职位都采用相同的字段结构；搜索结果为空时会返回清晰的错误行，而不会导致整次运行失败。

支持 MCP。 可将其作为工具供 Claude、Cursor 和其他 AI Agent 调用（请参阅下方的安装部分）。

功能

核心能力

• 按关键词、地点、国家和公司搜索 LinkedIn 上的公开职位
• 按资历级别、雇佣类型、远程办公和发布日期筛选
• 或直接通过 URL 获取特定职位发布（每次运行最多 1000 个）
• 每行均包含职位名称、公司、地点、描述、薪资和申请链接

数据质量

• 每次均为每个职位返回一行结构一致的 JSON 数据
• 每行均提供通俗易懂的 summary 字段，便于快速浏览并用于 AI
• 搜索结果为空时返回清晰的错误行，避免单个查询拖垮整个批次

使用示例

基本示例

{
  "keyword": "python developer",
  "location": "New York",
  "maxJobs": 5
}

筛选示例

{
  "keyword": "product manager",
  "location": "London",
  "experienceLevel": "mid-senior",
  "jobType": "full-time",
  "remote": true,
  "timeRange": "past-week",
  "maxJobs": 50
}

按 URL 获取特定职位

{
  "jobUrls": [
    "https://www.linkedin.com/jobs/view/4286961888"
  ]
}

输入参数

参数	类型	必填	默认值	描述
keyword	str	以下任选其一	-	要搜索的职位名称或关键词，例如 "python developer"。
location	str	以下任选其一	-	搜索地点，例如 "New York" 或 "United Kingdom"。
company	str	以下任选其一	-	按特定公司名称筛选。
jobUrls	list[str]	以下任选其一	-	特定的 LinkedIn 职位发布 URL。每次运行最多 1000 个。
country	str	否	-	用于限定搜索范围的两位国家代码，例如 "US"、"GB"。
jobType	str	否	-	full-time、part-time、contract、temporary、internship、volunteer。
experienceLevel	str	否	-	internship、entry、associate、mid-senior、director、executive。
remote	bool	否	false	仅返回远程职位。
timeRange	str	否	-	past-day、past-week、past-month。
maxJobs	int	否	25	每次搜索的职位数上限（最多 500）。用于控制成本。指定职位 URL 时会忽略此项。

请提供关键词、地点、公司或至少一个 URL。

输出格式

每个任务都以一行 JSON 的形式返回：

{
  "result_type": "job",
  "jobId": "4286961888",
  "jobUrl": "https://www.linkedin.com/jobs/view/4286961888",
  "title": "Senior Python Developer",
  "companyName": "GlossGenius",
  "companyUrl": "https://www.linkedin.com/company/glossgenius",
  "location": "New York, NY",
  "seniorityLevel": "Mid-Senior level",
  "employmentType": "Full-time",
  "jobFunction": "Engineering and Information Technology",
  "salary": "$150,000 - $190,000",
  "postedDate": "2026-06-20",
  "numApplicants": 47,
  "applyUrl": "https://www.linkedin.com/jobs/view/4286961888/apply",
  "summary": "Senior Python Developer, at GlossGenius, New York, NY, Full-time, $150,000 - $190,000"
}

当 LinkedIn 列出薪资范围或基本薪资时，才会返回 salary 字段。

---

常见问题

这会让我的 LinkedIn 或 LinkedIn Recruiter 账户面临风险吗？

不会。它只读取公开的 LinkedIn 页面，也就是任何人退出登录后都能打开的页面。它绝不会登录，也不会索要你的 Cookie：没有输入账户、密码或 li_at 会话 Cookie 的地方。它的任何操作都与你的 LinkedIn 账户、LinkedIn Recruiter 席位或 Sales Navigator 许可证无关。请求在 Apify 的服务器上运行，而不是在你的浏览器中，因此不会与你建立关联；运行期间，你可以继续使用 Recruiter。

---

在 Claude Cowork 桌面应用中安装

Cowork 是桌面应用的自动化模式。要将 LinkedIn Jobs API 作为工具提供给它，请将 Apify MCP 服务添加为连接器。

1. 打开 Claude 桌面应用，前往 设置 → 连接器（或前往 设置 → 开发者 → 编辑配置，直接编辑 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/linkedin-jobs-api"
      ]
    }
  }
}

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

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

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

然后使用 claude mcp list 验证，或在会话中运行 /mcp。让 Claude Code 调用 LinkedIn 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. 前往 设置 → 连接器 → 浏览连接器，搜索 Apify MCP server。安装它（如果出现提示，请启用或更新）。
2. 连接时，使用 Apify API 令牌进行身份验证，并启用工具 johnvc/linkedin-jobs-api。
3. 在任意聊天中，打开 + → 连接器，然后启用 Apify。
4. 也可以选择 添加自定义连接器，粘贴完整的 MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/linkedin-jobs-api，并在出现提示时使用 OAuth。
5. 让 Claude 运行 LinkedIn 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/linkedin-jobs-api"
    }
  }
}

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

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

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

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

---

用心打造

使用 LinkedIn Jobs API，以可靠、结构化的结果支持招聘、市场调研和潜在客户开发工作流。

🤖 向 AI 助手咨询此 Actor

在你选择的 AI 中打开一条关于 LinkedIn Jobs API 的现成提示词：

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

最后更新：2026.10.27