Servidor MCP de LinkedIn Jobs

Servidor MCP autohospedado que extrae ofertas de empleo de LinkedIn con tus cookies de sesión autenticadas. Se ejecuta en Docker. Sin Apify, sin costes por ejecución.

Configuración

1. Obtén tus cookies

1. Instala la extensión de Chrome Cookie-Editor

2. Inicia sesión en LinkedIn (usa una cuenta secundaria)

3. Haz clic en Cookie-Editor → Export (JSON)

4. Busca y copia dos valores:

   • li_at — tu cookie de sesión

   • JSESSIONID — utilizado como token CSRF (el valor tiene un formato como ajax:1234...)

2. Configura

cp .env.example .env
# Edit .env and paste your cookie values

3. Compila y prueba

# Build the Docker image
docker build -t linkedin-mcp .

# Quick smoke test — should print the MCP server startup log
docker run --rm --env-file .env linkedin-mcp
# Ctrl+C to stop

4. Conecta con Claude Desktop

Edita tu archivo de configuración de Claude Desktop:

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

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

{
  "mcpServers": {
    "linkedin-jobs": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "--env-file", "/ABSOLUTE/PATH/TO/linkedin-mcp/.env",
        "linkedin-mcp"
      ]
    }
  }
}

⚠️ Usa la ruta absoluta a tu archivo .env. ~/ no se expande aquí.

5. Reinicia Claude Desktop

Después de guardar la configuración, cierra completamente y vuelve a abrir Claude Desktop. Verás un icono de herramientas 🔧 en la barra de chat; haz clic en él para confirmar que scrape_jobs, get_job_details, check_cookie y update_cookies aparecen en la lista.

6. Primera conversación

You: Check if my LinkedIn cookie is valid
Claude: [calls check_cookie] ✓ Authenticated as John Doe

You: Scrape 20 AI Engineer or ML Engineer jobs posted in the last 3 days in the US
Claude: [calls scrape_jobs] ...returns full job list with descriptions

Actualización de cookies (cada 30–60 días)

Cuando las cookies caduquen, vuelve a exportarlas desde Cookie-Editor y dile a Claude:

Update my LinkedIn cookies: li_at is "new_value" and jsessionid is "new_value"

Claude llamará a update_cookies; no es necesario reiniciar el contenedor.

Desarrollo

# Run with live source reloading
docker compose up

# Inspect MCP tools without Claude Desktop
npx @modelcontextprotocol/inspector docker run --rm -i --env-file .env linkedin-mcp

Estructura del proyecto

linkedin-mcp/
├── src/
│   ├── server.py        # MCP server — tool definitions and handlers
│   ├── scraper.py       # LinkedIn Voyager API calls (httpx)
│   ├── models.py        # Pydantic models for Job data
│   └── __init__.py
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
├── .env.example
└── .gitignore