Pôr o eBay a comunicar com o Claude não é conceptualmente difícil. É uma aplicação OAuth, quatro valores e uma lista de permissões. A dificuldade é que o eBay dá a esses valores nomes diferentes dos de todos os outros marketplaces, e um campo pede algo que parece exatamente um URL, mas não é.
Os quatro valores e como o eBay os chama
App ID é o client ID. Cert ID é o client secret. Ambos estão no eBay Developer Portal em My Account → Application Keys e basta copiá-los e colá-los.
RuName é o que bloqueia as pessoas e tem a sua própria secção abaixo.
Marketplace ID define em que site do eBay opera e tem de corresponder a uma configuração regional suportada. Isto é quase sempre óbvio — até deixar de o ser. O eBay especifica en-US para a Malásia e Singapura, o tipo de detalhe que se descobre através de um erro, não de um guia.
RuName é um nome, não um endereço
No portal do programador, aceda a Keyset → User Tokens → Get a Token via Your Application e crie ou abra uma entrada de Redirect URL. Nessa entrada, defina “Your auth accepted URL” como o endereço de callback do cliente que está a ligar. O Orkas usa https://orkas.ai/api/connectors/oauth/dcr-callback, e não precisa de nenhum servidor próprio.
Depois — e este é o passo — copie o RuName que o eBay gerou para essa entrada. É uma cadeia de caracteres curta e opaca ao lado do URL que acabou de introduzir. O campo que a pede está rodeado de campos de URL, pelo que o instinto é colar novamente o URL. Isso não permite a autorização, e o erro devolvido não explica porquê.
O sandbox não é um atalho
O eBay tem um sandbox que exige apenas uma conta de programador gratuita, sem uma conta de vendedor em situação regular, e é realmente útil para aprender o formato da API. Não é útil para o que realmente pretende, que são os seus próprios anúncios e encomendas. Os dados do sandbox são sintéticos.
As novas ligações no Orkas usam apenas produção. Ou seja, o pedido ao eBay Developers Program — uma aplicação com permissões de conta de vendedor, stock, anúncios e envio, e o respetivo Production Keyset — é o ponto de bloqueio desta configuração, não o cliente escolhido depois. Comece cedo. O guia oficial de autorização merece ser lido enquanto o pedido está pendente.
Ler não é escrever
Com o keyset na mão, a lista de permissões determina para que serve realmente a ligação. Perguntar o que vendeu na semana passada é uma operação de leitura. Rever um anúncio, ajustar o stock ou marcar uma encomenda como enviada é uma operação de escrita e exige os âmbitos de permissão correspondentes na aplicação.
Vários serviços alojados que ligam o eBay ao Claude são apenas de leitura por conceção, e isso é um produto razoável — apenas não é o mesmo produto. Verifique a capacidade de escrita antes de investir no pedido, porque o pedido é idêntico nos dois casos.
O conector do Orkas comunica com as Sell APIs de produção a partir da sua máquina. As credenciais ficam cifradas no dispositivo, e não num ficheiro de configuração ou em servidores de terceiros, e qualquer operação de escrita numa conta ativa passa por um pedido de permissão no cliente.
Quando outra coisa é a melhor resposta
Só quer relatórios: um conector alojado exige menos configuração e não há nada para instalar. Quer execução agendada sem supervisão: esta é uma aplicação de computador, fechar a janela interrompe tudo; uma tarefa agendada num servidor é o formato certo. Ainda está a aprender a API: use o sandbox com uma conta de programador gratuita e ainda não ligue nada a uma conta ativa.
O mesmo catálogo cobre Etsy, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce e as plataformas chinesas. Os textos vizinhos sobre Etsy e Shopify cobrem o mesmo terreno para esses dois.