API de iCIMS: Extrae ofertas de trabajo en vivo de cualquier portal de carreras de iCIMS

iCIMS no proporciona una API pública de lectura para ofertas de trabajo, por lo que la mayoría de los equipos terminan escribiendo un parser único por empleador. Este repositorio te muestra el atajo: un ejemplo funcional en Python más los pasos de instalación de MCP para la API de carreras de iCIMS en Apify.

Apúntalo a un portal de carreras y obtén ofertas estructuradas: título, ID de requisición, empleador, ubicaciones, tipo de empleo, fechas de publicación y actualización, salario cuando el empleador lo publica y el enlace para postular. Lee ambas superficies públicas de iCIMS: los portales clásicos careers-{tenant}.icims.com y los portales modernos de carreras de iCIMS que viven en el dominio propio del empleador, así no necesitas saber cuál utiliza cada empresa.

Consigue una clave API gratuita de Apify aquí: https://apify.com?fpr=9n7kx3

Tutorial en texto

La API de iCIMS que buscas es este Actor. Le das una cosa, un portal de carreras, ya sea como URL en startUrls o como nombre simple de empresa en companies, y este determina en qué superficie de iCIMS está ese empleador antes de obtener cualquier dato. Cada requisición activa se devuelve como una fila: title, id (el número de req propio del empleador), organization, locations_derived, employment_type, date_posted, date_updated, description_text, salary_raw y apply_url. Los nombres de los campos coinciden deliberadamente con las convenciones comunes de los feeds de empleo, por lo que las filas se insertan en un pipeline existente sin necesidad de una capa de mapeo.

La parte que realmente ahorra dinero es newerThan. Ajústalo a 7d y el Actor filtra según los datos de última modificación del sitio antes de abrir cualquier página de oferta, de modo que una consulta diaria a un empleador con 400 ofertas activas te cuesta solo las que realmente cambiaron. Añade includeDetails: false y obtienes un feed de cambios puro: url, id, title, dates. Esa es exactamente la forma detrás de la receta Rastrea nuevas ofertas de iCIMS cada día, que un equipo de reclutamiento puede ejecutar en un horario y canalizar a Slack.

Los sitios que fallan no quedan en silencio. Un tenant inactivo, un portal con restricción de IP o un dominio que resulta no ser iCIMS se devuelve como una fila de error etiquetada con un error_code, de modo que un trabajo automatizado puede distinguir entre "no hay nuevas ofertas" y "este empleador ya no usa iCIMS".

Related MCP server: JobDataLake MCP Server

Inicio rápido

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

Pega tu token de Apify en .env, luego:

uv run icims-api-example.py

Esa primera ejecución extrae cinco ofertas de un portal de carreras con descripciones de texto, lo que se mantiene casi gratuito. Cada entrada en icims-api-example.py está comentada para que puedas ampliarla deliberadamente.

Recetas

Conjuntos de entrada listos para usar, cada uno es una página en vivo en Apify Store que puedes ejecutar sin escribir código:

Consejo de programación: cualquiera de estas puede ejecutarse con un temporizador. En la consola de Apify, abre el Actor, haz clic en Programaciones y añade un cron diario o semanal. Combina una programación con newerThan: "24h" y includeDetails: false y tendrás un feed de cambios de ofertas que cuesta una fracción de un rastreo completo.

Parámetros de entrada

Campos de salida

Cada fila lleva result_type, ya sea job o 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, y en filas de error error_code y error_message.

El conjunto de datos ofrece dos vistas. Resumen es la tabla completa. Cambios es la vista de monitoreo: url, date_updated, date_posted, title, que es la única forma que necesitas cuando estás comparando ejecuciones.

Instalar en Claude Cowork Desktop

Cowork es el modo de automatización de la aplicación de escritorio. Para darle la API de iCIMS como herramienta, añade el servidor MCP de Apify como conector.

1. Abre la aplicación de escritorio de Claude y ve a Configuración > Conectores (o Configuración > Desarrollador > Editar configuración para editar claude_desktop_config.json directamente).

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Añade el servidor MCP de Apify, precargado solo con este Actor:

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api"
      ]
    }
  }
}

3. Reinicia la aplicación. La primera vez que Cowork llame a la herramienta, completa el aviso de OAuth en tu navegador, o añade tu token de API de Apify en la configuración del conector para omitir OAuth.

4. En un chat de Cowork, confirma que la herramienta está disponible y pídele que ejecute la API de iCIMS.

Descarga la aplicación de escritorio y comienza una prueba gratuita: https://claude.ai/referral/uIlpa7nPLg Más ayuda: https://docs.apify.com/platform/integrations/claude-desktop

Instalar en Claude Code

Claude Code es la herramienta de línea de comandos. Añade el servidor MCP del Actor con un solo comando:

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

Para usar un token en lugar de OAuth de navegador:

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

Luego verifica con claude mcp list, o ejecuta /mcp dentro de una sesión. Pídele a Claude Code que llame a la API de iCIMS.

Prueba Claude Code gratis: https://claude.ai/referral/uIlpa7nPLg Documentación de MCP de Claude Code: https://code.claude.com/docs/en/mcp

