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.
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
| Portal | Primera integración | Condición |
|---|---|---|
| InfoJobs | Búsqueda oficial de ofertas | Registrar una aplicación y respetar sus condiciones de API |
| Tecnoempleo | RSS personalizado de una alerta propia | Configurar la URL del canal; el API general sigue sujeto a autorización escrita |
| Importación manual de URL o alertas propias | Sin scraping; API directa solo con aprobación de LinkedIn |
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
