amazon-listing-doctor
亚马逊 Listing 质检+打分 Skill | Amazon listing health-check & scoring (CDQ/A9/COSMO/Alexa)
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up amazon-listing-doctor (claude-skill project) into my current project. Found on https://claudeers.com/amazon-listing-doctor Repo: https://github.com/buluslan/amazon-listing-doctor Homepage/docs: — Detected install method: claude-skill → # copy this skill into .claude/skills/amazon-listing-doctor/ Category: skills. Platforms: api, desktop. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
# copy the skill dir into your project: # .claude/skills/amazon-listing-doctor/ (or ~/.claude/skills/amazon-listing-doctor/ for all projects)
git clone https://github.com/buluslan/amazon-listing-doctor
// compatibility
| Platforms | api, desktop |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | Python |
🩺 Amazon Listing Doctor
根据亚马逊7月27日正式上线的标题新规，基于 CDQ / A9 / COSMO / Alexa 四大底座的亚马逊 Listing 体检 + 打分 Skill
想了解更多最新AI行业动态,AI+电商/广告的行业实践方法,人与AI如何协作共生的思考,请关注公众号:【新西楼.AI】
CDQ 质量分 · A9 收录 · COSMO 意图覆盖 · Alexa 可发现性 · 合规体检 · 标题词组分诊
Created By Buluu@新西楼
项目简介
Amazon Listing Doctor 是一款 Agent 原生 的亚马逊 Listing 质检 Skill,适配各类 AI Coding Agent。基于四大知识底座(CDQ / A9 / COSMO / Alexa for Shopping)对任意 Listing 做全身体检 + 打分,输出多维度健康报告。零依赖、零 API Key,纯标准库 Python,clone 下来就能跑。
只诊断不改写 —— 告诉你"哪里有问题、该改什么",改写由你自己决定。
兼容性:基于命令行调用,任何能执行 shell 的 Agent 都能用 —— 通过 Skill 加载 / AGENTS.md 注入 / 直接终端调用均可。
✨ 它做什么
一条命令,给你的 Listing 出一份多维度体检报告:
| 维度 | 底座 | 回答的问题 |
|---|---|---|
| CDQ 质量分(主总分) | 亚马逊内部 6 维 ASIN 质量评分 | 我的内容质量能打几分? |
| A9 收录健康度 | A9 搜索收录逻辑 | 我的 Listing 能不能被搜到? |
| COSMO 意图覆盖度 | 亚马逊常识知识图谱(WWW 2024) | 我的 Listing 对不对得上用户意图? |
| Alexa 可发现性 | Alexa for Shopping / Rufus（AEO 买家问答） | AI 购物助手回答买家提问时会推荐我吗? |
| 合规体检 | 2026-07-27 新规 | 我有没有违规? |
| 标题词组分诊 | 词性 + 合规信号 | 标题里每个词该留 / 该挪 / 该删? |
🚫 它不做什么
- 不改写文案 —— 只给"该改什么"的改进建议清单,改写交给你自己
- 不内置浏览器抓取 —— 零依赖,数据靠你粘贴(推荐用第三方工具取数后粘贴)
- 不冒充官方 COSMO 分 —— COSMO 无公开权重,本 skill 的 COSMO 维度是基于公开论文精神的社区诊断,如实标注
🚀 快速开始
# 1. 把你的 listing 归一化成 JSON(见下方 schema),存为 listing.json
# 2. 跑全量体检
python scripts/compliance_report.py --file listing.json > report.json
# 3.(或单独跑某一维)
python scripts/cdq_score.py --file listing.json # CDQ 质量分
python scripts/cosmo_check.py --file listing.json # COSMO 意图覆盖
python scripts/indexability.py --file listing.json # A9 收录
python scripts/title_triage.py --file listing.json # 标题词组分诊
输出是结构化 JSON;按 assets/report-template.md 渲染成人类可读报告。
listing JSON 最小结构 + 数据分层
输入字段分两组,缺字段触发评分降级(标 score=null + 字段缺失原因)而非报错:
{
"market": "US", "language": "en", "mode": "strict_75", "category": "Electronics",
"brand": "Anker", "is_parent": false, "is_variation": true,
"title": "...", "item_highlights": "...",
"bullets": [{"header": "...", "body": "..."}],
"description": "...", "backend_search_terms": "...",
"attributes_filled": ["brand", "color"],
"has_a_plus": true
}
| 分层 | 字段 | 来源 |
|---|---|---|
| 前台（详情页可见） | title / bullets / description / images / brand / has_a_plus / market / language / attributes_filled / attributes_top10_expected | 第三方 API / SP-API 均可取 |
| 后台（详情页不可见） | item_highlights / backend_search_terms / band_a_critical_6 / is_parent / is_variation | 必须从 Seller Central 后台导出 |
为什么这样切:前台数据=详情页对买家可见,第三方工具理论上都能拉;后台数据(backend_search_terms/item_highlights)=隐藏索引字段,外部 API 拿不到。Skill 支持用户单独贴前台/后台/两者一起,缺字段不影响审计流程跑通。
评分降级示例
只给 title 一个字段,缺其他字段时报告输出:
Overall NON-COMPLIANT; 17 passed, 2 failed, 1 warn; CDQ 31.2/100 (Poor); data 29% (minimal)
- COSMO 评分降级: 缺 bullets / item_highlights
- Alexa 评分降级: 缺 bullets / item_highlights
- CDQ 子分 structured_attribute 降级: 缺 attributes_filled + attributes_top10_expected
- A9 子分 backend_hygiene 降级: 缺 backend_search_terms
- ...
data_coverage.unlock_dimensions: [补 item_highlights → 解锁 A9 高亮强度..., 补 attributes → 解锁 CDQ 30% 权重...]
字段不全也没关系——缺的字段对应检查自动跳过,不会报错。详见 SKILL.md。
多语言修复
- ✅ 德语 listing 不再因 mit / für / durch / aus 等介词被判关键词堆砌(虚词按
language自动取) - ✅ promo / subjective 黑名单补齐 de / fr / it / es
- ✅ 全大写品牌名 DJI / BMW / LG / HP / HTC / OPPO / TCL 等走白名单(不依赖用户传 brand 字段)
🧠 四大底座怎么落地
- CDQ:6 维加权(属性 30% / 标题 25% / 变体 20% / 图片 15% / 五点 5% / A+ 5%)→ 0-100 分 + 档位
- A9:核心词前置位置 + backend 卫生度 + 属性完整度 + 有效索引词
- COSMO:扫全文匹配
references/cosmo_ontology.json的常识概念,四维覆盖(use_case / audience / goal / constraint)+ 缺失清单 - Alexa:模拟买家向 AI 购物助手提问,判断 listing 能否被回答(AEO 买家问答,Agent 按规范针对具体产品生成问题;substring 词匹配兜底)
- 标题词组分诊:把标题拆成语义词组,按词性 + 合规信号给去向建议(标题必留 / 下移亮点 / 下移五点 / 删除违规),告诉你每个词该去哪——诊断不是改写
📁 结构
amazon-listing-doctor/
├── SKILL.md # 质检路由(工作流 + 原则)
├── scripts/ # 13 个纯标准库 Python 脚本
│ ├── compliance_report.py # 汇总器(核心入口,含 data_coverage 降级板块)
│ ├── cdq_score.py # CDQ 6 维评分
│ ├── cosmo_check.py # COSMO 意图覆盖(本项目独占)
│ ├── title_triage.py # 标题词组分诊(去向建议)
│ ├── indexability.py # A9 收录
│ ├── alexa_check.py # Alexa 可发现性(AEO 买家问答)
│ ├── alexa_question_gen.py # ALEXA AEO 规范加载器
│ ├── image_check.py # 图片缺陷
│ ├── lint_title/highlights/bullets/backend.py # 合规校验
│ └── check_keyword_layering.py
├── references/ # 规则与词库(公开版)
│ ├── cosmo_ontology.json # COSMO 概念本体(4 维 + 10 类目分词)
│ ├── alexa_question_protocol.md # ALEXA AEO 问题生成规范
│ ├── cdq_weights.json # CDQ 权重
│ ├── rules.json # 合规硬规则(含 de/fr/it/es 多语言黑名单)
│ └── ...
└── assets/ # 输出模板
├── output-template.json
└── report-template.md
📜 License
MIT — 随便用,欢迎 PR 扩展词库/类目。
如果这个工具帮到了你,欢迎 ⭐ Star 支持。更多 AI × 跨境电商实操内容,关注公众号「新西楼」。
// faq
What is amazon-listing-doctor?
亚马逊 Listing 质检+打分 Skill | Amazon listing health-check & scoring (CDQ/A9/COSMO/Alexa) . It is open-source on GitHub.
Is amazon-listing-doctor free to use?
amazon-listing-doctor is open-source under the MIT license, so it is free to use.
What category does amazon-listing-doctor belong to?
amazon-listing-doctor is listed under skills in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/amazon-listing-doctor)
// retro hit counter
[](https://claudeers.com/amazon-listing-doctor)
// reviews
// guestbook
// related in Claude Skills
🔓An agentic skills framework & software development methodology that works.
🔓
🔓💫 Toolkit to help you get started with Spec-Driven Development
🔓AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…