Configuración de la API de eBay para un agente de publicación con IA

El agente de IA que publica mis artículos en eBay puede agrupar mis fotos, identificar el artículo, fijar su precio a partir de los comparables que le paso y preparar el anuncio. No puede abrir su propia cuenta de desarrollador de eBay. Para eso, eBay quiere una persona, y también para unas cuantas pantallas más que vienen después.

Por eso, esta guía de configuración de la API de eBay divide el trabajo en dos. Tú te encargas de seis páginas de eBay y pegas tres valores en un archivo de tu propio disco. Tu agente hace el resto desde una terminal: la página de privacidad, el enlace de consentimiento, el intercambio del código por un token y la comprobación de las políticas. El encabezado de cada paso indica a quién le toca: Tú, o Tú y tu agente. Dentro de un paso, las instrucciones a secas te corresponden a ti. Una línea que empieza por “Pídele a tu agente” marca su turno, y tú puedes ver cómo pasan los datos JSON por la pantalla.

Quién hace qué en la configuración de la API de eBay

Paso	Tú	Tu agente
Antes de empezar	Ten una cuenta de vendedor, una cuenta de GitHub y un agente de programación con IA. Responde las preguntas de adopción	Copia el código a una carpeta privada, lo instala y ejecuta las pruebas
1. Cuenta de desarrollador	Regístrate y espera la aprobación	—
2. Conjunto de claves de Production	Créalo	—
3. Desbloquear el conjunto de claves	Responde el formulario de eBay sobre la eliminación de cuentas	—
4. Página de privacidad	Dale un nombre, un contacto y tu servicio de IA	Completa la plantilla y publica un Gist
5. RuName (Nombre de URL de redirección)	Completa un formulario	—
6. Archivo .env	Pega tres valores	Crea el archivo y configura Production
7. Consentimiento	Acepta en eBay y copia una dirección	Genera el enlace e intercambia el código por un token
8. Políticas comerciales	Crea las políticas de envío, pago y devoluciones	Las comprueba y te inscribe si das el sí
9. account.json	Toma las decisiones que él no puede y aprueba una ubicación nueva	Escribe el archivo, aplica tus respuestas de adopción y ejecuta cinco comprobaciones

Piensa en el token de actualización del paso 7 como en la llave de tu coche, y en el proceso automatizado como en un aparcacoches con un reglamento. El aparcacoches estaciona el coche: tu agente prepara una oferta sin publicar que los compradores no pueden ver. No sale del aparcamiento hasta que tú asientas, porque publicar requiere tu sí explícito. Hay una salvedad que conviene dejar clara. La llave en sí permite hacer más de lo que autoriza el reglamento, así que se guarda en .env, en tu disco, y nunca en un chat.

Los números rosas de cada captura corresponden a los números de los pasos que aparecen debajo. Las etiquetas coinciden con las pantallas de eBay de noviembre de 2026. eBay cambia los nombres de vez en cuando, así que, si una etiqueta es distinta, fíate de la página de eBay enlazada.

Todo lo que aparece aquí procede de ebay-listing-agent, el proceso automatizado de publicación que uso con mi propia cuenta de vendedor. Tu agente necesita el repositorio antes del paso 1, así que guarda el enlace ahora.

Por qué esta configuración de la API de eBay va directamente a Production

eBay ofrece un Sandbox (Entorno de pruebas), un mercado ficticio para hacer pruebas. La propia guía del repositorio empieza ahí. Esta no. Tus anuncios están en Production, y un usuario de prueba del Sandbox empieza sin políticas comerciales ni ubicación de inventario. Prepararlas en el Sandbox es un desvío. Por eso, tu agente se conecta a tu cuenta real de vendedor desde el principio, y las protecciones del proceso automatizado se encargan de lo demás:

• El flujo de trabajo Lister se detiene en una oferta sin publicar. Los compradores no pueden verla.
• publish sin --confirm muestra un resumen y se niega a continuar. Tu agente te enseña ese resumen y espera tu sí.
• Los dos comandos que modifican tu cuenta de vendedor, setup --opt-in y setup --create-location, también se niegan a continuar sin --confirm.
• Tu agente puede eliminar una oferta sin publicar que no quieras con delete-offer. El comando rechaza cualquier oferta que ya esté publicada.

