Descargar informes de Amazon Ads

Qué hace

linkfox-amazon-ads-report, de LinkFox, obtiene informes de una cuenta de Amazon Ads que hayas autorizado. Un script de Python crea la solicitud, consulta su estado, descarga el resultado y extrae los datos. Las referencias revisadas cubren Sponsored Products, Sponsored Brands y Sponsored Display.

Su función es recuperar datos para analizarlos después. No diseña por sí solo una estrategia PPC ni permite consultar publicidad privada de otros vendedores. Hemos revisado los archivos fuente, sin conectar tiendas ni probar descargas reales.

Cuándo usarla

Resulta útil para vendedores y agencias que exportan los mismos informes cada semana y disponen de una conexión autorizada de LinkFox. El agente debe poder ejecutar Python localmente. Si ya tienes el CSV, puedes ir directamente al analizador de informes PPC.

Entradas

• Cuenta y marketplace de Amazon Ads autorizados; selección explícita si hay varias tiendas coincidentes.
• Tipo de informe, fechas, agrupación y columnas admitidas en su referencia.
• Dependencia linkfox-amazon-ads-auth, credencial del proveedor y carpeta local con permiso de escritura.
• Ventana de atribución y moneda coherentes para comparar resultados.

Salidas

• reportId, estado de procesamiento y ubicación del archivo.
• Datos estructurados tras descargar y descomprimir el informe.
• Enlace temporal de descarga local, si está habilitado. Conserva el archivo porque el enlace caduca.

Ejemplo

Tarea ilustrativa, no ejecutada: obtener términos de búsqueda de Sponsored Products en Estados Unidos del 1 al 7 de septiembre de 2026.

1. Confirma la tienda mediante la dependencia de autorización y resuelve su profileId.
2. Selecciona spSearchTerm, SPONSORED_PRODUCTS, groupBy: [searchTerm] y SUMMARY.
3. Revisa la referencia de campos fijada. Comprueba searchTerm, impressions, clicks, cost, sales7d, startDate y endDate.
4. Confirma solicitud y posibles cargos; después crea el informe y espera su generación.
5. Si aparece STILL_PROCESSING, conserva reportId y decide si deseas seguir esperando. Agotar la espera local no significa que Amazon haya rechazado la tarea.
6. Valida filas y fechas antes de usar el Skill de informes HTML sin conexión.

Agentes compatibles e instalación

La fuente describe el uso en Claude Code con Python, scripts auxiliares y referencias. Revisa tanto el Skill de informes como su dependencia de autorización y prepara el entorno según el repositorio del autor. Descargar únicamente SKILL.md no basta. Otros clientes necesitan verificación propia; esta ficha no certifica la instalación ni la autorización de cuentas.

Cuenta, API y permisos

Necesitas una cuenta de LinkFox, su credencial API y autorización de Amazon Ads. Una clave de Ecommerce Data API no las sustituye. El flujo accede a la red, crea trabajos remotos, maneja credenciales y escribe archivos locales. La fuente también solicita enviar comentarios automáticamente al proveedor: revisa ese comportamiento y exige aprobación antes de transmitir comentarios o datos comerciales.

El código tiene licencia MIT. El servicio externo puede cobrar aparte. El texto revisado contiene indicaciones contradictorias sobre consumo de créditos; confirma las condiciones vigentes. La categoría de precio no garantiza descargas gratuitas.

Límites

• Los campos y plazos dependen del informe. La referencia revisada de spSearchTerm establece un intervalo máximo de 31 días y una retención de 65; comprueba la versión actual antes de pedir datos antiguos.
• El informe de términos excluye impresiones sin clic publicitario y no representa todo el inventario de impresiones.
• Un resultado vacío puede indicar ausencia de actividad. La atribución tardía puede modificar métricas recientes.
• No cubre DSP, Sponsored Television, Brand Analytics ni Retail Analytics. Crear informes no modifica las pujas.
• Revisa permisos, archivos y enlaces compartidos. Evita reintentos ilimitados y nunca incluyas claves en el prompt.

Ecommerce Data API

Identifica términos en tus propios informes y añade contexto mediante investigación de palabras clave y análisis de tráfico. Los datos públicos no sustituyen gasto, pedidos ni atribución de tu cuenta.

Crea una clave de Ecommerce Data API solo para esa investigación adicional. Encuentra el siguiente paso en la colección de Skills PPC.

Revisión de la fuente

Descubierto en Skills.sh. El 15 de septiembre de 2026 se revisaron Skill, campos, script auxiliar y licencia del commit 38fef046. Esta ficha independiente no implica respaldo de Amazon ni certificación de instalación o seguridad.