Etsy API服务

提供全面的Etsy API v3接口服务,包含50多个功能模块,覆盖Etsy平台的各种操作,适用于电商开发和管理。

  • by BusyBee3333
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 BusyBee3333/etsy-mcp-2026-complete

使用说明

@mcpengine/etsy——最全面的etsy MCP服务器

最完整的 模型上下文协议(MCP) 服务器 Etsy API v3,特色 50+工具模块 几乎覆盖整个Etsy API表面。


特性

  • 50+工具 跨越每个Etsy API域
  • 满的 Etsy API v3 覆盖
  • Zod已验证 每个工具上的输入模式
  • readOnlyHint 在所有GET/list操作上
  • destructiveHint 关于所有删除操作
  • 光标/偏移分页 在所有列表工具上
  • 基于Axios的客户端,支持OAuth承载令牌
  • TypeScript没有编译错误

工具索引

列表(核心)

工具 说明
etsy_listings_list 使用筛选器列出活动列表
etsy_listing_get 获取单个列表
etsy_listings_get_by_ids 按ID批量获取列表
etsy_listings_list_by_shop 列出商店中的所有商品
etsy_listing_create 创建新列表
etsy_listing_update 更新列表
etsy_listing_delete 删除列表
etsy_listings_featured 获取特色房源

列出图片

工具 说明
etsy_listing_images_list 为列表列出图像
etsy_listing_image_get 获取特定图像
etsy_listing_image_upload 通过URL上传图像
etsy_listing_image_delete 删除图像
etsy_listing_images_reorder 重新排序列表图像

视频列表

工具 说明
etsy_listing_videos_list 列出视频
etsy_listing_video_get 获取特定视频
etsy_listing_video_upload 上传/附加视频
etsy_listing_video_delete 删除视频

清单库存

工具 说明
etsy_listing_inventory_get 获取库存(变化、价格、数量)
etsy_listing_inventory_update 更新库存

列出属性

工具 说明
etsy_listing_properties_list 列出属性
etsy_listing_property_get 购置房产
etsy_listing_property_update 更新属性
etsy_listing_property_delete 删除属性

数字文件

工具 说明
etsy_listing_files_list 列出数字下载文件
etsy_listing_file_get 获取文件
etsy_listing_file_upload 上传数字文件
etsy_listing_file_delete 删除文件

翻译

工具 说明
etsy_listing_translations_list 列出翻译
etsy_listing_translation_get 获取翻译
etsy_listing_translation_create 创建翻译
etsy_listing_translation_update 更新翻译

变体图像

工具 说明
etsy_listing_variation_images_get 获取变化图像
etsy_listing_variation_images_update 更新变体图像

商店

工具 说明
etsy_shop_get 开个店
etsy_shop_update 更新店铺
etsy_shops_by_owner 按用户获取店铺
etsy_shop_find 按名称搜索商店

店铺专区

工具 说明
etsy_shop_sections_list 列出章节
etsy_shop_section_get 获取一个部分
etsy_shop_section_create 创建一个分区
etsy_shop_section_update 更新一个部分
etsy_shop_section_delete 删除一个部分

关于我们,生产合作伙伴,退货政策

工具 说明
etsy_shop_about_get 获取店铺关于页面
etsy_shop_production_partners_list 列出生产合作伙伴
etsy_shop_production_partner_create 创建合作伙伴
etsy_shop_production_partner_update 更新合作伙伴
etsy_shop_production_partner_delete 删除合作伙伴
etsy_shop_return_policies_list 列出退货政策
etsy_shop_return_policy_get 获取政策
etsy_shop_return_policy_create 创建策略
etsy_shop_return_policy_update 更新策略
etsy_shop_return_policy_delete 删除策略

运输概况

工具 说明
etsy_shop_shipping_profiles_list 列出个人资料
etsy_shop_shipping_profile_get 获取个人资料
etsy_shop_shipping_profile_create 创建个人资料
etsy_shop_shipping_profile_update 更新个人资料
etsy_shop_shipping_profile_delete 删除个人资料
etsy_shipping_profile_destinations_list 列出目的地
etsy_shipping_profile_destination_create 创建目的地
etsy_shipping_profile_destination_update 更新目标
etsy_shipping_profile_destination_delete 删除目的地
etsy_shipping_profile_upgrades_list 列出升级
etsy_shipping_profile_upgrade_create 创建升级
etsy_shipping_profile_upgrade_update 更新升级
etsy_shipping_profile_upgrade_delete 删除升级
etsy_shipping_carriers_list 列出运输公司

订单和收据

工具 说明
etsy_receipts_list 列出订单/收据
etsy_receipt_get 获取收据
etsy_receipt_update 更新收据(发货、备注)
etsy_receipt_transactions_list 列出交易记录
etsy_receipt_transaction_get 获取交易
etsy_receipt_transactions_by_receipt 收据交易
etsy_receipt_shipments_list 列出货物
etsy_receipt_shipment_create 添加跟踪
etsy_shop_receipt_transactions_list 店铺收货交易
etsy_shop_listing_transactions_list 列出交易记录

支付与金融

工具 说明
etsy_payments_list 列出付款
etsy_payment_get 获得付款
etsy_payments_by_receipt 收据付款
etsy_payment_ledger_entries_list 列出分类账条目
etsy_payment_ledger_entry_get 获取分类账条目
etsy_payment_account_get 获取付款账户
etsy_ledger_entries_list 列出分类账条目(alt)
etsy_ledger_entry_get 获取分类账条目
etsy_ledger_entry_payment_get 分类账分录付款
etsy_payouts_list 列出支出
etsy_payout_get 获得奖金

