Zar Jobs AI Connector

Conector de empleo para asistentes de IA, empaquetado como plugin de Codex y basado en MCP.

AI job connector for Codex and other MCP-compatible clients.

Estado

Los hitos 0, 1, 2A, 3A, 4, 5A y 6A están completos. InfoJobs dispone de búsqueda y detalle local mediante su API oficial, Tecnoempleo admite RSS propio por URL local o XML aportado al MCP remoto y LinkedIn admite importación manual sin conectarse al portal. El servidor público es anónimo, sin estado y no persiste consultas, ofertas ni credenciales. El despliegue HTTPS y la revisión del directorio requieren cuentas y decisiones externas.

Related MCP server: RecruitData

Objetivo

Zar Jobs AI Connector permitirá que un asistente de IA:

• conozca qué capacidades están disponibles en cada portal;

• normalice enlaces de ofertas aportados por el usuario;

• busque ofertas mediante APIs oficiales cuando exista autorización;

• prepare comparaciones y siguientes pasos sin enviar candidaturas;

• mantenga siempre a la persona como responsable de la decisión final.

Portales previstos

La matriz completa y sus fuentes están en docs/PORTAL-CAPABILITIES.md.

Principios

• APIs oficiales o acceso expresamente autorizado.

• Solo lectura por defecto.

• Nunca enviar una candidatura automáticamente.

• Credenciales fuera del repositorio.

• Datos mínimos, trazabilidad de la fuente y resultados verificables.

• Funcionar sin depender de una instalación de career-ops.

Inicio rápido para desarrollo

Requisitos: Node.js 22 o superior.

git clone https://github.com/abelvalle/zar-jobs-ai-connector.git
Set-Location zar-jobs-ai-connector
npm.cmd install
npm.cmd run check
npm.cmd test
npm.cmd run smoke

El smoke test inicia el servidor MCP por stdio, conecta un cliente real y ejecuta las capacidades que no requieren credenciales. Las pruebas incluyen además un cliente real conectado al transporte Streamable HTTP.

Herramientas actuales

• get_portal_capabilities: devuelve el estado, dependencias y siguiente acción segura de InfoJobs, Tecnoempleo y LinkedIn.

• normalize_job_url: valida una URL HTTPS sin abrirla, elimina parámetros de seguimiento conocidos e identifica el portal.

• search_infojobs_jobs: busca ofertas mediante el endpoint oficial de InfoJobs, con paginación y un máximo de 50 resultados.

• get_infojobs_job: obtiene y normaliza el detalle público de una oferta de InfoJobs.

• list_tecnoempleo_alert_jobs: devuelve ofertas del RSS oficial de una alerta propia de Tecnoempleo.

• import_tecnoempleo_rss: procesa en memoria el XML de una alerta propia aportado por el usuario, sin hacer una llamada de red.

• import_linkedin_job: normaliza una oferta de LinkedIn aportada por el usuario y la marca como no verificada.

Las dos herramientas de InfoJobs requieren INFOJOBS_CLIENT_ID y INFOJOBS_CLIENT_SECRET en el entorno del servidor. Consulta la guía de configuración de InfoJobs; nunca compartas esos valores en un chat ni los confirmes en Git.

La lectura local de Tecnoempleo requiere TECNOEMPLEO_RSS_URL. Consulta la guía de configuración de Tecnoempleo; la URL puede ser privada y tampoco debe publicarse. El MCP remoto utiliza contenido RSS aportado en la llamada y no necesita esa variable.

MCP remoto

npm.cmd run start:http sirve /mcp mediante Streamable HTTP y /health para monitorización. Su superficie pública incluye capacidades, normalización e importaciones seguras de Tecnoempleo y LinkedIn; excluye las herramientas que dependen de secretos locales.

Consulta despliegue remoto, evaluaciones y checklist de publicación.

Documentación

• Arquitectura

• Tecnología

• Roadmap e hitos

• Capacidades por portal

• Configuración de InfoJobs

• Configuración de Tecnoempleo

• Uso seguro con LinkedIn

• Seguridad y privacidad

• MCP remoto

• Checklist de publicación

• Autorizaciones de proveedores

• Soporte

• Contribución y ramas

Ramas

• develop: desarrollo activo.

• master: último hito estable y verificado.

El repositorio se inicializa con la documentación en master; el desarrollo posterior parte de develop y solo se promociona a master tras superar sus comprobaciones.

La publicación actual es el código fuente público y el servidor remoto reproducible. La aparición en el directorio universal de plugins de OpenAI corresponde al Hito 6B y requiere un endpoint HTTPS estable, identidad verificada y revisión externa.

Licencia

MIT