eBay を Claude につなぐこと自体は概念的に難しくありません。OAuth アプリ、4 つの値、権限のリストです。難しいのは、eBay がこれらの値に他のマーケットプレイスとは違う名前を付けていること、そして 1 つの欄が、見た目は完全に URL なのに URL ではないものを求めることです。
4 つの値と、eBay での呼び方
App ID が client ID、Cert ID が client secret です。どちらも eBay Developer Portal の My Account → Application Keys にあり、コピーして貼るだけです。
RuName が人を止めるもので、これは下で個別に扱います。
Marketplace ID はどの eBay サイトで操作するかを決め、そのサイトが対応するロケールと一致している必要があります。たいていは自明です——自明でない場合を除いて。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 をコピーします。今入力した URL の隣にある、短くて意味の読めない文字列です。それを求める欄の周囲は URL の欄ばかりなので、つい URL をもう一度貼りたくなります。それでは認可が通らず、返ってくるエラーは理由を教えてくれません。
サンドボックスは近道ではありません
eBay には無料の開発者アカウントだけで使えるサンドボックスがあり、良好な状態の販売アカウントも不要で、API の形を学ぶには本当に役立ちます。しかし本当に欲しいもの、つまり自分の出品と自分の注文には役立ちません。サンドボックスのデータは合成されたものです。
Orkas の新規接続は本番のみです。つまり eBay Developers Program への申請——販売アカウント・在庫・出品・配送の権限を持つアプリと、その Production Keyset——がこの構成の最長工程であり、後から選ぶクライアントではありません。早めに始めてください。待つ間は公式の認可ガイドを読む価値があります。
読めることと書けることは違う
キーセットが揃うと、権限リストが接続の用途を決めます。先週何が売れたかを尋ねるのは読み取りです。出品の修正、在庫の調整、注文の発送済み処理は書き込みで、アプリ側に対応するスコープが要ります。
eBay と Claude をつなぐホスト型サービスのいくつかは設計上、読み取り専用です。それは妥当な製品ですが、同じ製品ではありません。申請に労力を投じる前に書き込み側を確認してください。その手前の申請はどちらでも同じだからです。
Orkas のコネクタは、自分のマシンから本番の Sell API を直接呼びます。認証情報は設定ファイルや他社のサーバーではなく端末上で暗号化され、稼働中のアカウントへ書き込む操作はクライアント側の権限確認を通ります。
他の選択肢のほうがよい場合
レポートだけ欲しい：ホスト型コネクタは設定が少なく、入れるものもありません。誰も見ていない状態で定期実行したい：これはデスクトップアプリで、ウィンドウを閉じれば止まります。サーバー上の定期実行が正しい形です。まだ API を学んでいる：無料の開発者アカウントとサンドボックスを使い、稼働中のアカウントにはまだ何もつながないでください。
同じカタログは Etsy、Walmart Marketplace、Amazon Seller Central、Shopify、WooCommerce、そして中国の各プラットフォームも扱います。隣の Etsy と Shopify の記事は、同じ話をその 2 つについて扱っています。