job-search-mcp

Un asistente personal de búsqueda de empleo para Claude Desktop. Le pides a Claude que encuentre trabajos; busca en los portales de empleo reales, puntúa cada uno de 0 a 100 según lo bien que encaje contigo y los muestra en un tablero clasificado que puedes triar con un clic. Todo se ejecuta localmente: no se necesitan claves de API ni cuentas.

Es una aplicación MCP: un pequeño servidor con el que Claude Desktop se comunica, más un tablero integrado que se renderiza directamente en el chat.

Alcance: está ajustado para roles de ingeniería de software en EE. UU. (las fuentes integradas y los filtros de rol se dirigen a empleadores tecnológicos de EE. UU.). Otros campos o regiones devolverán resultados escasos.

Funciona en: construido y probado para Claude Desktop. También debería funcionar en otros clientes MCP que ejecuten un servidor local (stdio) y rendericen interfaces de aplicación MCP, como VS Code (Copilot), Cursor o Goose (sin probar). Los clientes solo remotos (ChatGPT, Claude en web/móvil) no pueden lanzar un servidor local, por lo que no funcionarán.

Qué hace

• Busca en portales de empleo reales — LinkedIn más 8 fuentes de ATS/empleo (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Hacker News, RemoteOK, Remotive), usando tus roles objetivo y ubicación.

• Puntúa cada trabajo para ti — Claude lee la descripción completa y le da una puntuación de ajuste de 0 a 100 con una razón de una línea, sopesando tus habilidades, años de experiencia, ajuste de seniority y el rol.

• Te permite triar rápido — Aplicar / Omitir en cada tarjeta, o en masa ("descartar todo lo que esté por debajo de 60").

• Recuerda — mantiene una lista corta en curso, un rastreador de lo que has solicitado y no te mostrará el mismo trabajo dos veces (durante 6 meses).

Related MCP server: Jobless MCP

Configuración

1. Informa a Claude Desktop sobre ello. Abre tu archivo de configuración:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Añade esto bajo "mcpServers" — npx obtiene el paquete publicado por ti, sin necesidad de clonar ni compilar:

{
  "mcpServers": {
    "job-search": {
      "command": "npx",
      "args": ["-y", "@servation/job-search-mcp"]
    }
  }
}

2. Cierra y vuelve a abrir Claude Desktop por completo (en Windows, sal desde la bandeja del sistema; cerrar la ventana no es suficiente). Eso es todo.

npm install
npm run build

Luego apunta la configuración a dist/main.js de esta carpeta en su lugar:

{
  "mcpServers": {
    "job-search": {
      "command": "node",
      "args": ["D:\\job-search-mcp\\dist\\main.js"]
    }
  }
}

Cómo usarlo

Solo habla con Claude. Por ejemplo:

• "Guarda mi perfil" — pega primero tu currículum; Claude extrae tus habilidades, roles, años y ubicación para que las búsquedas y la puntuación se adapten a ti.

• "Encuentra trabajos de ingeniero backend en California, nivel senior, publicados esta semana."

• "Encuentra trabajos con pocos solicitantes" — añade el filtro de solicitantes tempranos de LinkedIn.

• "Descarta todo lo que esté por debajo de 60."

• "Muestra a lo que he aplicado."

• "Vuelve a puntuar el tablero."

Un primer uso típico: guarda tu perfil → "busca trabajos" → Claude los puntúa y muestra el tablero clasificado → tú aplicas/omites.

El tablero

El tablero es una lista corta en curso. Un trabajo permanece en él hasta que Aplicas (se mueve a tu rastreador) o Omites (oculto para siempre). Las nuevas búsquedas omiten automáticamente los trabajos que ya están en el tablero, en tu rastreador, descartados o mostrados en los últimos 6 meses, para que nunca veas el mismo anuncio dos veces seguidas.

Haz clic en Aplicado u Omitir en una tarjeta, o pídele a Claude que lo haga. Triado en el widget, se mantiene.

Herramientas (para referencia)

Rara vez las llamas por su nombre — Claude elige la correcta — pero esto es lo que hay bajo el capó:

Dónde viven tus datos

Un archivo JSON en tu máquina: sin nube, no se envía nada a ningún sitio excepto a los portales de empleo que buscas:

• Instalado: ~/.job-search-mcp/jobs.json

• Ejecutando desde el código fuente: ./data/jobs.json

• Anula con la variable de entorno JOB_SEARCH_MCP_DATA.

Opcional: modo LinkedIn Premium

Por defecto, LinkedIn usa sus endpoints públicos de invitado: sin inicio de sesión y sin riesgo de inicio de sesión de cuenta, y ya obtienes descripciones completas de los trabajos. Ten en cuenta que el acceso automatizado aún se ejecuta desde tu propia IP y va contra el Acuerdo de Usuario de LinkedIn incluso en modo invitado, así que úsalo bajo tu propio criterio. Si quieres datos más ricos/Premium, puedes usar tu cuenta con sesión iniciada añadiendo un bloque env a la configuración del servidor:

"job-search": {
  "command": "npx",
  "args": ["-y", "@servation/job-search-mcp"],
  "env": {
    "LINKEDIN_LI_AT": "<your li_at cookie>",
    "LINKEDIN_JSESSIONID": "ajax:1234567890123456789"
  }
}

Obtén ambas cookies desde una pestaña linkedin.com con sesión iniciada → DevTools → Application → Cookies.

⚠️ Aviso: esto va contra los Términos de Servicio de LinkedIn y puede hacer que tu cuenta sea marcada o restringida. Las cookies también caducan aproximadamente cada mes y los endpoints internos de LinkedIn cambian sin previo aviso. Si algo falla, vuelve automáticamente al modo invitado. Deja fuera el bloque env para mantenerte completamente seguro (solo invitado).

Cómo funciona la puntuación

Claude (el modelo anfitrión) hace la puntuación directamente: lee cada descripción y juzga el ajuste, lo cual está bien calibrado. Se mantiene una fórmula determinista (computeMatchScore en scoring.ts) como respaldo para cualquiera que ejecute un modelo local más débil que tiende a sobreclasificar todo; no está activa por defecto.

Desarrollo

npm run typecheck    # type-check UI + server + harness
npm run build        # build the UI bundle (vite single-file) + compile the server (tsc)
npm run serve:stdio  # run the server from source (tsx) for local testing
npm run harness      # work on the review UI without Claude Desktop (see harness/)
npm run canary       # check every job source is still returning postings

El servidor es solo stdio (main.ts → server.ts); la interfaz es una aplicación React empaquetada en un único archivo HTML incrustado (src/mcp-app.tsx → dist/mcp-app.html) que el servidor sirve como recurso ui://.

Si trabajas en la interfaz, usa harness/. Es un sustituto local de Claude Desktop que renderiza el widget contra un almacén de trabajos sintético y un puente real ui/*. Abrir dist/mcp-app.html en una pestaña del navegador solo te da "Conectando…", y las cosas que más probablemente se rompan (apertura de enlaces, temas, el refresco posterior al montaje) están mediadas por el anfitrión, por lo que solo aparecen con un anfitrión al otro lado.

Si una fuente de empleo se apaga, npm run canary te dice cuál. Los slugs de empresa se pudren a menudo, por lo que la solución suele estar en el registro remoto de slugs que updateCompanyDirectoriesFromRegistry() vuelve a leer en tiempo de ejecución, en lugar de en una nueva versión.