amazon-catalog-cli

分类: 测试与安全 | 上传者: BWB03 | 下载: 0 | 版本: v1.0（最新）

Catalog CLI 审核亚马逊类别列表报告（CLR 文件，.xlsx）以查找列表质量问题。它运行 12 个查询插件，涵盖缺失属性、标题验证、项目符号优化、产品类型检查等。

更新日志: Source: GitHub https://github.com/BWB03/amazon-catalog-cli

目录结构

当前层级: 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)

登录后下载/点赞/收藏 ❤ 6 | ★ 0

amazon-catalog-cli

目录结构

SKILL.md

举报内容

提示