📦 Downloads

Dois arquivos. Eles fazem quase tudo automaticamente.

Scripts do Instalador

Como executar os scripts

Opção 1 — Mais fácil (recomendada)

Clique com o botão direito no arquivo .ps1 e selecione "Executar com PowerShell". Se pedir confirmação, clique em "Sim".

Opção 2 — Via terminal

Abra o PowerShell como Administrador e execute:

powershell -ExecutionPolicy Bypass -File C:\caminho\para\instalar.ps1

Opção 3 — Liberar de forma permanente (avançado)

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

🔍 Pré-requisitos

O que você precisa ter antes de rodar o instalador. Não se preocupe — o próprio script instala o que estiver faltando.

O que o script instala automaticamente

O que você instala manualmente (uma vez)

Verificação manual (opcional)

Se quiser verificar antes de rodar o script, abra o PowerShell e teste:

python --version
node --version
npm --version

⚙️ Executar instalar.ps1

Guia de acompanhamento para quando o script estiver rodando.

Etapa 1 — Perguntas de Configuração

O script vai perguntar 4 coisas. Anote suas respostas antes:

Etapa 2 — Instalação de Dependências

O script vai detectar e instalar automaticamente. Pode demorar alguns minutos se for a primeira vez. Mensagens normais que você vai ver:

[OK] Python encontrado: Python 3.11.x
[OK] Node.js encontrado: v20.x.x
  Instalando requests...
  Instalando google-ads...
[OK] Pacotes Python instalados.
[OK] Claude Code instalado.

Etapas 3 a 8 — Criação Automática

O script cria tudo sozinho. Você não precisa fazer nada — só aguardar:

Resultado esperado

Ao final, o script mostra:

============================================================
  INSTALACAO CONCLUIDA
============================================================

  Sistema instalado com sucesso em:
  C:\minha-agencia\

  [OK] Estrutura de pastas completa
  [OK] CLAUDE.md personalizado para Minha Agencia
  [OK] index.md, log.md, wiki/overview.md
  [OK] 8 skills em .claude/commands/
  [OK] 3 agentes IA em system-prompts/agents/
  [OK] 4 scripts Python de coleta e automacao
  [OK] Templates de credenciais em credentials/
  [OK] Dependencias Python instaladas
  [OK] Claude Code instalado

🗂️ Configurar o Obsidian

O Obsidian é onde você vai visualizar e navegar pelo seu wiki. O LLM escreve, você lê.

Instalar o Obsidian

Plugins recomendados (opcional)

Vá em Configurações (ícone de engrenagem) → Community Plugins → Browse:

O que você deve ver no Obsidian

No painel esquerdo (explorador de arquivos), a estrutura deve aparecer assim:

📁 minha-agencia
├── 📄 CLAUDE.md
├── 📄 index.md
├── 📄 log.md
├── 📁 raw/
├── 📁 wiki/
│   ├── 📄 overview.md
│   ├── 📁 clients/
│   ├── 📁 segments/
│   └── 📁 sources/
├── 📁 outputs/
└── 📁 agente-performance/

🤖 Primeiro Acesso ao Claude Code

Claude Code é o terminal inteligente que vai escrever e manter seu wiki.

Abrir o Claude Code

cd C:\minha-agencia

claude

Resposta esperada do /status

Olá! Estou orientado e pronto.

**Status atual — [Nome do Negócio]**

- Clientes ativos: nenhum ainda
- Fontes ingeridas: 0
- Páginas wiki: 3 (overview, index, log)
- Último lint: nunca

**Próximos passos:**
1. Executar conectar.ps1 para configurar tokens de API
2. Adicionar primeiro cliente com /novo-cliente
3. Ingerir primeiras fontes com /ingerir

Conta Anthropic

Para usar o Claude Code você precisa de uma conta em anthropic.com. O plano gratuito tem limite de mensagens. Para uso profissional, recomendamos o plano pago para ter acesso sem restrições.

✅ Checklist — Parte 1 Concluída

Confirme cada item antes de avançar para a Parte 2. Clique nos itens para marcar.

Instalação

