AI自由职业管理工具

kwork-mcp

AI-управление фрилансом на Kwork.ru через Model Context Protocol

将Claude连接到您的KWork帐户，并通过语音或文本管理订单、对话、交易和夸克。没有屏幕截图，没有标签切换，没有手动程序。

为什么需要

KWork的自由职业者每天花30-60分钟做一个例行的事情：检查收件箱，回复客户，查看交易所，更新报价。 郭议员 让Claude在几秒钟内成为你的助手：

你： 有新消息吗？ 克劳德： 2未阅读：User123询问时间表，Designeru Pro感谢您的订单。

你： Python交易所怎么样？ 克劳德： 9个项目。有趣的：“Telegram-Bot for Store”15000€，0回复，还剩18小时。

你： 显示订单详情#12345 克劳德： 目录解析器，5000€，用户123。聊天室里有12条消息，最后一条来自客户。..

14工具

对话和消息

工具在做什么 |-----------|-----------| | kwork_inbox –包含预览、时间、未读计数器的对话框列表。 | kwork_dialog –与用户的完整通信-与订单和状态的上下文› | kwork_send 给我留言。

订单

工具在做什么 |-----------|-----------| | kwork_orders –所有订单：活动，完成，取消。 | kwork_order –订单详情+聊天-3个并行API呼叫一个命令› | kwork_order_message –在聊天室下订单（自动找到客户）。。 | kwork_order_deliver 下订单检查。

项目交流

工具在做什么 |-----------|-----------| | kwork_exchange –用过滤器、搜索和破坏浏览交易所→ | kwork_project –项目细节：描述、预算、客户、反馈数量› | kwork_propose 为项目提出建议。

Kvorki和帐户

工具在做什么 |-----------|-----------| | kwork_my_kworks –列出您的状态和价格。 | kwork_kwork_toggle 【打开/暂停KWORK】 | kwork_stats –余额、评级、订单数量、连接→ | kwork_screenshot kwork页面截图

快速启动

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.连接

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

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

python3 server.py

4.Playwright（可选）

工具 kwork_propose 和 kwork_screenshot 需要浏览器中的Cookies。通过出口 Cookie编辑器 文件 cookies.json:

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

14个工具中有12个完全通过API运行，没有cookie或浏览器。

这是如何运作的

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

• kwork_api.py async HTTP客户端 api.kwork.ru.自动授权、令牌缓存、自动刷新
• kwork_browser.py — Playwright fallback.只有在需要时才会懒惰地启动
• server.py -14个FastMCP MCP工具

为什么是API而不是PARSING？ 更快的10倍，更可靠，不会在更新排版时崩溃。KWork为移动应用程序提供了一个完整的REST API-我们正在使用它。

安全

• 登录名和密码存储在本地 .env （B） .gitignore)
• API令牌缓存到 .kwork_token.json 有权 600
• 浏览器Cookies-in cookies.json （B） .gitignore)
• 没有数据发送给第三方-只有直接连接到 api.kwork.ru

许可证

麻省理工学院

_{Сделано для фрилансеров, которые ценят своё время}