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

5. For compact non-operation docs such as auth, OAuth, errors, push notifications, or news:

node scripts/lookup-operation.js --doc-tags

node scripts/lookup-operation.js --doc-tag Auth --grep token --limit 20

6. Add --schemas only when request or response fields are needed:

node scripts/lookup-operation.js --operation-id ProductAPI_GetProductList --details --schemas

7. Run validation after changing swagger.json or the helper:

node scripts/lookup-operation.js --validate

8. Do not open the full swagger.json unless the user explicitly asks for broad source material. Use the lookup script for compact output.

Files

• swagger.json: complete OpenAPI source and the only API source of truth.
• scripts/lookup-operation.js: local read-only helper for Swagger-derived API maps, endpoint lookup, doc tag lookup, parameter/schema lookup, and validation. It is not a user-facing Ozon API client.

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.