让 eBay 跟 Claude 说上话，概念上不难：一个 OAuth 应用、四个值、一份权限清单。难在 eBay 给这些值起的名字跟其他平台都不一样，而且有一个字段要的东西看起来完全像网址，却偏偏不是网址。
四个值，以及 eBay 管它们叫什么
App ID 就是 client ID。Cert ID 就是 client secret。两个都在 eBay Developer Portal 的 My Account → Application Keys 里，复制粘贴即可。
RuName 是卡住人的那个，下面单独讲。
Marketplace ID 决定你在哪个 eBay 站点上操作，而且必须匹配该站点支持的 locale。这件事大多数时候是显然的——直到它不显然。eBay 给马来西亚和新加坡指定的是 en-US，这种细节通常是从报错里发现的，不是从指南里。
RuName 是个名字，不是地址
在开发者门户里，你走 Keyset → User Tokens → Get a Token via Your Application，新建或打开一条 Redirect URL 记录。在这条记录里，把“Your auth accepted URL”设成你要连的那个客户端的回调地址。Orkas 用的是 https://orkas.ai/api/connectors/oauth/dcr-callback，你不需要自己有服务器。
然后——关键就是这一步——把 eBay 为这条记录生成的 RuName 复制出来。它是紧挨着你刚填的网址旁边的一串短的、看不出含义的字符。要它的那个字段四周全是网址字段，所以直觉会让你把网址再粘一遍。那样授权不会通过，而返回的报错不会告诉你原因。
沙箱不是捷径
eBay 有沙箱，只要一个免费开发者账号，不需要状态良好的卖家账号，用来熟悉 API 的形状确实好用。但它对你真正想要的东西没用——你要的是自己的 listing 和自己的订单，而沙箱里的数据是造出来的。
Orkas 里的新连接只走生产环境。也就是说，eBay Developers Program 的申请——一个带卖家账号、库存、listing 和履约权限的应用，以及它的 Production Keyset——才是这套配置里最长的那一环，而不是你之后挑哪个客户端。早点开始。等待期间值得读官方授权指南。
读得到不等于改得了
keyset 到手之后，权限清单才决定这个连接到底能干什么。问上周卖了什么是读。改 listing、调库存、把订单标记为已发货是写，需要应用上有对应的 scope。
好几家把 eBay 接到 Claude 的托管服务在设计上就是只读的，那是个合理的产品——只是跟你要的不是同一个产品。在你投入申请之前先确认写这一侧，因为它前面那道申请，两种情况下的工作量完全一样。
Orkas 的 connector 从你自己的机器直接调生产环境的 Sell API。凭证在设备上加密存放，不在配置文件里，也不在别人的服务器上；任何写进活跃账号的操作都要过客户端里的权限确认。
什么时候别的方案更合适
你只想要报表：托管 connector 配置更少，什么都不用装。你要它定时跑、没人盯着：这是桌面应用，关掉窗口就停；服务器上的定时任务才是对的形态。你还在摸 API：用沙箱加一个免费开发者账号，先别把任何东西连到活跃账号上。
同一份目录还覆盖 Etsy、Walmart Marketplace、Amazon Seller Central、Shopify、WooCommerce 和中国的几个平台，所以这套凭证功夫不会每开一个店就重来。旁边关于 Etsy 和 Shopify 的两篇讲的是同一件事在那两个平台上的样子。