iCIMS API: Получение актуальных вакансий с любого карьерного сайта iCIMS

iCIMS не предоставляет публичного read API для вакансий, поэтому большинство команд пишут одноразовые парсеры под каждого работодателя. Этот репозиторий показывает shortcut: рабочий пример на Python и инструкции по установке MCP для iCIMS Careers API на Apify.

Укажите карьерный сайт и получите структурированные вакансии: название, ID реквизиции, работодатель, локации, тип занятости, даты публикации и обновления, зарплату (если работодатель её публикует) и ссылку для отклика. Инструмент читает обе публичные поверхности iCIMS: классические порталы careers-{tenant}.icims.com и современные карьерные сайты iCIMS, размещённые на собственном домене работодателя, так что вам не нужно знать, какой из них использует компания.

Получите бесплатный API-ключ Apify здесь: https://apify.com?fpr=9n7kx3

Текстовое руководство

icims api, который вы ищете, — это данный Actor. Вы передаёте ему одно — карьерный сайт, либо как URL в startUrls, либо как простое название компании в 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.

Сайты, которые не работают, не остаются незамеченными. Мёртвый tenant, портал с IP-ограничением или домен, который оказался не iCIMS, возвращается как помеченная строка ошибки с error_code, так что автоматическая задача может отличить «нет новых вакансий» от «этот работодатель ушёл с iCIMS».

Related MCP server: io.github.groundtruthtools/ats-jobs-mcp

Быстрый старт

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 в качестве инструмента, добавьте MCP-сервер Apify как коннектор.

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. Добавьте MCP-сервер Apify, предварительно загруженный только с этим 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 — это инструмент командной строки. Добавьте MCP-сервер Actor одной командой:

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 Документация MCP для Claude Code: 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 читает MCP-серверы из файла проекта .cursor/mcp.json.

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 подключается к MCP-серверу Apify через режим разработчика (доступен на планах 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

FAQ

Существует ли официальный API iCIMS для вакансий? Нет публичного API, к которому можно было бы подключиться. iCIMS продаёт интеграционный доступ своим собственным клиентам, поэтому если вам нужны вакансии от работодателя, у которого вы не работаете, публичный карьерный сайт — это единственная доступная поверхность. Этот Актор считывает эту поверхность и выдаёт те же структурированные поля, которые предоставил бы API.

Работает ли он на обоих типах сайтов iCIMS? Да. Поддерживаются как классические порталы на icims.com, так и современные карьерные сайты iCIMS, размещённые на собственном домене работодателя. Актор определяет домен и выбирает правильный путь, так что вы можете передать любой из них и не задумываться.

Как парсить вакансии, не нагружая сайт? Используйте newerThan. На классическом портале фильтр применяется к данным об изменениях самого сайта до открытия страницы вакансии, поэтому неизменённая заявка никогда не загружается. Добавьте includeDetails: false, и один запуск коснётся одной страницы на сайт.

Можно ли использовать это как ATS API внутри моего продукта? Именно так большинство людей и поступают. Вызывайте его из своего бэкенда с помощью Apify client, или из n8n, или через MCP из агента. Имена выходных полей следуют общепринятым соглашениям для фидов вакансий, поэтому ваш существующий нормализатор обычно обработает их без изменений.

Что происходит, когда карьерный сайт недоступен или ограничен? Вы получаете строку с result_type: "error" и error_code, например tenant_not_found, ip_gated или not_icims, а не аварийное завершение запуска. Задача в списке наблюдения может реагировать на это: работодатель ушёл с iCIMS, или тенант был отозван.

Сколько стоит один запуск? Цены указаны на странице Актора и выставляются за каждую доставленную строку с вакансией, поэтому мониторинговый запуск, обнаруживший две изменённые вакансии, обойдётся в две строки, а не в полный обход. Проверьте актуальные цены там, а не доверяйте числу, скопированному в README.

На какие поля можно рассчитывать? url, id, title, organization и date_updated присутствуют в каждой строке с вакансией. Зарплата, категория и координаты зависят от того, что публикует работодатель, поэтому они могут быть null.

Люди также ищут

icims api, icims ats, icims jobs, ats api, job data api, парсить вакансии, api системы отслеживания кандидатов, api публикации вакансий, компании, использующие icims, документация icims api, icims mcp сервер, отслеживать новые вакансии icims, данные о вакансиях на карьерном сайте, api списка вакансий

Интеграция с n8n

Доступен как community-узел n8n: n8n-nodes-icims-careers-api. В n8n: Settings, Community Nodes, установите n8n-nodes-icims-careers-api, затем используйте в любом workflow (также работает как инструмент AI Agent).

Дополнительно

• Актор в Apify Store: https://apify.com/johnvc/icims-careers-api?fpr=9n7kx3

• Бесплатный аккаунт Apify: https://apify.com?fpr=9n7kx3

• Документация Apify Python client: 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