keepr-etsy-ops

Claude Code skill pack for Etsy operations. Built and battle-tested by the team behind Keepr (Shopify) and NoteKeepr (Etsy).

The only open-source Etsy operations skill pack on the planet right now. Every other Etsy SEO / publishing tool we found is paid SaaS (Seerxo, Sale Samurai, eRank) or unmaintained community code. This is free, MIT-licensed, and shipped by an active Etsy seller.

What's in it

Skill	What it does
etsy-listing-publisher	Publishes draft listings live via Etsy API v3. Validates required fields, auto-applies AI Disclosure tag where required, sets shipping profile + return policy + production partner. Refuses to publish if compliance gaps exist.
etsy-listing-optimizer	Audits an existing live listing against Etsy 2026 SEO best practices. Suggests title/tag/description rewrites, photo improvements, 13-tag strategy gaps. Outputs a diff ready for one-click apply.
etsy-ai-disclosure-auditor	Scans every listing in the shop for missing AI Disclosure tags (required by Etsy's 2025 generative-AI policy). Categorizes by risk level (clear AI / partial AI / human-made), tags accordingly, flags ambiguous cases for operator review.
etsy-ads-pacer	Daily Etsy Ads budget management. Reads impressions + CPC + 30-day attribution, raises bids on winners (CPA below target), pauses losers (>30 days zero conversion), reallocates budget. Avoids the trap of manual ad management.
etsy-review-harvester	Pulls 5-star reviews via Etsy API, generates UGC content templates (Pinterest pin copy, IG carousel scripts, Reddit testimonial framing) from review quotes. Closes the review→content loop.
etsy-shop-doctor	End-to-end shop health audit: shipping speed, return policy completeness, About page word count, photo quality (resolution + count per listing), response time, conversion-killer detection. Outputs prioritized fix list.

Install

# Add the marketplace
/plugin marketplace add PCSAdmin081/keepr-etsy-ops

# Install the pack
/plugin install keepr-etsy-ops@keepr-etsy-ops

Or clone directly:

git clone https://github.com/PCSAdmin081/keepr-etsy-ops.git ~/.claude/skills/keepr-etsy-ops

Required setup

These skills assume:

1. Etsy API v3 OAuth token — created at https://www.etsy.com/developers. Store in ETSY_API_KEY and ETSY_OAUTH_TOKEN env vars. The etsy-listing-publisher skill needs listings_w scope; etsy-ads-pacer needs shops_r + shops_w.
2. Shop ID — your numeric Etsy shop ID. Store in ETSY_SHOP_ID env var.
3. Sole-prop or LLC with EIN — Etsy seller accounts require some form of legal entity for tax compliance. These skills don't help with that.

Philosophy

These skills enforce three rules:

1. Default to draft. No skill publishes live without explicit operator confirmation. The publisher checks compliance gates first; the ads pacer logs decisions but only acts within pre-approved budget envelopes; the optimizer outputs diffs, not auto-applied changes.
2. AI Disclosure compliance is non-negotiable. Etsy started enforcing the AI Disclosure tag in 2025. Listings without the correct tag get hidden from search. The auditor runs as a pre-flight check before any publish action.
3. Velocity over volume. Etsy's 2026 algorithm rewards <5 high-quality listings per week over 50 mass-listings. These skills are designed for slow, curated shops — not arbitrage.

What this is NOT

• Not a generic Etsy CMS — for that, use Vela or Marmalead
• Not an AI listing generator — for that, see keepr-dnd-skills/dnd-listing-writer (writes the copy; this pack publishes it)
• Not a Pinterest auto-poster — for that, see postiz-agent
• Not an arbitrage / mass-listing tool — Etsy's 2026 algorithm punishes that pattern; this pack refuses to support it

Companion skill packs

For the full Keepr indie-ecommerce stack:

• keepr-dnd-skills — TTRPG-specific brand voice, listing copy, Pinterest pin design, content strategy
• coreyhaines31/marketingskills — 50+ generic marketing skills (CRO, email, ads)
• CosmoBlk/email-marketing-bible — comprehensive email marketing knowledge base
• AgriciDaniel/claude-email — inbox triage + deliverability auditing

License

MIT. Use it, fork it, white-label it.

Who maintains this

Built by the team behind Keepr / NoteKeepr. We use it for our own Etsy operations every day; everything here is battle-tested against real listing data and Etsy's 2025-2026 policy changes, not theorycraft. Issues and PRs welcome.