Скилл Ozon Seller API

Установка

git clone https://github.com/miilg/ozon-seller-api-skill.git ~/.claude/skills/ozon-seller-api

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл хранит полную OpenAPI 3.0 спецификацию Ozon Seller API и скрипт lookup-operation.js, который ищет операции по запросу, пути или operationId, раскрывает параметры и схемы, показывает разделы про авторизацию, OAuth и окружение. Скрипт работает локально и не вызывает API Ozon. Агент отвечает по точным методам и путям из спецификации и подставляет в примеры только плейсхолдеры для Client-Id и Api-Key.

Для кого. Для разработчиков интеграций с Ozon, которые пишут код в Claude Code или Codex.

Пример запроса к агенту

Как обновить остатки на FBS-складах через Ozon API? Покажи метод и тело запроса

Ограничения

swagger.json нужно заменять вручную при обновлении API Ozon. Для скрипта нужен Node.js.

Как отключить. Удалите каталог ozon-seller-api из папки скиллов агента.

Проверка безопасности

• Локальный скрипт только читает спецификацию и не делает сетевых запросов

Коротко о README

README описывает пакет в формате Agent Skills для Claude Code, Codex и других агентов. Установка клонированием в личный или проектный каталог скиллов. Скрипт поддерживает флаги --map, --tags, --doc-tags, --query, --operation-id, --path, --details, --schemas и --validate. Карта разделов строится из x-tagGroups спецификации, отдельный рукописный индекс не ведется.

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.

Похожие