💼 Wellfound Jobs API：一个用于薪资和股权数据的初创公司职位 API

一个用于 Wellfound（原名 AngelList Talent）的初创公司职位 API。可按职位、地点和远程状态进行搜索，每个职位返回一行干净的 JSON 数据：包含完整职位描述、解析后的薪资和股权范围，以及招聘初创公司的信号，包括 Y Combinator 背景、顶级投资者和融资阶段。

Actor： https://apify.com/johnvc/wellfound-jobs-api?fpr=9n7kx3

视频演示

文字演示

此职位 API 将 Wellfound 的公开初创公司列表转化为结构化数据。你提供 roles（Wellfound 的 slug，如 software-engineer，或普通词语如 "software" 和 "pm"，系统会自动映射）以及可选的 locations，例如 san-francisco、new-york 或 london。每个角色和地点组合都会成为一次独立的搜索，API 会为你自动处理分页结果。

每一行都会返回 title、url、完整的 Markdown 格式 description，以及解析为实际数字的薪酬信息：salaryMin、salaryMax、salaryCurrency、equityMin 和 equityMax。附带的 company 对象包含 name、size、tagline、stage 以及 Wellfound 发布的徽章，因此你可以只保留远程初创公司职位、仅 YC 初创公司职位，或仅招聘中的公司。

一个具体用例：设置 remoteOnly 和 minSalary 来构建一份每周更新的远程初创公司职位列表（高于特定薪资门槛），然后启用 fetchJobDetails 来为你关心的候选列表添加福利、行业、公司网站以及地理坐标信息。

快速开始

前提条件

• Python 3.11 或更高版本

• uv 用于包管理

• Apify API 令牌。在 https://apify.com?fpr=9n7kx3 获取免费 API 密钥

git clone https://github.com/johnisanerd/Apify-Wellfound-Jobs-API.git
cd Apify-Wellfound-Jobs-API
uv sync
cp .env.example .env       # then paste your token into .env
uv run python wellfound-jobs-api-example.py

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

export APIFY_API_TOKEN="your_apify_api_token_here"
uv run python wellfound-jobs-api-example.py

为什么要使用这个 Wellfound Jobs API？

• 包含完整职位描述。 职位列表行会返回完整的职位描述，无需额外抓取。

• 薪资和股权以数字形式呈现。 Wellfound 以字符串形式发布薪酬，如 $135k - $175k * 0.05% - 0.25%。此 API 将其解析为 salaryMin、salaryMax、equityMin 和 equityMax，方便你排序和筛选。

• 可筛选的初创公司信号。 ycOnly、topInvestorsOnly、activelyHiringOnly 和 companyStage 直接来自 Wellfound 显示的徽章。

• 按实际获取的数据付费。 按每个交付的职位计费，职位描述和可选详情丰富分别收取少量费用。被你的筛选条件过滤掉的职位不收费。

功能特性

核心能力

• 按职位、地点和远程状态搜索，自动分页

• 自由文本职位输入，自动映射到真实的 Wellfound slug（"software" 映射为 software-engineer）

• 关键词包含和排除筛选，适用于标题、描述、公司和地点

• 薪资、股权、工作类型和经验筛选

• 初创公司信号筛选：Y Combinator、顶级投资者、招聘中、融资阶段

• 可选的详情丰富：福利、行业、公司网站、地理位置、结构化薪酬

• 直接粘贴任何 Wellfound 搜索 URL，使用 startUrls

数据质量

• 每个职位一行，跨运行中所有搜索线程去重

• 每个职位上线时间的 ISO 时间戳

• 如果运行没有返回结果，数据集会说明原因，而不仅仅是记录在日志中

使用示例

基本示例

run_input = {"roles": ["software-engineer"], "maxItems": 5}

远程初创公司职位

run_input = {"roles": ["software-engineer"], "remoteOnly": True, "maxItems": 25}

YC 初创公司职位，薪资超过 15 万美元

run_input = {
    "roles": ["software-engineer"],
    "ycOnly": True,
    "minSalary": 150000,
    "maxItems": 25,
}

特定城市的初创公司职位，带丰富信息

run_input = {
    "roles": ["software-engineer"],
    "locations": ["san-francisco"],
    "fetchJobDetails": True,
    "maxItems": 10,
}

输入参数

输出格式

