Una herramienta CLI de solo lectura para la API de Spotify Ads (v3) que permite informes profundos, estimación de audiencia y análisis de campañas.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install spotify-ads-cli
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar spotify-ads-cli usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es Spotify Ads CLI?
Spotify Ads CLI es una herramienta técnica robusta diseñada para interactuar con la API de Spotify Ads v3, permitiendo a desarrolladores y profesionales de marketing extraer datos de rendimiento granulares directamente desde la terminal. Como una poderosa adición a la biblioteca Openclaw Skills, simplifica el proceso de consultar cuentas comerciales, rastrear el gasto publicitario y analizar jerarquías de campañas. La skill proporciona una pasarela de solo lectura para métricas publicitarias críticas, garantizando la exploración segura de datos sin modificaciones accidentales en campañas activas.
Al integrar esta herramienta en su flujo de trabajo de Openclaw Skills, puede acceder programáticamente a todo, desde instantáneas de rendimiento agregado hasta informes complejos de conocimientos demográficos. Maneja los matices de la API de Spotify, como la conversión de micros a moneda y la generación de informes CSV asíncronos, convirtiéndolo en una utilidad esencial para estrategias publicitarias basadas en datos.
Casos de uso de Spotify Ads CLI
- Monitoreo diario del gasto publicitario en Spotify y métricas de rendimiento en múltiples cuentas publicitarias.
- Extracción de conocimientos demográficos basados en edad, género y plataforma para la optimización de la audiencia.
- Realización de planificación previa a la campaña mediante la estimación del alcance de la audiencia y rangos de puja para criterios de segmentación específicos.
- Auditoría de activos creativos y estado de los anuncios para garantizar la salud de la campaña.
- Automatización de la generación y recuperación de informes CSV a gran escala para visualización de datos externa.
Cómo funciona Spotify Ads CLI
- El usuario proporciona un token de acceso de Spotify OAuth a través de variables de entorno o un archivo de configuración local para autenticarse con la API de Spotify Ads.
- La skill identifica las empresas accesibles y sus cuentas publicitarias asociadas mediante comandos de descubrimiento.
- Según las consultas del usuario, la CLI solicita puntos de datos específicos, como informes agregados, opciones de segmentación o metadatos de activos.
- Para los informes, la skill maneja la paginación a través de tokens de continuación o inicia solicitudes de generación de CSV asíncronas.
- Todos los datos recuperados se muestran como JSON formateado o compacto, listos para su análisis o procesamiento posterior dentro de Openclaw Skills.
Configuración de Spotify Ads CLI
Para utilizar esta skill, primero instale la CLI globalmente usando npm:
npm install -g spotify-ads-cli
La autenticación requiere una Spotify Developer App con acceso a la API de anuncios. Puede configurar la skill estableciendo una variable de entorno:
export SPOTIFY_ADS_ACCESS_TOKEN='your_access_token'
Alternativamente, cree un archivo de credenciales en ~/.config/spotify-ads-cli/credentials.json con la siguiente estructura:
{
"access_token": "your_access_token"
}
Esquema de datos y taxonomía de Spotify Ads CLI
La skill organiza los datos siguiendo la jerarquía de entidades de Spotify Ads. Todas las salidas son por defecto en formato JSON.
| Nivel | Datos Incluidos |
|---|---|
| Negocio | ID, Nombre y enlaces de cuentas publicitarias asociadas. |
| Cuenta Publicitaria | Estado, moneda y configuración de alto nivel. |
| Campaña / Conjunto de Anuncios | Presupuesto (convertido de micros), cronograma y especificaciones de segmentación. |
| Informes | Impresiones, clics, alcance y gasto en unidades estándar. |
| Segmentación | Especificación basada en JSON para filtros geográficos, de edad y de interés. |
Funciones avanzadas de Spotify Ads CLI
- Soporte para generación de informes CSV asíncronos con polling automatizado para actualizaciones de estado.
- Herramientas de estimación de audiencia y rango de puja para una planificación presupuestaria precisa.
- Informes de diagnóstico detallados para píxeles de medición y datasets.
- Gestión de paginación para campañas grandes utilizando parámetros de offset y limit.
- Integración perfecta con otras Openclaw Skills para pipelines automatizados de informes de marketing.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Feishu Notifier Core
Un puente ligero y seguro para enviar notificaciones automatizadas a Feishu (Lark) a través de Openclaw Skills.
Quantum Agent Memory
Un marco de memoria optimizado por computación cuántica que utiliza QAOA para resolver problemas de clustering, compactación y recuperación basada en sinergia para AI agents.
X Ads CLI
Una interfaz de línea de comandos de solo lectura para consultar la X Ads API v12 y analizar el rendimiento de campañas y la estructura de la cuenta.
Jefe de Gabinete Ejecutivo
Un jefe de gabinete impulsado por IA, diseñado para optimizar la toma de decisiones ejecutivas a través de briefings automatizados, preparación de reuniones y recopilación estratégica de información.
Snapchat Ads CLI
Una interfaz de línea de comandos integral y de solo lectura para consultar la Snapchat Marketing API para analizar el rendimiento de anuncios y la estructura de la cuenta.
Bid Monitor V2.0
Un radar de inteligencia empresarial automatizado que rastrea, filtra y envía oportunidades de licitación de construcción y EPC directamente a plataformas de comunicación empresarial.
Presentado*
