AI导哈

Etsy API服务器

一个提供完整Etsy Open API v3访问的模型上下文协议（MCP）服务器，支持买家浏览和卖家店铺管理，包含37种工具覆盖商品列表、订单、物流、评价、库存、支付等功能。

  • by aserper
  • TypeScript
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 aserper/etsy-mcp

使用说明

Etsy MCP服务器

模型上下文协议（MCP）服务器，提供对Etsy Open API v3的完全访问。支持买家浏览和卖家店铺管理 37工具 涵盖列表、订单、发货、评论、库存、付款等。

特性

  • 全面覆盖Etsy API v3 -37个MCP工具包裹约70个API端点
  • OAuth 2.0+PKCE --基于浏览器的安全身份验证，具有自动令牌刷新功能
  • 买方和卖方工作流程 --搜索房源、管理店铺、处理订单、处理发货
  • 速率限制 --并发安全10请求/秒限制器，以遵守Etsy的限制
  • 自动重试 --429/5xx错误的指数回退，401的自动令牌刷新
  • TypeScript --使用Etsy官方OpenAPI规范生成的类型进行完全类型安全
类别 工具
挂牌 search_listings, get_listing, create_draft_listing, update_listing, delete_listing, get_listings_by_shop
商店 get_shop, update_shop, find_shops, get_shop_sections, manage_shop_sections
订单 get_shop_receipts, get_receipt, update_receipt, create_shipment
交易 get_transactions_by_shop, get_transaction, get_transactions_by_receipt
运输 get_shipping_profiles, create_shipping_profile, update_shipping_profile, manage_shipping_destinations, get_shipping_carriers
评论 get_reviews_by_listing, get_reviews_by_shop
用户 get_me, get_user, get_user_addresses
分类学 get_buyer_taxonomy, get_taxonomy_properties
图片/视频 get_listing_images, upload_listing_image, upload_listing_video, delete_listing_image
库存 get_listing_inventory, update_listing_inventory
支付 get_payments, get_ledger_entries
退货政策 get_return_policies, manage_return_policy
认证 authenticate

安装

来源

git clone https://github.com/aserper/etsy-mcp.git
cd etsy-mcp
npm install
npm run build

码头工人

docker pull ghcr.io/aserper/etsy-mcp:latest

配置

注册地址： Etsy开发者 获取您的API证书。

变量 必填 描述
ETSY_API_KEY 是 您的Etsy API密钥字符串
ETSY_SHARED_SECRET 是 您的Etsy共享密钥

复制 .env.example 到 .env 并填写您的凭据：

cp .env.example .env

用法

Claude桌面配置

{
  "mcpServers": {
    "etsy": {
      "command": "node",
      "args": ["/path/to/etsy-mcp/dist/index.js"],
      "env": {
        "ETSY_API_KEY": "your_keystring",
        "ETSY_SHARED_SECRET": "your_shared_secret"
      }
    }
  }
}

码头工人

docker run --rm \
  -e ETSY_API_KEY=your_keystring \
  -e ETSY_SHARED_SECRET=your_shared_secret \
  ghcr.io/aserper/etsy-mcp:latest

认证

首次使用时，调用 authenticate 工具。这将使用PKCE打开您的浏览器，进入Etsy的OAuth同意页面。授予访问权限后，令牌存储在 ~/.etsy-mcp/tokens.json （仅限所有者权限），并在过期时自动刷新。

发展

npm install          # Install dependencies
npm run build        # Compile TypeScript
npm test             # Run tests
npm run dev          # Watch mode
npm run lint         # Type check
npm run generate-types  # Regenerate types from Etsy OAS spec

API覆盖范围

该服务器覆盖完整的Etsy Open API v3（约70个端点）。通过公共API不可用的功能（消息、购物车、收藏夹、结账）超出了范围。

许可证

麻省理工学院

贡献

欢迎投稿！请随时打开问题或提交PR。

免责声明

本项目不隶属于、认可或与Etsy，股份有限公司有关联。它使用Etsy公开的Open API v3。负责任地使用，并按照 Etsy的API使用条款.

相关 MCP