mcp-cn-commerce
MCP-серверы только для чтения: заказы, возвраты и реклама на китайских площадках Douyin Shop, Taobao, JD, Kuaishou
- 99 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Читает заказы, возвраты и рекламные балансы по ключам продавца: это коммерческие и персональные данные клиентов
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-cn-commerceОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает заказы, возвраты и рекламные балансы по ключам продавца: это коммерческие и персональные данные клиентов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp-cn-commerce — монорепозиторий независимых MCP-серверов, которые дают агенту структурированный доступ к данным продавца на китайских торговых площадках. Каждый сервер оборачивает открытый API одной платформы: Douyin Shop и Taobao (заказы и возвраты), JD (заказы, магазин, две послепродажные выборки), Kuaishou, Xiaohongshu и WeChat Store (часть чтения заказов и возвратов), Ocean Engine и Qianchuan (сведения о рекламодателе и баланс), Pinduoduo (вход есть, чтение отключено до получения полной схемы). Всего восемь платформ и 155 зарегистрированных инструментов, а Youzan подключается только через SDK. Все инструменты по умолчанию только читают: агент анализирует данные, но ничего не меняет. Общая основа дает пул соединений, лимиты, повторы запросов, метрики и маскирование. Деньги и время приводятся к единому виду, а отчеты помечают пропуски и неполную пагинацию. Каждый инструмент в описании `tools/list` несет метки `contract_status`, `supported` и `live_verified`. Установка идет из PyPI в виртуальное окружение: `python -m pip install "mcp-cn-commerce==0.1.6"`. Серверы запускаются командами вроде `mcp-cn-doudian`, `mcp-cn-jd` и `mcp-cn-oceanengine`, а доступы задаются переменными окружения.
Для кого. Продавцам и аналитикам, которые работают на китайских маркетплейсах и хотят читать заказы, возвраты и баланс рекламных кабинетов через Claude Desktop или другой MCP-клиент.
Подходит, если
- Нужно выгрузить заказы Douyin Shop за фиксированный интервал и найти оставшиеся страницы и детали
- Требуется узнать статус, сумму и время завершения возврата на Taobao
- Нужен баланс авторизованного рекламного кабинета Ocean Engine без захода в интерфейс
- Нужен общий отчет из нормализованных записей с пометками о пропущенных полях
Не подходит, если
- Нужно менять товары, цены или остатки: инструменты только читают
- Нужны данные Pinduoduo: чтение закрыто до получения полной официальной схемы
- Нужны данные без авторизации продавца: доступ идет через ваши ключи платформы
Пример запроса к агенту
Прочитай заказы Douyin Shop за вчера и покажи оставшиеся страницы, затем сверь статус возврата по заказу из этого спискаMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
DOUDIAN_APP_KEYсекрет- Ключ приложения Douyin Shop
DOUDIAN_APP_SECRETсекрет- Секрет приложения Douyin Shop
DOUDIAN_ACCESS_TOKENсекрет- Токен доступа Douyin Shop
JD_APP_KEYсекрет- Ключ приложения JD
JD_APP_SECRETсекрет- Секрет приложения JD
JD_ACCESS_TOKENсекрет- Токен доступа JD
Ограничения
- У всех SDK метка `live_verified` равна `false`: проверка на реальных магазинах и сверка с кабинетом продавца не завершены, первые вызовы нужно сверять с админкой платформы.
- Число зарегистрированных инструментов (155) не означает число проверенных контрактов. Есть исторические и явно неподдерживаемые входы, а часть операций (полные возвраты JD, отчеты Ocean Engine) закрыта.
- Для каждой платформы нужны собственные доступы: ключ приложения, секрет, токен и идентификатор магазина, выданные платформой.
- Нужны Python 3.11 или новее, а клиенту MCP указывают абсолютный путь к исполняемому файлу из `.venv/bin/`.
Как отключить. Удалите блоки `oceanengine`, `doudian` и `jd` из конфигурации MCP-клиента, затем удалите виртуальное окружение с пакетом. Токены отзовите в кабинете разработчика платформы.
Частые вопросы
Как подключить mcp-cn-commerce к Claude Desktop?
Установите пакет в виртуальное окружение (`python -m pip install "mcp-cn-commerce==0.1.6"`) и добавьте в MCP-конфигурацию блоки с абсолютными путями к `.venv/bin/mcp-cn-doudian`, `mcp-cn-jd` и `mcp-cn-oceanengine`. Ключи платформ задайте в разделе `env`: переменные оболочки десктоп-клиент не видит.
Может ли агент изменить мой магазин?
Нет. Все инструменты по умолчанию только читают, а операции с пометкой `supported=false` отклоняются до обращения к платформе.
Какие платформы покрыты?
Douyin Shop, Taobao, JD, Pinduoduo (чтение закрыто), Kuaishou, Xiaohongshu, WeChat Store, Ocean Engine и Qianchuan. Youzan подключается только как SDK. Подробности по операциям лежат в таблице `docs/sdk-integration.md`.
Что означает метка live_verified?
Она показывает, проверена ли операция на реальном магазине. Сейчас для всех SDK она равна `false`, поэтому первые результаты стоит сверять с кабинетом продавца. Метки `contract_status`, `supported` и `live_verified` есть в описании каждого инструмента.
Какие переменные окружения нужны?
Для каждой платформы свой набор: например `DOUDIAN_APP_KEY`, `DOUDIAN_APP_SECRET`, `DOUDIAN_SHOP_ID` и `DOUDIAN_ACCESS_TOKEN` для Douyin Shop или `JD_APP_KEY`, `JD_APP_SECRET`, `JD_ACCESS_TOKEN` для JD. Полный список лежит в `.env.example`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-серверы для кабинетов продавца Wildberries, Ozon, Яндекс Маркета и Авито через официальные API с подтверждением записи
Набор MCP-серверов для Wildberries, Ozon, Яндекс Маркета, Битрикс24, amoCRM, Авито, Директа, Метрики, Вебмастера и DaData, локально бесплатно
Read-only MCP кабинета Яндекс Маркета
Yandex Market Readonly MCP
MCP только для чтения кабинета продавца Яндекс Маркета: товары, заказы, цены, остатки и отзывы, без единого изменяющего инструмента
RetailCRM MCP
retailcrm-mcp
MCP-сервер RetailCRM: заказы, клиенты, товары, остатки, оплаты, задачи и аналитика магазина через API v5
mpmentor-ru-mcp-readonly: Wildberries и Ozon только для чтения
mpmentor-ru-mcp-readonly
Локальный MCP-сервер подключает Codex и Claude Code к Wildberries, Ozon Seller и Ozon Performance без инструментов изменения и удаления
MCP-сервер для Ozon Seller API с каталогом из 441 метода, классами доступа на чтение и запись и хранением ключей вне репозитория
Коротко о README
README (на китайском и английском) объясняет, что это набор MCP-серверов для данных продавца, публикации контента среди задач нет. Дальше идут таблица платформ с границами поддержки, быстрый старт с установкой Core 0.1.6 и настройкой переменных окружения, подключение к MCP-клиентам, архитектура, справочник инструментов, раздел о безопасности, примеры запросов и дорожная карта.