⚠️ Advertencia: Esta configuración conecta tu agente a tu cuenta real de vendedor. Guarda el Cert ID (identificador de certificado) y el token de actualización únicamente en .env. No los pegues en un chat. No incluyas .env en un commit de git.

Antes de empezar

Tú aportas:

• Una cuenta de vendedor de eBay en regla, con los pagos configurados. Tus anuncios irán aquí.
• El mercado de Estados Unidos (EBAY_US). Los demás mercados no se han probado.
• Una cuenta de GitHub. Tu agente publica allí una pequeña página en el paso 4.
• Un agente de programación con IA que pueda ejecutar comandos de terminal, como Claude Code, Cursor o Codex CLI.

Tu agente hace lo siguiente:

• Clona el repositorio y copia core/ en una carpeta privada nueva. Una copia, no un fork: en GitHub, el fork de un repositorio público es público, y tus carpetas de anuncios contendrán los identificadores de tus ofertas.
• Instala Python 3.10+, ImageMagick 7 y la CLI de GitHub (gh) si faltan, luego los paquetes de Python y, después, ejecuta las pruebas.
• Te guía por ADOPTION-QUESTIONS.md: tu límite de precio para la revisión, la confianza que necesita antes de preparar un anuncio y qué políticas debe usar. Anota tus respuestas y las aplica en el paso 9. Tus respuestas sobre envíos y devoluciones determinan lo que crearás en el paso 8.

Una instrucción que puedes pegar:

Lee ADOPTION-GUIDE.md en github.com/matbanik/ebay-listing-agent. Haz conmigo los pasos del 1 al 3. Estamos configurando eBay en Production, no en el Sandbox. Detente antes del acceso a la API de eBay.

Di “Production” en voz alta, así tal cual. La guía del repositorio propone empezar por el Sandbox, y un agente diligente sigue el repositorio.

1. Tú: inscríbete en el eBay Developers Program (Programa de desarrolladores de eBay)

Tu cuenta de vendedor no puede llamar a la API. eBay gestiona su programa de desarrolladores como un edificio aparte, con su propia puerta de entrada, así que necesitas una segunda cuenta. Puede usar el mismo correo que tu cuenta de vendedor. Sigue siendo un acceso distinto.

1. Abre la página de registro del eBay Developers Program.
2. Completa el formulario. Introduce tu correo una segunda vez donde lo pida.
3. Acepta el API License Agreement (Acuerdo de licencia de la API). Completa la comprobación de que no eres un robot. Selecciona Join (Inscribirse).
4. Espera la aprobación. Puede tardar alrededor de un día laborable. No puedes crear claves antes de que te aprueben.

eBay puede pedirte una dirección de correo de empresa. Dásela si tienes una.

2. Tú: crea tu conjunto de claves de Production de eBay

Un conjunto de claves es el carné de identidad de tu aplicación: tres valores que le dicen a eBay qué aplicación llama a su puerta. Necesitas el de Production.

1. Abre Application Keys en el sitio de desarrolladores.
2. En Production, crea un conjunto de claves. Dale el título de aplicación que quieras, por ejemplo “my-ebay-lister”.
3. Comprueba que la sección Production muestre App ID (Client ID) (Identificador de aplicación o de cliente), Dev ID y Cert ID (Client Secret) (Identificador de certificado o secreto del cliente).
4. Deja esta página abierta. La necesitarás otra vez en los pasos 3, 5 y 6.

El App ID identifica tu aplicación. El Cert ID es su contraseña, así que trátalo como tal. El Dev ID no se usa. Los dos enlaces enmarcados debajo del App ID, User Tokens y Notifications, son las puertas a los pasos 5 y 3. Un conjunto de claves de Production recién creado también dice “Your Keyset is currently disabled.” (Tu conjunto de claves está deshabilitado actualmente). Es normal. El paso 3 lo desbloquea.

3. Tú: desbloquea el conjunto de claves de Production

eBay no activará un conjunto de claves de Production hasta que respondas una pregunta: cuando un usuario de eBay cierra su cuenta, ¿cómo se entera tu aplicación? Las aplicaciones que guardan datos de usuarios de eBay deben recibir esos avisos de eliminación. Las que no los guardan pueden solicitar una exención. El formulario está detrás del enlace Notifications, debajo de tu App ID de Production. También puedes abrir directamente la página de notificaciones de Production.

