Catalog CLI

Agent-native Amazon catalog auditing tool

The first AI-agent-friendly Amazon catalog analysis tool. Query your CLRs with structured input, integrate via MCP server, and automate catalog audits.

Hosted API available at api.catalogcli.com — persistent storage, unlimited scans, and API access for $9.99/mo. Learn more

What's New in v2.0

• Shared core architecture - Business logic separated into catalog/core/, powering both CLI and MCP
• MCP server - catalog mcp launches a stdio MCP server with 4 tools, ready for Claude Desktop and any MCP client
• JSON input - --json and --stdin flags for structured agent input
• Schema introspection - catalog schema --format json returns full request/response schemas
• Field masks - --fields sku,severity,details to reduce output size
• Pagination - --limit and --offset for controlling result size
• NDJSON streaming - --format ndjson for line-by-line streaming of large results
• Input hardening - Pydantic validation rejects path traversal, injection, and malformed input
• Environment variables - CATALOG_CLI_DEFAULT_FORMAT=json for headless/CI use
• Backward compatible - All v1.x commands work unchanged

Features

• Agent-Native - CLI + MCP server as equal citizens, JSON/NDJSON output, schema introspection
• Fast - Query 1000+ SKU catalogs in seconds
• Extensible - Plugin system for custom queries
• Comprehensive - 13 built-in catalog health checks
• Intent Optimized - COSMO-inspired shopper intent coverage for bullets

Installation

pip install amazon-catalog-cli

Or install from source:

git clone https://github.com/BWB03/amazon-catalog-cli.git
cd amazon-catalog-cli
pip install -e .

Quick Start

For Humans

# Run all catalog checks
catalog scan my-catalog.xlsx

# Detailed results
catalog scan my-catalog.xlsx --show-details

# Run specific check
catalog check intent-bullets my-catalog.xlsx

# List available queries
catalog list-queries

For AI Agents

# JSON output with field mask and limit
catalog scan my-catalog.xlsx --format json --fields sku,severity,details --limit 20

# Structured JSON input
catalog scan --json '{"file": "my-catalog.xlsx", "queries": ["missing-attributes"], "limit": 10}'

# Piped input
echo '{"file": "my-catalog.xlsx"}' | catalog scan --stdin --format json

# NDJSON streaming for large results
catalog scan my-catalog.xlsx --format ndjson

# Schema introspection (discover queries, params, response shapes)
catalog schema --format json

MCP Server (for Claude Desktop, CLR Pro, etc.)

# Start MCP server
catalog mcp

Add to Claude Desktop config:

{
  "mcpServers": {
    "catalog": {
      "command": "catalog",
      "args": ["mcp"]
    }
  }
}

MCP tools: catalog_scan, catalog_check, catalog_list_queries, catalog_schema

Available Queries

Attribute Audits

• missing-attributes - Find mandatory attributes missing from listings
• missing-any-attributes - Find all missing attributes (required + conditional)
• new-attributes - Find unused template fields that might add value

Content Quality

• intent-bullets - Score bullet points against shopper intent coverage
• bullet-prohibited-content - Find bullet points with prohibited chars, emojis, claims, or placeholders
• bullet-formatting - Check bullet formatting (capitalization, length, punctuation)
• bullet-awareness - Soft violations in bullets (excessive caps, problematic chars)
• long-titles - Find titles exceeding 200 characters
• title-prohibited-chars - Find titles with prohibited characters
• **p

... View full README on GitHub