upwork-mcp

MCP-сервер для автоматизации работы на Upwork. Ищите вакансии, составляйте и отправляйте заявки, управляйте сообщениями и контрактами — всё это из Claude Desktop или любого MCP-совместимого клиента.

Возможности

• Поиск вакансий — поиск по ключевым словам с фильтрами (бюджет, почасовая ставка, уровень опыта, рейтинг клиента, свежесть), автоматическая оценка и обнаружение «красных флагов»

• Рабочий процесс с заявками — создание черновиков по шаблонам, предварительный просмотр и отправка с явным подтверждением; действует суточный лимит

• Проверка клиентов — проверка по 7 критериям «красных флагов» (верификация платежей, рейтинг, история найма, возраст аккаунта, количество повторных публикаций, объем заявок, минимальная почасовая ставка)

• Сообщения — список непрочитанных диалогов, чтение переписки, создание черновиков и отправка ответов

• Контракты — список активных/прошлых контрактов, просмотр деталей и записей в рабочем дневнике

• Безопасность сессии — постоянный профиль Chromium, обнаружение Cloudflare, истечение срока действия через 7 дней бездействия, ограничение домена upwork.com

• Журнал аудита — каждый вызов инструмента записывается в ~/.upwork-mcp/audit.log (только метаданные, без содержимого)

Требования

• Python 3.11+

• uv (рекомендуется) или pip

• Действующая учетная запись Upwork

Установка

Использование uv (рекомендуется)

git clone https://github.com/kubegrind/upwork-mcp
cd upwork-mcp
uv sync
uv run playwright install chromium

Использование pip

git clone https://github.com/kubegrind/upwork-mcp
cd upwork-mcp
pip install -e .
playwright install chromium

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

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "upwork": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/upwork-mcp",
        "run",
        "upwork-mcp"
      ]
    }
  }
}

Claude Code

claude mcp add upwork -- uv --directory /absolute/path/to/upwork-mcp run upwork-mcp

Переменные окружения

Аутентификация

Сервер использует постоянный профиль браузера Chromium. При первом запуске выполните аутентификацию вручную:

uv run upwork-mcp --no-headless

Откроется окно браузера. Войдите в Upwork обычным способом. Сессия сохраняется в ~/.upwork-mcp/profile/ и используется повторно при последующих запусках. Сессии истекают через 7 дней бездействия.

Инструменты

Вакансии

Заявки

Сообщения

Контракты

Профиль

Сессия и аудит

Шаблоны заявок

Шаблоны хранятся в ~/.upwork-mcp/templates/. Шаблон по умолчанию загружается из default.txt, если он существует. Передайте имя файла через template_name, чтобы использовать пользовательский шаблон.

Поддерживаемые переменные:

{job_title}         {client_name}       {key_skill}
{estimated_timeline} {rate}             {years_experience}
{industries}        {custom_paragraph}  {start_date}
{your_name}

Пример шаблона (~/.upwork-mcp/templates/default.txt):

Hi {client_name},

I noticed you're looking for {key_skill} help on {job_title}.
I have {years_experience} years of relevant experience and can deliver {estimated_timeline}.

My rate is {rate}.

{your_name}

Сохраненные поиски

Создавайте JSON-файлы в ~/.upwork-mcp/searches/ для сохранения конфигураций поиска:

{
  "query": "devops kubernetes",
  "experience_level": "expert",
  "budget_min": 500,
  "client_rating_min": 4.5
}

Запуск через upwork_run_saved_search(search_name="devops").

Оценка вакансий

Вакансии оцениваются по шкале 1–10 с использованием взвешенной модели:

Вакансии с оценкой ниже 4.0 фильтруются из результатов. Вакансии с оценкой 7.0 и выше помечаются как [HIGH PRIORITY].

Безопасность

• Инструменты ЗАПИСИ (submit_proposal, withdraw_proposal, send_message, close_session, rotate_session) требуют confirmed: true — модель не может действовать без явного подтверждения пользователя

• Суточный лимит заявок — жесткое ограничение в 10 заявок в день

• Ограничение домена — навигация в браузере ограничена upwork.com

• Отсутствие утечки учетных данных — файлы cookie и токены никогда не возвращаются, не записываются в логи и не выводятся на экран

• Защита от обхода путей — имена файлов шаблонов и сохраненных поисков проверяются с помощью Path.is_relative_to()

• Журнал аудита — все вызовы инструментов записываются с указанием времени, типа действия, цели и статуса

Разработка

uv sync --extra dev
uv run pytest
uv run ruff check src
uv run mypy src

Лицензия

MIT