Catalog CLI

Agent-native Amazon catalog auditing tool. 13 quality checks for your listings. Run locally, integrate with AI agents, or use our hosted API.

pip install amazon-catalog-cli

click to copy

$ catalog scan my-catalog.xlsx

GitHub API Docs

Get Started

Choose your path based on your comfort level.

Non-Technical Easiest

Use Claude Code as your guide

Install Claude Code (Anthropic's coding tool)
Open Claude Code and say:
"Install the amazon-catalog-cli package and set it up as an MCP server"
Then say:
"Scan my-catalog.xlsx and explain the issues"

Claude Code runs the install for you and walks you through everything in plain English.

Power User Free

Run audits from your terminal

Install: pip install amazon-catalog-cli
Download your CLR from Seller Central
Run: catalog scan my-catalog.xlsx
Review results with color-coded severity

Full control. Rich terminal output. Export to JSON or CSV.

Developer / Agency Pro

Integrate into your tools

Register: POST api.catalogcli.com/v1/auth/register
Upload CLR via API
Run scans programmatically
Build dashboards, automations, client reports

Persistent storage. Unlimited scans. $9.99/mo.

What It Checks

Attribute Audits

missing-attributes — Required fields that are empty
missing-any-attributes — All missing fields (required + conditional)
new-attributes — Template fields you're not using

Content Quality

rufus-bullets — Score bullets against Amazon's RUFUS AI framework
bullet-prohibited-content — Prohibited chars, emojis, claims
bullet-formatting — Length, caps, punctuation checks
bullet-awareness — Soft violations and style issues
long-titles — Titles exceeding 200 characters
title-prohibited-chars — Prohibited characters in titles
prohibited-chars — Prohibited chars in title/brand
hijacking-detection — Detect potential catalog hijacking

Catalog Structure

product-type-mismatch — Product type vs item type mismatches
missing-variations — Products that should be grouped as variations

Four Ways to Use

CLI Free

catalog scan my-catalog.xlsx

Run audits locally from your terminal. Rich output with severity-coded tables.

Python Free

from catalog.core import execute_scan

Import directly into your Python scripts and automation pipelines.

Claude Code Free Pro

catalog setup-claude

Use natural language to audit catalogs. Free locally, or Pro for hosted API with persistent storage.

Hosted API Pro

POST api.catalogcli.com/v1/catalogs

Persistent storage, unlimited scans, API access for your tools and dashboards.

Pricing

	Open Source CLI	Free API	Pro API
	Free forever	Free forever	$9.99/mo
13 quality audits	✓	✓	✓
Scans	Unlimited (local)	2 lifetime	Unlimited
Catalogs stored	—	1	Unlimited
Results persistence	—	7 days	Permanent
API access	—	✓	✓
Rate limit	—	10 req/min	100 req/min
Variation Creator	—	—	Coming soon

Claude Code Integration

Use natural language to audit your Amazon catalogs. One command to set up.

catalog setup-claude

catalog setup-claude --pro --api-key YOUR_KEY

You: Scan my-catalog.xlsx and tell me the biggest issues

Found 29,902 issues across 164 SKUs. Top concerns: - 847 required attributes missing (brands, product types) - 2,140 bullet points scored below 3/5 on RUFUS framework - 12 potential hijacking cases detected Recommend starting with the hijacking cases — those need immediate attention.

Free (Local)

MCP server runs on your machine. Claude Code calls the CLI directly. Your CLR files never leave your computer.

Pro (Hosted API)

Claude Code talks to api.catalogcli.com. Persistent storage, scan history, unlimited catalogs — all through natural language.

Security

Open Source CLI

Your data stays local. The CLI processes everything on your machine. No data leaves your computer. No accounts, no tracking.

Pro API Storage

CLR files are stored in Cloudflare R2 — encrypted at rest, zero-egress architecture. Files are only accessible via your API key. Delete your data anytime through the API.

Input validation includes path traversal protection, injection prevention, and Pydantic schema enforcement on all inputs.

FAQ

What is a CLR?

A Category Listing Report is Amazon's official bulk product data export. It contains all your listing fields — titles, bullets, attributes, variations, and more. Download it from Seller Central under Inventory > Category Listing Report.

Is this free?

The CLI is free and open source (MIT license). The hosted API has a free tier (2 scans) and a Pro tier ($9.99/mo) for unlimited access with persistent storage.

Does this work with AI agents?

Yes. Catalog CLI was designed agent-first. It includes an MCP server for Claude Code and Claude Desktop, JSON output for automation, schema introspection, and field masking for efficient context usage.

What marketplaces are supported?

Any Amazon marketplace that uses Category Listing Reports. The tool auto-detects the marketplace from the CLR file headers.

Can I add custom checks?

Yes. The plugin architecture makes it easy to add new queries. Create a new Python file in the queries directory implementing the QueryPlugin interface.