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.
- Envía una solicitud GET No se requiere token ni cuenta para la API pública de Jobs.
- Añade filtros opcionales Usa
count,geo,industryytag. - Lee el array de empleos Guarda solo lo que tu interfaz necesite y conserva la URL del listado de Jobicy.
- Comprueba si un listado sigue activo Envía una solicitud ligera
HEADa la URL de la vacante en Jobicy. Una respuesta HTTP404o410significa 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.
| Campo | Tipo | Descripción |
|---|---|---|
id | entero | ID único del listado en Jobicy. |
url | cadena | URL 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. |
jobTitle | cadena | Título del rol. |
companyName | cadena | Nombre del empleador. |
companyLogo | cadena | URL del logotipo del empleador cuando está disponible. |
jobIndustry | array | Etiquetas de categoría de empleo. |
jobType | array | Valores de tipo de empleo. |
jobGeo | cadena | Elegibilidad de ubicación remota. |
jobLevel | cadena | Nivel de experiencia o antigüedad. |
jobExcerpt | cadena | Resumen breve del listado, hasta 55 caracteres. |
jobDescription | cadena HTML | Descripción completa del empleo. |
pubDate | fecha-hora | Fecha de publicación original. |
salaryMin / salaryMax | número | Límites salariales cuando se proporcionan. |
salaryCurrency | cadena | Código de moneda ISO. |
salaryPeriod | cadena | Intervalo 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.
- Puedes usar los listados de Jobicy en tus propios productos y experiencias de usuario sin solicitar permiso individual.
- Mantén a Jobicy como fuente original y conserva la URL canónica del empleo de Jobicy al mostrar listados.
- Puedes crear tus propias interfaces, resúmenes, categorías, experiencias de búsqueda y contexto adicional alrededor de los listados.
- No presentes los listados de Jobicy como publicaciones de empleo originales tuyas ni elimines la atribución de fuente.
- Evita solicitudes excesivas a la API y almacena en caché las respuestas cuando corresponda para ofrecer una experiencia fiable para todos.
- 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