@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密钥
- 访问 Etsy开发者门户
- 点击 创建新应用程序
- 注意你的 API密钥(密钥串)
- 对于写操作,设置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.跑步
或与 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
许可证
麻省理工学院——见 许可证