⚠️ Precaución: Selecciona únicamente un motivo de exención que sea cierto en tu caso. Si ninguno es cierto para tu aplicación, no la solicites. Usa la vía del punto de conexión que aparece al final de este paso. Si se abre un cuadro de confirmación después de accionar el interruptor, léelo. Selecciona Confirm (Confirmar) solo si lo que afirma es cierto en tu caso. El formulario dice: “Failure to provide correct information may result in penalties or having your account disabled.” (No proporcionar información correcta puede dar lugar a sanciones o a la deshabilitación de tu cuenta).

1. Selecciona Marketplace Account Deletion.
2. Activa el interruptor Exempted from Marketplace Account Deletion (Exento de la eliminación de cuentas del mercado).
3. Selecciona el Exemption reason que sea cierto en tu caso. Describe lo que guardas en Additional information (Información adicional).
4. Selecciona Submit.
5. Abre Application Keys otra vez. Busca en el conjunto de claves de Production el mensaje “Your Keyset is currently disabled.”
6. ¿Sigue ahí el mensaje? Detente. Pasa a la página de privacidad del paso 4 mientras esperas. No empieces el consentimiento del paso 7 hasta que desaparezca el mensaje.

Esto es lo que tienes que valorar. El proceso automatizado solo funciona con tu propia cuenta de vendedor. Nunca inicia sesión con otros usuarios de eBay y no guarda datos de compradores. Sí guarda en tu disco archivos sobre tus propios anuncios: títulos, precios, identificadores de ofertas e identificadores de anuncios. La expresión de eBay, “any eBay data,” (cualquier dato de eBay), no aclara si eso cuenta. No puedo decidirlo por ti, y tu agente tampoco.

Si ningún motivo encaja o eBay rechaza la exención, la otra vía es suscribir un punto de conexión HTTPS que responda a los avisos de eBay. El repositorio no incluye ninguno, así que lo alojas tú, y el consentimiento del paso 7 espera hasta que funcione. La guía de eBay sobre la eliminación de cuentas lo explica. Algunos desarrolladores del foro de eBay cuentan que sus conjuntos de claves siguieron en “Non Compliant” (No conforme) después de solicitarla, así que comprueba el conjunto de claves antes de continuar.

4. Tú y tu agente: publica una página de privacidad

eBay no creará un RuName en el paso 5 sin una URL de política de privacidad. Escribirla suena a deberes. La mayor parte le toca a tu agente, porque el repositorio incluye una plantilla.

1. Dale a tu agente un nombre de aplicación, tu nombre o el de tu empresa, un contacto público y el servicio de IA que usas.
2. Pídele a tu agente que complete PRIVACY-TEMPLATE.md. Guarda el resultado como privacy-policy.md.
3. Pídele a tu agente que publique privacy-policy.md como un Gist público de GitHub.
4. ¿gh te pide iniciar sesión? Ejecuta gh auth login tú mismo. Sigue sus indicaciones.
5. Lee la página que publique tu agente. Comprueba el nombre y el contacto.
6. Guarda el enlace del Gist. Lo pegarás en el formulario del RuName en el paso 5.

Una instrucción que puedes pegar:

Completa PRIVACY-TEMPLATE.md para “My eBay Lister”. Propietario: [tu nombre o empresa]. Contacto: [el correo o la página que publicarás]. Servicio de IA: [el que usas]. Guárdala como privacy-policy.md, publícala como un Gist público y dame el enlace.

La plantilla tiene cinco partes breves: a qué accede la aplicación, qué guarda, con quién lo comparte, cómo eliminarlo y cómo contactar contigo. También tiene una línea para nombrar cualquier servicio de IA que analice tus fotos. Tu agente lee tus fotos para identificar artículos, así que indica el servicio en el que lo ejecutas. Tampoco promete más de la cuenta: “Esto es un punto de partida, no asesoramiento jurídico”. La publicación en sí requiere una sola línea de tu agente:

gh gist create --public --desc "Privacy policy: My eBay Lister" privacy-policy.md

5. Tú: crea tu RuName de eBay

