Catalog CLI Pro MCP server

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

• Seller Central AJAX lookup - Fetch Amazon's live Seller Central listing JSON with catalog listing fetch
• Live listing vs CLR diff - Compare Amazon's current listing fields against your Category Listing Report with catalog listing diff
• Agent-ready Seller Central tools - New MCP tools catalogsellerlistingfetch and catalogsellerlistingdiff
• Local cookie auth - Use --cookie, --cookie-file, or CATALOGSELLERCENTRAL_COOKIE; Seller Central cookies stay local

v2.2 Title Readiness

• Amazon title readiness - mobile-title-readiness flags titles over 75 characters for Amazon's mobile title update
• Rewrite-ready output - Returns first-75-character title segments, overflow text, significant terms, item highlight status, and recommended next actions
• Agent workflow friendly - Aliases title-75 and amazon-title-75 make it easy to call from Claude, MCP clients, and automation workflows
• 14 built-in checks - Adds a title triage workflow while keeping the classic 200-character long-titles check unchanged

v2.0 Agent Foundations

• 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 - CATALOGCLIDEFAULT_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 - 14 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

# Audit titles for Amazon's 75-character mobile title update
catalog check mobile-title-readiness 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

# Title rewrite triage for agents
catalog check mobile-title-readiness my-catalog.xlsx --format json \
  --fields sku,details,title_char_count,mobile_visible_title,overflow_title,all_significant_terms

Shortened. The full README is on GitHub.