{
  "result_type": "job",
  "id": "4353862",
  "title": "Product Manager",
  "url": "https://wellfound.com/jobs/4353862-product-manager",
  "description": "### About the role ...",
  "compensationRaw": "$130k - $200k * 0.15% - 0.25%",
  "salaryMin": 130000,
  "salaryMax": 200000,
  "salaryCurrency": "USD",
  "equityMin": 0.15,
  "equityMax": 0.25,
  "jobType": "full-time",
  "remote": false,
  "remoteKind": "ONSITE",
  "locationNames": ["San Francisco"],
  "postedAt": "2026-07-28T20:58:57+00:00",
  "company": {
    "name": "Agave API",
    "slug": "agave-api",
    "size": "SIZE_11_50",
    "tagline": "Unified API for construction software",
    "stage": "early_stage",
    "ycFunded": true,
    "topInvestors": true,
    "activelyHiring": true
  }
}

启用 fetchJobDetails 后，行还会包含 benefits、industry、companyWebsite、geo、detailSalary 和 applicantLocationRequirements。

设置定时任务

保存你的搜索任务，然后附加一个定时任务以构建历史新职位记录。有用的 cron 表达式：0 7 * * * 表示每天早上 7 点，0 6 * * 1 表示每周一。

人们还搜索了

如何通过 API 获取初创公司职位数据？ 从 Python、Apify API 或任何 MCP 客户端运行此 Actor。它返回 JSON、CSV 或 Excel 格式。

如何找到远程初创公司职位？ 将 remoteOnly 设置为 true。行中包含 remote、remoteKind 和 acceptedRemoteLocationNames。

如何找到 Y Combinator 初创公司职位？ 将 ycOnly 设置为 true，或通过 topInvestorsOnly 和 companyStage 进行筛选。

能否获取特定城市的初创公司职位？ 可以。将 roles 与 locations（如 san-francisco、new-york 或 london）结合使用。

是否包含薪资和股权？ 是的，同时提供原始文本和解析后的数值范围。

Wellfound 对求职者免费吗？ 是的。此 API 读取的是访问者看到的相同公开页面，并将其返回为结构化数据。

在 Claude Cowork Desktop 中安装

Cowork 是桌面应用的自动化模式。要为其添加 Wellfound 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/wellfound-jobs-api"
      ]
    }
  }
}

3. 重启应用。当 Cowork 首次调用该工具时，在浏览器中完成 OAuth 提示，或在连接器设置中添加你的 Apify API 令牌以跳过 OAuth。

4. 在 Cowork 聊天中，确认工具可用，并让其运行 Wellfound 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/wellfound-jobs-api"

要使用令牌而不是浏览器 OAuth：

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

然后通过 claude mcp list 验证，或在会话中运行 /mcp。让 Claude Code 调用 Wellfound 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/wellfound-jobs-api。

3. 在任何聊天中，打开 + → 连接器 并开启 Apify。

4. 或者，选择 添加自定义连接器，粘贴完整的 MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api，并在提示时使用 OAuth。

5. 让 Claude 运行 Wellfound 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/wellfound-jobs-api"
    }
  }
}

2. 如果你更喜欢令牌认证而不是浏览器 OAuth，可以添加一个 header：

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

3. 打开 Cursor → 设置 → MCP，确认 apify 服务器已连接（绿色圆点）。

4. 在 Composer 或 Chat 中，让 Cursor 调用 Wellfound Jobs API。

初次使用 Cursor？在此获取：https://cursor.com/referral?code=XQP4VBLI3NNX

在 ChatGPT 中安装

ChatGPT 通过开发者模式连接到 Apify MCP 服务器（适用于 ChatGPT Pro、Plus、Business、Enterprise 和 Education 计划）。

1. 点击您的个人资料图标，然后进入设置 > 应用。如果您没有看到创建应用按钮，请打开高级设置并启用开发者模式。

2. 点击创建应用并填写表单：

   • 名称： Apify

   • MCP 服务器 URL： https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api

   • 身份验证： OAuth

3. 点击创建并授权与 Apify 的连接。

4. 要在对话中使用该应用，请点击聊天中的 +，选择开发者模式，然后选择 Apify。

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

用心制作

使用 Wellfound Jobs API 为您的招聘、市场研究和潜在客户生成工作流程提供可靠、结构化的结果。

最后更新：2026.08.18