Instalar en Claude (sitio web)

En claude.ai añades Apify como conector, luego habilitas solo la herramienta de este Actor.

1. Ve a Configuración > Conectores > Explorar conectores y busca Servidor MCP de Apify. Instálalo (habilita o actualiza si se solicita).

2. Al conectar, autentícate con tu token de API de Apify y habilita la herramienta johnvc/icims-careers-api.

3. En cualquier chat, abre + > Conectores y activa Apify.

4. Alternativamente, elige Añadir conector personalizado y pega la URL MCP completa https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api, usando OAuth cuando se solicite.

5. Pídele a Claude que ejecute la API de iCIMS.

Abre Claude en la web: https://claude.ai

Instalar en Cursor

Cursor lee los servidores MCP desde un archivo de proyecto en .cursor/mcp.json.

1. En tu proyecto, crea .cursor/mcp.json:

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

2. Si prefieres autenticación por token en lugar de OAuth de navegador, añade un encabezado:

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

3. Abre Cursor > Configuración > MCP y confirma que el servidor apify está conectado (punto verde).

4. En Composer o Chat, pídele a Cursor que llame a la API de iCIMS.

¿Nuevo en Cursor? Consíguelo aquí: https://cursor.com/referral?code=XQP4VBLI3NNX

Instalar en ChatGPT

ChatGPT se conecta al servidor MCP de Apify a través del modo Desarrollador (disponible en los planes ChatGPT Pro, Plus, Business, Enterprise y Education).

1. Haz clic en tu icono de perfil, luego ve a Configuración > Aplicaciones. Si no ves un botón Crear aplicación, abre Configuración avanzada y activa Modo desarrollador.

2. Haz clic en Crear aplicación y completa el formulario:

   • Nombre: Apify

   • URL del servidor MCP: https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api

   • Autenticación: OAuth

3. Haz clic en Crear y autoriza la conexión con Apify.

4. Para usar la aplicación en una conversación, haz clic en + en el chat, elige Modo desarrollador y selecciona Apify.

Más ayuda: https://docs.apify.com/platform/integrations/mcp

¿Existe una API oficial de iCIMS para ofertas de empleo? No hay una pública a la que puedas registrarte. iCIMS vende acceso de integración a sus propios clientes, por lo que si deseas obtener ofertas de un empleador para el que no trabajas, la página pública de carreras es la superficie que tienes disponible. Este Actor lee esa superficie y te entrega los mismos campos estructurados que una API.

¿Funciona en ambos tipos de sitio de iCIMS? Sí. Son compatibles tanto los portales clásicos en icims.com como los sitios modernos de carreras de iCIMS alojados en el dominio propio del empleador. El Actor analiza el dominio y elige la ruta correcta, por lo que puedes pasar cualquiera de los dos sin preocuparte.

¿Cómo puedo extraer ofertas de empleo sin sobrecargar el sitio? Usa newerThan. En la superficie del portal clásico, el filtro se aplica a los datos de cambio del propio sitio antes de abrir cualquier página de oferta, por lo que nunca se recupera una solicitud sin cambios. Añade includeDetails: false y una ejecución tocará una página por sitio.

¿Puedo usar esto como una API de ATS dentro de mi propio producto? Eso es lo que la mayoría de la gente hace con él. Llámalo desde tu backend con el cliente de Apify, o desde n8n, o a través de MCP desde un agente. Los nombres de los campos de salida siguen las convenciones comunes de canales de ofertas, por lo que un normalizador que ya tengas normalmente lo consumirá sin cambios.

¿Qué ocurre cuando un sitio de carreras está inactivo o restringido? Obtienes una fila con result_type: "error" y un error_code como tenant_not_found, ip_gated o not_icims, en lugar de una ejecución fallida. Un trabajo de lista de seguimiento puede actuar sobre eso: el empleador se mudó de iCIMS o el inquilino se retiró.

¿Cuánto cuesta una ejecución? Los precios están en la página del Actor y se facturan por fila de oferta entregada, por lo que una ejecución de monitoreo que encuentra dos ofertas modificadas cuesta dos filas, no un rastreo completo. Consulta los precios en vivo allí en lugar de confiar en un número copiado en un README.

¿En qué campos puedo confiar? url, id, title, organization y date_updated están presentes en cada fila de oferta. El salario, la categoría y las coordenadas dependen de lo que publique el empleador, por lo que pueden ser nulos.

La gente también busca

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

Integración con n8n

Disponible como un nodo comunitario de n8n, n8n-nodes-icims-careers-api. En n8n: Configuración, Nodos Comunitarios, instala n8n-nodes-icims-careers-api, luego úsalo en cualquier flujo de trabajo (también funciona como herramienta de Agente de IA).

Más

• Actor en la Tienda de Apify: https://apify.com/johnvc/icims-careers-api?fpr=9n7kx3

• Cuenta gratuita de Apify: https://apify.com?fpr=9n7kx3

• Documentación del cliente Python de Apify: https://docs.apify.com/api/client/python/

• Documentación de MCP de Apify: https://docs.apify.com/platform/integrations/mcp

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

Última actualización: 2026.08.17