# Etsy

Read Etsy shop data: receipts, listings, transactions, payment ledger; create listings.

- Repository: https://github.com/Anil-matcha/awesome-muse-connectors (1403 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-13
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Anil-matcha/awesome-muse-connectors --skill etsy -g -a claude-code -y`
Codex: `npx skills add Anil-matcha/awesome-muse-connectors --skill etsy -g -a codex -y`
Cursor: `npx skills add Anil-matcha/awesome-muse-connectors --skill etsy -g -a cursor -y`
Gemini CLI: `npx skills add Anil-matcha/awesome-muse-connectors --skill etsy -g -a gemini-cli -y`

## Description

Read Etsy shop data: receipts, listings, transactions, payment ledger; create listings. Trigger phrases: etsy, shop orders, listings, receipts, seller.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Etsy

## Purpose
Read the user's Etsy shop: receipts (orders), active listings, transactions, and the payment-account ledger. Create listings on confirmation. Use when the user mentions Etsy, their shop, or listing management.

## Tooling
All commands go through `bin/etsy.py`; every command needs `--shop-id`:

```bash
bin/etsy.py auth --shop-id 12345678                       # verify OAuth token and keystring
bin/etsy.py receipts --shop-id 12345678 --limit 25        # list receipts (orders)
bin/etsy.py listings --shop-id 12345678 --limit 25        # list active listings
bin/etsy.py listing-create --shop-id 12345678 --json '{...}'  # create a listing (confirm first)
bin/etsy.py transactions --shop-id 12345678 --limit 25    # list transactions
bin/etsy.py ledger --shop-id 12345678 --limit 25          # list payment-account ledger entries
```

## Auth
- Provider id: `etsy` (credential is collected as `custom.etsy`)
- Collection: OAuth 2.0 via the secure credential flow (`credentials.request_api_access`); register an app at etsy.com/developers. The app keystring is collected alongside the token as a second credential entry. The key must be approved in the Etsy developer portal before any call works.
- Allowed hosts: `openapi.etsy.com`
- Status check: `bin/etsy.py auth --shop-id <id>` (must return `"ok": true`)

The rest: https://github.com/Anil-matcha/awesome-muse-connectors/blob/HEAD/connectors/etsy/SKILL.md