Скилл Ozon Seller API
Ozon Seller API — Agent Skill
Скилл-справочник по Ozon Seller API: полный swagger.json и Node.js-скрипт для компактного поиска эндпоинтов и схем
- 4 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент запускает Node-скрипт lookup-operation.js для поиска по спецификации Ozon Seller API
- Скрипт работает с локальным swagger.json и в API Ozon не ходит
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/ozon-seller-api-agent-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент запускает Node-скрипт lookup-operation.js для поиска по спецификации Ozon Seller API
- Скрипт работает с локальным swagger.json и в API Ozon не ходит
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл хранит полную OpenAPI 3.0 спецификацию Ozon Seller API и скрипт lookup-operation.js, который ищет операции по запросу, пути или operationId, раскрывает параметры и схемы, показывает разделы про авторизацию, OAuth и окружение. Скрипт работает локально и не вызывает API Ozon. Агент отвечает по точным методам и путям из спецификации и подставляет в примеры только плейсхолдеры для Client-Id и Api-Key.
Для кого. Для разработчиков интеграций с Ozon, которые пишут код в Claude Code или Codex.
Подходит, если
- Нужно найти метод для товаров, остатков, отправлений FBO или FBS
- Нужно посмотреть схему запроса перед написанием интеграции
- Нужен минимальный пример вызова API на выбранном языке
Не подходит, если
- Нужен готовый CLI или клиент для реальных вызовов Ozon API
- Нужна аналитика продаж, а не документация
Пример запроса к агенту
Как обновить остатки на FBS-складах через Ozon API? Покажи метод и тело запросаОграничения
swagger.json нужно заменять вручную при обновлении API Ozon. Для скрипта нужен Node.js.
Как отключить. Удалите каталог ozon-seller-api из папки скиллов агента.
Частые вопросы
Откуда взята спецификация?
Из официальной документации Ozon Seller API на docs.ozon.ru.
Делает ли скрипт запросы к Ozon?
Нет, он только читает локальный swagger.json.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Ozon — все инструментыСкилл с официальными спецификациями OpenAPI Ozon Seller (463 операции) и Performance API (48 операций) плюс CLI для быстрого поиска нужного метода
Скилл аналитики продавца Ozon
ozon-seller-skill
Скилл с двумя десятками Python-скриптов поверх Ozon Seller API: остатки, оборачиваемость, финансовые отчеты, карточки товаров и отзывы
Скилл-справочник по Ozon Seller API для FBS: обработка отправлений, этикетки, маркировка Честный Знак и акты, с полной OpenAPI-схемой
Аналитика магазина Ozon для Codex
Ozon Store Analytics Skill
Скилл Codex для аналитики магазина Ozon только на чтение: показы, переходы, конверсия, заказы, доставка, отмены, возвраты и позиции в поиске
Ozon University: база знаний FBO для агента
Ozon University — Codex Skill
Скилл-справочник по продаже на Ozon через FBO: товары, финансы, продвижение, послепродажное обслуживание, Seller API и соответствие проекта правилам
Консультант по продажам на Ozon для Codex
Ozon Expert Skill
Скилл Codex с базовыми знаниями о продажах на Ozon: автозагрузка карточек, ключевые слова под поиск Ozon и диагностика операционных проблем
Коротко о README
README описывает пакет в формате Agent Skills для Claude Code, Codex и других агентов. Установка клонированием в личный или проектный каталог скиллов. Скрипт поддерживает флаги --map, --tags, --doc-tags, --query, --operation-id, --path, --details, --schemas и --validate. Карта разделов строится из x-tagGroups спецификации, отдельный рукописный индекс не ведется.
Бейдж для README
Исходный SKILL.md
---
name: ozon-seller-api
description: Ozon Seller API reference and helper. Use when working with Ozon marketplace API integrations, endpoints, request or response schemas, Client-Id/Api-Key auth, OAuth, products, prices, stocks, warehouses, FBO/FBS/rFBS/FBP postings, returns, finance, analytics, reports, reviews, questions, chats, push notifications, offer_id, product_id, sku, or warehouse_id.
---
# Ozon Seller API
Use this skill for targeted Ozon Seller API lookups and integration help. Treat `swagger.json` as the only API documentation source of truth.
## Protocol Details
Do not rely on static protocol notes in this skill body. Use Swagger-derived helper output instead:
- Endpoint method, media type, auth headers, and parameters: `node scripts/lookup-operation.js --operation-id <id> --details`
- API key auth: `node scripts/lookup-operation.js --doc-tag Auth`
- OAuth: `node scripts/lookup-operation.js --doc-tag OAuth-token`
- Environment/base host: `node scripts/lookup-operation.js --doc-tag Environment`
## Lookup Workflow
Run helper commands from this skill directory, or use an absolute path to `scripts/lookup-operation.js`. In Claude Code, `${CLAUDE_SKILL_DIR}` points at this skill directory.
1. For a bird's-eye view, start with the Swagger-backed map. It uses `x-tagGroups` and tag metadata from `swagger.json`:
`node scripts/lookup-operation.js --map`
2. For targeted search, query the read-only helper:
`node scripts/lookup-operation.js --query "product list" --limit 5`
3. For a known endpoint, path, or operation ID:
`node scripts/lookup-operation.js --operation-id ProductAPI_GetProductList --details`
`node scripts/lookup-operation.js --path /v3/product/list --details`
4. For lower-level navigation, list raw tags or operations in one tag:
`node scripts/lookup-operation.js --tags`
`node scripts/lookup-operation.js --tag ProductAPI --limit 20`
## Answering Rules
- Use the exact method and path from the lookup result.
- Include auth headers in examples, using placeholders only. Prefer parameter details from `--details`.
- If an endpoint is beta, premium, or Ozon Delivery specific, say so.
- Prefer the user's requested language or stack for code examples.
- For direct API examples, include the JSON body shape and a minimal success-path request.
- Do not invent or rely on a bundled Ozon CLI. Generate small app-specific wrappers when the user asks for executable code.