| name | ozon-seller-api |
| description | 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. |
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.
Workflow
- Если меняешь скрипты, сначала запусти
./tests/e2e.sh.
- Если не знаешь, где метод, открой
references/INDEX.md.
- Если задача описана по-бизнесовому, а не именем метода, открой
references/SCENARIOS.md.
- Если знаешь домен, открой
references/categories/<category>.md.
- Для поиска используй
./scripts/ozon-find-method.sh "<query>".
- Для вызова используй wrapper из
scripts/methods/....
- Если wrapper не подходит, используй
./scripts/ozon-request.sh.
Standard Commands
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, а не весь каталог категорий подряд.
