Remote Jobs MCP

Al conectarse al servidor público MCP de Jobicy, sus herramientas de IA pueden buscar, filtrar y recuperar de forma autónoma las últimas ofertas de empleo remoto en tiempo real.

Documentación

En esta página

Un solo endpoint para empleos remotos actuales.

La API pública de Jobs devuelve los últimos listados remotos disponibles en Jobicy. Úsala para productos de descubrimiento de empleo, herramientas de investigación, sitios web comunitarios, paneles internos y prototipos.

FORMATO

JSON limpio

Campos estructurados para el empleador, el rol, la ubicación, el tipo de empleo, la descripción y el salario.

ACCESO

Sin clave API

Comienza con una simple solicitud GET. No se requiere cuenta ni cabecera de autenticación; url devuelve el listado de Jobicy.

RESULTADOS

Hasta 200 empleos

Recupera los registros más recientes y combina filtros de ubicación, categoría y palabras clave.

GET https://jobicy.com/api/v2/remote-jobs

02 · Inicio rápido

De cero a la primera respuesta.

Comienza con el endpoint público, añade solo los filtros que necesites y conserva la URL del listado de Jobicy al mostrar un listado.

  1. Envía una solicitud GET No se requiere token ni cuenta para la API pública de Jobs.
  2. Añade filtros opcionales Usa count, geo, industry y tag.
  3. Lee el array de empleos Guarda solo lo que tu interfaz necesite y conserva la URL del listado de Jobicy.
  4. Comprueba si un listado sigue activo Envía una solicitud ligera HEAD a la URL de la vacante en Jobicy. Una respuesta HTTP 404 o 410 significa que la vacante ya no está activa.
const response = await fetch(
  "https://jobicy.com/api/v2/remote-jobs?count=10&geo=usa&industry=engineering"
);

