Job Platform MCP Monorepo

Proporciona las API de empleo de Wanted, 사람인 y 잡코리아 como servidores MCP independientes, y ofrece una Skill de Agente que encuentra ofertas de empleo personalizadas basándose en currículums y portafolios. Es un monorepo de TypeScript.

Este documento es un documento de referencia que puede utilizarse tanto cuando una persona configura directamente como cuando agentes como Codex, Claude Code, OpenCode u OpenClaw configuran en su lugar.

Funciones ofrecidas

La skill job-match-search realiza las siguientes tareas.

• Analiza el currículum, CV, historial profesional y portafolio proporcionados por el usuario

• Extrae el puesto objetivo, la experiencia, las habilidades, el dominio y las condiciones preferidas

• Si no hay región ni condiciones detalladas, pregunta todo de una vez antes de buscar

• Si el usuario omite introducir condiciones, busca sin restricciones de región ni modalidad de trabajo

• Consulta conjuntamente los MCP conectados de Wanted, 사람인 y 잡코리아

• Elimina ofertas duplicadas y evalúa la idoneidad basándose en evidencias

• Proporciona las razones de coincidencia de las ofertas principales, los requisitos que faltan y los enlaces a las ofertas originales

Related MCP server: RecruitData

Principios de diseño

• Los tres MCP se ejecutan como procesos stdio separados.

• No comparten credenciales ni clientes de API entre plataformas.

• Utilizan los permisos de API que cada usuario ha obtenido directamente.

• Las funciones de pago solo se invocan cuando la cuenta del usuario tiene permiso.

• No se envían el texto completo del currículum ni datos personales a las API de empleo.

• Solo se transmiten a la API las condiciones derivadas mínimas necesarias para la búsqueda, como nombre del puesto, habilidades, experiencia y región.

• No se realiza envío de solicitudes, creación de cuentas, contacto con responsables ni pagos sin la confirmación del usuario.

Requisitos

• Node.js 22 o superior

• pnpm 11 o superior

• Git

• Credenciales de API de la plataforma de empleo que se vaya a utilizar

Compruebe las versiones.

node --version
pnpm --version
git --version

Inicio rápido

1. Obtener el repositorio

git clone https://github.com/sjungwon03/job-platform-mcp.git
cd job-platform-mcp

Si está trabajando localmente antes de obtener el repositorio remoto, continúe con los siguientes pasos desde la raíz del repositorio actual.

2. Instalación de dependencias y compilación

pnpm install
pnpm build

Para verificar el estado completo:

pnpm verify

La verificación incluye lint, comprobación de tipos de TypeScript, pruebas del almacén de credenciales, pruebas MCP y compilación de producción.

3. Preparación de las credenciales de API

Solo necesita configurar la plataforma que desee. No es necesario utilizar las tres plataformas.

Wanted

Emisión: https://openapi.wanted.jobs/apply/

Este proyecto no paga los costes de la API en su lugar ni proporciona claves públicas. Si se utilizan funciones de pago, el usuario de ese MCP gestiona los permisos y pagos con su propia cuenta de Wanted.

사람인

Emisión: https://oapi.saramin.co.kr/

잡코리아

Información: https://www.jobkorea.co.kr/service/api

잡코리아 proporciona una URL de llamada exclusiva tras la aprobación de uso y el registro de la IP de solicitud.

Se necesita al menos una de las dos URL. La URL emitida completa debe tratarse como información confidencial.

4. Introducción segura de las credenciales

No introduzca las credenciales directamente en chats, README, archivos rastreados por Git ni en el JSON de configuración de MCP.

Ejecute el configurador seguro desde la raíz del repositorio.

node skills/job-match-search/scripts/configure-credentials.mjs

El configurador funciona en el siguiente orden:

1. Selecciona la plataforma a configurar.

2. Solicita los valores de autenticación enmascarados con asteriscos.

3. Por defecto, los guarda en job-platform-mcp/credentials.json dentro del directorio de configuración del usuario.

4. En Linux, macOS y WSL, restringe los permisos del archivo a 0600.

5. Rechaza rutas dentro del repositorio, enlaces simbólicos y archivos legibles por otros usuarios.

