iCIMS API：从任意 iCIMS 招聘网站获取实时职位信息

iCIMS 并未提供公开的职位信息读取 API，因此大多数团队最终需要为每个雇主编写一次性的解析器。本仓库为你展示了一条捷径：一个可运行的 Python 示例，以及针对 Apify 上 iCIMS Careers API 的 MCP 安装步骤。

将其指向一个招聘网站，即可获得结构化的职位信息：职位名称、申请编号、雇主、地点、雇佣类型、发布日期和更新日期、雇主公开的薪资信息，以及申请链接。它能够读取 iCIMS 的两种公开界面——经典的 careers-{tenant}.icims.com 门户和位于雇主自有域名上的现代 iCIMS 招聘网站——因此你无需事先了解雇主使用的是哪一种。

在此处获取免费的 Apify API 密钥：https://apify.com?fpr=9n7kx3

文字操作指南

你正在寻找的 icims api 就是这个 Actor。你只需提供一项信息——一个招聘网站，可以是 startUrls 中的 URL，也可以是 companies 中的纯公司名称——它会在抓取任何数据之前自动判断该雇主使用的是哪个 iCIMS 界面。每个活跃的职位需求都会以一行数据返回：title、id（雇主自己的需求编号）、organization、locations_derived、employment_type、date_posted、date_updated、description_text、salary_raw 和 apply_url。字段名称特意与常见的职位信息推送规范保持一致，因此这些数据行可以直接接入现有管道，无需额外的映射层。

真正节省成本的部分是 newerThan。将其设置为 7d，Actor 会在打开任何职位页面之前，根据网站自身的最后修改数据进行过滤。因此，每天轮询一个拥有 400 个开放需求的雇主，你只需为实际发生变动的少数几个页面付费。添加 includeDetails: false，你将获得一个纯粹的变更信息流：url、id、title、dates。这正是 Track New iCIMS Job Postings Every Day 配方背后的数据格式，招聘团队可以按计划运行该配方，并将结果推送到 Slack。

失败的网站不会静默处理。一个失效的租户、一个受 IP 限制的门户，或者一个实际上并非 iCIMS 的域名，都会以带有 error_code 的标记错误行返回，这样自动化任务就能区分“没有新职位”和“该雇主已离开 iCIMS”。

Related MCP server: JobDataLake MCP Server

快速开始

git clone https://github.com/johnisanerd/Apify-iCIMS-Careers-API.git
cd Apify-iCIMS-Careers-API
uv sync
cp .env.example .env

将你的 Apify 令牌粘贴到 .env 文件中，然后：

uv run icims-api-example.py

首次运行会从一个招聘网站拉取五个带有文本描述的职位，这几乎不产生费用。icims-api-example.py 中的每个输入参数都有注释，方便你根据需要扩大范围。

配方

现成的输入配置，每个都是 Apify Store 上的一个活跃页面，无需编写任何代码即可运行：

定时建议： 上述任何配方都可以设置定时运行。在 Apify Console 中打开该 Actor，点击 Schedules，然后添加每日或每周的 cron 任务。将定时任务与 newerThan: "24h" 和 includeDetails: false 结合使用，你就拥有了一个职位变更信息流，其成本仅为完整抓取的一小部分。

输入参数

输出字段

每行数据都包含 result_type，值为 job 或 error。

url、id、title、organization、organization_url、description_text、description_html、description_markdown、employment_type、locations_derived、remote_derived、date_posted、date_updated、date_validthrough、salary_raw、category、additional_fields、apply_url、latitude、longitude、tenant、source、source_type、source_surface、source_domain、source_url、scraped_at，以及在错误行中的 error_code 和 error_message。

数据集提供两种视图。Overview 是完整表格。Changes 是监控视图：url、date_updated、date_posted、title，这是你在对比不同运行结果时唯一需要的数据格式。

在 Claude Cowork Desktop 中安装