RuName es la abreviatura de “redirect URL name”, nombre de URL de redirección. Es el nombre que usa eBay para tu configuración de redirección, y parece que el nombre de tu aplicación haya pasado por una trituradora: YourName-YourApp-ab12-cdefgh. El paso de consentimiento lo necesita. Cada conjunto de claves tiene su propio RuName, así que crea este desde el conjunto de claves de Production.

Llega al formulario:

1. En Application Keys, selecciona User Tokens debajo del App ID de Production.
2. Abre Get a Token from eBay via Your Application (Obtener un token de eBay mediante tu aplicación). Selecciona “You have no Redirect URLs. Click here to add one.” (No tienes URL de redirección. Haz clic aquí para añadir una).
3. ¿eBay te pide una dirección legal? Completa el formulario. Selecciona Continue to create RuName (Continuar para crear el RuName).

Completa el formulario. Los números rosas corresponden a esta lista:

1. En Your privacy policy URL (URL de tu política de privacidad), pega el enlace del Gist del paso 4.
2. En Your auth accepted URL (Tu URL de autorización aceptada) y Your auth declined URL (Tu URL de autorización rechazada), introduce cualquier dirección HTTPS. Mi configuración usa https://example.com.
3. Introduce un Display Title (Título visible), por ejemplo “My eBay Lister”. Verás este título en la página de consentimiento del paso 7.
4. Guarda el formulario.
5. Copia el RuName. Lo pegarás en .env en el paso 6.

¿Por qué la URL de autorización aceptada puede ser cualquier página HTTPS? No tiene que ejecutarse nada allí. Después de que aceptes en el paso 7, eBay envía tu navegador a esa dirección con un código de un solo uso añadido, y tú lo copias directamente de la barra de direcciones. El formulario de eBay añade: “If you leave these fields blank, the eBay default accept and reject pages will be used.” (Si dejas estos campos vacíos, se usarán las páginas predeterminadas de aceptación y rechazo de eBay). En ese caso, la dirección que copias tiene otro aspecto. El paso 7 muestra ambas.

eBay tampoco acepta su propia política de privacidad como si fuera la tuya: la URL debe ser HTTPS y “should not be eBay’s Privacy Policy URL.” (no debe ser la URL de la política de privacidad de eBay). La guía Quick OAuth Guide (Guía rápida de OAuth) de eBay pide un RuName con “OAuth Enabled” (OAuth habilitado). Si tu formulario muestra esa opción, actívala.

6. Tú y tu agente: completa el archivo .env

.env es un archivo de texto sin formato que guarda tus claves en tu propio disco. Tu agente lo crea. Tú introduces los secretos, para que nunca pasen por el chat.

1. Pídele a tu agente que cree .env a partir de .env.example, con EBAY_ENVIRONMENT=production.
2. Abre .env en un editor de texto.
3. Pega el App ID después de EBAY_CLIENT_ID=.
4. Pega el Cert ID después de EBAY_CLIENT_SECRET=.
5. Pega el RuName después de EBAY_REDIRECT_URI=. Pega el RuName, no una URL.
6. Deja EBAY_USER_REFRESH_TOKEN= vacío. El paso 7 lo escribe.
7. Guarda el archivo.

Cuando termines, las cinco líneas que importan tendrán este aspecto, con tus valores en lugar de los corchetes angulares:

EBAY_ENVIRONMENT=production
EBAY_CLIENT_ID=<Production App ID>
EBAY_CLIENT_SECRET=<Production Cert ID>
EBAY_REDIRECT_URI=<Production RuName>
EBAY_USER_REFRESH_TOKEN=

La línea del RuName es donde más gente tropieza. El ajuste se llama redirect_uri, así que una URL parece la respuesta correcta. eBay quiere el RuName. Poner una URL ahí es la causa más habitual de los errores de redirect_uri.

Si alguna vez se filtra el Cert ID, abre Application Keys y selecciona Rotate (Reset) Cert ID con un periodo de gracia de 0, para que el anterior deje de funcionar de inmediato. Pega el nuevo en .env. Los tokens de actualización siguen funcionando después de la rotación, así que no tienes que repetir el paso 7.

7. Tú y tu agente: consentimiento y token de actualización de eBay

Este es el apretón de manos. Le dices a eBay, como vendedor, que esta aplicación puede gestionar tus anuncios. eBay entrega a tu navegador un código de un solo uso. Tu agente lo intercambia por un token de actualización, la clave de larga duración que el proceso automatizado usa a partir de entonces. Solo tienes cinco minutos, así que lee la lista primero y luego empieza.

