Claude 的 connector 目录里没有 Etsy,Etsy 自己也没发 MCP server。所以每条路都是第三方的——而它们在一件决定"这个连接有没有用"的事上分道扬镳。
“Etsy 能不能接到 Claude”,答案是能,而且有四条路。它们不可互换:区别在于这个连接能不能写,以及你的 Etsy 凭证最后落在谁手里。然后四条路会卡在同一道门上,而各家安装教程通常一句话就带过了。
一句话 没有官方路径 Claude 的 connector 目录里没有 Etsy,Etsy 自己也没发过 MCP server。今天你能装的东西全是第三方的。
四条路
Claude 的 connector 目录。 没有可连的东西。Etsy 不在里面,Etsy 自己也没发 MCP server,所以这条暂时不成立。
社区做的 MCP server。 GitHub 上有好几个,基于 Etsy 的 Open API v3。你自己在本机把 server 跑起来、注册进客户端,API 凭证也由你自己提供。
托管 MCP 或集成平台。 这类服务夹在 Claude 和 Etsy 之间,配置是四条里最短的。代价有两样:你的 Etsy 凭证存在对方的基础设施上,而且其中好几家在设计上就是只读的。
内置了 connector 的桌面客户端。 Orkas 是这一种。它从你的机器直接调 https://openapi.etsy.com/v3/application,不需要跑 MCP server,中间也没有别人。
四条路都卡的那道门
Etsy 的 Open API v3 并不是“拿个 key 就能调”那种开放。读写你自己的店,需要一个已获准 Seller API Access 的应用。个人卖家可以在 Etsy Developers → Your Apps 申请,不需要公司主体。
你会拿到三个值,其中一个会让人耗掉一下午:
Keystring 和 Shared Secret 在应用详情页直接能拿。 Shop ID 是数字 ID,不是店铺名——而你店铺的公开网址里放的是名字,不是 ID。官方给的解法是 findShops 接口:按店铺名搜索,在结果里返回 shop_id。但这个调用本身要用你刚拿到的 Keystring 和 Shared Secret 做认证,所以顺序不能反:先建应用,再拿凭证,然后用凭证去查自己店铺的 ID。
有一步比看上去简单。Etsy 会要求你为应用登记一个回调地址,这听起来像是要自己搭服务器。不用——你登记的是你所用客户端的那个地址。Orkas 用的是 https://orkas.ai/api/connectors/oauth/dcr-callback,把它粘进 Redirect URI 一栏,这一步就完了。
审批要多久我们不打算给数字。Etsy 没有承诺时限,论坛里流传的天数是个别经历,不是排期。把它当成一个实际步骤而不是走过场,并且在你开始挑客户端之前就先提交。等待期间值得读的是 Etsy 的官方认证文档 。
比较客户端之前 先去申请 Seller API Access 每条路都要它,所以申请才是最长的那一环。之后你选什么都改变不了这一点。
读得到不等于改得了
凭证到手之后,四条路就不再等价了。问“上周进了多少单”是读。改价格、续期 listing、更新库存、切换运费模板是写,需要对应的权限范围。
这正是多数“把 Etsy 接到 Claude”的文章跳过的区别。一个能用自然语言查店铺数据的托管 connector 是真有用,也是真只读;你让它去改十二条 listing,什么都不会发生。选之前先确认写这一侧,因为它前面那道申请,两种情况下的工作量完全一样。
Orkas 的 Etsy connector 覆盖店铺、listing、库存、订单履约、运费模板和店铺分区——读写两侧都有。凭证在你自己的设备上加密存放,不落在配置文件里,也不落在别人的服务器上;任何会写进活跃店铺的操作都要过客户端里的一道权限确认,而不是指望模型小心。
什么时候别用它
有四种情况,别的方案更合适。 你只想问问题: 托管 connector 更省事,什么都不用装。 你要它定时无人值守地跑: Orkas 是桌面应用,关掉窗口就停;服务器上的定时任务才是对的形态。 你要 Etsy 去触发几十个其他服务的工作流: 集成平台就是干这个的,这个不是。 你只想批量改标题、价格或标签: Etsy 自己 Shop Manager 里的批量编辑就能做,而且完全不需要申请 API。这种情况什么都别装。
桌面这条路替代的不是 Etsy 自己的工具,而是你本来要塞在店铺和模型之间的那一堆小服务——每一个都各自存着一份你的凭证。同一份目录 还覆盖 eBay 、Walmart Marketplace、Amazon Seller Central、Shopify 、WooCommerce 和中国的几个平台,所以这堆东西不会每开一个店就重来一遍。
实践补充
版本与使用说明
原文对无人值守运行作了限制性描述。当前使用指南同时提供“自动化”:可在指定设备上执行一次性或周期任务,运行时设备与所需权限必须可用。桌面工作流和托管服务的区别,应与 Orkas 是否能安排定时任务分开理解。
原文关于授权提示的描述,应结合当前连接器指南阅读。连接器调用(包括外部 CLI 智能体发起的调用)遵循本机操作权限设置;已识别的读取和常规编辑不一定询问,敏感或未分类操作取决于所选模式。不要假设每次写入都会重新请求确认。
延伸任务示例
检查这十个商品的材质与尺寸描述是否一致,引用当前字段,提出修改并标出缺少的产品依据,不发布修改或改变价格。
首次读取的核对表
| 项目 | 记录内容 |
|---|---|
| 店铺与范围 | 店铺、站点、时间范围及所用连接方式 |
| 样本记录 | 在店铺后台能独立核对的商品或订单编号 |
| 字段差异 | 返回值、后台值、缺失字段和可能的口径差异 |
| 待办事项 | 建议修改、依据及尚未批准的操作 |
下一步
Orkas 官方指南 · 最后核验:2026-09-14