← story.propek
STORY 20.7
Pesquisa Automática na Ads Library
PENDING
ACCEPTANCE CRITERIA (14/18)
Script `squads/traffic-ads/scripts/spy-competitors.js` criado
Executa 1x por semana (cron via GitHub Actions — junto com weekly-ai-analysis)
Lista de concorrentes configurável em `squads/traffic-ads/config/competitors.json`
Concorrentes iniciais: Vonixx, Cadillac, DubBoyz, Vintex
Campo `page_name` e `page_id` (se conhecido) por concorrente
Usa Firecrawl MCP (`mcp__firecrawl__firecrawl_scrape`) para acessar Meta Ads Library
URL de consulta: `https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=BR&q={nome_do_concorrente}`
Alternativa: Meta Ad Library API oficial se disponível sem autenticação especial
Extrai: criativos ativos, tipo de anúncio (imagem/video), plataformas (FB/IG), data de início
Compara resultado com último spy salvo (`data/spy/spy-YYYY-MM-DD.json` mais recente)
Identifica anúncios novos (IDs não vistos na coleta anterior)
Identifica anúncios que pararam de rodar
Dados brutos salvos em `squads/traffic-ads/data/spy/spy-YYYY-MM-DD.json`
Relatório MD em `squads/traffic-ads/reports/spy-YYYY-MM-DD.md`
Relatório inclui: novos anúncios por concorrente, anúncios parados, destaques (maior tempo rodando = vencedores deles)
Job `spy-competitors` adicionado no workflow semanal
Executa ANTES de `weekly-ai-analysis` (para análise ter os dados de spy)
Output do spy disponível para a análise semanal (Story 20.6)
TIMELINE
31/03/2026
feat: Epic 20 — Traffic Manager Autonomo, 7 stories, 393+ testes, 4 security gates [Epic 20] [Story 6.1-sales-intelligence-bot]
7a8b92d
ARQUIVOS (4)
squads/traffic-ads/config/competitors.json CREATE
squads/traffic-ads/scripts/spy-competitors.js CREATE
squads/traffic-ads/tests/spy-competitors.test.js CREATE
squads/traffic-ads/data/spy/ CREATE