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:

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)