Indeed Skills

indeed-skills: Habilidades de la API de ofertas de empleo de Indeed para agentes de IA

Habilidades de agente para datos en vivo de ofertas de empleo de Indeed. Tres habilidades listas para usar que brindan a Claude, ChatGPT, Cursor o cualquier bucle de agente personalizado una API de ofertas de empleo: busca listados de Indeed por palabra clave y ubicación, obtén detalles normalizados de roles y consulta salarios, descripciones, información de empresas y beneficios a través de la API REST RolesAPI. Si has estado buscando una API de Indeed o una alternativa de API de datos de Indeed que devuelva JSON limpio, esta es la forma más rápida de conectar datos de empleo a un agente de IA.

Gratis para comenzar. Obtén una clave (100 créditos al registrarte, sin necesidad de tarjeta) y estarás buscando ofertas de empleo en vivo desde tu agente en menos de dos minutos.

Biblioteca estándar de Python puro. Sin dependencias. Licencia MIT-0.

Instalación

# OpenClaw (via ClawHub)
npx clawhub@latest install indeed-full

# Hermes Agent
hermes skills install skills-sh/nikhonit/indeed-skills/skills/indeed-full

# Generic agent skills (Claude Code, Cursor, Cline)
npx skills add nikhonit/indeed-skills

Reemplaza indeed-full por indeed-search o indeed-salary para instalar una variante enfocada.

Habilidades en este repositorio

Habilidad	Qué hace	Costo en créditos
indeed-full	Kit completo: búsqueda de listados, detalles completos de roles por clave de empleo o URL pegada, salario, descripción, empresa y segmentos de beneficios, verificación de cuenta	1 crédito por llamada
indeed-search	Búsqueda ligera: listados por palabra clave y ubicación, además de ajustes predefinidos para publicados hoy, publicados esta semana y solo remoto	1 crédito por página de resultados
indeed-salary	Consultas solo de salario por clave de empleo o URL de Indeed pegada	1 crédito por consulta

Instala indeed-full para agentes que necesitan una cobertura amplia. Instala las variantes enfocadas cuando quieras una superficie de herramientas mínima.

Inicio rápido

1. Regístrate en rolesapi.com y crea una clave en rolesapi.com/app/keys. El plan gratuito incluye 100 créditos, sin necesidad de tarjeta.
2. Exporta la clave y ejecuta un script:

export ROLESAPI_KEY="rk_live_..."
python3 skills/indeed-search/scripts/search_listings.py "registered nurse" "Chicago, IL"

Salida real, recortada a uno de los 35 resultados:

{
  "data": [
    {
      "job_key": "7dcf172c8d7fc756",
      "title": "Nursing",
      "company": { "name": "Golden Healthcare Services Inc" },
      "location": "Olympia Fields, IL 60461",
      "employment_type": "Full-time",
      "salary": { "min": 30, "max": 45, "period": "hour", "currency": "USD", "source": "employer" },
      "posted_at": "2026-06-26",
      "url": "https://www.indeed.com/viewjob?jk=7dcf172c8d7fc756"
    }
  ],
  "meta": { "count": 35 },
  "request_id": "a18e4ef88ad4b00b"
}

Introduce cualquier job_key en los scripts de detalle:

python3 skills/indeed-full/scripts/get_role.py 7dcf172c8d7fc756
python3 skills/indeed-salary/scripts/get_salary.py 7dcf172c8d7fc756

Guía completa: inicio rápido de rolesapi.com.

Compatibilidad

• Claude Code / Claude Skills: coloca una carpeta de habilidad en tu directorio de habilidades y Claude la detectará desde el SKILL.md.
• ChatGPT y GPT personalizados: llama a los scripts desde un intérprete de código o envuélvelos como acciones.
• Cursor, Cline y otros agentes de codificación: los scripts son herramientas CLI simples, por lo que cualquier agente que pueda ejecutar Python puede usarlos.
• Cualquier bucle de agente: cada script es una CLI independiente sin entrada estándar que imprime JSON, fácil de invocar desde Node, Go o Rust.
• Opción sin instalación: RolesAPI ofrece un servidor MCP alojado en https://api.rolesapi.com/mcp. Apunta tu cliente MCP hacia él y omite los scripts por completo.

