{
  "markdown": "# mcp-ozon-seller\n\n[![License: MIT + Commons Clause](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue.svg)](./LICENSE)\n\nMCP server for [Ozon Seller API](https://docs.ozon.ru/api/seller/) — Russia's largest marketplace.\n\nConnect AI clients (Claude Desktop, Cursor, n8n) to your Ozon seller account: manage products, update prices and stocks, view orders, get analytics, monitor finances and returns.\n\n> **First MCP server for Ozon Seller API.**\n\n**26 tools · 7 groups · Two modes: local (stdio) + remote (HTTP)**\n\n---\n\n## Tools\n\n### A. Account\n\n| Tool | Description |\n|------|-------------|\n| `get_seller_info` | Verify credentials, get account info |\n\n### B. Products\n\n| Tool | Description |\n|------|-------------|\n| `list_products` | List products with status filters |\n| `get_product` | Product card: attributes, status, images |\n| `create_product` | Create new products (up to 100 at once) |\n| `update_product` | Update product attributes and description |\n| `archive_product` | Hide product from storefront |\n| `unarchive_product` | Restore product to active sale |\n\n### C. Prices & Stocks\n\n| Tool | Description |\n|------|-------------|\n| `get_prices` | Current prices and price index |\n| `update_prices` | Update prices (up to 1000 products at once) |\n| `get_stocks` | Stock levels across all warehouses |\n| `update_stocks` | Update FBS warehouse stocks |\n\n### D. Orders\n\n| Tool | Description |\n|------|-------------|\n| `list_fbo_orders` | List FBO orders |\n| `get_fbo_order` | FBO order details |\n| `list_fbs_orders` | List FBS orders |\n| `get_fbs_order` | FBS order details |\n| `get_fbs_awaiting` | FBS orders waiting to be shipped |\n\n### E. Analytics\n\n| Tool | Description |\n|------|-------------|\n| `get_analytics` | Sales, revenue, views, returns — any period |\n| `get_warehouse_stocks` | Ozon warehouse stocks with turnover data |\n\n### F. Finance\n\n| Tool | Description |\n|------|-------------|\n| `get_finance_report` | Cash flow report for a period |\n| `list_transactions` | Transactions: accruals, commissions, payouts |\n| `get_transactions_totals` | Transaction summary totals |\n\n### G. Returns & Rating\n\n| Tool | Description |\n|------|-------------|\n| `list_fbo_returns` | FBO returns: items, reasons, amounts |\n| `list_fbs_returns` | FBS returns: items, reasons, amounts |\n| `get_seller_rating` | Seller quality index |\n| `get_seller_rating_history` | Seller rating history over time |\n| `list_warehouses` | Seller warehouses (IDs needed for stock updates) |\n\n---\n\n## Quick Start\n\n### Mode 1: Local (stdio) — Claude Desktop / Cursor\n\n**Step 1:** Get your API credentials\nOzon Seller → Settings → API Integrations → Seller API → Create key (role: **Admin**)\n\n**Step 2:** Add to your Claude Desktop config:\n\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"ozon-seller\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@woyax/mcp-ozon-seller\"],\n      \"env\": {\n        \"OZON_CLIENT_ID\": \"123456\",\n        \"OZON_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n**Step 3:** Restart Claude Desktop. Ask: *\"Show my top 10 products by revenue for last week\"*\n\n---\n\n### Mode 2: Remote (HTTP) — hosted on your VPS\n\n**Start the server:**\n```bash\nMCP_PORT=3000 npx @woyax/mcp-ozon-seller --transport http\n```\n\n**Connect from any MCP client:**\n```\nhttp://your-server.com:3000/mcp?client_id=123456&api_key=your-api-key\n```\n\nMultiple users can connect simultaneously — credentials are passed per-request.\n\n---\n\n## n8n Integration\n\nAdd a custom MCP node with URL:\n```\nhttp://your-server.com:3000/mcp?client_id=CLIENT_ID&api_key=API_KEY\n```\n\n---\n\n## Example Prompts\n\n```\nShow my revenue and orders for the last 7 days\n```\n```\nList all products that are out of stock\n```\n```\nUpdate the price for offer_id ABC-123 to 1990 rubles\n```\n```\nShow all FBS orders that are waiting to be shipped\n```\n```\nWhat's my current seller rating?\n```\n```\nShow finance report for last month\n```\n\n---\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `OZON_CLIENT_ID` | **Yes** | Numeric seller ID from Ozon personal account |\n| `OZON_API_KEY` | **Yes** | API key (UUID) from Ozon personal account |\n| `MCP_TRANSPORT` | No | `stdio` (default) or `http` |\n| `MCP_PORT` | No | Port for HTTP mode (default: `3000`) |\n\n---\n\n## API Credentials\n\n1. Go to [Ozon Seller](https://seller.ozon.ru)\n2. Settings → API Integrations → Seller API\n3. Create new key with role **Admin** (required for all 26 tools)\n4. Save `Client-Id` (numeric) and `Api-Key` (UUID)\n\n---\n\n## Rate Limits\n\nOzon API enforces rate limits. This server automatically retries on 429 errors with exponential backoff (1s → 2s → 4s).\n\n⚠️ `get_warehouse_stocks` has stricter limits — avoid calling it in tight loops.\n\n---\n\n## Author & Support\n\nBuilt by [Oleg Alekseev](https://github.com/woyaxnini) — ERP/AI integration architect.\n\n- 📧 [woyaxnini@gmail.com](mailto:woyaxnini@gmail.com) · [woyax@yandex.com](mailto:woyax@yandex.com)\n- 💬 Telegram: [@ale_oleg](https://t.me/ale_oleg) · Channel: [@woyax_ai](https://t.me/woyax_ai)\n- 💬 MAX: [max.ru/id503610654564_biz](https://max.ru/id503610654564_biz)\n\nNeed help integrating AI agents with your ERP, CRM, or Ozon? Custom MCP servers, n8n workflows, AI automation — [contact me](mailto:woyaxnini@gmail.com).\n\n---\n\n## Woyax AI Stack — Corporate AI Suite for Russian Business\n\nThis package is part of **[Woyax AI Stack](https://github.com/woyaxnini)**: a collection of MCP servers and AI agents for business process automation in the Russian corporate environment.\n\n| Component | What it does | Links |\n|---|---|---|\n| **[mcp-max-messenger](https://github.com/woyaxnini/mcp-max-messenger)** | AI integration with MAX messenger: notifications, approvals, bots | [Use cases](https://woyaxnini.github.io/mcp-max-messenger/) · [Article](https://spark.ru/user/268070/blog/317224/mcp-server-dlya-messendzhera-max-po-url-ndash-nashe-vsyo-karta-primenimosti) |\n| **[mcp-chestnyi-znak](https://github.com/woyaxnini/mcp-chestnyi-znak)** | True API access for product labelling: marking codes, documents, balances | [Use cases](https://woyaxnini.github.io/mcp-chestnyi-znak/) |\n| **[mcp-ozon-seller](https://github.com/woyaxnini/mcp-ozon-seller)** | Ozon store management: products, prices, orders, finance, analytics | [GitHub](https://github.com/woyaxnini/mcp-ozon-seller) |\n| **[Woyax AI Process Auditor](https://spark.ru/user/268070/blog/310279/voyaks-analitik-ii-avtomatizatsii-kommercheskaya)** | Telegram bot that conducts structured interviews with employees and builds a company AI automation map | [Article](https://spark.ru/user/268070/blog/310279/voyaks-analitik-ii-avtomatizatsii-kommercheskaya) |\n\n---\n\n## License\n\nMIT + Commons Clause © [Oleg Alekseev](https://github.com/woyaxnini)\n\nFree to use for personal and corporate purposes. Selling as a hosted service requires author's permission. See [LICENSE](./LICENSE) for details.\n",
  "bytes": 7011,
  "sha": "fb8bff2fb18b0936bbaaf47a6c875b7283ed1e4a0278e33e54e5ea3a911064c4",
  "repo_slug": "woyaxnini/mcp-ozon-seller",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_woyaxnini_ozon_seller_5a9ceb19/readme"
}