← Back to Skills Marketplace
linbeihanda

amazon-listing-grader

by Handa · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
39
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install amazon-listing-grader
Description
Grade Amazon product listing quality. Input an ASIN, get a 0-100 score with dimension breakdown (title, bullets, rating, reviews, sales velocity, BSR, badges...
README (SKILL.md)

amazon-listing-grader

Score any Amazon product listing on a 0–100 scale across 7 dimensions. Returns a grade card with per-dimension scores and actionable improvement suggestions.

Requirements

  • CLAW_KEY env var set
  • CLAW_API_BASE env var (default: https://api.claw-school.com)
  • uv installed

Grade a listing

uv run ~/.openclaw/agents/sunny-xie/workspace/skills/amazon-listing-grader/scripts/grade.py \x3CASIN>

Example:

uv run ~/.openclaw/agents/sunny-xie/workspace/skills/amazon-listing-grader/scripts/grade.py B088FLY7S8

Scoring dimensions (100 pts total)

Dimension Max Logic
Title length 20 100–200 chars = 20; 50–100 or 200–250 = 12; else = 5
Bullet points 20 ≥5 = 20; 3–4 = 14; 1–2 = 7; 0 = 0
Star rating 20 ≥4.5 = 20; ≥4.0 = 14; ≥3.5 = 8; \x3C3.5 = 3
Review count 15 ≥10K = 15; ≥1K = 12; ≥100 = 7; \x3C100 = 3
Sales velocity 15 "bought in past month" present = 15; absent = 0
BSR 10 Any BSR present = 10; absent = 0
Badges 10 Amazon's Choice + Best Seller = 10; either = 7; none = 0

Grade scale

Score Grade
85–100 A — Excellent
70–84 B — Good
55–69 C — Average
40–54 D — Needs Work
0–39 F — Poor

Output format

{
  "asin": "B088FLY7S8",
  "title": "12 Pack Small American Flags...",
  "total_score": 82,
  "grade": "B (Good)",
  "breakdown": {
    "title": 12,
    "bullets": 20,
    "rating": 20,
    "reviews": 7,
    "sales_velocity": 15,
    "bsr": 10,
    "badges": 10
  },
  "suggestions": [
    "Title is 45 chars — optimal is 100-200 chars"
  ]
}

Interpreting results

Present the results as a structured report. Call out:

  1. Total score and grade label
  2. Strongest dimensions (highest scores)
  3. Weakest dimensions with the suggestions
  4. Overall priority action (the suggestion that would give the biggest score boost)
Usage Guidance
Install only if you trust the publisher and the configured scraping service with your CLAW_KEY and the Amazon listing URLs you analyze. Keep CLAW_API_BASE set to the intended trusted HTTPS endpoint, and avoid using broad trigger phrases for non-Amazon listing work.
Capability Assessment
Purpose & Capability
The artifacts match the stated purpose: a user supplies an ASIN, the script fetches parsed Amazon listing data, scores listing quality dimensions, and prints structured JSON results.
Instruction Scope
Execution is documented as an explicit CLI command, and the required CLAW_KEY and CLAW_API_BASE variables are listed. The docs could be clearer that the key and ASIN-derived Amazon URL are sent to the configured API, and some trigger phrases are broader than Amazon-specific use.
Install Mechanism
No install hook, startup behavior, background worker, or hidden bootstrap was found. The only runtime dependency is httpx declared in the Python script metadata for uv.
Credentials
Network use and a scraping API credential are proportionate for an API-backed listing grader, but users must trust the configured CLAW_API_BASE endpoint because the script posts CLAW_KEY and the target URL there.
Persistence & Privilege
The skill does not request elevated privileges, create persistence, modify local or remote account data, index local files, or read unrelated environment secrets.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install amazon-listing-grader
  3. After installation, invoke the skill by name or use /amazon-listing-grader
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of amazon-listing-grader: - Grades Amazon product listings on a 0–100 scale across 7 key dimensions (title, bullets, rating, reviews, sales velocity, BSR, badges) - Provides per-dimension score breakdowns and actionable improvement suggestions - Returns a structured report highlighting strengths, weaknesses, and prioritized action items - CLI usage requires ASIN input; outputs JSON with scores, grade, breakdown, and suggestions
Metadata
Slug amazon-listing-grader
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is amazon-listing-grader?

Grade Amazon product listing quality. Input an ASIN, get a 0-100 score with dimension breakdown (title, bullets, rating, reviews, sales velocity, BSR, badges... It is an AI Agent Skill for Claude Code / OpenClaw, with 39 downloads so far.

How do I install amazon-listing-grader?

Run "/install amazon-listing-grader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is amazon-listing-grader free?

Yes, amazon-listing-grader is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does amazon-listing-grader support?

amazon-listing-grader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created amazon-listing-grader?

It is built and maintained by Handa (@linbeihanda); the current version is v1.0.0.

💬 Comments