# marketplace-catalog-sync

Guides the agent while you build a seller connector that pushes SKUs into a VTEX marketplace and keeps price and stock in step.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 installs · ★ 46
- Author: vtex
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vtex/skills/tree/HEAD/skills/marketplace-catalog-sync/SKILL.md
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/skills/marketplace-catalog-sync

## What it does

The skill applies to seller-side catalog work on VTEX: registering and updating SKUs through Change Notification, walking a SKU Suggestion from send to pending to approved or denied, mapping product fields onto the VTEX catalog schema, and notifying price and inventory separately. A good part of it is about picking the right route. There are two `POST` routes under `changenotification`, and swapping them breaks the integration.

Seller connectors must call the two-segment form, with the seller account and the seller's own SKU code in the path. The single-segment form expects the marketplace SKU ID, so a seller code does not belong there. A `200 OK` means the SKU is already on file for that seller and you are updating it; `404 Not Found` means you still need to send a suggestion. Suggestions go to `https://api.vtex.com/{accountName}/suggestions/{sellerId}/{sellerSkuId}` rather than the store hostname, using the same App Key and App Token.

Some things are simply off limits. A seller cannot write to the Catalog API directly — `POST /api/catalog/pvt/product` and `POST /api/catalog/pvt/stockkeepingunit` are marketplace-side calls, and from a connector they return `403 Forbidden` or leave entries that skipped approval. A suggestion can only be edited while pending; once the marketplace decides, it is frozen.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill marketplace-catalog-sync -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/marketplace-catalog-sync/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/marketplace-catalog-sync/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill marketplace-catalog-sync -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/marketplace-catalog-sync/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill marketplace-catalog-sync -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/marketplace-catalog-sync/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vtex/skills marketplace-catalog-sync
```

2. **Manually: put the files in place**
- File: `.github/skills/marketplace-catalog-sync/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill marketplace-catalog-sync -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/vtex/skills --path skills/marketplace-catalog-sync
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/marketplace-catalog-sync/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill marketplace-catalog-sync -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/vtex/skills/tree/HEAD/skills/marketplace-catalog-sync/SKILL.md

## When to use it
- register a seller's new SKU in the marketplace catalog
- tell the two changenotification routes apart by path shape
- carry a SKU through suggestion and approval
- send price and inventory notifications on their own endpoints
- answer Fulfillment Simulation inside the time budget

## Example prompts
- Write a seller connector that pushes SKUs to a VTEX marketplace using Change Notification
- Check that SKU registration uses the route with `{sellerId}` and the seller SKU code, not the single `{skuId}` form
- Add price and inventory notifications plus Fulfillment Simulation handling

## Similar
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 472900 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 104400 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs

From the same set: [vtex/skills](https://affpapa.org/en/nevibecode/by/vtex/skills.md) — 38 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md