Etsy Ai Disclosure Auditor

---
name: etsy-ai-disclosure-auditor
description: Scans every listing in an Etsy shop for missing AI Disclosure tags required by Etsy's 2025 generative-AI policy. Use when the user wants to audit AI compliance, check AI Disclosure tags, prepare a shop for the AI policy enforcement, or avoid shop suspension. Categorizes listings by risk level (clear AI / partial AI / human-made), tags accordingly with operator approval, flags ambiguous cases for manual review.
---

# Etsy AI Disclosure Auditor

You audit an entire Etsy shop for compliance with Etsy's 2025 generative-AI disclosure policy. Listings that use AI-generated images, AI-written descriptions, or AI-assisted designs without the AI Disclosure tag get hidden from search and risk shop suspension. This skill prevents that.

## When to invoke

- User says "audit AI compliance" / "check AI Disclosure tags" / "AI disclosure audit"
- User mentions Etsy's AI policy or concerns about shop suspension
- User is preparing to publish multiple new listings
- Operator wants a periodic compliance sweep (recommended monthly)

## Etsy's 2025 AI Disclosure Policy — what it actually requires

Per Etsy's published seller policy (effective 2025, enforcement increased throughout 2026):

**Listings MUST disclose AI involvement if:**
- Product images are AI-generated (Midjourney, DALL-E, Stable Diffusion, Flux, etc.)
- Product designs are AI-generated (graphics, patterns, illustrations made by AI)
- Listing descriptions are written by AI without substantial human editing
- The product itself is delivered as AI output (e.g., custom AI portraits)

**Disclosure mechanism:**
- Add the tag `ai_generated` to the listing's tag set (uses one of 13 slots)
- OR register an AI tool as a "Production Partner" under Shop Manager → Settings → Production Partners and reference it in the listing
- The Production Partner approach is preferred for shops with many AI-involved listings (doesn't waste a tag slot per listing)

**Listings do NOT need disclosure if:**
- Photos are human-taken
- Designs are human-drawn or human-designed
- Descriptions are human-written (operator typing or operator-edited from AI draft)
- AI was only used for ideation / brainstorming, not for delivered output

## Audit categories

Every listing in the shop falls into one of:

| Category | Definition | Action |
|---|---|---|
| **CLEAR AI** | AI-generated images, AI illustrations on product, AI-generated text in description (unedited) | Tag required — refuse to skip |
| **PARTIAL AI** | Human-designed cover with AI-generated interior pages, or AI-assisted layouts, or AI-edited copy | Tag recommended — flag for operator |
| **HUMAN-MADE** | No AI involvement in delivered output (operator photography, hand-drawn design, human writing) | No tag needed — log the no-AI declaration |
| **AMBIGUOUS** | Operator-uncertain or mixed-source assets | Flag for manual review — do not tag |

## Required environment

- `ETSY_API_KEY`, `ETSY_OAUTH_TOKEN`, `ETSY_SHOP_ID` set
- Token scope: `listings_r` to read, `listings_w` to apply tags

## Audit flow

1. **Pull all active listings** via `GET /v3/application/shops/{shop_id}/listings/active?limit=100` (paginate)
2. **For each listing**, score AI involvement based on heuristic signals:
   - **Image filenames** (if exposed via API metadata) — keywords like `flux`, `midjourney`, `dalle`, `_ai_`, `generated` suggest AI source
   - **Image inspection** — if image looks like AI output (uncanny details, AI-style proportions, characteristic background), flag
   - **Description style** — em-dash overuse (—), structured "Furthermore/Additionally/Moreover" phrasing, generic AI cadence
   - **Production partner declarations** — already-declared partners count as disclosed
3. **Ask the operator** for confirmation on PARTIAL and AMBIGUOUS categories
4. **Apply tags** only after explicit per-listing approval
5. **Log every decision** to audit trail

## Heuristic AI-detection signals

These are signals only — never tag based on heuristics alone, always confirm with operator:

**Strong signals (90%+ likely AI):**
- Image dimensions exactly match common AI output (1024×1024, 1024×1792, etc.)
- Filename contains AI tool names
- Operator-flagged in shop metadata

**Medium signals (50-90%):**
- Description starts with "Discover the [adjective] [product]…"
- Heavy em-dash usage with parallel structure
- "Crafted with [emotion]" phrasing
- Uncanny micro-details in product photos (extra fingers, distorted text, impossible reflections)

**Weak signals (<50%):**
- Polished writing without typos
- Stylized photography
- Modern fonts

## Output format

```
=== ETSY AI DISCLOSURE AUDIT ===

Shop: {shop_name}
Listings scanned: 47
Compliance status: 32 OK, 8 needs review, 7 missing tag

┌─ CLEAR AI (7 listings — tag missing, action required) ───────┐
│                                                              │
│ 1. listing 1234567890                                        │
│    "Custom DnD Portrait AI Art Print"                        │
│    Heuristic: filename "midjourney_v6_portrait.png"          │
│    Recommended: add tag "ai_generated"                       │
│    Apply? (y/N): _                                           │
│                                                              │
│ ... (6 more)                                                 │
└──────────────────────────────────────────────────────────────┘

┌─ PARTIAL AI (8 listings — tag recommended) ──────────────────┐
│                                                              │
│ 1. listing 1234567891                                        │
│    "Hand-bound Notebook with AI-generated Interior Art"      │
│    Description: human-written. Cover: human-photographed.    │
│    Interior pages: AI-generated decorative borders.          │
│    Recommended: add tag "ai_generated" (interior art)        │
│    Apply? (y/N/skip): _                                      │
│                                                              │
│ ... (7 more)                                                 │
└──────────────────────────────────────────────────────────────┘

┌─ HUMAN-MADE (32 listings — no action needed) ────────────────┐
│ Logged 32 listings as no-AI per operator confirmation        │
└──────────────────────────────────────────────────────────────┘

┌─ AMBIGUOUS (0 listings) ─────────────────────────────────────┐
│ No ambiguous cases found                                     │
└──────────────────────────────────────────────────────────────┘

=== ACTIONS TO APPLY ===

7 tags to add. Estimated API calls: 7.
Apply all? (y/N/per-listing): _
```

## Strict rules

- **Never apply a tag without operator confirmation** — even on CLEAR AI listings, always show the listing and ask
- **Never remove an AI Disclosure tag** — only adds
- **Never make a definitive AI/not-AI claim without operator input** — phrase as "appears to be" or "heuristic suggests"
- **Always log the audit** even if no tags applied — operator may need to prove compliance attempt later
- **If ≥50% of shop is AI-flagged**, recommend the operator register an AI Production Partner instead of per-listing tagging

## Output log

Save audit results to `keepr-ops/logs/etsy-ai-audit-YYYY-MM-DD.json`:

```json
{
  "audit_date": "2026-05-18T14:32:11Z",
  "shop_id": "...",
  "listings_scanned": 47,
  "clear_ai": [{"listing_id": "...", "tag_applied": true}, ...],
  "partial_ai": [...],
  "human_made_count": 32,
  "ambiguous": [],
  "operator_signature": "jack@reimaginemediagroup.com"
}
```

This log is the operator's proof of due diligence if Etsy ever requests it.

## Related skills

- `etsy-listing-publisher` — calls this audit as a pre-flight check
- `etsy-listing-optimizer` — runs alongside for SEO + compliance combined audit
- `etsy-shop-doctor` — broader shop health audit that includes this one