Imagen principal de Amazon con fondo blanco

Qué hace

amazon-white-background es uno de los doce Skills de imagen del paquete ecommerce-image-skills de xianyu110. Convierte una foto hecha con el móvil o enviada por el proveedor en una imagen principal cuadrada sobre fondo blanco puro, y después mide el resultado con un script de Python incluido.

Dos cosas lo distinguen de una colección de prompts. Empieza escribiendo un bloqueo de identidad del producto: forma, color, texto del logotipo, piezas incluidas y lo que no debe aparecer. Ese bloque se pega en todos los prompts para que el producto generado siga siendo el que vendes. Después check_main_image.py da tres cifras: cuánto de blanco es el borde, qué parte del encuadre ocupa el producto y el lado más largo en píxeles.

Cuándo usarlo

Úsalo cuando tengas una foto real del producto y necesites una imagen principal que cumpla la norma de fondo blanco del marketplace. No es el punto de partida adecuado si no tienes foto: el Skill permite generar solo con texto, pero indica al agente que presente el resultado como un concepto y no como el producto real. Para planificar un conjunto completo de imágenes en lugar de producir una, consulta Amazon Listing Images.

Entradas

Al menos una foto del producto, como mínimo de frente; ayudan más ángulos y un primer plano del logotipo. Cualquier dato que la foto no muestre (tamaño, capacidad, material) tienes que aportarlo tú. La fuente indica al agente que pregunte o lo omita, y que nunca invente especificaciones ni certificaciones.

Salidas

Una imagen 1:1 y el informe de comprobación. El script da por buena una imagen cuando al menos el 98% del borde exterior (el 2% más externo) está dentro de una pequeña tolerancia respecto a #FFFFFF, el producto ocupa como mínimo el 85% del encuadre en su lado más largo y el lado más largo de la imagen mide al menos 1000 px. También indica qué parte del fondo es exactamente 255,255,255. La opción --fix lleva los píxeles casi blancos a blanco puro y recorta de nuevo para que el producto cubra alrededor del 87%.

Flujo de ejemplo

Solo demostración; no se ejecutó. Los valores son inventados para mostrar cómo se lee el informe. No se generó ninguna imagen.

input_photo: phone-snapshot.jpg
identity_lock:
  shape: tall cylinder, rounded shoulders
  colour: matte sage green body, bamboo lid
  logo: white wordmark centred on the upper body
  must_not_appear: accessories not in the box, extra logos
check_main_image:
  width: 1600
  height: 1600
  white_background: 0.994
  coverage: 0.81
  result: coverage below 0.85

Aquí el fondo pasa y el tamaño es suficiente, pero el producto ocupa el 81% del encuadre, por debajo del umbral del 85%. El siguiente paso sería la opción --fix del script, o una nueva generación con el producto más grande en el encuadre. Superar estas comprobaciones solo cubre fondo, cobertura y tamaño. No dice nada sobre si el producto de la imagen sigue coincidiendo con el real.

Agentes compatibles y configuración

La fuente nombra Claude Code, Codex, Cursor y cualquier agente que cargue SKILL.md. Evidencia revisada el 2026-10-13 en el commit f4566fd: el SKILL.md fijado, scripts/check_main_image.py, scripts/generate.py, scripts/online_link.py, el manifiesto del plugin y la licencia MIT. Los otros once Skills del paquete no se leyeron completos. Esta página es source-reviewed, no install-tested, y no muestra comando de instalación.

Cuenta, API y permisos

El Skill ofrece tres formas de producir la imagen, y cada una envía tus datos a un sitio distinto:

• La herramienta de imagen del propio agente. Nada más allá de lo que tu agente ya hace.
• Una API key. generate.py lee GPTIMAGE_API_KEY y envía el prompt y tus fotos de producto a GPTIMAGE_BASE_URL. El valor por defecto es https://api.openai.com. La fuente recomienda en su lugar una pasarela de terceros; si la configuras, tus fotos y tu clave van a esa pasarela.
• Un enlace para el navegador. online_link.py construye una URL al sitio de imágenes del propio autor con el prompt completo en la cadena de consulta, además de etiquetas de campaña. Al abrirla, el texto del prompt se envía a ese sitio.

El script de comprobación se ejecuta en local y necesita pillow y numpy. No interviene ninguna clave de este sitio.

Límites y revisión humana

El repositorio promociona los servicios del autor en todo momento, así que decide qué vía usas antes de que el agente elija por ti. Los modelos de imagen pueden redibujar un logotipo o cambiar una proporción y aun así dejar un fondo blanco limpio; compara el resultado con el producto real antes de subirlo. Los valores de las normas que recoge el Skill son el resumen del autor en el commit revisado. Comprueba tú las normas vigentes de tu categoría, porque ropa y otras categorías difieren. No hemos generado ninguna imagen con este Skill.

Combinar con Ecommerce Data API

El bloqueo de identidad necesita datos, y un listing ya publicado es una fuente para obtenerlos. amazon.products.details devuelve el título, la marca, las viñetas, las dimensiones y la URL de la imagen principal de un producto, que puedes contrastar con tu foto antes de escribir el bloqueo. amazon.products.competitors devuelve productos similares a un ASIN, para ver cómo están encuadradas las imágenes principales junto a las que aparecerás. Consulta la documentación de detalle de producto y la de competidores, y después crea una API key de Ecommerce Data API si quieres ese contexto. Los datos describen listings públicos. No generan ni evalúan imágenes, y el Skill funciona sin ellos.