Cowork 是桌面应用的自动化模式。要为其提供 iCIMS 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/icims-careers-api"
      ]
    }
  }
}

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

4. 在 Cowork 聊天中，确认该工具可用，并要求其运行 iCIMS 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/icims-careers-api"

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

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

然后使用 claude mcp list 验证，或在会话中运行 /mcp。要求 Claude Code 调用 iCIMS 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/icims-careers-api。

3. 在任何聊天中，打开 + > Connectors 并开启 Apify。

4. 或者，选择 Add custom connector 并粘贴完整的 MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api，在提示时使用 OAuth。

5. 要求 Claude 运行 iCIMS API。

在网页上打开 Claude：https://claude.ai

在 Cursor 中安装

Cursor 从项目文件 .cursor/mcp.json 中读取 MCP 服务器。

1. 在你的项目中，创建 .cursor/mcp.json：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api"
    }
  }
}

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

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

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

4. 在 Composer 或 Chat 中，要求 Cursor 调用 iCIMS 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/icims-careers-api

   • Authentication： OAuth

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

4. 要在对话中使用该应用，请点击聊天中的 +，选择 Developer mode，然后选择 Apify。

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

常见问题解答

iCIMS 是否有官方的职位发布 API？
没有公开可注册的 API。iCIMS 仅向其客户销售集成访问权限，因此如果你需要获取非雇主的职位信息，公开的职业网站就是可用的界面。此 Actor 读取该界面，并为你提供与 API 相同的结构化字段。

它是否适用于两种类型的 iCIMS 网站？
是的。支持 icims.com 上的经典门户以及雇主自有域名上的现代 iCIMS 职业网站。Actor 会探测域名并选择正确的路径，因此你可以传入任意一种而无需考虑。

如何在不频繁请求网站的情况下抓取职位发布？
使用 newerThan。在经典门户界面上，该过滤器会在打开任何职位页面之前应用于网站自身的变更数据，因此未更改的职位永远不会被获取。添加 includeDetails: false 后，每次运行仅访问每个站点的一个页面。

我能否在自己的产品中将其用作 ATS API？
这正是大多数人的用法。你可以通过 Apify 客户端从后端调用它，或通过 n8n，或通过 MCP 从代理调用。输出字段名称遵循常见的职位推送约定，因此你已有的标准化工具通常可以直接使用。

当职业网站失效或受限时会发生什么？
你会得到一行 result_type: "error" 和 error_code（例如 tenant_not_found、ip_gated 或 not_icims），而不是运行崩溃。监控任务可以据此采取行动：雇主已离开 iCIMS，或租户已停用。

一次运行的费用是多少？
定价在 Actor 页面 上，按交付的职位行数计费，因此一次监控运行如果发现两个变更的职位，只计两行，而非完整爬取。请查看那里的实时定价，而不是相信 README 中复制的数字。

哪些字段是可靠的？
url、id、title、organization 和 date_updated 在每个职位行中都存在。薪资、类别和坐标取决于雇主发布的内容，因此可能为 null。

人们还搜索

icims api, icims ats, icims jobs, ats api, job data api, scrape job postings, applicant tracking system api, job posting api, companies that use icims, icims api documentation, icims mcp server, track new icims job postings, career site job data, job listings api

n8n 集成

可作为 n8n 社区节点使用，n8n-nodes-icims-careers-api。在 n8n 中：设置 → 社区节点 → 安装 n8n-nodes-icims-careers-api，然后可在任何工作流中使用（也可作为 AI 代理工具）。

更多

• Apify Store 上的 Actor：https://apify.com/johnvc/icims-careers-api?fpr=9n7kx3

• 免费 Apify 账户：https://apify.com?fpr=9n7kx3

• Apify Python 客户端文档：https://docs.apify.com/api/client/python/

• Apify MCP 文档：https://docs.apify.com/platform/integrations/mcp

• uv：https://docs.astral.sh/uv/

最后更新：2026.08.17