• ☐ instalar.ps1 executado sem erros críticos
• ☐ Python instalado e funcionando (python --version)
• ☐ Node.js instalado e funcionando (node --version)
• ☐ Claude Code instalado (claude --version)
• ☐ Pasta do vault criada com estrutura completa
• ☐ CLAUDE.md criado com nome do negócio correto
• ☐ Scripts Python presentes em agente-performance/

Obsidian

• ☐ Obsidian instalado
• ☐ Vault apontado para a pasta correta
• ☐ Estrutura de pastas visível no explorador do Obsidian
• ☐ CLAUDE.md abre corretamente com o conteúdo personalizado

Claude Code

• ☐ Claude Code abre no terminal da pasta do vault
• ☐ Login com conta Anthropic concluído
• ☐ /status responde com o estado do wiki

📘 Meta Ads: Token Permanente

Um token que nunca expira — a base de toda automação com Meta Ads e Instagram.

Conceito: O que é um System User

É um "usuário técnico" dentro do seu Business Manager — não é uma pessoa real, é uma credencial de sistema. Ele tem as permissões que você define e gera um token permanente.

Pré-requisito: Acesso ao Business Manager

Você precisa ser administrador do Business Manager. Se for gerenciar campanhas de clientes, o token deve ser criado no BM do cliente (ou o cliente deve fazer esses passos e te passar o token).

Passo 1 — Criar App no Meta for Developers

Passo 2 — Adicionar Marketing API

ads_read
ads_management
business_management
instagram_basic
pages_read_engagement

Passo 3 — Criar System User

Passo 4 — Gerar Token Permanente

Passo 5 — Atribuir Ativos ao System User

Ainda na tela do usuário do sistema:

Invoke-RestMethod "https://graph.facebook.com/v20.0/me?access_token=SEU_TOKEN"

Se retornar name e id, o token está válido.

🔵 Google Ads: API OAuth2

Mais passos que o Meta, mas feito uma vez. Depois é automático para sempre.

Os 4 componentes

Passo 1 — MCC (Conta Gerenciadora)

O MCC gerencia todas as contas de clientes. Se já tem, anote o ID. Se não tem:

Passo 2 — Developer Token

Passo 3 — Google Cloud Project

C:\minha-agencia\agente-performance\credentials\client_secret.json

Passo 4 — Gerar Refresh Token

Com o client_secret.json na pasta certa, execute no terminal:

cd C:\minha-agencia\agente-performance
python google-ads\lib\generate_refresh_token.py

Um browser vai abrir. Faça login com a conta Google do MCC. Após autorizar, o script mostra os três valores — copie todos.

🔌 Executar conectar.ps1

Com os dados das páginas anteriores em mãos, o script faz o resto.

Como executar

powershell -ExecutionPolicy Bypass -File C:\caminho\para\conectar.ps1

O que acontece em cada parte

Parte A — Meta Ads

Parte B — Google Ads

Resultado esperado ao final

============================================================
  CONEXOES CONFIGURADAS
============================================================

  [OK] Meta Ads: TOKEN CONFIGURADO
  [OK] Google Ads: CREDENCIAIS CONFIGURADAS

  PROXIMOS PASSOS:
  1. Abra o Obsidian apontando para: C:\minha-agencia
  2. Abra o terminal e execute: claude
  3. Teste com: /status  /novo-cliente  /gerar-relatorio-meta

✅ Checklist — Parte 2 Concluída

Confirme cada item antes de usar o sistema com clientes reais.

Meta Ads

• ☐ App criado no Meta for Developers
• ☐ Marketing API adicionada com permissões corretas
• ☐ System User criado no Business Manager
• ☐ Token permanente gerado (expiração: Nunca)
• ☐ Contas de anúncios atribuídas ao System User
• ☐ Token validado pelo conectar.ps1 (apareceu nome do usuário)
• ☐ credentials/meta.env criado com token real

Google Ads

• ☐ MCC configurado com contas de clientes vinculadas
• ☐ Developer Token solicitado (aguardando aprovação se produção)
• ☐ Projeto criado no Google Cloud
• ☐ Google Ads API ativada no projeto
• ☐ client_secret.json na pasta credentials/
• ☐ Refresh Token gerado com sucesso
• ☐ credentials/google-ads.yaml preenchido
• ☐ Teste de conexão listou contas do MCC

