# Ozon Seller API

> Ozon Seller API skill with bash wrappers, method search, category references, and raw requests. Use when working with Ozon Seller API products, prices, stocks, warehouses, FBS, FBO, FBP, returns, analytics, finance, chats, notifications, or Ozon Logistics.

- Skill: `esporykhin/ozon-seller-api` (Agent Skill, multi-file: 462 files)
- Install (CLI): `npx skillmds@latest add esporykhin/ozon-seller-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/esporykhin/ozon-seller-api/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: esporykhin (https://skillmd.com/u/esporykhin)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/esporykhin/ozon-seller-api

---


# Ozon Seller API

Короткий рабочий skill для Ozon Seller API.

## Coverage

- Категорий в каталоге: `38`
- Bash wrappers: `409`

## Authentication

Креды лежат в `config/.env` внутри скилла (файл в `.gitignore`):
```
OZON_CLIENT_ID=...
OZON_API_KEY=...
```

`scripts/_common.sh` загружает их автоматически и валит запрос с понятной ошибкой, если не заданы.

**Если `config/.env` нет** — агент обязан запустить onboarding: спросить у пользователя Client-Id и Api-Key, предложить ДВА варианта:
- **Вариант 1:** передать в чат (агент сам создаст `config/.env` через `cp config/.env.example config/.env`, подставит значения, `chmod 600`).
- **Вариант 2:** пользователь выполняет локально: `cp config/.env.example config/.env` и редактирует вручную.

Как получить ключи: см. [config/README.md](config/README.md).

## Workflow

1. Если меняешь скрипты, сначала запусти `./tests/e2e.sh`.
2. Если не знаешь, где метод, открой `references/INDEX.md`.
3. Если задача описана по-бизнесовому, а не именем метода, открой `references/SCENARIOS.md`.
4. Если знаешь домен, открой `references/categories/<category>.md`.
5. Для поиска используй `./scripts/ozon-find-method.sh "<query>"`.
6. Для вызова используй wrapper из `scripts/methods/...`.
7. Если wrapper не подходит, используй `./scripts/ozon-request.sh`.

## Standard Commands

```bash
OZON_CLIENT_ID=... OZON_API_KEY=... ./scripts/ozon-request.sh POST /v1/roles --empty
./scripts/ozon-find-method.sh "product list"
./scripts/ozon-find-method.sh "question list"
./scripts/ozon-find-method.sh "/v2/warehouse/list"
OZON_CLIENT_ID=... OZON_API_KEY=... ./scripts/methods/product/post-product-list.sh --data '{"filter":{"visibility":"ALL"},"limit":100}'
```

## Notes

- Для write-методов сначала делай минимальный payload на 1 объект.
- Для массовых операций сначала проверь read-методом, что именно собираешься менять.
- Если payload неизвестен, смотри category reference и не тащи весь каталог в контекст.
- Для ориентации по задаче сначала лучше читать `references/SCENARIOS.md`, а не весь каталог категорий подряд.