amazon-catalog-cli

Category: Testing & Security | Uploader: BWB03 | Downloads: 0 | Version: v1.0（Latest）

Catalog CLI audits Amazon Category Listing Reports (CLR files, .xlsx) for listing quality issues. It runs 12 query plugins covering missing attributes, title validation, bullet point optimization, product type checks, and more.

Changelog: Source: GitHub https://github.com/BWB03/amazon-catalog-cli

Directory Structure

Current level: tree/main/

📁 catalog/
- 📁 core/
  - 📄 __init__.py 393 B
  - 📄 engine.py 5.5 KB
  - 📄 models.py 4.2 KB
  - 📄 parser.py 11.6 KB
  - 📄 query_engine.py 4.1 KB
  - 📄 schema.py 1.2 KB
  - 📄 validation.py 2.0 KB
- 📁 queries/
  - 📄 __init__.py 983 B
  - 📄 bullet_validation.py 10.7 KB
  - 📄 char_validation.py 1.6 KB
  - 📄 hijacking_detection.py 4.0 KB
  - 📄 missing_attributes.py 2.2 KB
  - 📄 new_attributes.py 1.6 KB
  - 📄 product_type_check.py 1.5 KB
  - 📄 rufus_bullets.py 12.5 KB
  - 📄 title_checks.py 1.9 KB
  - 📄 variation_check.py 2.5 KB
- 📁 surfaces/
  - 📄 __init__.py 43 B
  - 📄 cli.py 15.5 KB
  - 📄 mcp.py 7.4 KB
- 📄 __init__.py 77 B
- 📄 cli.py 153 B
- 📄 output.py 5.5 KB
- 📄 parser.py 141 B
- 📄 query_engine.py 193 B
📁 tests/
- 📄 __init__.py 0 B
- 📄 test_cli.py 2.7 KB
- 📄 test_mcp.py 554 B
- 📄 test_models.py 2.7 KB
- 📄 test_schema.py 1.5 KB
- 📄 test_validation.py 3.2 KB
📄 .gitignore 99 B
📄 catalog_cli.py 140 B
📄 CHANGELOG.md 7.5 KB
📄 LICENSE 1.0 KB
📄 OPENCLAW.md 1.1 KB
📄 README.md 9.3 KB
📄 requirements.txt 69 B
📄 setup.py 1.2 KB
📄 SKILL.md 2.7 KB

SKILL.md

# Catalog CLI - Agent Guidance

## What this tool does
Catalog CLI audits Amazon Category Listing Reports (CLR files, .xlsx) for listing quality issues. It runs 12 query plugins covering missing attributes, title validation, bullet point optimization, product type checks, and more.

## Quick patterns

### Health check (fastest)
```bash
catalog scan report.xlsx --format json --queries missing-attributes,long-titles --fields sku,severity,details --limit 10
```

### Full audit
```bash
catalog scan report.xlsx --format json
```

### Single query
```bash
catalog check rufus-bullets report.xlsx --format json --limit 20
```

### JSON input (structured)
```bash
catalog scan --json '{"file": "report.xlsx", "queries": ["missing-attributes"], "fields": ["sku", "severity"], "limit": 10}'
```

### Piped input
```bash
echo '{"file": "report.xlsx"}' | catalog scan --stdin
```

### Schema discovery
```bash
catalog schema --format json
catalog schema missing-attributes --format json
```

## Rules for agents

1. **Always use `--format json`** for machine-readable output
2. **Use field masks** (`--fields sku,severity,details`) to reduce output size
3. **Use `--limit`** to cap results and avoid overwhelming context
4. **Check schema first** for unknown queries: `catalog schema --format json`
5. **Use NDJSON** (`--format ndjson`) for streaming large results line-by-line

## Available queries

| Query | Description |
|-------|-------------|
| `missing-attributes` | Find mandatory attributes missing from listings |
| `missing-any-attributes` | Find all missing attributes (required + conditional) |
| `long-titles` | Find titles exceeding 200 characters |
| `title-prohibited-chars` | Find titles with prohibited characters |
| `rufus-bullets` | Evaluate bullets against Amazon's RUFUS AI framework |
| `prohibited-chars` | Find prohibited characters in title/brand |
| `bullet-prohibited-content` | Find prohibited content in bullet points |
| `bullet-formatting` | Check bullet formatting (caps, length, punctuation) |
| `bullet-awareness` | Soft violations in bullets (excessive caps, etc.) |
| `product-type-mismatch` | Product type / item type keyword mismatches |
| `missing-variations` | Products that might be missing variation relationships |
| `new-attributes` | Template attributes not being used |

## MCP server

Add to Claude Desktop config:
```json
{
  "mcpServers": {
    "catalog": {
      "command": "catalog",
      "args": ["mcp"]
    }
  }
}
```

MCP tools: `catalog_scan`, `catalog_check`, `catalog_list_queries`, `catalog_schema`

## Environment variables

- `CATALOG_CLI_DEFAULT_FORMAT` - Default output format (default: `terminal`, set to `json` for headless/CI)
- `CATALOG_CLI_CONFIG` - Config file path (reserved for future use)

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

amazon-catalog-cli

Directory Structure

SKILL.md

Report

Notice