Uma ferramenta CLI somente leitura para a API do Spotify Ads (v3) que permite relatórios detalhados, estimativa de público e análise de campanhas.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install spotify-ads-cli
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o spotify-ads-cli usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é Spotify Ads CLI?
O Spotify Ads CLI é uma ferramenta técnica robusta projetada para interagir com a API do Spotify Ads v3, permitindo que desenvolvedores e profissionais de marketing extraiam dados de desempenho granulares diretamente do terminal. Como uma adição poderosa à biblioteca Openclaw Skills, ele simplifica o processo de consulta de contas comerciais, rastreamento de gastos com anúncios e análise de hierarquias de campanhas. A skill fornece um gateway somente leitura para métricas de publicidade críticas, garantindo a exploração segura de dados sem modificação acidental de campanhas ativas.
Ao integrar esta ferramenta ao seu fluxo de trabalho Openclaw Skills, você pode acessar programaticamente tudo, desde snapshots de desempenho agregado até relatórios complexos de insights demográficos. Ele lida com as nuances da API do Spotify, como a conversão de micros para moeda e a geração de relatórios CSV assíncronos, tornando-o um utilitário essencial para estratégias de publicidade baseadas em dados.
Casos de uso do Spotify Ads CLI
- Monitoramento diário dos gastos com anúncios no Spotify e métricas de desempenho em várias contas de anúncios.
- Extração de insights demográficos baseados em idade, gênero e plataforma para otimização de público.
- Execução de planejamento pré-campanha estimando o alcance do público e faixas de lance para critérios de segmentação específicos.
- Auditoria de ativos criativos e status de anúncios para garantir a integridade da campanha.
- Automação da geração e recuperação de relatórios CSV em grande escala para visualização de dados externa.
Como o Spotify Ads CLI funciona
- O usuário fornece um token de acesso Spotify OAuth via variáveis de ambiente ou um arquivo de configuração local para autenticar com a API do Spotify Ads.
- A skill identifica empresas acessíveis e suas contas de anúncios associadas usando comandos de descoberta.
- Com base nas consultas do usuário, o CLI solicita pontos de dados específicos, como relatórios agregados, opções de segmentação ou metadados de ativos.
- Para relatórios, a skill lida com paginação via tokens de continuação ou inicia solicitações de geração de CSV assíncronas.
- Todos os dados recuperados são exibidos como JSON formatado ou compacto, prontos para análise ou processamento posterior dentro do Openclaw Skills.
Configuração do Spotify Ads CLI
Para utilizar esta skill, primeiro instale o CLI globalmente usando npm:
npm install -g spotify-ads-cli
A autenticação requer um Spotify Developer App com acesso à API de anúncios. Você pode configurar a skill definindo uma variável de ambiente:
export SPOTIFY_ADS_ACCESS_TOKEN='your_access_token'
Alternativamente, crie um arquivo de credenciais em ~/.config/spotify-ads-cli/credentials.json com a seguinte estrutura:
{
"access_token": "your_access_token"
}
Esquema de Dados e Taxonomia de Spotify Ads CLI
A skill organiza os dados seguindo a hierarquia de entidades do Spotify Ads. Todas as saídas são padrão no formato JSON.
| Nível | Dados Incluídos |
|---|---|
| Negócio | ID, Nome e links de conta de anúncios associados. |
| Conta de Anúncios | Status, moeda e configuração de alto nível. |
| Campanha / Conjunto de Anúncios | Orçamento (convertido de micros), cronograma e especificações de segmentação. |
| Relatórios | Impressões, cliques, alcance e gastos em unidades padrão. |
| Segmentação | Especificação baseada em JSON para filtros geográficos, de idade e de interesse. |
Recursos avançados do Spotify Ads CLI
- Suporte para geração de relatórios CSV assíncronos com polling automatizado para atualizações de status.
- Ferramentas de estimativa de público e faixa de lance para planejamento preciso de orçamento.
- Relatórios de diagnóstico detalhados para pixels de medição e datasets.
- Gerenciamento de paginação para grandes campanhas usando parâmetros de offset e limit.
- Integração perfeita com outras Openclaw Skills para pipelines automatizados de relatórios de marketing.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Feishu Notifier Core
Uma ponte leve e segura para enviar notificações automatizadas para o Feishu (Lark) através do Openclaw Skills.
Quantum Agent Memory
Uma estrutura de memória otimizada por computação quântica que usa QAOA para resolver problemas de clustering, compactação e recuperação baseada em sinergia para AI agents.
X Ads CLI
Uma interface de linha de comando somente leitura para consultar a X Ads API v12 e analisar o desempenho de campanhas e a estrutura da conta.
Chefe de Gabinete Executivo
Um chefe de gabinete alimentado por IA, projetado para otimizar a tomada de decisão executiva por meio de briefings automatizados, preparação de reuniões e coleta estratégica de informações.
Snapchat Ads CLI
Uma interface de linha de comando abrangente e somente leitura para consultar a Snapchat Marketing API para analisar o desempenho de anúncios e a estrutura da conta.
Bid Monitor V2.0
Um radar automatizado de inteligência de negócios que rastreia, filtra e envia oportunidades de licitação de construção e EPC diretamente para plataformas de comunicação empresarial.
Apresentou*
