kwork-mcp

Подключите Claude к вашему аккаунту Kwork — и управляйте заказами, диалогами, биржей и кворками голосом или текстом. Без скриншотов, без переключения вкладок, без ручной рутины.

Зачем это нужно

Фрилансер на Kwork тратит 30-60 минут в день на рутину: проверить входящие, ответить клиентам, просмотреть биржу, обновить кворки. kwork-mcp превращает Claude в вашего ассистента, который делает это за секунды:

Вы: Есть новые сообщения? Claude: 2 непрочитанных: user123 спрашивает про сроки, designer_pro благодарит за заказ.

Вы: Что на бирже по Python? Claude: 9 проектов. Интересный: "Telegram-бот для магазина" за 15 000₽, 0 откликов, осталось 18 часов.

Вы: Покажи детали заказа #12345 Claude: Парсер каталога, 5 000₽, заказчик user123. В чате 12 сообщений, последнее от заказчика...

14 инструментов

Диалоги и сообщения

Заказы

Биржа проектов

Кворки и аккаунт

Быстрый старт

1. Установка

git clone https://github.com/OpenClaw/kwork-mcp.git
cd kwork-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python -m playwright install chromium

2. Настройка

cp .env.example .env

Заполните .env своими данными:

KWORK_LOGIN=your_email@example.com
KWORK_PASSWORD=your_password

3. Подключение

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "kwork": {
      "command": "/path/to/kwork-mcp/.venv/bin/python3",
      "args": ["/path/to/kwork-mcp/server.py"]
    }
  }
}

Добавьте в .mcp.json проекта:

{
  "mcpServers": {
    "kwork": {
      "command": "/path/to/kwork-mcp/.venv/bin/python3",
      "args": ["/path/to/kwork-mcp/server.py"]
    }
  }
}

Сервер работает через stdio — совместим с любым MCP-клиентом:

python3 server.py

4. Playwright (опционально)

Для инструментов kwork_propose и kwork_screenshot нужны cookies из браузера. Экспортируйте их через Cookie-Editor в файл cookies.json:

[
  {"name": "PHPSESSID", "value": "...", "domain": "kwork.ru", "path": "/"},
  {"name": "csrf_user_token", "value": "...", "domain": "kwork.ru", "path": "/"}
]

12 из 14 инструментов работают полностью через API — без cookies и браузера.

Как это работает

┌─────────────┐     stdio      ┌──────────────┐     HTTP      ┌──────────────┐
│  Claude /    │◄──────────────►│   server.py  │◄────────────►│ api.kwork.ru │
│  MCP Client │                │  (FastMCP)   │              │              │
└─────────────┘                │              │   Playwright  │  kwork.ru    │
                               │              │◄─ ─ ─ ─ ─ ─ ►│  (fallback)  │
                               └──────────────┘              └──────────────┘

• kwork_api.py — async HTTP-клиент для api.kwork.ru. Автоматическая авторизация, кеширование токена, auto-refresh

• kwork_browser.py — Playwright fallback. Запускается лениво, только когда нужен

• server.py — 14 MCP-инструментов на FastMCP

Почему API, а не парсинг? Быстрее в 10x, надёжнее, не ломается при обновлении вёрстки. Kwork имеет полноценный REST API для мобильного приложения — мы его используем.

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

• Логин и пароль хранятся локально в .env (в .gitignore)

• Токен API кешируется в .kwork_token.json с правами 600

• Cookies браузера — в cookies.json (в .gitignore)

• Никакие данные не отправляются третьим сторонам — только прямое соединение с api.kwork.ru

Лицензия

MIT