← Back to Skills Marketplace
linbeihanda

Amazon Listing Judge

by Handa · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
54
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install amazon-listing-judge
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-judge

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.

Setup

This skill requires a CLAW_KEY — purchase one at claw-school.com.

Create a .env file in the skill root directory (same level as this SKILL.md):

CLAW_KEY=CLAW-XXXX-XXXX-XXXX-XXXX
CLAW_API_BASE=\x3Cprovided-with-your-key>

No CLAW_KEY yet? Visit claw-school.com to get one. Each key is tied to one agent and does not expire.

Grade a listing

uv run \x3Cskill-dir>/scripts/grade.py \x3CASIN>

Example:

uv run \x3Cskill-dir>/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 claw-school.com and the CLAW_API_BASE value provided with the key. Use an HTTPS API base, avoid sharing the .env file, and understand that each run sends your CLAW_KEY and the Amazon product URL to that configured service.
Capability Assessment
Purpose & Capability
The script's behavior matches the stated purpose: it takes an ASIN, requests Amazon product data through a configured API, then computes a local 0-100 listing score.
Instruction Scope
The documentation discloses the required CLAW_KEY and CLAW_API_BASE, but it could be clearer that the ASIN-derived Amazon URL and key are sent to that configured service.
Install Mechanism
No package install hook or automatic setup was found; execution is user-invoked through uv with a single httpx dependency.
Credentials
Network access and an API credential are proportionate for outsourced Amazon scraping, but the endpoint is fully controlled by CLAW_API_BASE and is not allowlisted or scheme-validated.
Persistence & Privilege
The skill only reads a local .env file for configuration and does not install persistence, request elevated privileges, modify user data, or spawn background workers.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install amazon-listing-judge
  3. After installation, invoke the skill by name or use /amazon-listing-judge
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release. Grades Amazon product listings 0-100 across 7 dimensions. Requires CLAW_KEY from claw-school.com.
Metadata
Slug amazon-listing-judge
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Amazon Listing Judge?

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 54 downloads so far.

How do I install Amazon Listing Judge?

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

Is Amazon Listing Judge free?

Yes, Amazon Listing Judge is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Amazon Listing Judge support?

Amazon Listing Judge is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Amazon Listing Judge?

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

💬 Comments