6. No vuelve a mostrar los valores; solo indica si cada plataforma está configurada.

Ubicación de almacenamiento predeterminada:

~/.config/job-platform-mcp/credentials.json

Para usar otra ruta absoluta, configure JOB_MATCH_CREDENTIALS_FILE de la misma manera tanto en el configurador como en el host MCP. No se pueden usar rutas dentro del repositorio.

Compruebe el estado de la configuración:

node skills/job-match-search/scripts/configure-credentials.mjs --check

La salida no incluye los valores reales.

Wanted: 설정됨
사람인: 설정됨
잡코리아: 미설정

Este archivo es un JSON local protegido por los permisos de archivo del sistema operativo; no es un archivo cifrado por sí mismo. En Windows nativo, se recomienda usar el almacén de secretos del sistema operativo que proporciona el agente o el host MCP.

5. Registro del servidor en el host MCP

Registre el ejecutor común run-mcp.mjs sin copiar las credenciales directamente en la configuración de MCP.

Primero compile todos los paquetes.

pnpm build

Sustituya absolute-path por la ruta absoluta real del repositorio.

{
  "mcpServers": {
    "wanted": {
      "command": "node",
      "args": [
        "/absolute-path/job-platform-mcp/skills/job-match-search/scripts/run-mcp.mjs",
        "wanted"
      ]
    },
    "saramin": {
      "command": "node",
      "args": [
        "/absolute-path/job-platform-mcp/skills/job-match-search/scripts/run-mcp.mjs",
        "saramin"
      ]
    },
    "jobkorea": {
      "command": "node",
      "args": [
        "/absolute-path/job-platform-mcp/skills/job-match-search/scripts/run-mcp.mjs",
        "jobkorea"
      ]
    }
  }
}

Puede registrar solo las plataformas configuradas. Tras reiniciar el host MCP, compruebe los siguientes nombres en la lista de herramientas.

wanted_list_jobs
saramin_search_jobs
saramin_get_job
jobkorea_fetch_jobs
jobkorea_fetch_entry_jobs

Si el host MCP añade el nombre del servidor como prefijo, el nombre real expuesto puede variar ligeramente.

Procedimiento de configuración para agentes

Cuando un agente configure este repositorio, siga el siguiente orden. Las personas también pueden usar el mismo procedimiento.

1. Compruebe que el directorio actual es la raíz del repositorio, donde se encuentra pnpm-workspace.yaml.

2. Compruebe las versiones requeridas con node --version y pnpm --version.

3. Ejecute pnpm install y pnpm build.

4. Pregunte al usuario qué plataforma quiere conectar y si ya ha obtenido las credenciales.

5. No pida que introduzca los valores de autenticación en una ventana de chat normal.

6. Ejecute configure-credentials.mjs en una TTY interactiva y deje que el usuario introduzca los valores enmascarados directamente.

7. Compruebe la ubicación de configuración del agente o host MCP que se utiliza.

8. Registre únicamente la ruta absoluta de run-mcp.mjs y los argumentos de plataforma, sin valores secretos.

9. Tras reiniciar el host MCP, verifique la conexión con una solicitud de solo lectura que devuelva pocos resultados.

10. En caso de éxito, informe únicamente del nombre de la plataforma conectada. No incluya valores de autenticación ni la URL emitida de 잡코리아 ni siquiera en los errores.

Si el agente no puede ofrecer una TTY interactiva, indique al usuario únicamente el comando de configuración y espere a que termine de introducir los datos. No repita automáticamente los fallos de autenticación.

Instalación de la skill de emparejamiento de empleo

El original de la skill se encuentra en el siguiente directorio:

skills/job-match-search/
├── SKILL.md
├── references/
├── scripts/
└── test/

La skill utiliza el formato público Agent Skills y no depende de frontmatter específico de ningún agente. Solo cambia el directorio que busca cada cliente.

Codex

Enlace la carpeta original en el directorio de skills personales.

mkdir -p ~/.codex/skills
ln -s /absolute-path/job-platform-mcp/skills/job-match-search ~/.codex/skills/job-match-search

Si ya existe una ruta con el mismo nombre, no la elimine ni la sobrescriba; compruebe primero la skill existente.

