По сути подключить eBay к Claude несложно. Нужны приложение OAuth, четыре значения и список разрешений. Трудность в том, что eBay называет эти значения иначе, чем другие маркетплейсы, а одно поле запрашивает нечто, выглядящее в точности как URL, но не являющееся им.
Четыре значения и их названия в eBay
App ID — идентификатор клиента. Cert ID — секрет клиента. Оба находятся в eBay Developer Portal в разделе «Мой аккаунт» → «Ключи приложения» и просто копируются и вставляются.
RuName — то самое значение, на котором застревают пользователи; ему посвящён отдельный раздел ниже.
Marketplace ID выбирает сайт eBay, на котором вы работаете, и должен соответствовать поддерживаемой им локали. Обычно это очевидно — пока не окажется иначе. Для Малайзии и Сингапура eBay указывает en-US — именно такую деталь обычно узнают из ошибки, а не из руководства.
RuName — имя, а не адрес
В портале разработчика перейдите в «Набор ключей» → «Токены пользователя» → «Получить токен через своё приложение» и создайте или откройте запись URL перенаправления. В ней задайте для поля “Ваш URL при успешной авторизации” адрес обратного вызова подключаемого клиента. Orkas использует https://orkas.ai/api/connectors/oauth/dcr-callback, и собственный сервер для этого не нужен.
Затем — и это ключевой шаг — скопируйте RuName, который eBay создал для этой записи. Это короткая непрозрачная строка рядом с 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 разбираются те же вопросы для этих двух платформ.