Menu
Comprehensive Etsy API integration for shop management, product listing, order fulfillment, and analytics.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Create presentations, PowerPoints, PDFs, and websites using Gamma AI. Convert markdown or text files into professional presentations with themes, export to PPTX/PDF, and manage projects. Use when asked to create presentations with Gamma or convert content to slides.
Manage AI Kit catalogs with installation, configuration, updates, and evolution workflows. Install kits from GitHub, track files with surgical removal, apply pattern-based mapping, and contribute changes back to source repositories.
Manage .project/PLAN.json with schema evolution, CRUD operations, and jq-style queries. Use when creating, reading, updating, or deleting plan items, validating against schemas, migrating between schema versions, or querying plan data with complex filters. Supports ID and name-based searches.
Guide for creating agent plugins compatible with both VS Code Copilot and Anthropic Claude Code. Use when users want to create a new plugin, bundle skills/agents/hooks/MCP servers into a distributable plugin, set up a plugin marketplace, or need guidance on plugin structure and cross-platform compatibility.
Guide for creating effective VS Code Copilot skills following ai-ley kit standards. Use when users want to create a new skill, update an existing skill, or need guidance on skill structure, TypeScript scripts, MCP servers, or skill best practices.
Comprehensive index management for AI-ley kit resources - reindex resources to .github/aicc/indexes/*.index.json with ID-based keying and .my/ override support, plus search/query capabilities with multiple output formats. Use for rebuilding indexes, searching resources by name/keywords/content, or exporting index data in various formats (JSON, YAML, XML, CSV, Markdown, HTML).
| id | ailey-shop-etsy |
| name | Etsy Integration |
| description | Comprehensive Etsy API integration for shop management, product listing, order fulfillment, and analytics. |
| keywords | ["etsy","ecommerce","shop","listing","order","analytics","handmade"] |
Comprehensive Etsy API integration for shop management, product listing, order fulfillment, and analytics.
The Etsy skill provides seamless integration with Etsy's API for managing online shops, products, orders, customer interactions, and business analytics. Manage listings, track inventory, fulfill orders, respond to reviews, and access detailed shop performance metrics.
✅ Shop management (settings, policies, profile) ✅ Product listing management (create, update, delete, organize) ✅ Order management (fulfillment, tracking, customer communication) ✅ Analytics and reporting (sales, traffic, revenue) ✅ Reviews and feedback management ✅ Favorites and recommendations ✅ Inventory tracking and management ✅ Shop policies and configurations ✅ Customer communication ✅ Automatic account tier detection
Etsy provides different seller account types with varying capabilities and limitations.
Use Case: Hobbyist sellers or testing
Use Case: Active sellers, small businesses
Use Case: Professional sellers, high-volume shops
| Feature | Personal | Business | Plus |
|---|---|---|---|
| Active Listings | 10 | 50 | 300 |
| Shop Customization | ✅ Basic | ✅ Advanced | ✅ Advanced |
| Order Management | ✅ Basic | ✅ Advanced | ✅ Priority |
| Analytics | ⚠️ Limited | ✅ Standard | ✅ Premium |
| API Access | ⚠️ Limited | ✅ Full | ✅ Premium |
| Email Support | ❌ | ✅ | ✅ Priority |
| Phone Support | ❌ | ❌ | ✅ |
| Shipping Discounts | ❌ | ❌ | ✅ (20%) |
| Advertising Credit | ❌ | ❌ | ✅ ($5/mo) |
| Tax Tools | ⚠️ Basic | ✅ Full | ✅ Full |
| Bulk Operations | ❌ | ✅ | ✅ |
| Custom Reports | ❌ | ⚠️ Limited | ✅ |
Create .env file with credentials:
ETSY_API_KEY=your_api_key
ETSY_API_SECRET=your_api_secret
ETSY_ACCESS_TOKEN=your_access_token
ETSY_SHOP_ID=your_shop_id
ETSY_ACCOUNT_TYPE=business
Add to .github/aicc/aicc.yaml:
skills:
etsy:
type: shop
path: .github/skills/ailey-shop-etsy
enabled: true
config:
apiKey: ${ETSY_API_KEY}
apiSecret: ${ETSY_API_SECRET}
accessToken: ${ETSY_ACCESS_TOKEN}
shopId: ${ETSY_SHOP_ID}
timeout: 30000
features:
shop: true
listings: true
orders: true
reviews: true
analytics: true
npm run detect
# Get shop information
npm run shop -- info
# Update shop policies
npm run shop -- update-policy --policy shipping --content "Ships within 2 days"
# List shop policies
npm run shop -- list-policies
# Create listing
npm run product -- create \
--title "Handmade Ceramic Mug" \
--description "Beautiful handcrafted ceramic mug" \
--price 35.00 \
--quantity 50
# Update listing
npm run product -- update --listing-id 123456 --price 40.00
# List products
npm run product -- list --limit 50 --sort created
# Delete listing
npm run product -- delete --listing-id 123456
# List orders
npm run order -- list --limit 20 --sort created
# Get order details
npm run order -- get --order-id abc123
# Fulfill order
npm run order -- fulfill \
--order-id abc123 \
--tracking-code 1234567890 \
--carrier USPS
# Send message to buyer
npm run order -- message --order-id abc123 --message "Thank you for purchase!"
# Get shop stats
npm run analytics -- stats
# Get listings performance
npm run analytics -- listings --days 30
# Get sales report
npm run analytics -- sales --start-date 2025-01-01
# List reviews
npm run review -- list --limit 50
# Respond to review
npm run review -- respond --review-id rev123 --response "Thank you for the feedback!"
# Get review summary
npm run review -- summary
import { EtsyClient } from './src/index';
const client = new EtsyClient({
apiKey: process.env.ETSY_API_KEY,
apiSecret: process.env.ETSY_API_SECRET,
accessToken: process.env.ETSY_ACCESS_TOKEN,
shopId: process.env.ETSY_SHOP_ID
});
// Detect tier
const tier = await client.detectAccountTier();
console.log(`Tier: ${tier.tier}, Listings: ${tier.maxListings}`);
// Create listing
const listing = await client.createListing({
title: 'Handmade Mug',
description: 'Beautiful ceramic mug',
price: 35.00,
quantity: 50
});
// Get orders
const orders = await client.listOrders({ limit: 20 });
// Fulfill order
await client.fulfillOrder(order.id, {
tracking: '1234567890',
carrier: 'USPS'
});
// Get analytics
const stats = await client.getShopStats();
console.log(`Total Sales: $${stats.totalSales}`);
detectAccountTier() - Detect seller account tiergetShopInfo() - Get shop information and settingsupdateShopPolicy() - Update shop policieslistShopPolicies() - List all shop policiesgetShopStats() - Get shop statisticsupdateShopSettings() - Update shop settingscreateListing() - Create new product listingupdateListing() - Update product listingdeleteListing() - Delete product listinggetListing() - Get listing detailslistListings() - List shop listingsbulkUpdateListings() - Update multiple listingslistOrders() - List shop ordersgetOrder() - Get order detailsfulfillOrder() - Mark order as shippedcancelOrder() - Cancel ordersendOrderMessage() - Send message to buyerdownloadLabel() - Download shipping labelgetShopStats() - Get shop statisticsgetListingsPerformance() - Get listings analyticsgetSalesReport() - Get sales data by date rangegetTrafficReport() - Get visitor traffic datagetRevenueSummary() - Get revenue summarylistReviews() - List shop reviewsgetReview() - Get review detailsrespondToReview() - Respond to customer reviewgetReviewSummary() - Get review statisticsgetReviewsByListing() - Get reviews for specific listingaddToFavorites() - Add listing to favoritesremoveFavorites() - Remove from favoriteslistFavorites() - List favorite listingsgetFavoritesCount() - Get number of favorites| Issue | Solution |
|---|---|
| Authentication failed | Verify API credentials at https://www.etsy.com/developers |
| Listing not found | Check listing ID and shop permissions |
| Order fulfillment error | Verify tracking number format for carrier |
| Rate limit exceeded | Wait before retrying, upgrade to Plus tier for higher limits |
| Shop not connected | Ensure OAuth token is current and shop ID matches |
| Analytics data missing | Wait 24 hours for data to populate |
| Permission denied error | Check developer app has required scopes |
| Invalid shop ID | Get correct shop ID from shop settings |
version: 1.0.0 updated: 2026-02-01 reviewed: 2026-02-01 score: 4.6