También hay un llms.txt (y llms-full.txt) si quieres entregar toda la superficie de la API a un modelo.

Lo que obtienes

Objetos de rol normalizados en más de 60 ediciones nacionales de Indeed: título, empresa con calificación, ubicación, tipo de empleo, salario (mínimo, máximo, moneda, período, empleador vs estimación), beneficios, descripción completa, fecha de publicación y URL canónica. Cada respuesta es un sobre de { "data": ..., "request_id": "..." }. Consulta la documentación de la API de roles, la documentación de la API de búsqueda, la documentación de la API de listados y la especificación OpenAPI.

Para trabajo masivo, la API también ofrece búsqueda asíncrona y enriquecimiento por lotes de hasta 500 publicaciones por empleo, con eventos de finalización entregados mediante webhooks firmados.

Autenticación

Establece la variable de entorno ROLESAPI_KEY con tu clave de RolesAPI (formato rk_live_...).

export ROLESAPI_KEY="rk_live_..."

Obtén una clave gratuita: 100 créditos al registrarte, sin necesidad de tarjeta. La misma clave funciona para estas habilidades, el servidor MCP alojado y las llamadas REST directas.

Precios

Plan	Precio	Créditos	Límite de velocidad
Gratuito	$0	100 (una vez al registrarte)	20/min
Mensual	$5/mes	1,000/mes	200/min
Anual	$54/año	12,000 por adelantado	300/min

Un crédito equivale a un detalle de rol o una página de resultados de búsqueda. Las llamadas fallidas no se cobran. Precios completos: rolesapi.com/pricing.

Preguntas frecuentes

¿Cómo obtengo ofertas de empleo de Indeed como JSON? Regístrate en rolesapi.com, exporta ROLESAPI_KEY y llama a GET /v1/listings?keyword=...&location=... (o ejecuta search_listings.py desde este repositorio). Obtendrás resúmenes de roles JSON normalizados con claves de empleo para llamadas de detalle posteriores.

¿Existe una API gratuita de empleos de Indeed? El plan gratuito de RolesAPI incluye 100 créditos al registrarte sin necesidad de tarjeta, suficiente para 100 búsquedas o consultas de roles. Los planes de pago comienzan en $5/mes por 1,000 créditos.

¿Cuánto cuesta? 1 crédito por detalle de rol o página de resultados de búsqueda. $5/mes por 1,000 créditos, o $54/año por 12,000. Las llamadas fallidas no se cobran.

¿Funciona fuera de los Estados Unidos? Sí. Pasa --country (por ejemplo, gb, de, in) para buscar en cualquiera de las más de 60 ediciones nacionales de Indeed.

¿Puedo obtener el salario de una publicación específica de Indeed? Sí. GET /v1/roles/{job_key}/salary devuelve mínimo, máximo, moneda, período y si la cifra provino del empleador o de una estimación. La habilidad indeed-salary envuelve exactamente esto y también acepta una URL de Indeed pegada.

¿Puede mi agente usar esto sin instalar nada? Sí. Apunta un cliente MCP al servidor alojado, https://api.rolesapi.com/mcp, y las mismas herramientas de búsqueda y roles estarán disponibles sin instalación.

¿Es esta una API oficial de Indeed? No. RolesAPI es un producto independiente. Consulta el aviso legal a continuación.

Problemas y contribuciones

Consulta CONTRIBUTING.md. Informes de seguridad: SECURITY.md.

Licencia

MIT Sin Atribución. Haz fork, publica, sublicencia. No se requiere atribución.

Aviso legal

RolesAPI es un producto independiente y no está afiliado, respaldado ni patrocinado por Indeed. Indeed es una marca comercial de su propietario.