1. Pídele a tu agente que ejecute auth-url. Te dará un enlace de consentimiento.
2. Abre el enlace de consentimiento en tu navegador.
3. ¿eBay te pide iniciar sesión? Introduce el nombre de usuario y la contraseña de tu cuenta de vendedor. No uses la cuenta de desarrollador.
4. Lee los permisos en la página de consentimiento. Acéptalos.
5. Copia la dirección completa de la barra de direcciones de la página que se abra.
6. Pega la dirección completa en el chat.
7. Pídele a tu agente que ejecute exchange-code con ella de inmediato.
8. Comprueba que tu agente indique "stored": true. ¿Indica invalid_grant? Vuelve a empezar desde el principio de esta lista.

Así son las dos direcciones. Tu agente te da la primera. Tú le devuelves la segunda.

You open (the consent link from your agent):
https://auth.ebay.com/oauth2/authorize?client_id=<App ID>&redirect_uri=<RuName>&response_type=code&scope=https%3A//api.ebay.com/oauth/api_scope%20...

You copy (from the address bar, after you accept):
https://example.com/?code=v%5E1.1%23i%5E1%23...&expires_in=299

La parte después de code= cambia cada vez. Funciona una vez y caduca a los 299 segundos, que es lo que te indica expires_in=299. Tu dirección puede incluir otras partes, como state=. Cópiala entera. Tu agente extrae el código.

¿Es seguro pegarlo en un chat? El código funciona una vez y caduca a los cinco minutos. eBay solo lo intercambia por un token si va acompañado de tu Cert ID, y el Cert ID se queda en .env. Así que el código no sirve sin el Cert ID. Hay dos sitios que sí lo ven: el chat y el sitio de tu URL de autorización aceptada, que puede registrar la dirección a la que llegas. Ninguno recibe tu Cert ID y, una vez que tu agente intercambia el código, ya está gastado. El enlace de consentimiento sí muestra tu App ID y tu RuName. Es normal: todos los enlaces de consentimiento de OAuth los incluyen.

¿Dejaste vacía la URL de autorización aceptada en el paso 5? Entonces eBay te envía a su propia página, y la dirección empieza así:

https://signin.ebay.com/ws/eBayISAPI.dll?ThirdPartyAuthSucessFailure&isAuthSuccessful=true&state=null&code=v%5E1...

Sí, “Sucess.” Así lo escribe eBay, no yo. La parte de code= también está ahí, y exchange-code la lee de cualquier dirección. Esta vía también evita que el código llegue a un sitio que no gestionas. Mi propia configuración usa example.com, así que no he probado esta vía personalmente.

Qué	Duración	Quién se encarga
Código	299 segundos, un solo uso	Lo copias una vez
Token de acceso	2 horas	La herramienta lo renueva por sí sola
Token de actualización	Unos 18 meses	Repite este paso cuando caduque

Si algo sale mal:

• invalid_grant: el código ya se usó o tiene más de cinco minutos. Consigue un enlace nuevo y pega más rápido.
• Error de redirect_uri: .env contiene una URL o un RuName del Sandbox en lugar del RuName de Production.
• invalid_client: el App ID y el Cert ID proceden de distintos conjuntos de claves, o EBAY_ENVIRONMENT no es production.

8. Tú y tu agente: crea las políticas comerciales de eBay

Las políticas comerciales son respuestas guardadas a las preguntas que plantea cada anuncio: ¿cómo se envía, cómo paga el comprador y qué pasa si hay una devolución? Tu agente las vincula a cada oferta por su identificador. Su herramienta puede leer políticas, pero no tiene ningún comando para crearlas, así que esta parte te toca a ti.

Pídele a tu agente que ejecute policies primero. Enumera las políticas que ya tienes. Si ya tienes una política de envío gratuito, una de pago y una de devoluciones de 30 días, pasa al paso 9. Si policies indica que tu cuenta no está inscrita en Business Policies, tu agente puede ejecutar setup --opt-in --confirm, pero solo después de que des el sí. Luego pídele que ejecute policies otra vez. Cuando desaparezca el error de inscripción, crea tus políticas. Las propias notas del repositorio sitúan esa espera entre unos minutos y 24 horas.

