# Etsy

> Etsy

- Skill: `spike-faye-lei/etsy` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add spike-faye-lei/etsy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spike-faye-lei/etsy/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: spike-faye-lei (https://skillmd.com/u/spike-faye-lei)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spike-faye-lei/etsy

---

# Etsy

## Overview
Handmade and vintage marketplace — search listings, view details, shop profiles, and reviews.

## Workflows

### Search and view listing
1. `searchListings(query)` → `listingId`, `shopName`
2. `getListingDetail(listingId)` → title, price, description, photos, seller

### Read listing reviews
1. `searchListings(query)` → `listingId`
2. `getReviews(listingId)` → averageRating, reviews[]

### Browse a shop
1. `searchListings(query)` → `shopName`
2. `getShop(shopName)` → rating, sales, location, owner

## Operations

| Operation | Intent | Key Input | Key Output | Notes |
|-----------|--------|-----------|------------|-------|
| searchListings | search items by keyword | query | listingId, title, price, shopName, rating | entry point |
| getListingDetail | full listing info | listingId ← searchListings | title, price, description, photos, shopName, material | |
| getReviews | listing reviews | listingId ← searchListings | averageRating, totalReviews, reviews[] | LD+JSON provides ~4 recent reviews |
| getShop | shop profile | shopName ← searchListings | name, location, rating, sales, owner, activeListings | |

## Quick Start

```bash
# Search for handmade pottery
openweb etsy exec searchListings '{"query":"handmade pottery"}'

# Get listing details
openweb etsy exec getListingDetail '{"listingId":"168685596"}'

# Get reviews for a listing
openweb etsy exec getReviews '{"listingId":"168685596"}'

# Get shop profile
openweb etsy exec getShop '{"shopName":"nealpottery"}'
```