Claude Code

Enlace en la ruta de skills del proyecto.

mkdir -p .claude/skills
ln -s ../../skills/job-match-search .claude/skills/job-match-search

En Claude Code, cuando se invoca directamente, se usa de la siguiente manera:

/job-match-search 내 이력서에 맞는 백엔드 공고를 찾아줘

OpenCode

Enlace en la ruta de skills del proyecto.

mkdir -p .opencode/skills
ln -s ../../skills/job-match-search .opencode/skills/job-match-search

OpenCode también admite rutas compatibles con .claude/skills y .agents/skills.

OpenClaw

Si se usa este repositorio como workspace de OpenClaw, la ruta actual skills/job-match-search se detecta automáticamente. Para instalarlo en otro workspace:

openclaw skills install /absolute-path/job-platform-mcp/skills/job-match-search

En entornos que no admiten enlaces simbólicos, copie la carpeta completa en la ruta de skills del cliente correspondiente. Debe copiar no solo SKILL.md, sino también references y scripts.

Uso de la skill

Adjunte un currículum o portafolio, o especifique una ruta local que el agente pueda leer.

$job-match-search
첨부한 이력서를 분석해서 내 경력에 맞는 채용공고를 찾아줘.

Puede especificar la región y las condiciones a la vez.

$job-match-search
서울 또는 판교, 주 2회 이하 출근, 정규직 백엔드 포지션을 찾아줘.
Java와 Spring 실무 경험을 중요하게 보고 연봉이 공개된 공고를 우선해줘.

También puede empezar sin fijar condiciones.

$job-match-search
내 포트폴리오에 맞는 공고를 찾아줘. 조건은 아직 정하지 않았어.

En ese caso, la skill pregunta de una vez por la región, la modalidad de trabajo, el tipo de contrato y las preferencias principales. Si se omiten las respuestas, busca ampliamente sin restricciones.

Los resultados predeterminados incluyen la siguiente información:

• El perfil de búsqueda analizado y las suposiciones declaradas

• Las 10 ofertas con mayor idoneidad

• Las razones de coincidencia confirmadas y los requisitos que faltan o no se han verificado

• Región, modalidad de trabajo, fecha límite, fuente y enlace a la oferta original

• Las plataformas consultadas, términos de búsqueda, filtros y los ámbitos que fallaron

La puntuación de idoneidad es una heurística comparativa; no es una probabilidad de ser seleccionado.

Comandos de desarrollo

Workspace completo:

pnpm install
pnpm lint
pnpm typecheck
pnpm test
pnpm build
pnpm verify

Para comprobar solo un paquete:

pnpm --filter wanted-mcp test
pnpm --filter saramin-mcp test
pnpm --filter jobkorea-mcp test

Para ejecutar solo las pruebas del almacén de credenciales:

pnpm test:skill

Estructura del proyecto

.
├── packages/
│   ├── wanted-mcp/
│   ├── saramin-mcp/
│   └── jobkorea-mcp/
├── skills/
│   └── job-match-search/
├── package.json
├── pnpm-lock.yaml
└── pnpm-workspace.yaml

El workspace raíz solo integra la instalación de dependencias, un único lockfile y la verificación completa. La configuración, los clientes, los esquemas de herramientas y las pruebas de cada MCP se mantienen dentro de su paquete correspondiente.

Solución de problemas

Advertencias de seguridad

• No confirme credenciales reales en Git.

• No pegue credenciales en issues, PR, chats ni registros.

• Si una clave queda expuesta, revóquela de inmediato y vuelva a emitirla en la plataforma.

• Trate la URL de llamada de 잡코리아 completa como información confidencial.

• No coloque el archivo del almacén de credenciales en carpetas de sincronización en la nube ni en directorios compartidos.

• No conceda acceso al almacén de credenciales a skills o scripts gestionados por otras personas.

Licencia y condiciones de uso de la API

Los datos de cada plataforma de empleo, las condiciones de uso de la API, los límites de llamadas y las políticas de facturación se rigen por los términos de esa plataforma. Este repositorio no elude los permisos de autenticación ni las funciones de pago, y no otorga derechos de redistribución de los datos de la API.