Ozon Seller API skill

Install

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

This is third-party code. Review the repository files before installing.

What it does

The skill keeps the full OpenAPI 3.0 spec of the Ozon Seller API and a lookup-operation.js helper that finds operations by query, path or operationId, expands parameters and schemas, and shows auth, OAuth and environment docs. The helper runs locally and does not call the Ozon API. The agent answers with exact methods and paths from the spec and uses placeholders for Client-Id and Api-Key.

Who it is for. For Ozon integration developers coding in Claude Code or Codex.

Example request

How do I update FBS warehouse stocks via the Ozon API? Show the method and request body

Limitations

swagger.json must be replaced manually when Ozon updates the API. The helper needs Node.js.

How to disable. Remove the ozon-seller-api folder from your agent's skills directory.

Security check

• The local helper only reads the spec and makes no network calls

README in short

The README describes an Agent Skills package for Claude Code, Codex and other agents. Install by cloning into a personal or project skills directory. The helper supports --map, --tags, --doc-tags, --query, --operation-id, --path, --details, --schemas and --validate. The section map is derived from the spec's x-tagGroups, with no hand-maintained index.

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.

Related