# Ratos de IA — Operação de Marketing Completa (@ratosdeia, ratos.link/somkt)

Sistema operacional de marketing no Claude Code por @ratosdeia. Skills oficiais conectam direto a Meta Ads, Google Ads, GA4 e Meta Insights via SDK oficial.

## Skills Liberadas (publicamente disponíveis)

### Tráfego Pago

| Skill | O que faz | Status | Instalada? |
|---|---|---|---|
| **meta-ads-ratos** | Gerencia campanhas, conjuntos, anúncios, criativos no Meta Ads. SDK oficial. | LIBERADA | ⬜ |
| **google-ads-ratos** | Keywords, search terms, quality score, campanhas Google Ads. SDK oficial. | LIBERADA | ⬜ |
| **ga4-ratos** | Sessões, pageviews, fontes, bounce rate, conversões real-time do GA4. SDK google-analytics-data. | LIBERADA | ✅ `~/.claude/skills/ga4-ratos/` |
| **ads-ratos** | **O cérebro**. Cruza Meta + Google + GA4, benchmarks BR, gera health score + relatório HTML. | LIBERADA | ⬜ |

### Copy e Estratégia

| Skill | GitHub | Método | Instalada? |
|---|---|---|---|
| **ogilvy-copy** | `github.com/duduesh/ogilvy-copy` | David Ogilvy — brand/posicionamento, headlines, manifestos, institucional | ✅ `~/.claude/external-marketing-skills/ogilvy-copy/` |
| **schwartz-copy** | `github.com/duduesh/schwartz-copy` | Eugene Schwartz — nível de consciência + sofisticação de mercado ANTES de gerar copy | ✅ `~/.claude/external-marketing-skills/schwartz-copy/` |

## Skills Em Teste (ainda não liberadas)

- **criativo-ads** — gera imagens 1080×1080 + 1080×1920 em HTML com identidade visual custom, render Playwright
- **carrossel** — transcrição de vídeo → carrossel IG/TikTok (texto, HTML, render, publicação automática)
- **publicação-instagram** — publica carrosséis/posts via Post for Me API (legendas, hashtags)
- **links-page** — páginas de links curtos em ratos.link com UTMs, pixel, deploy Cloudflare Pages
- **automação-DM-Instagram** — comenta keyword → DM automática com link (substitui ManyChat)

## Instalação rápida

### ga4-ratos (já instalada)
```
~/.claude/skills/ga4-ratos/
├── SKILL.md
├── README.md
├── contas.yaml
├── references/
└── scripts/
```

Configurar credencial GA4:
```bash
# service account JSON do Google Cloud
export GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcp/ga4-sa.json
# property_id em contas.yaml
```

### Instalar meta-ads-ratos + google-ads-ratos + ads-ratos
Baixar em ratos.link/somkt e seguir tutorial de instalação do site.

### Clonar ogilvy-copy + schwartz-copy como skills
Copiar do external:
```bash
cp -r ~/.claude/external-marketing-skills/ogilvy-copy ~/.claude/skills/
cp -r ~/.claude/external-marketing-skills/schwartz-copy ~/.claude/skills/
```

## Workflow integrado sugerido

```
┌─────────────────────────────────────────────────────────┐
│  DIAGNÓSTICO                                            │
│  ga4-ratos (dados) + ads-ratos (health score)           │
└──────────────┬──────────────────────────────────────────┘
               ↓
┌─────────────────────────────────────────────────────────┐
│  ESTRATÉGIA                                             │
│  schwartz-copy (consciência) + ogilvy-copy (posicion.)  │
│  + Estrutura Invisível (Pedro Netto, ref 11)            │
└──────────────┬──────────────────────────────────────────┘
               ↓
┌─────────────────────────────────────────────────────────┐
│  CRIATIVO                                               │
│  FORGE (VIZNFR, ref 06) + MEC (ref 04) + Y2K (ref 01)   │
└──────────────┬──────────────────────────────────────────┘
               ↓
┌─────────────────────────────────────────────────────────┐
│  PUBLICAÇÃO                                             │
│  meta-ads-ratos + google-ads-ratos (paid)               │
│  publicação-instagram (orgânico)                        │
└──────────────┬──────────────────────────────────────────┘
               ↓
┌─────────────────────────────────────────────────────────┐
│  MENSURAÇÃO                                             │
│  ga4-ratos (real-time) + ads-ratos (relatório semanal)  │
└─────────────────────────────────────────────────────────┘
```

## Credenciais necessárias (tokens oficiais)

| Skill | Credencial | Onde obter |
|---|---|---|
| meta-ads-ratos | Access Token longa duração + Ad Account ID | developers.facebook.com |
| google-ads-ratos | Developer Token + OAuth2 + Customer ID | ads.google.com/home/tools/manager-accounts |
| ga4-ratos | Service Account JSON (Google Cloud) | console.cloud.google.com |
| ads-ratos | Consome outputs dos 3 acima | — |

⚠️ Tokens oficiais (developer tokens), não scrapers. Sem risco de bloqueio por ToS. Ler tutoriais antes de começar.

## Curso Claude Code OS

Produto associado: **Claude Code OS** — curso do @ratosdeia em ratos.link que ensina a montar operação completa no Claude Code (skills, automação, VSCode).

## Integração com marketing-campanha-ia

- **Substitui parcialmente VIZNFR PUBLISHER** (ref 06) — Ratos usa SDK oficial, VIZNFR usa Graph API direto. Ambos funcionam.
- **Complementa Xquads** (ref 05) — Xquads são prompts, Ratos são skills com tool use real
- **Casa com Estrutura Invisível** (ref 11) — Pedro Netto gera copy, meta-ads-ratos sobe
- **Casa com MEC + Y2K** (refs 01, 04) — MEC gera criativo, meta-ads-ratos publica

## Cross-ref

- Curso: ratos.link/somkt
- Canal: @ratosdeia (Instagram)
- Site: ratosdeia.com.br
- Dashboard integrado: skill `ads-ratos` gera relatório HTML próprio (paralelo ao War Room VIZNFR)