Connecter eBay à Claude n’est pas conceptuellement difficile. Il faut une application OAuth, quatre valeurs et une liste d’autorisations. La difficulté est qu’eBay nomme ces valeurs autrement que les autres marketplaces, et qu’un champ demande quelque chose qui ressemble exactement à une URL sans en être une.
Les quatre valeurs et leurs noms chez eBay
L’App ID est l’identifiant client. Le Cert ID est le secret client. Les deux se trouvent dans le portail développeur eBay, sous Mon compte → Clés d’application, et se copient-collent simplement.
RuName est ce qui bloque les utilisateurs ; une section lui est consacrée ci-dessous.
Marketplace ID sélectionne le site eBay sur lequel vous travaillez et doit correspondre à une locale prise en charge par cette marketplace. Cela paraît généralement évident, jusqu’au cas contraire. eBay spécifie en-US pour la Malaisie et Singapour, le genre de détail que l’on découvre par une erreur plutôt que dans un guide.
RuName est un nom, pas une adresse
Dans le portail développeur, allez dans Jeu de clés → Jetons utilisateur → Obtenir un jeton via votre application, puis créez ou ouvrez une entrée URL de redirection. Définissez-y « Votre URL d’authentification acceptée » sur l’adresse de rappel du client que vous connectez. Orkas utilise https://orkas.ai/api/connectors/oauth/dcr-callback, sans nécessiter de serveur à vous.
Ensuite — c’est l’étape essentielle — copiez le RuName généré par eBay pour cette entrée. C’est une courte chaîne opaque placée à côté de l’URL que vous venez de saisir. Le champ qui l’attend est entouré de champs URL, d’où le réflexe de recoller l’URL. Cela n’autorise pas la connexion, et l’erreur renvoyée n’explique pas pourquoi.
Le bac à sable n’est pas un raccourci
eBay propose un bac à sable qui ne nécessite qu’un compte développeur gratuit, sans compte vendeur en règle. Il est réellement utile pour apprendre la structure de l’API, mais pas pour ce que vous voulez vraiment : vos annonces et vos commandes. Les données du bac à sable sont synthétiques.
Les nouvelles connexions dans Orkas utilisent uniquement la production. La demande auprès du programme développeur eBay — une application avec les autorisations de compte vendeur, stock, annonces et traitement des commandes, et son jeu de clés de production — est donc l’étape la plus longue, pas le client que vous choisissez ensuite. Commencez tôt. Le guide officiel d’autorisation mérite d’être lu pendant l’attente.
Lire n’est pas écrire
Une fois le jeu de clés obtenu, la liste d’autorisations détermine l’usage réel de la connexion. Demander ce qui s’est vendu la semaine dernière est une lecture. Modifier une annonce, ajuster le stock ou marquer une commande comme expédiée est une écriture, qui exige les autorisations correspondantes sur l’application.
Plusieurs services hébergés reliant eBay à Claude sont volontairement en lecture seule. C’est un produit raisonnable, mais différent. Vérifiez le volet écriture avant d’investir du temps dans la demande d’application, car cette démarche préalable est identique dans les deux cas.
Le connecteur Orkas utilise les API Sell de production depuis votre machine. Les identifiants sont chiffrés sur l’appareil plutôt que stockés dans un fichier de configuration ou sur les serveurs d’un tiers. Toute écriture sur un compte réel passe par une demande d’autorisation dans le client, au lieu de compter sur la prudence du modèle.
Quand une autre solution convient mieux
Vous voulez seulement des rapports : un connecteur hébergé demande moins de configuration et rien à installer. Vous voulez une exécution planifiée sans surveillance : il s’agit d’une application de bureau, donc fermer la fenêtre l’arrête ; une tâche planifiée sur serveur convient mieux. Vous apprenez encore l’API : utilisez le bac à sable et un compte développeur gratuit, sans rien connecter à un compte réel pour le moment.
Le même catalogue couvre Etsy, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce et les plateformes chinoises : la gestion des identifiants ne repart donc pas de zéro pour chaque boutique. Les articles voisins sur Etsy et Shopify traitent des mêmes points pour ces deux plateformes.