评论

工具 说明
etsy_shop_reviews_list 店铺评论
etsy_listing_reviews_list 列出评论

用户和地址

工具 说明
etsy_user_get 获取用户
etsy_user_me 获取经过身份验证的用户
etsy_user_addresses_list 列出地址
etsy_user_address_get 获取地址
etsy_user_address_delete 删除地址

分类与发现

工具 说明
etsy_taxonomy_seller_list 列出卖家分类
etsy_taxonomy_node_get 获取分类节点
etsy_taxonomy_properties_list 列出分类属性
etsy_taxonomy_properties_get 获取节点的属性
etsy_buyer_taxonomy_list 列出买家分类
etsy_buyer_taxonomy_node_get 获取买家分类节点
etsy_listings_search 全球上市搜索
etsy_shop_listings_search 在商店内搜索
etsy_shop_listings_by_section 按部门列出

收藏夹

工具 说明
etsy_user_favorite_listings_list 列出喜爱的列表
etsy_user_favorite_listing_get 检查列表是否被选中
etsy_user_favorite_listing_add 收藏列表
etsy_user_favorite_listing_remove 取消订阅列表
etsy_user_favorite_shops_list 列出喜爱的商店
etsy_user_favorite_shop_get 检查该店铺是否受到青睐
etsy_user_favorite_shop_add 最喜欢的商店
etsy_user_favorite_shop_remove 取消对商店的订阅

图片、媒体和图标

工具 说明
etsy_listing_image_upload_url 从URL上传图像
etsy_listing_image_set_rank 设置图像显示级别
etsy_listing_image_update_alt 更新图像alt文本
etsy_shop_icon_get 获取店铺图标
etsy_shop_icon_delete 删除店铺图标
etsy_shop_banner_get 获取店铺横幅
etsy_shop_banner_delete 删除店铺横幅

列出生命周期和内容

工具 说明
etsy_listing_drafts_list 列出列表草稿
etsy_listing_draft_create 创建草稿
etsy_listing_draft_publish 发布草稿
etsy_listing_renew 续订过期的列表
etsy_listings_expired_list 列出过期列表
etsy_listings_inactive_list 列出非活动列表
etsy_listing_stats_get 获取房源统计信息
etsy_listing_views_get 获取浏览次数
etsy_listings_stats_bulk 批量上市统计数据
etsy_featured_listings_list 列出特色房源
etsy_listing_set_featured_rank 设置特色排名
etsy_listing_feature 以列表为特色
etsy_listing_unfeature 取消显示列表
etsy_listing_tags_get 获取列表标签
etsy_listing_tags_update 替换标签
etsy_listing_tags_add 添加标签
etsy_listing_materials_get 获取材料
etsy_listing_materials_update 更换材料
etsy_listing_materials_add 添加材料
etsy_listing_occasion_get 抓住机会
etsy_listing_occasion_set 设定场合
etsy_listing_styles_update 更新样式

店铺分析

工具 说明
etsy_shop_stats_get 店铺级别统计
etsy_shop_receipt_summary 订单摘要
etsy_shop_payment_summary 付款账户摘要

产品与服务

工具 说明
etsy_listing_offering_get 获取产品
etsy_listing_product_get 获取产品变体

设置

1.获取Etsy API密钥

  1. 访问 Etsy开发者门户
  2. 点击 创建新应用程序
  3. 注意你的 API密钥(密钥串)
  4. 对于写操作,设置OAuth 2.0并获取访问令牌

2.安装

npm install
npm run build

3.配置

cp .env.example .env
# Edit .env with your credentials
ETSY_API_KEY=your_etsy_api_key_here
ETSY_ACCESS_TOKEN=your_oauth_access_token_here  # Optional: for write operations

4.跑步

npm start

或与 npx:

ETSY_API_KEY=<key> node dist/main.js

MCP客户端配置

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "etsy": {
      "command": "node",
      "args": ["/path/to/etsy-mcp/dist/main.js"],
      "env": {
        "ETSY_API_KEY": "your_api_key_here",
        "ETSY_ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}

光标

增添 .cursor/mcp.json 在您的项目中:

{
  "mcpServers": {
    "etsy": {
      "command": "node",
      "args": ["./dist/main.js"],
      "env": {
        "ETSY_API_KEY": "your_api_key_here"
      }
    }
  }
}

认证

Etsy API使用两种形式的身份验证:

操作 需要授权
公开上市搜索 仅限API密钥
读取车间数据 仅限API密钥
写入/更新操作 OAuth 2.0访问令牌
财务数据 OAuth 2.0访问令牌

API密钥:通行证 ETSY_API_KEY env 是
OAuth令牌:通行证 ETSY_ACCESS_TOKEN env 是

有关OAuth设置,请参阅 Etsy的OAuth 2.0指南.


建筑学

src/
├── main.ts          # Entry point, env validation
├── server.ts        # MCP server class, tool loader
├── client.ts        # Axios-based Etsy API v3 client
├── types.ts         # TypeScript interfaces
└── tools/           # One file per API domain (47 modules)
    ├── listings.ts
    ├── listing_images.ts
    ├── ...
    └── listing_occasion.ts

发展

npm run dev     # ts-node (no build step)
npm run build   # TypeScript compile → dist/
npm run lint    # ESLint

许可证

麻省理工学院——见 许可证