⚙️ 9 Skills Base do Sistema

Instaladas automaticamente pelo instalar.ps1. São a espinha dorsal do wiki — gestão de conhecimento e coleta de dados.

Cole o conteúdo ou indique o arquivo:
/ingerir
> Cole aqui o relatório de campanha...

🚀 10 Skills Avançadas

Adicionadas ao sistema para otimizar o tempo do gestor nas tarefas de maior recorrência e impacto. Cada skill resolve um problema real do dia a dia.

/copy-meta support-health leads-whatsapp

/proposta medicina-integrativa

Mapa completo: todas as 18 skills

🚀 Primeiros Comandos

Sistema instalado e conectado. Aqui estão os primeiros passos para operação real.

Sequência recomendada para o primeiro dia

cd C:\minha-agencia && claude

/status

/novo-cliente

/ingerir

/gerar-relatorio-meta

Referência rápida de todos os comandos

Rotina semanal sugerida

Segunda:   /diagnostico-conta (verificar todas as contas)
Quarta:    /consultar "o que está pendente esta semana?"
Sexta:     Registrar reuniões da semana com /reuniao

Fechamento mensal:
  /gerar-relatorio-meta (todos os clientes)
  /gerar-relatorio-google (todos os clientes)
  /segmento (análise cruzada)
  /lint (saúde do wiki)

❓ Problemas Comuns

Soluções para os erros mais frequentes durante a instalação e uso.

Instalação

❌ "winget não é reconhecido como comando"

O winget requer Windows 10 versão 1809+. Solução: instale Python e Node.js manualmente pelos sites oficiais antes de rodar o script.

# Verificar versão do Windows
winver

❌ "Acesso negado" ao criar pastas

Execute o PowerShell como Administrador. Clique com botão direito no ícone do PowerShell → "Executar como Administrador".

❌ "claude não é reconhecido"

Feche e reabra o terminal. Se persistir:

npm install -g @anthropic-ai/claude-code
# Fechar e reabrir o terminal

Meta Ads

❌ Token retorna erro "Invalid OAuth access token"

O token foi copiado com espaços ou quebra de linha. Copie novamente clicando diretamente no token no Business Manager, sem arrastar para selecionar.

❌ "User does not have permission" ao listar contas

O System User não foi atribuído às contas de anúncios. Volte ao Business Manager → Usuários do Sistema → Atribuir ativos → Contas de anúncios.

❌ Token expira mesmo sendo "permanente"

Isso acontece se o app foi criado com tipo errado ou se as permissões foram revogadas. Gere um novo token com o mesmo processo — o mesmo System User pode ter múltiplos tokens.

Google Ads

❌ "Developer token has not been approved"

Normal. O token de produção precisa de aprovação manual do Google (até 5 dias úteis). Enquanto aguarda, você pode usar Meta Ads normalmente. O Google Ads vai funcionar quando o token for aprovado.

❌ "The caller does not have permission" no teste de conexão

A conta Google usada para gerar o refresh token não tem acesso ao MCC. Use a mesma conta Gmail que é administradora do MCC para gerar o token.

❌ "client_secret.json não encontrado"

Verifique o nome exato do arquivo e o caminho:

C:\minha-agencia\agente-performance\credentials\client_secret.json

O nome deve ser exatamente client_secret.json — sem outros caracteres no nome.

Claude Code

❌ Agente não lê o CLAUDE.md

Verifique se o Claude Code foi aberto dentro da pasta do vault:

cd C:\minha-agencia
claude

❌ "/status" retorna resposta genérica sem mencionar o nome do negócio

O Claude Code não está lendo o CLAUDE.md correto. Verifique se o arquivo está na raiz da pasta do vault e abra o Claude Code na pasta certa.

❌ Script Python retorna "Credenciais não configuradas"

Execute o conectar.ps1 primeiro. Os scripts verificam se meta.env e google-ads.yaml estão preenchidos antes de rodar.