Ozon Seller API skill

Ozon Seller API — Agent Skill

An Ozon Seller API reference skill: the full swagger.json plus a Node.js helper for compact endpoint and schema lookups

  • 4 ★ on the repository
  • Last commit
Skill

Extended access

Why this level

  • The agent runs the lookup-operation.js Node script to search the Ozon Seller API spec
  • The script works on a local swagger.json and never calls the Ozon API
All reasons and checks
Russian stack

miilv/ozon-seller-api-skill

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/ozon-seller-api-agent-skill

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The agent runs the lookup-operation.js Node script to search the Ozon Seller API spec
  • The script works on a local swagger.json and never calls the Ozon 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.

Good fit when

  • You need a method for products, stocks, FBO or FBS postings
  • You need a request schema before writing an integration
  • You need a minimal API call example in your language

Not a fit when

  • You need a ready CLI or client for real Ozon API calls
  • You need sales analytics rather than documentation

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.

FAQ

Where does the spec come from?

From the official Ozon Seller API docs at docs.ozon.ru.

Does the helper call Ozon?

No, it only reads the local swagger.json.

Discussion

No questions or reviews yet.

Russian stack

A skill bundling the official OpenAPI specs for Ozon Seller (463 operations) and Performance API (48 operations), plus a CLI to look up the right method

SkillExtended access6Repository stars
Russian stack

A skill with two dozen Python scripts over the Ozon Seller API: stock, turnover, financial reports, product cards and reviews

SkillExtended access
Russian stack

A reference skill for the Ozon Seller API's FBS flow: posting processing, labels, Honest Sign marking and acts, with a full OpenAPI schema

SkillMinimal access

Ozon store analytics skill for Codex

Ozon Store Analytics Skill

Russian stack

A read-only Codex skill for Ozon store analytics: impressions, product views, conversion, orders, delivery, cancellations, returns and search ranking

SkillExtended access2Repository stars
Russian stack

A Codex skill with baseline Ozon selling knowledge: automated listing uploads, Ozon-specific keyword optimization and operational diagnostics

SkillMinimal access1Repository stars

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.

README badge

Original 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.

Report a problem

Foxx AIOzon Seller API skill
Foxx AI

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.