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 y 1 están completos. El Hito 2A añade búsqueda y detalle de ofertas mediante la API oficial de InfoJobs; la prueba en vivo del Hito 2B queda pendiente de credenciales de aplicación. El conector no persiste consultas, ofertas ni credenciales.

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, enumera las cuatro herramientas y ejecuta las capacidades que no requieren credenciales.

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.

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.

Documentación

• Arquitectura

• Tecnología

• Roadmap e hitos

• Capacidades por portal

• Configuración de InfoJobs

• Seguridad y privacidad

• 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 en GitHub. La aparición en el directorio universal de plugins de OpenAI corresponde al Hito 6 y requiere un MCP remoto, identidad verificada y revisión externa.

Licencia

MIT