An Etsy Open API command-line tool for working with shops, listings, images, inventory, orders, receipts, and shipping. It sends Etsy requests through the project's Bun-based social command.

Use it to read or update Etsy shop data, manage listings and inventory, handle orders and shipping, and work with images. It also supports Etsy app credentials and seller sign-in.

It avoids writing separate request code for each Etsy API operation. A dry-run option lets you inspect a request before sending it.

social-etsy — Skill for Claude Code and Codex by isaacrowntree

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add isaacrowntree/claude-social-skills --skill social-etsy

Clone the repo

git clone --depth 1 https://github.com/isaacrowntree/claude-social-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/isaacrowntree/claude-social-skills/social-etsy/github.svg)](https://agentmods.dev/skills/isaacrowntree/claude-social-skills/social-etsy)

Your own site

<a href="https://agentmods.dev/skills/isaacrowntree/claude-social-skills/social-etsy"><img src="https://agentmods.dev/badge/skills/isaacrowntree/claude-social-skills/social-etsy/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/isaacrowntree/claude-social-skills/social-etsy"><img src="https://agentmods.dev/badge/skills/isaacrowntree/claude-social-skills/social-etsy.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,220 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00000	$0.01220
Opus 5.5	$0.00000	$0.00488
Sonnet 5.5	$0.00000	$0.00244
Haiku 4.5	$0.00000	$0.00122

Measured 10d ago against content hash 6799d9c66a60, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

social-etsy scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/social-etsy/SKILL.md · 96 lines

How it starts

The opening of the file, as written. The whole thing — 96 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Etsy Open API v3: every operation (shop, listings, images, inventory, orders/receipts, shipping…), generated from Etsy's OpenAPI description.

Run: social etsy <command> (installed via bun link in this repo, or bun run /path/to/claude-social-skills/src/cli.ts etsy …). Add --dry-run before any command to print the request instead of sending it.

Credentials

ETSY_KEYSTRING
ETSY_SHARED_SECRET

Keystring and shared secret from https://www.etsy.com/developers/your-apps; public reads need only these. For seller operations register https://localhost:8086/callback (or ETSY_REDIRECT_URI) as the app's callback URL and run social auth login etsy. ETSY_SCOPES overrides the default "listings_r listings_w shops_r shops_w transactions_r profile_r email_r".

Check what is present with social auth status etsy; store a value with social auth set etsy <KEY> <value> (OS keyring, else ~/.config/social/.env); run the interactive flow with social auth login etsy. Docs: https://developers.etsy.com/documentation/

API description this wrapper is built from

openapi: www.etsy.com/openapi/generated/oas/3.0.0.json; pinned in spec-pins.json. Refresh with social specs pull etsy; CI fails if upstream changes.

Commands

Every command accepts --json (raw JSON) and --jq <expr> (filter the JSON with jq).

`social etsy apis`

the etsy API groups and how many operations each has

`social etsy ops [filter]...`

search operations: every word must appear in the id, summary, path, description or field names; best matches first

  --api <name>               only this API group (see `social etsy apis`)

`social etsy describe <op>`

parameters, body, scopes and response shape of one operation

  --depth <n>                how deep to expand nested fields (default 2)

`social etsy call <op>`

call any operation by id; --dry-run prints the request instead

  -p, --param <k=v>          path/query/header parameter (default [])
  -f, --field <k=v>          body field, typed (numbers, booleans, null, JSON literals) (default [])
  --raw-field <k=v>          body field, always a string (default [])
  --file <field=path>        file for a multipart part (image=./photo.jpg) or a binary body (default [])
  --output <file>            save a binary response (PDF, image, feed file) here
  --input <file>             request body from a JSON file (- for stdin)

Read the full file on GitHub · 96 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

10d ago First seen · 96 lines · 0 tokens per session scan A 6799d9c66a60

Subscribe to this mod's changes

social-etsy is a skill published in the GitHub repository isaacrowntree/claude-social-skills (4 stars, last pushed 4d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,220 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-28.

E-commerce

social-etsy next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
social-etsyisaacrowntree/claude-social-skills	Skill	4	4d ago	MIT	A	0	Claude Code, Codex
amazon-reviews-api-skillbrowser-act/skills	Skill	6.3k	3d ago	MIT	A	124	Claude Code, Codex
amazon-competitor-analyzerbrowser-act/skills	Skill	6.3k	3d ago	MIT	A	48	Claude Code, Codex
asc-subscription-localizationrorkai/app-store-connect-cli-skills	Skill	1.1k	today	MIT	A	60	Claude Code
food-orderBitterbot-AI/bitterbot-desktop	Skill	2.5k	today	MIT	A	53	Claude Code, Codex
external-purchasesrshankras/claude-code-apple-skills	Skill	867	today	MIT	A	76	Claude Code
Product Photoshoot Workflowjau123/MeiGen-AI-Design-MCP	Skill	1.8k	yesterday	MIT	A	111	Claude Code

social-etsy

Getting it into your agent

Wrote this? Show the measurements

What it costs to keep this loaded

Grade A, and why

Nothing flagged

How it starts

social etsy

Credentials

API description this wrapper is built from

Commands

social etsy apis

social etsy ops [filter]...

social etsy describe <op>

social etsy call <op>

What this file has done since we first saw it

social-etsy compared with skills from other repositories

`social etsy apis`

`social etsy ops [filter]...`

`social etsy describe <op>`

`social etsy call <op>`