MCP-сервер вакансий LinkedIn

Самохостируемый MCP-сервер, который парсит вакансии LinkedIn с использованием ваших аутентифицированных сессионных cookie. Работает в Docker. Никакого Apify, никаких затрат за каждый запуск.

Настройка

1. Получите свои cookie

1. Установите расширение для Chrome Cookie-Editor

2. Войдите в LinkedIn (используйте запасной аккаунт)

3. Нажмите Cookie-Editor → Export (JSON)

4. Найдите и скопируйте два значения:

   • li_at — ваш сессионный cookie

   • JSESSIONID — используется как CSRF-токен (значение выглядит как ajax:1234...)

2. Конфигурация

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

3. Сборка и тестирование

# 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. Подключение к Claude Desktop

Отредактируйте файл конфигурации 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"
      ]
    }
  }
}

⚠️ Используйте абсолютный путь к вашему файлу .env. ~/ здесь не раскрывается.

5. Перезапустите Claude Desktop

После сохранения конфигурации полностью закройте и снова откройте Claude Desktop. Вы увидите значок инструментов 🔧 в строке чата — нажмите его, чтобы убедиться, что scrape_jobs, get_job_details, check_cookie и update_cookies присутствуют в списке.

6. Первый диалог

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

Обновление cookie (каждые 30–60 дней)

Когда срок действия cookie истечет, экспортируйте их заново из Cookie-Editor и скажите Claude:

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

Claude вызовет update_cookies — перезапуск контейнера не требуется.

Разработка

# 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

Структура проекта

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