# Yandex Market Readonly MCP

ИИ-помощник для кабинета продавца Яндекс Маркета: магазины, товары, заказы, остатки, цены, возвраты, отзывы и индекс качества. Сервер только читает данные. Изменить кабинет через этот MCP нельзя, даже если у API-Key есть права на запись.

Документация Partner API: [API Яндекс Маркета для продавцов](https://yandex.ru/dev/market/partner-api/doc/ru/).

**[Установка на Ubuntu → DEPLOY.md](DEPLOY.md)** · [Примеры](USAGE.md) · [Инструкция для ИИ](AI_GUIDE.md)

## Что можно анализировать

| Направление | Что доступно |
|---|---|
| Магазины | `campaignId`, `businessId`, модель FBY/FBS/DBS/Express |
| Товары | SKU, карточки, скрытые офферы |
| Цены и остатки | Текущие цены, остатки, оборачиваемость |
| Заказы | Список и карточка заказа, статистика за период |
| Возвраты | Невыкупы и возвраты — без решений |
| Качество и отзывы | Индекс качества, отзывы покупателей |
| Локально | План пополнения, юнит-экономика, агрегации |

Создание отчётов, этикеток, смена статусов, ответы в чатах и любые изменения кабинета исключены.

## Как устроено

```text
ChatGPT Web
        ↓ OAuth 2.0 Authorization Code + PKCE S256
   Cloudflare Quick Tunnel (служба ym-cloudflared)
        ↓
  Ubuntu VPS → Yandex Market Readonly MCP → YM_API_KEY
                                          → api.partner.market.yandex.ru
```

API-Key Маркета хранится только в `.env` на сервере и используется только для исходящих запросов. ChatGPT подключается к MCP через OAuth: на странице входа вводятся логин и пароль MCP, не ключ Маркета. Для локального Cursor доступен запуск через stdio.

## Инструменты

`ym_status`, `ym_catalog`, `ym_schema`, `ym_read`, `ym_result`, `ym_campaigns`, `ym_find_product`, `ym_product_profile`, `ym_orders`, `ym_order_profile`, `ym_stocks`, `ym_prices`, `ym_returns`, `ym_ratings`, `ym_feedbacks`, `ym_sales_summary`, `ym_daily_review`, `ym_stock_plan`, `ym_unit_economics`, `ym_aggregate`.

Все инструменты помечены как read-only. Есть ресурс `ym://guide` и prompt `ym_daily_review`.

## Быстрый старт разработчика

Нужен Node.js 22 или новее.

```bash
git clone https://github.com/zimuspro156-lab/mcp-ym-readonly.git
cd mcp-ym-readonly
npm ci
npm test
```

Секреты в чат и в Git не вставляйте. Для сервера используйте [DEPLOY.md](DEPLOY.md).

Исходный код — [MIT](LICENSE). Проект не является официальным продуктом Яндекса.