讓 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 的兩篇講的是同一件事在那兩個平台上的樣子。