# catalog-cli-pro

An MCP server that runs 14 listing quality checks on an Amazon catalog. Point it at a CLR file and read the issues.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 17
- Author: BWB03
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/BWB03/amazon-catalog-cli
- Updated: 2026-09-03
- HTML: https://affpapa.org/en/nevibecode/mcp/catalog-cli-pro

## What it does

catalog-cli-pro plugs an agent into Amazon catalog auditing. The checks match the `catalog` CLI: missing mandatory attributes, banned characters in titles, bullet formatting, product type mismatches, products that should be variations. One check, `mobile-title-readiness`, flags titles past 75 characters and hands back the first 75 characters, the overflow and the significant terms, which is what you need before rewriting.

Seven MCP tools ship with it: `catalog_scan`, `catalog_scan_summary`, `catalog_check`, `catalog_seller_listing_fetch`, `catalog_seller_listing_diff`, `catalog_list_queries`, `catalog_schema`. The fetch tool pulls live Seller Central listing JSON for an ASIN; the diff tool lines that JSON up against a row in your CLR. Seller Central cookies never leave your machine — pass them with `--cookie`, `--cookie-file` or `CATALOG_SELLER_CENTRAL_COOKIE`.

You need `CATALOG_API_KEY` set, or the server will not start. A hosted option at $9.99/mo adds persistent storage and removes the scan cap. Locally it runs through `npx`. Incoming requests are validated with Pydantic, so malformed JSON and path traversal get rejected before any work happens.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CATALOG_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add catalog-cli-pro -e CATALOG_API_KEY=<CATALOG_API_KEY> -- npx -y @bwb03/catalog-cli-pro
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add catalog-cli-pro --env CATALOG_API_KEY=<CATALOG_API_KEY> -- npx -y @bwb03/catalog-cli-pro
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "catalog-cli-pro": {
            "command": "npx",
            "args": [
                "-y",
                "@bwb03/catalog-cli-pro"
            ],
            "env": {
                "CATALOG_API_KEY": "<CATALOG_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "catalog-cli-pro": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@bwb03/catalog-cli-pro"
            ],
            "env": {
                "CATALOG_API_KEY": "<CATALOG_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CATALOG_API_KEY=<CATALOG_API_KEY> catalog-cli-pro npx -y @bwb03/catalog-cli-pro
```
Replace <…> with your own values

## When to use it
- surface mandatory attributes that listings are missing
- catch banned characters and emojis inside bullet points
- list titles over 75 characters ahead of Amazon's mobile update
- diff a live listing against its Category Listing Report row
- export audit results as JSON for downstream tooling

## Example prompts
- Run `catalog scan` on `my-catalog.xlsx` and show me only the error-level issues
- Check the titles with `mobile-title-readiness` and list the ones over 75 characters
- Diff the live listing `B000TEST01` against my CLR file and show what changed

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

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