if (!response.ok) {
  throw new Error(\`HTTP ${response.status}\`);
}

const data = await response.json();
console.log(data.jobs);

API comercial de Jobs opcional: enlaces de solicitud directa

La clave API es opcional. Sin ella, url siempre contiene la URL del listado de Jobicy y la API pública sigue siendo gratuita. Para recibir la URL original de solicitud ATS en url, crea una clave API en tu Panel de API de Jobicy y envíala con cada solicitud como Authorization: Bearer API_KEY. Se requiere un monedero: cada empleo con una URL de solicitud directa disponible cuesta $0.01 una vez por clave API. Las solicitudes repetidas para el mismo empleo y clave son gratuitas.

Solicitud comercial con clave Bearer

curl "https://jobicy.com/api/v2/remote-jobs?count=10&geo=usa&industry=engineering" \
  -H "Authorization: Bearer API_KEY" \
  -H "Accept: application/json"

03 · Parámetros de consulta

Solicita solo los listados que necesitas.

Todos los filtros son opcionales. Combínalos para reducir los resultados por cantidad, elegibilidad geográfica, categoría de empleo o palabra clave de texto.

count

Número de listados a devolver. Rango aceptado: 1–200.

Por defecto 200

geo

Slug de ubicación como usa, europe o apac.

Opcional

industry

Slug de categoría como engineering, marketing o data-science.

Opcional

tag

Búsqueda de palabras clave aplicada al contenido de empleo disponible.

Opcional

Usa slugs actuales

Carga la lista de ubicaciones y la lista de categorías antes de almacenar valores en una integración de producción.

Ejemplos de solicitudes

Búsqueda por palabra clave

Veinte empleos recientes que mencionen Python.

GET /api/v2/remote-jobs?count=20&tag=python

Filtro por país

Quince empleos recientes disponibles en Canadá.

GET /api/v2/remote-jobs?count=15&geo=canada

Categoría y ubicación

Empleos de marketing disponibles para solicitantes en EE. UU.

GET /api/v2/remote-jobs?geo=usa&industry=marketing

Éxito del cliente

Cinco oportunidades recientes de soporte al cliente.

GET /api/v2/remote-jobs?count=5&industry=supporting

04 · Campos de respuesta

Datos listos para mostrar o analizar.

Cada empleo incluye su URL de origen, empleador, elegibilidad, tipo de empleo, descripción, fecha de publicación e información salarial cuando se proporciona.

CampoTipoDescripción
identeroID único del listado en Jobicy.
urlcadenaURL del listado en Jobicy para solicitudes públicas. Con una clave Bearer válida de la API comercial de Jobs, contiene la URL original de solicitud ATS cuando está disponible; de lo contrario, sigue siendo la URL del listado de Jobicy.
jobTitlecadenaTítulo del rol.
companyNamecadenaNombre del empleador.
companyLogocadenaURL del logotipo del empleador cuando está disponible.
jobIndustryarrayEtiquetas de categoría de empleo.
jobTypearrayValores de tipo de empleo.
jobGeocadenaElegibilidad de ubicación remota.
jobLevelcadenaNivel de experiencia o antigüedad.
jobExcerptcadenaResumen breve del listado, hasta 55 caracteres.
jobDescriptioncadena HTMLDescripción completa del empleo.
pubDatefecha-horaFecha de publicación original.
salaryMin / salaryMaxnúmeroLímites salariales cuando se proporcionan.
salaryCurrencycadenaCódigo de moneda ISO.
salaryPeriodcadenaIntervalo salarial, como anual o por hora.
{
  "id": 123456,
  "url": "https://jobicy.com/jobs/example-role",
  "jobTitle": "Senior Product Designer",
  "companyName": "Example Company",
  "companyLogo": "https://example.com/logo.png",
  "jobIndustry": ["Creative & Design"],
  "jobType": ["full-time"],
  "jobGeo": "Anywhere",
  "jobLevel": "Senior",
  "jobExcerpt": "Short summary of the role",
  "jobDescription": "<p>Complete HTML job description</p>",
  "pubDate": "2026-07-30T12:00:00+00:00",
  "salaryMin": 90000,
  "salaryMax": 125000,
  "salaryCurrency": "USD",
  "salaryPeriod": "yearly"
}

Comprobación de disponibilidad de listados

Para verificar si una vacante recuperada previamente sigue activa, envía una solicitud ligera HEAD a la URL del listado de Jobicy devuelta por la API pública. Una respuesta HTTP 404 o 410 indica que la vacante ya no está activa. Para listados almacenados en caché o guardados, comprobar la disponibilidad una o dos veces por hora suele ser suficiente.

Compila y ejecuta una solicitud aquí.

Elige filtros, envía la solicitud, inspecciona la respuesta JSON y cópiala en tu flujo de trabajo de desarrollo.

GET https://jobicy.com/api/v2/remote-jobs?count=5

{
  "status": "Ready to send a request"
}

Búsqueda de empleo remoto para herramientas de IA.

El servidor MCP público permite que asistentes, agentes e IDE compatibles descubran filtros válidos y recuperen listados estructurados a través del endpoint MCP público de Jobicy.

HERRAMIENTA 01

get_jobs

Recupera empleos usando filtros opcionales count, geo, industry y tag.

HERRAMIENTA 02

get_taxonomies

Devuelve slugs actuales de ubicación o categoría antes de que una herramienta aplique filtros estrictos.

{
  "mcpServers": {
    "jobicy-jobs": {
      "url": "https://jobicy.com/mcp"
    }
  }
}

07 · Fuente RSS

Crea una fuente filtrada.

RSS funciona bien para lectores, flujos de trabajo de publicación y servicios de automatización que no necesitan una integración JSON.

URLs canónicas y heredadas

Usa /jobs/feed para nuevas integraciones. La dirección más antigua /feed/job_feed sigue disponible por compatibilidad. Consultar unas pocas veces al día suele ser suficiente y no debe superar una vez por hora.

08 · Uso justo

Crea experiencias útiles con datos de Jobicy.

La API de Jobicy está diseñada para sitios web, aplicaciones, boletines, herramientas de investigación, productos de IA y otros servicios que ayudan a los usuarios a descubrir oportunidades de trabajo remoto.

  1. Puedes usar los listados de Jobicy en tus propios productos y experiencias de usuario sin solicitar permiso individual.
  2. Mantén a Jobicy como fuente original y conserva la URL canónica del empleo de Jobicy al mostrar listados.
  3. Puedes crear tus propias interfaces, resúmenes, categorías, experiencias de búsqueda y contexto adicional alrededor de los listados.
  4. No presentes los listados de Jobicy como publicaciones de empleo originales tuyas ni elimines la atribución de fuente.
  5. Evita solicitudes excesivas a la API y almacena en caché las respuestas cuando corresponda para ofrecer una experiencia fiable para todos.
  6. No uses la API para crear redes de spam, bases de datos de empleo engañosas o servicios que afecten negativamente a empleadores o candidatos.

No se requiere aprobación para integraciones normales

La mayoría de las integraciones, incluidos portales de empleo, boletines, herramientas profesionales, asistentes de IA y aplicaciones internas, pueden usar la API pública sin un acuerdo separado. Contáctanos solo para asociaciones comerciales de alto volumen o acuerdos de datos personalizados.

Gana comisiones con tus referidos de Jobicy

Si usas listados de Jobicy en tu sitio web, aplicación, boletín u otro producto, puedes convertir las URLs originales de empleos de Jobicy en enlaces de referido y ganar una comisión cuando los usuarios que refieras realicen compras elegibles en Jobicy.

Simplemente añade tu ID de usuario de Jobicy a la URL del empleo: https://jobicy.com/jobs/example-job**?u=YOUR\_USER\_ID**

La URL del empleo sigue siendo la misma: el parámetro ?u= simplemente atribuye al usuario referido a tu cuenta.

Ganas una comisión cuando tus usuarios referidos completan compras elegibles en Jobicy.

Consulta tu ID de referido, usuarios referidos, ganancias y otros detalles de afiliado en tu cuenta de Afiliado.
Gestiona tu cuenta de afiliado →
Aprende más sobre el Programa de Afiliados de Jobicy →

09 · Integraciones

Integra o automatiza sin reconstruir todo.

Usa un widget pequeño, el plugin oficial de WordPress o una receta de automatización cuando un cliente API personalizado añadiría trabajo innecesario.

01

Envía nuevos empleos remotos a LinkedIn, X, Facebook, Telegram, Slack, Discord o WordPress.

02

Widget incrustable

Añade una interfaz de búsqueda de empleo responsive con temas claro y oscuro.

03

Plugin de WordPress ›

Muestra listados recientes de Jobicy con el shortcode [jobicy_jobs].

Ejemplo de widget

<div id="jobicy-widget"></div>
<script>
window.jobicyWidgetConfig = {
  query: "Developer",
  theme: "light",
  autoSearch: true,
  limit: 10
};
</script>
<script src="https://jobicy.com/api/prod/wg.js"></script>

10 · Preguntas frecuentes

Antes de pasar a producción.

Los principales detalles operativos para una integración estable de API pública o fuente.

¿La API de Jobs requiere una clave API?

No. El endpoint público de empleos remotos y las solicitudes de taxonomía no requieren autenticación. Una clave API Bearer solo es necesaria para el acceso a la API comercial de Jobs, que devuelve URLs de solicitud ATS directas en url cuando están disponibles.

¿Cómo recibo el enlace de solicitud original?

Envía Authorization: Bearer API_KEY con la solicitud a la API de Jobs. Con una clave activa y saldo suficiente en el monedero de la API, url devuelve la URL original de solicitud ATS. Si una vacante no tiene URL de solicitud original, url sigue siendo el listado de Jobicy y no se realiza ningún cargo.

¿Cuántos empleos puede devolver una solicitud?

El parámetro count acepta valores de 1 a 200. El endpoint devuelve los empleos coincidentes más recientes disponibles.

¿Cómo debe un cliente descubrir filtros válidos?

Usa ?get=locations y ?get=industries en lugar de depender indefinidamente de una lista codificada.

¿La descripción del empleo puede contener HTML?

Sí. Trata jobDescription como HTML y desinféctalo según las reglas de seguridad de tu aplicación.

¿Con qué frecuencia debe una integración consultar?

Unas pocas comprobaciones al día suelen ser suficientes. Las comprobaciones automatizadas no deben ejecutarse más de una vez por hora.

Ejemplos de integración en GitHub

Compila con la API de Jobs de Jobicy, fuentes RSS y MCP usando ejemplos completos para Node.js, Python, Next.js, Telegram, Discord, Slack, WordPress, n8n, Zapier, Make y agentes de IA. Ver ejemplos de la API de Jobicy en GitHub