SkillFoxx

wb-codex-harness: a Codex workspace for the Wildberries cabinet

wb-codex-harness

A ready Codex folder: a WB MCP server, five skills and scripts for per-article profit and the card funnel, writing only after your yes

  • 0 ★ on the repository
  • Last commit
Workflow

Broad access

Why this level

  • A Wildberries token with the "Prices and discounts", "Promotion" and "Questions and reviews" categories lets the agent write prices, ads and review replies
  • A review reply and spent advertising budget cannot be rolled back, even though writing goes through confirmation
All reasons and checks
Russian stack

webkoth/wb-codex-harnessAuthor:Minas Sarkisyan

Install

Works in
Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add workflows/wb-codex-harness

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

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • A Wildberries token with the "Prices and discounts", "Promotion" and "Questions and reviews" categories lets the agent write prices, ads and review replies
  • A review reply and spent advertising budget cannot be rolled back, even though writing goes through confirmation

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

What it does

The repository builds a Codex workspace for a Wildberries seller cabinet. It has a TypeScript WB MCP server with tools for cards, prices, advertising, reviews, orders, stock, finances and the funnel, calculation scripts and five skills: `setup-check`, `cost-import`, `profit`, `card-funnel` and `card-lab`. Scripts calculate money and the model never recalculates them: `profit` builds profit before tax per article from the realization report, advertising, storage and cost price and writes `reports/profit-*.xlsx`. `card-funnel` shows where cards lose money and prepares draft edits in `drafts/`. `card-lab` looks at competitors, the second frame and SEO but never writes to the cabinet itself. Write tools show a was-and-will-be preview, ask for confirmation and log to `data/changes.jsonl`, with rollback through `scripts/rollback.ts`. For a price the server rereads values and returns `applied`, `pending`, `rejected` or `unknown`.

Who it is for. Wildberries sellers who calculate unit economics in spreadsheets and want to hand Codex the per-article profit calculation and the card funnel review.

Good fit when

  • You need profit before tax per article for last week with advertising and storage
  • Cost price sits in a spreadsheet or a supplier price list and must be brought into `data/cost.csv`
  • You need to see at which funnel step a card loses orders and get draft edits
  • A price change must be applied, checked by the `applied` status and rolled back if needed

Not a fit when

  • You need profit after tax: scripts calculate before tax only
  • You need a client other than Codex CLI: rules and skills are written for Codex
  • You need organic CTR: the Wildberries API has none, only visibility and advertising CTR remain

Example request

Calculate profit per article for last week and show the unprofitable ones

Limitations

Installation is described for macOS: it needs Node.js 20 or newer, Codex CLI and a personal Wildberries token for 180 days with the "Content", "Analytics", "Statistics", "Finance", "Promotion", "Prices and discounts" and "Questions and reviews" categories. The first profit calculation takes minutes because of Wildberries limits, then the cache is used. A reply to a review and spent advertising budget cannot be rolled back. No license is stated in the repository. One author, the last commit in October 2026, no stars.

How to disable. Delete the project folder and the `wb` server entry from `.codex/config.toml`, then revoke the token in the Wildberries cabinet under "API access".

FAQ

How do I set up the workspace?

Run `./setup.sh` in the cloned folder: it installs dependencies, builds the WB MCP server, writes `.codex/config.toml` and creates `.env`. Then paste the token into `WB_API_TOKEN=`.

Which skills are in the workspace?

`$setup-check`, `$cost-import`, `$profit`, `$card-funnel` and `$card-lab`. They live in `.agents/skills/` and are called by name in Codex.

How do I roll back a change in the cabinet?

List journal entries with `npx tsx scripts/rollback.ts --list`, then run `npx tsx scripts/rollback.ts <id> --yes`. A price rollback also verifies the result.

What does `pending` mean for a price?

WB accepted the request but the application is not yet visible on rereading. Do not repeat the write blindly, check the price in the cabinet first.

Why does the model not do the calculations?

By the `AGENTS.md` rules scripts in `scripts/*.ts` calculate money, and the model neither sums amounts nor recalculates the result with its own formulas.

Discussion

No questions or reviews yet.

All Wildberries tools
Russian stack

A read-only Wildberries MCP server: products, ads, orders, stock, finance and reviews, with writes blocked in code, not just prompts

MCP serverExtended access
Russian stack

Wildberries Seller API MCP server: cards, prices, promotions, ads, orders, supplies, reviews and finance across several stores

MCP serverBroad access8

Wildberries MCP

wildberries-mcp

Russian stack

MCP server for the Wildberries seller API: products, prices, stock, orders, FBS supplies, analytics, reviews and ads

MCP serverBroad access16
Russian stack

Seven Codex skills for Wildberries jewelry cards: a CTR-focused main photo, an 8-slide series, local retouching and visual autotests

SkillMinimal access1

README in short

The README explains how to install the workspace, which commands to say to Codex, how folders are organised, how writes to the cabinet are protected, how to run code checks and what limits the calculations have.

README badge

Report a problem