Far comunicare eBay con Claude non è concettualmente difficile. Servono un'app OAuth, quattro valori e un elenco di autorizzazioni. La difficoltà è che eBay assegna a quei valori nomi diversi da ogni altro marketplace, e un campo richiede qualcosa che sembra esattamente un URL ma non lo è.
I quattro valori e come li chiama eBay
App ID è l'ID client. Cert ID è il segreto client. Entrambi si trovano nel portale per sviluppatori eBay, in Il mio account → Chiavi applicazione, e per entrambi basta copiare e incollare.
RuName è quello su cui le persone si bloccano, e più avanti gli dedichiamo una sezione.
L'ID del marketplace seleziona il sito eBay su cui operi e deve corrispondere a un'impostazione locale supportata da quel marketplace. Di solito è ovvio — finché non lo è più. eBay specifica en-US per Malesia e Singapore, proprio il tipo di dettaglio che si scopre da un errore anziché da una guida.
RuName è un nome, non un indirizzo
Nel portale per sviluppatori, vai su Set di chiavi → Token utente → Ottieni un token tramite la tua applicazione, quindi crea o apri una voce URL di reindirizzamento. In quella voce, imposta “Il tuo URL di autorizzazione accettata” sull'indirizzo di callback del client che stai collegando. Orkas usa https://orkas.ai/api/connectors/oauth/dcr-callback e non richiede un server di tua proprietà.
Poi — ed è questo il passaggio decisivo — copia il RuName generato da eBay per quella voce. È una breve stringa opaca accanto all'URL che hai appena digitato. Il campo che la richiede è circondato da campi URL, quindi viene spontaneo incollare di nuovo l'URL. Così l'autorizzazione non riesce e l'errore restituito non spiega il motivo.
La sandbox non è una scorciatoia
eBay offre una sandbox che richiede solo un account sviluppatore gratuito, senza bisogno di un account venditore in regola, ed è davvero utile per familiarizzare con la struttura dell'API. Non è utile per ciò che ti interessa davvero: le tue inserzioni e i tuoi ordini. I dati della sandbox sono sintetici.
Le nuove connessioni in Orkas usano solo l'ambiente di produzione. Questo significa che la richiesta al programma eBay Developers Program — un'app con autorizzazioni per account venditore, inventario, inserzioni ed evasione degli ordini, insieme al relativo set di chiavi di produzione — è la parte che richiede più tempo in questa configurazione, non il client che scegli in seguito. Avviala per tempo. Vale la pena leggere la guida ufficiale all'autorizzazione mentre la richiesta è in attesa.
Leggere non significa scrivere
Una volta ottenuto il set di chiavi, l'elenco delle autorizzazioni determina a cosa serve effettivamente la connessione. Chiedere cosa è stato venduto la settimana scorsa è un'operazione di lettura. Modificare un'inserzione, aggiornare l'inventario o contrassegnare un ordine come spedito è un'operazione di scrittura e richiede gli ambiti di autorizzazione corrispondenti nell'app.
Diversi servizi ospitati che collegano eBay a Claude sono di sola lettura per scelta progettuale, ed è un prodotto sensato — semplicemente, è un prodotto diverso. Verifica le funzioni di scrittura prima di investire tempo nella richiesta, perché la procedura preliminare è identica in entrambi i casi.
Il connettore Orkas accede alle API Sell di produzione dal tuo computer. Le credenziali sono crittografate sul dispositivo, anziché essere conservate in un file di configurazione o sui server di qualcun altro, e qualsiasi operazione di scrittura su un account reale passa attraverso una richiesta di autorizzazione nel client, invece di affidarsi alla prudenza del modello.
Quando un'altra soluzione è più adatta
Vuoi solo resoconti: un connettore ospitato richiede meno configurazione e non c'è nulla da installare. Vuoi esecuzioni programmate senza supervisione: questa è un'applicazione desktop, quindi chiudere la finestra ne interrompe l'esecuzione; un processo pianificato su un server è la soluzione adatta. Stai ancora imparando a usare l'API: usa la sandbox e un account sviluppatore gratuito, senza collegare ancora nulla a un account reale.
Lo stesso catalogo copre Etsy, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce e le piattaforme cinesi, così non devi ricominciare a destreggiarti tra le credenziali per ogni negozio. Gli articoli correlati su Etsy e Shopify affrontano gli stessi argomenti per queste due piattaforme.