WB Margin Analyzer
A self-hosted web app for Wildberries sellers: upload purchase and sales Excel files and get a color-coded margin table with Claude commentary
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Only works with Excel files the user uploads, no access to a Wildberries account
- AI features only read already-uploaded analysis data, nothing external is changed
Install
Manual install
git clone https://github.com/TinaUma/wb-margin-analyzer.git && cd wb-margin-analyzer && cp .env.example .env && docker compose up --buildLocal deployment of the whole stack with one command.
This is third-party code. Review the repository files before installing.
What it does
The seller uploads two Excel files (purchase costs and sales), a FastAPI plus pandas backend computes margin as revenue minus commission minus logistics minus cost, with return logistics doubled per WB's tariff. Results render in a React dashboard as color-coded margin zones (green, yellow, red), with sorting, a per-product card and a price/cost what-if simulator. With an Anthropic key configured, Claude Sonnet adds a text diagnosis, recommendations and risks to each analysis and answers follow-up chat questions about it; without a key the app still runs, those endpoints just return a clear error instead of an interpretation. Results can be exported to Excel with colored rows and a separate Claude commentary sheet.
Who it is for. For Wildberries sellers who want to see in seconds which products in a large Excel export are unprofitable, without hand-built spreadsheet formulas.
Good fit when
- You have WB purchase and sales Excel exports and need a fast margin breakdown
- You want color-coded profitability sorting and a price simulator
- You are fine self-hosting it via Docker Compose on your own server or machine
Not a fit when
- You need Wildberries Seller API integration instead of manual Excel exports: the service only works with uploaded files
- You need the AI interpretation and chat without your own Anthropic key: those features are unavailable without one
- You need a ready hosted service without deploying it yourself
Example request
Upload my WB purchase and sales files and show which products are losing moneyLimitations
This is not a skill or an MCP server for an agent, but a standalone web app (FastAPI plus React) deployed via Docker Compose and used through a browser. AI features need the user's own paid ANTHROPIC_API_KEY, the author's public demo does not show them due to Anthropic API geoblocking for Russian servers. The README documents no Seller API integration, only manual Excel uploads.
How to disable. Run docker compose down in the project directory.
Security check
- Only works with Excel files the user uploads, no access to a Wildberries account
- AI features only read already-uploaded analysis data, nothing external is changed
README in short
The README describes the problem (WB sellers can't see real margin because of fees and returns), the margin formula, a Docker Compose quick start, the full stack (FastAPI, SQLAlchemy, pandas, React, PostgreSQL, Claude Sonnet), an environment variable table, and the project layout with backend, frontend and 60 pytest tests.
FAQ
Is an Anthropic key required?
No, the app computes margin without one, but the AI diagnosis, recommendations and chat only work with an ANTHROPIC_API_KEY set.
Can the service connect directly to the WB Seller API?
No, per the README data only enters the service through manually uploading two Excel files.
Related
A set of investment research skills for Claude Code and Codex built on four investors' methodologies. It is a research tool, not investment advice
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
Alpaca's official MCP server: orders for stocks, ETFs, crypto and options, position management and market data in plain language
inn-check-ru: counterparty risk traffic light
inn-check-ru
An open-source skill that checks a Russian company by tax ID across EGRUL, bailiffs, courts, bankruptcy and sanctions, and returns a dated risk verdict