1. Abre My eBay. Selecciona Account. Selecciona Selling en el menú de la izquierda.
2. Selecciona Business Policies. Se abre la página Manage your business policies (Gestionar tus políticas comerciales).
3. Selecciona Create policy arriba a la derecha. Selecciona el tipo de política.

Crea tres políticas de esta forma, de una en una.

Política de envío

El cálculo de precios del proceso automatizado incorpora el coste de envío al precio del artículo, así que necesita una política de envío gratuito. Evita el envío calculado. Las preguntas de adopción del repositorio lo ponen como ejemplo de una política que puede fallar por errores en los datos del paquete.

1. En Cost type, selecciona Flat: Same cost to all buyers (Tarifa fija: el mismo coste para todos los compradores).
2. Activa Offer free shipping.
3. Introduce un Policy name (Nombre de la política), por ejemplo “Free domestic shipping” (Envío nacional gratuito).
4. Selecciona el Shipping method (Método de envío) que se ajuste a tus artículos.
5. Selecciona el Handling time (Tiempo de preparación) que se ajuste a tus artículos.
6. Selecciona Save (Guardar).

Políticas de pago y devoluciones

1. Crea una política de pago. Activa Require immediate payment when buyer uses Buy It Now (Exigir el pago inmediato cuando el comprador usa Comprar ahora). Selecciona Save.
2. Crea una política de devoluciones. Activa Accept returns (Aceptar devoluciones) en las devoluciones nacionales.
3. En Allowed within (Plazo permitido), selecciona 30 Days (30 días). En Return shipping paid by (El envío de devolución lo paga), selecciona Buyer (Comprador). Selecciona Save.
4. Pídele a tu agente que ejecute policies otra vez.
5. Comprueba que aparezcan las tres políticas.

Mi política de pago exige el pago inmediato, y la política de devoluciones predeterminada del repositorio es de 30 días, con el envío de devolución a cargo del comprador. El formulario de eBay añade su propio incentivo: “Offering a minimum 30-day return policy helps your listings qualify for Top Rated Seller Benefits.” (Ofrecer una política de devoluciones de al menos 30 días ayuda a que tus anuncios cumplan los requisitos para las ventajas de los vendedores mejor valorados).

9. Tú y tu agente: escribe account.json y ejecuta las comprobaciones

Los identificadores de tus políticas y tu ubicación de inventario son distintos de los de los demás, así que se guardan en account.json, un archivo privado junto a .env. Tu agente lo escribe con setup. Ese comando no entrevista a nadie. Conserva las elecciones que ya estén guardadas en account.json. Si no las hay, toma la única candidata, como tu única ubicación o tu única política de devoluciones de 30 días. Cuando no puede elegir, lo indica en sus choices y espera una opción. Tu parte consiste en tomar las decisiones que él no puede.

1. Pídele a tu agente que ejecute setup --dry-run. Informa de lo que ha encontrado y de lo que no puede decidir.
2. Revisa las choices con tu agente. ¿Alguna línea dice “found: pass”? Dile qué política o ubicación debe usar.
3. ¿No tienes ubicación de inventario? Dale a tu agente tu código postal, ciudad y estado. Aprueba el comando --create-location.
4. Pídele a tu agente que ejecute setup --dry-run otra vez con tus elecciones.
5. ¿Sigue apareciendo algo en problems? Repite los pasos del 2 al 4.
6. Pídele a tu agente que ejecute setup con las mismas elecciones. Escribe account.json.
7. Pídele a tu agente que aplique el resto de tus respuestas de adopción. ADOPTION-QUESTIONS.md indica la clave o el archivo para cada una.
8. Comprueba el límite de precio y la tasa de comisión en la sección pipeline de account.json.
9. Pídele a tu agente que ejecute las cinco comprobaciones siguientes. Las cinco deberían completarse correctamente.

Tus elecciones se transmiten como opciones. Tu agente pasa el identificador de una política con --fulfillment (así llama eBay al envío), --payment o --return, y una ubicación con --location-key. Dos respuestas de adopción se transmiten igual: --disallow-fulfillment marca una política de envío que tu agente nunca debe usar, y --return-14-day indica una política de devoluciones de 14 días si conservas alguna:

