Your first 10 listings scored against Etsy's own title, tag, photo and description guidance, each with the reasons and the most common problems in your shop.
Who it is for: Etsy seller with 10-1,000 active listings who writes titles and tags by hand and is not sure which listings break Etsy's own search guidance.
Format: Claude skill pack · Version: 1.0.1 · Tested on: Python 3.13.5 (standard library only)
What it does
You give it the listings CSV you download from Etsy. Each listing is checked against Etsy's published seller guidance: title present and at most 140 characters, fewer than 15 words, no repeated words, no subjective words like perfect or beautiful, no price, sale or shipping words, no shouting in capitals; all 13 tags used, each at most 20 characters with only the characters Etsy allows, no duplicates, mostly multi-word phrases; at least 5 photos; a real description; materials filled in. Each listing gets a score and grade with the reasons. The free edition audits the first 10 listings in the file.
What you need
- Claude.ai with code execution switched on (or Claude Code, or Python 3.10+)
- Your listings CSV from Shop Manager > Settings > Options > Download Data
- No Etsy login is needed or used
5-minute setup
- Claude.ai: open Settings → Capabilities → Skills, click Upload skill and pick
claude-ai-upload/etsy-listing-seo-auditor.zip. - Claude Code: copy the folder
skills/etsy-listing-seo-auditorinto~/.claude/skills/. - Start a new chat. Attach your file and say: "Use etsy-listing-seo-auditor. Check my listings CSV and tell me what to fix first".
- Claude runs the script and gives you the files listed under Outputs. Check them before you act on them.
Try it with the sample
Run the sample (a fictional 12-listing shop):
python3 skills/etsy-listing-seo-auditor/scripts/core.py --listings samples/etsy-listings-sample.csv --out out
You should see 10 of 12 listings audited, 7 errors and 41 empty tag slots. In Claude, attach your CSV and use the prompt above.
Settings you can change
| Option | Default | What it is |
|---|---|---|
--listings |
(required) |
Etsy listings CSV: Shop Manager > Settings > Options > Download Data > Currently for Sale Listings |
--out |
out |
Output folder for audit.md and audit.csv |
What goes in and what comes out
Inputs: Etsy listings CSV (Currently for Sale Listings)
Outputs: audit.md (first 10 listings, worst first); audit.csv (score and issues per listing)
What Pro adds
- Every listing in the shop, not just the first 10
- Duplicate and competing titles across the shop
- Tags overused on most listings
- Cleaned-up title suggestions and tag ideas from your own titles
- A fixes sheet to work through
Pro: https://oarsmanai.com/agents/etsy-listing-seo-auditor-pro/
AI disclosure and limits
This product does not call an AI model at run time. It was built by Oarsman AI's AI agents and checked by the automated tests shipped with it.
Limits: - Audits the first 10 listings in the file. - Read-only: you make each change in Etsy. - Uses only the listings CSV, so it cannot see views, sales, categories or attributes. - Scores follow Etsy's published guidance; they do not promise rank or sales.
Not tested by us: - exports from shops in languages other than English - the effect of changes on your Etsy traffic
Files
- oarsman-etsy-listing-seo-auditor-v1.0.1.zip
- CHANGELOG.md
- QA-REPORT.json
- README.md
- SPEC.md
- SUPPORT.md
- TROUBLESHOOTING.md
- VERSION
- VIDEO-SCRIPT.md
- claude-ai-upload
- diagram.mmd
- diagram.png
- preview.png
- samples
- skills
- tests
Help
Self-serve: see TROUBLESHOOTING.md (fixes and FAQ). There is no call, chat or email support. Fixes ship as new versions at your download link. Refund: 14 days, works as described, through the checkout platform.