# Spy

> Espiona anuncios ATIVOS de qualquer concorrente na Biblioteca de Anuncios da Meta (Ad Library, publica e gratuita). Use quando o usuario pedir para ver anuncios de concorrente, espionar criativos, analisar o que o mercado esta rodando, "o que meu concorrente anuncia", pesquisa de criativos, ou /spy. Entrega relatorio estruturado: angulos, hooks, formatos, CTAs e tempo no ar de cada anuncio.

- **Type:** Skill
- **Install:** `agentstack add skill-giovani-junior-dev-trafego-pack-spy`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [giovani-junior-dev](https://agentstack.voostack.com/s/giovani-junior-dev)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [giovani-junior-dev](https://github.com/giovani-junior-dev)
- **Source:** https://github.com/giovani-junior-dev/trafego-pack/tree/main/spy

## Install

```sh
agentstack add skill-giovani-junior-dev-trafego-pack-spy
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# /spy — Espionagem de anuncios ativos (Meta Ad Library)

Ve TODOS os anuncios ativos de qualquer pagina/marca. Fonte: Biblioteca de Anuncios da Meta — publica, gratuita, oficial. Nao precisa de login nem token.

## Inputs (pergunte se faltar)
1. **Concorrente(s)**: nome da pagina, marca ou dominio (1 a 5).
2. **Pais**: padrao BR.
3. **Foco** (opcional): produto especifico, oferta, periodo.

## Workflow

### 1. Abrir a biblioteca
Para cada concorrente, abra no browser (ou WebFetch se render server-side):
```
https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=BR&q=&search_type=keyword_unordered
```
Se souber o ID da pagina, prefira `view_all_page_id=` (resultado exato, sem ruido).

### 2. Coletar por anuncio (minimo 10, ideal 20+)
Para cada anuncio ativo, extraia:
- **Inicio da veiculacao** (data "Veiculacao iniciada em") — anuncio rodando ha 30+ dias = provavelmente LUCRATIVO (ninguem paga por anuncio ruim por 1 mes)
- **Formato**: imagem / video / carrossel / colecao
- **Hook** (primeira frase do texto principal)
- **Promessa/oferta** central
- **CTA** (botao + convite no texto)
- **Destino** (LP, WhatsApp, formulario, DM)
- **Variacoes** (mesmo anuncio com N versoes = teste ativo de criativo)

### 3. Relatorio estruturado (entregar SEMPRE nesse formato)

```markdown
## SPY REPORT —  ()
### Resumo executivo
- Total de anuncios ativos: N | Formato dominante: X | Anuncio mais antigo ativo: N dias (= provavel campea)
### Top 5 anuncios (por tempo no ar)
| # | Desde | Formato | Hook | Oferta | CTA | Destino |
### Padroes detectados
- Angulos recorrentes: ...
- Estrutura de copy: ...
- O que eles NAO estao fazendo (gap inicial): ...
### Acao recomendada
- 3 aprendizados aplicaveis na proxima campanha do usuario
```

## Regras
- So dados PUBLICOS da Ad Library. Nada de login, scraping de perfil ou dados privados.
- Anuncio antigo ativo > anuncio novo bonito. Tempo no ar = proxy de performance.
- Nunca copiar copy literal do concorrente — extrair ANGULO e ESTRUTURA, criar original.
- Se a busca por keyword trouxer ruido, refinar com o nome exato da pagina (dropdown da propria biblioteca).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [giovani-junior-dev](https://github.com/giovani-junior-dev)
- **Source:** [giovani-junior-dev/trafego-pack](https://github.com/giovani-junior-dev/trafego-pack)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-giovani-junior-dev-trafego-pack-spy
- Seller: https://agentstack.voostack.com/s/giovani-junior-dev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.