# mcp-cn-commerce

MCP-сервер для чтения операционных данных на китайских маркетплейсах через stdio. Позволяет агенту собирать отчёты по заказам, возвратам и остаткам.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 87
- Автор: TonyWang-hub
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/TonyWang-hub/mcp-cn-commerce
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/mcp-cn-commerce

## Что делает

Сервер предоставляет набор адаптеров для китайских торговых площадок вроде Doudian, Taobao, JD и рекламного кабинета Ocean Engine. Все операции работают исключительно в режиме чтения. Никаких правок в карточки товаров агент не вносит. Задача сервера — отдавать структурированные выгрузки по продажам, балансам и сервисным обращениям.

Кодовая база рассчитана на Python 3.11+ и связывается с клиентами по протоколу stdio. В ядре есть общий пул сетевых соединений и маскирование персональных сведений. Суммы и временные метки приводятся к единому формату. Пропуски в пагинации сервер сразу помечает в сводке.

Для запуска понадобятся ключи доступа и токены авторизации от API выбранных площадок. Операции чтения для Pinduoduo отключены из-за отсутствия официальной схемы данных. Все адаптеры в коде имеют флаг `live_verified: false`. Сверка на реальных магазинах ещё не проводилась.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `OCEANENGINE_ACCESS_TOKEN`, `DOUDIAN_APP_KEY`, `DOUDIAN_APP_SECRET`, `DOUDIAN_SHOP_ID`, `DOUDIAN_ACCESS_TOKEN`, `JD_APP_KEY`, `JD_APP_SECRET`, `JD_ACCESS_TOKEN`, `TAOBAO_APP_KEY`, `TAOBAO_APP_SECRET` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> --env DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> --env DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> --env DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> --env DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> --transport stdio mcp-cn-commerce -- uvx mcp-cn-commerce
```
Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-cn-commerce <команда>

### Codex

**Командой платформы**
```bash
codex mcp add mcp-cn-commerce --env OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> --env DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> --env DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> --env DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> --env DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> -- uvx mcp-cn-commerce
```
Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-cn-commerce <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-cn-commerce": {
            "command": "uvx",
            "args": [
                "mcp-cn-commerce"
            ],
            "env": {
                "OCEANENGINE_ACCESS_TOKEN": "<OCEANENGINE_ACCESS_TOKEN>",
                "DOUDIAN_APP_KEY": "<DOUDIAN_APP_KEY>",
                "DOUDIAN_APP_SECRET": "<DOUDIAN_APP_SECRET>",
                "DOUDIAN_SHOP_ID": "<DOUDIAN_SHOP_ID>",
                "DOUDIAN_ACCESS_TOKEN": "<DOUDIAN_ACCESS_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-cn-commerce <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-cn-commerce": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-cn-commerce"
            ],
            "env": {
                "OCEANENGINE_ACCESS_TOKEN": "<OCEANENGINE_ACCESS_TOKEN>",
                "DOUDIAN_APP_KEY": "<DOUDIAN_APP_KEY>",
                "DOUDIAN_APP_SECRET": "<DOUDIAN_APP_SECRET>",
                "DOUDIAN_SHOP_ID": "<DOUDIAN_SHOP_ID>",
                "DOUDIAN_ACCESS_TOKEN": "<DOUDIAN_ACCESS_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-cn-commerce <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> -e DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> -e DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> -e DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> -e DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> mcp-cn-commerce uvx mcp-cn-commerce
```
Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-cn-commerce <команда>

## Когда брать
- читать списки заказов и данные возвратов на Doudian и JD
- проверять баланс рекламного счёта в Ocean Engine
- получать выгрузки по операциям магазина в Taobao без права записи
- нормализовать финансовые суммы и даты из разных маркетплейсов в отчётах

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md