Fazer o eBay conversar com o Claude não é conceitualmente difícil. É um app OAuth, quatro valores e uma lista de permissões. A dificuldade é que o eBay nomeia esses valores de forma diferente de todos os outros marketplaces, e um campo pede algo que parece exatamente uma URL, mas não é.
Os quatro valores e como o eBay os chama
App ID é o client ID. Cert ID é o client secret. Ambos ficam no eBay Developer Portal em My Account → Application Keys e são copiar e colar.
RuName é o que trava as pessoas, e tem sua própria seção abaixo.
Marketplace ID define em qual site do eBay você opera e precisa corresponder a um locale suportado. Isso é quase sempre óbvio — até não ser. O eBay especifica en-US para Malásia e Singapura, o tipo de detalhe que se descobre por um erro, não por um guia.
RuName é um nome, não um endereço
No portal do desenvolvedor você vai em Keyset → User Tokens → Get a Token via Your Application e cria ou abre uma entrada de Redirect URL. Nela você define “Your auth accepted URL” como o endereço de callback do cliente que está conectando. O Orkas usa https://orkas.ai/api/connectors/oauth/dcr-callback, e nenhum servidor seu é necessário.
Então — e este é o passo — você copia o RuName que o eBay gerou para essa entrada. É uma string curta e opaca ao lado da URL que você acabou de digitar. O campo que a pede está cercado de campos de URL, então o instinto é colar a URL de novo. Isso não autoriza, e o erro devolvido não explica por quê.
O sandbox não é um atalho
O eBay tem um sandbox que exige apenas uma conta de desenvolvedor gratuita, sem conta de vendedor em situação regular, e ele é genuinamente útil para aprender o formato da API. Não é útil para o que você realmente quer, que são seus próprios anúncios e pedidos. Os dados do sandbox são sintéticos.
Conexões novas no Orkas usam apenas produção. Ou seja, a solicitação ao eBay Developers Program — um app com permissões de conta de vendedor, estoque, anúncios e envio, e seu Production Keyset — é o gargalo desta configuração, não o cliente escolhido depois. Comece cedo. O guia oficial de autorização vale a leitura enquanto o pedido está pendente.
Ler não é escrever
Com o keyset em mãos, a lista de permissões decide para que a conexão realmente serve. Perguntar o que vendeu na semana passada é leitura. Revisar um anúncio, ajustar estoque ou marcar um pedido como enviado é escrita, e exige os escopos correspondentes no app.
Vários serviços hospedados de eBay para Claude são somente leitura por design, e isso é um produto razoável — apenas não é o mesmo produto. Verifique o lado da escrita antes de investir no pedido, porque o pedido é idêntico nos dois casos.
O conector do Orkas roda contra as Sell APIs de produção a partir da sua máquina. As credenciais ficam criptografadas no dispositivo, e não em um arquivo de configuração ou em servidores de terceiros, e tudo que escreve em uma conta ativa passa por um pedido de permissão no cliente.
Quando outra coisa é a resposta melhor
Você só quer relatórios: um conector hospedado exige menos configuração e não há nada para instalar. Você quer execução agendada sem ninguém olhando: este é um app desktop, fechar a janela para tudo; uma tarefa agendada em servidor é o formato certo. Você ainda está aprendendo a API: use o sandbox com uma conta de desenvolvedor gratuita e não conecte nada a uma conta ativa ainda.
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.