Conseguir que eBay se comunique con Claude no es difícil en lo conceptual. Se trata de una aplicación OAuth, cuatro valores y una lista de permisos. La dificultad está en que eBay da a esos valores nombres distintos de los que usan las demás plataformas de comercio, y un campo pide algo que parece exactamente una URL, pero no lo es.
Los cuatro valores y cómo los llama eBay
App ID es el ID de cliente. Cert ID es el secreto de cliente. Ambos están en el portal para desarrolladores de eBay, en Mi cuenta → Claves de la aplicación, y basta con copiarlos y pegarlos.
RuName es el que suele atascar a la gente, y tiene su propia sección más abajo.
Marketplace ID selecciona el sitio de eBay en el que operas y debe corresponder a una configuración regional que ese mercado admita. En general, esto resulta obvio — hasta que deja de serlo. eBay especifica en-US para Malasia y Singapur, que es exactamente el tipo de detalle que descubres por un error en lugar de por una guía.
RuName es un nombre, no una dirección
En el portal para desarrolladores, ve a Conjunto de claves → Tokens de usuario → Obtener un token mediante tu aplicación, y crea o abre una entrada de URL de redirección. En esa entrada, establece “Tu URL de autorización aceptada” con la dirección de devolución de llamada del cliente que estés conectando. Orkas usa https://orkas.ai/api/connectors/oauth/dcr-callback, y no necesitas un servidor propio para ello.
Después — y este es el paso clave — copia el RuName que eBay generó para esa entrada. Es una cadena corta sin significado evidente, situada junto a la URL que acabas de escribir. El campo que lo pide está rodeado de campos de URL, así que el impulso es pegar la URL otra vez. Eso no permite autorizar la conexión, y el error que recibes no explica por qué.
El entorno de pruebas no es un atajo
eBay ofrece un entorno de pruebas que solo requiere una cuenta gratuita de desarrollador, sin necesidad de una cuenta de vendedor en regla, y es realmente útil para conocer la estructura de la API. No sirve para lo que en realidad buscas: tus propios anuncios y tus propios pedidos. Los datos del entorno de pruebas son sintéticos.
Las conexiones nuevas en Orkas usan únicamente el entorno de producción. Eso significa que la solicitud al eBay Developers Program — una aplicación con permisos de cuenta de vendedor, inventario, anuncios y gestión de pedidos, y su conjunto de claves de producción — es la parte que más tiempo lleva de esta configuración, no el cliente que elijas después. Iníciala con antelación. Vale la pena leer la guía oficial de autorización mientras la solicitud está pendiente.
Leer no es escribir
Una vez que existe el conjunto de claves, la lista de permisos determina para qué sirve realmente la conexión. Preguntar qué se vendió la semana pasada es una operación de lectura. Modificar un anuncio, ajustar el inventario o marcar un pedido como enviado es una operación de escritura y requiere los ámbitos de permiso correspondientes en la aplicación.
Varios servicios alojados que conectan eBay con Claude son de solo lectura por diseño, y eso es un producto razonable — simplemente no es el mismo producto. Comprueba las funciones de escritura antes de dedicar esfuerzo a la solicitud, porque el trámite previo es idéntico en ambos casos.
El conector de Orkas opera con las API Sell de producción desde tu propia computadora. Las credenciales se almacenan cifradas en el dispositivo, en lugar de estar en un archivo de configuración o en servidores ajenos, y cualquier operación que escriba en una cuenta real pasa por una solicitud de permiso en el cliente, en vez de depender de que el modelo sea prudente.
Cuándo conviene otra solución
Solo quieres informes: un conector alojado requiere menos configuración y no hay nada que instalar. Quieres que se ejecute de forma programada sin supervisión: esta es una aplicación de escritorio, así que al cerrar la ventana se detiene; lo adecuado es una tarea programada en un servidor. Todavía estás aprendiendo a usar la API: utiliza el entorno de pruebas y una cuenta gratuita de desarrollador, y aún no conectes nada a una cuenta real.
El mismo catálogo incluye Etsy, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce y las plataformas chinas, para que no tengas que empezar de nuevo a gestionar credenciales con cada tienda. Los artículos relacionados sobre Etsy y Shopify abordan los mismos aspectos para esas dos plataformas.