esporykhin 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, а не весь каталог категорий подряд.