# Ozon Readonly MCP

ИИ-помощник для своего кабинета продавца Ozon: товары, заказы, остатки, финансы, реклама, отзывы и локальные расчёты. Сервер только читает данные. Изменить кабинет через этот MCP нельзя, даже если у API-ключа есть права на запись. Доступны 15 инструментов и 268 разрешённых операций из 511.

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

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

| Направление | Что доступно |
|---|---|
| Товары | Карточки, `offer_id` / `product_id` / `sku`, категории, характеристики, цены, остатки, ошибки |
| Заказы | FBO, FBS, rFBS, отправления, статусы, причины отмен |
| Поставки | Состав, статусы, доступные слоты только для просмотра |
| Возвраты | Списки, детали, суммы — без approve/reject |
| Финансы | Транзакции, начисления, комиссии, существующие отчёты о реализации |
| Аналитика | Продажи, остатки, оборачиваемость, Premium-воронка при наличии подписки |
| Реклама | Кампании, ставки, синхронные расходы и статистика Performance API |
| Коммуникации | Отзывы, вопросы, чаты — только чтение |
| Акции и рейтинги | Списки, кандидаты, текущие условия, рейтинг продавца |

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

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

```text
ChatGPT Web
        ↓ OAuth 2.0 Authorization Code + PKCE S256
   Cloudflare Quick Tunnel или named tunnel
        ↓
  Ubuntu VPS → Ozon Readonly MCP → ключи Seller / Performance
                                 → api-seller.ozon.ru
                                 → api-performance.ozon.ru
```

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

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

`ozon_status`, `ozon_catalog`, `ozon_schema`, `ozon_read`, `ozon_result`, `ozon_find_product`, `ozon_product_profile`, `ozon_order_profile`, `ozon_sales_funnel`, `ozon_ads_audit`, `ozon_stock_plan`, `ozon_finance_summary`, `ozon_unit_economics`, `ozon_aggregate`, `ozon_daily_review`.

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

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

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

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

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

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