python tools/ebay_api.py setup --dry-run --fulfillment <ID> --return <ID> --location-key HOME-01

El comando de ubicación que ejecuta tu agente después de tu sí tiene este aspecto:

python tools/ebay_api.py setup --create-location --location-key HOME-01 --postal-code <ZIP> --city <city> --state <ST> --confirm

Es fácil pasar por alto el punto 7 anterior, porque setup lee tu cuenta de eBay, no tus respuestas de adopción. Rellena pipeline con los valores predeterminados del repositorio: revisar todo lo que supere los $200, preguntar si la confianza está por debajo de 0.70, una comisión por venta del 13.6% y $0.40 por pedido. Esos valores se imponen hasta que tu agente edita el archivo, y las ejecuciones posteriores de setup conservan los cambios. Tus otras respuestas, como el origen de las fotos y las copias de seguridad, van en los archivos de los flujos de trabajo y en AGENTS.md. Los pasos 5 y 6 de ADOPTION-GUIDE.md enumeran cada cambio. Su paso 7 añade una validación con un anuncio ficticio de una linterna frontal que no modifica nada en eBay.

A continuación, las cinco comprobaciones del paso 9:

python tools/ebay_api.py setup --dry-run              # "problems": [] means ready
python tools/ebay_api.py policies
python tools/ebay_api.py categories "flashlight"
python tools/ebay_api.py browse "flashlight" --limit 1
python tools/ebay_api.py reconcile

Aquí tienes una ejecución real de setup --dry-run de mi propia cuenta, recortada y con los identificadores ocultos. Es una segunda ejecución, por eso cada elección dice “kept from account.json”. La línea que buscas es "problems": [].

{
  "file": "<your folder>/account.json",
  "written": false,
  ...
  "choices": {
    "merchantLocationKey": "kept from account.json",
    "fulfillment": "kept from account.json",
    "payment": "kept from account.json",
    "return": "kept from account.json"
  },
  "problems": [],
  ...
  "next": "Ready: the Lister copies these IDs into offer.json; validate_payload.py checks them"
}

"written": false significa que la simulación comprobó los datos y dejó el archivo tal como estaba.

Tu primer artículo: quién hace qué

Ya tienes configurada la API de eBay. A partir de aquí, dejas fotos en una carpeta y tu agente ejecuta cinco flujos de trabajo, uno tras otro. Tu parte se reduce a unas pocas intervenciones:

Flujo de trabajo	Qué haces tú
Import	Deja las fotos. Comprueba la agrupación
Curator	Corrige la identificación si es errónea
Evaluator	Pega comparables de ventas realizadas de Terapeak cuando te los pida
Lister	Nada. Se detiene en una oferta sin publicar
Review	Lee listing-draft.md y luego aprueba o rechaza

¿Por qué usar Terapeak a mano? El comando Browse de la herramienta ve lo que piden ahora otros vendedores, no lo que los compradores pagaron de verdad. Un precio de oferta es un techo, no una venta. Por eso, el Evaluator te pide comparables de ventas realizadas, y Terapeak, en Seller Hub (Centro de vendedores), los tiene.

Así trabaja el aparcacoches. Estaciona cada coche ordenadamente en el aparcamiento como una oferta sin publicar, y todo lo que supere tu límite de precio te espera incluso antes de aparcar. Nada sale del aparcamiento hasta que entregas el resguardo, y el resguardo es tu sí en el paso Review.

Consigue ebay-listing-agent en GitHub, dale a tu agente ADOPTION-GUIDE.md y dile “Production, no Sandbox”. Si alguna etiqueta de esta guía de configuración de la API de eBay ya no coincide con la pantalla de eBay, abre una incidencia en el repositorio para que el siguiente vendedor no tenga que buscarla.

Recursos

• eBay Developers Program: registro
• Claves de la aplicación de eBay
• Primeros pasos con las API de eBay
• Credenciales de OAuth de eBay
• Eliminación de cuentas del mercado de eBay
• Guía rápida de OAuth de eBay (RuName, código de consentimiento)
• Cómo restablecer tu Cert ID
• Políticas comerciales en eBay (ayuda para vendedores)
• Políticas comerciales (guía de la API de cuentas)
• ebay-listing-agent en GitHub
• CLI de GitHub: gh gist create
• Descargas de Python
• Descargas de ImageMagick

---