GrowthKit

Framework automatizado de marketing com IA para Claude Code. Usa skills composiveis para pesquisar, criar, publicar e otimizar conteudo.

Pre-requisitos

• Claude Code CLI instalado
• Node.js 18+ e npm

Instalacao

Via npm (recomendado)

npx growthkit

Ou instale globalmente:

npm install -g growthkit

Atualizar

npx growthkit --update

Atualiza skills, modelos e viewer sem tocar nos seus dados (configuracao/, biblioteca/, projetos/, .env).

Quick Start

1. Instale usando o comando acima
2. Configure suas API keys no .env
3. Abra Claude Code na pasta do projeto
4. Execute /onboarding para configurar sua marca (voz, tom, ICP)
5. Crie um projeto com /project-create nome-do-projeto
6. Comece a criar conteudo usando as skills disponiveis

Skills Disponiveis

Layer 0: Setup

| Skill | Descricao | |-------|-----------| | onboarding | Configura o framework do zero, cria marca.yaml | | project-creator | Cria novo projeto com estrutura padrao |

Layer 1: Coletar

| Skill | Descricao | |-------|-----------| | youtube-extractor | Extrai video YouTube em YAML | | youtube-trend-scout | Pesquisa videos trending por topico | | web-scraper | Extrai conteudo de URL em YAML | | keyword-researcher | Pesquisa keywords via Google Autocomplete | | reddit-researcher | Minera dores de audiencia no Reddit |

Layer 1.5: Social Collectors

| Skill | Descricao | |-------|-----------| | channel-analyzer | Analisa canal YouTube completo | | instagram-analyzer | Analisa perfil do Instagram | | editorial-synthesizer | Sintetiza linha editorial de multiplos canais | | competitive-intel | Orquestra analise competitiva completa |

Layer 2: Analisar

| Skill | Descricao | |-------|-----------| | trend-reporter | Gera relatorio de tendencias | | reference-analyzer | Analisa posts de referencia (Instagram, Twitter, LinkedIn) | | gsc-analyzer | Analisa dados do Google Search Console | | content-optimizer | Otimiza conteudo baseado em performance |

Layer 3: Criar

| Skill | Descricao | |-------|-----------| | content-writer | Escreve artigos e blog posts SEO | | social-writer | Cria posts para LinkedIn e Twitter/X | | slide-creator | Cria apresentacoes em React | | image-generator | Gera imagens via Gemini | | thumbnail-creator | Cria thumbnails YouTube otimizadas | | carousel-creator | Gera carrosseis para Instagram/LinkedIn | | repurposer | Transforma 1 conteudo em multiplos formatos |

Layer 3.5: Validar

| Skill | Descricao | |-------|-----------| | quality-gates | Valida qualidade com scores de readability, SEO e brand voice |

Layer 3.7: Visualizar

| Skill | Descricao | |-------|-----------| | project-viewer | Gera visualizacao HTML rica de projetos com roteiros e metricas |

Layer 4: Distribuir

| Skill | Descricao | |-------|-----------| | cms-publisher | Publica conteudo no CMS via API |

Layer 5: Trafego Pago

| Skill | Descricao | |-------|-----------| | meta-ads-manager | CRUD completo de campanhas Meta Ads | | meta-ads-creative | Upload de imagens e criativos | | meta-ads-audience | Custom e Lookalike Audiences | | meta-ads-analytics | Metricas e breakdowns | | meta-ads-spy | Espionagem de ads via Ad Library | | meta-ads-optimizer | Regras automatizadas de otimizacao |

Integracoes

| Skill | Descricao | |-------|-----------| | apollo-importer | Importa dados do Apollo.io | | clay-importer | Importa dados do Clay | | video-transcriber | Transcreve videos locais via Whisper |

Estrutura

configuracao/    -> Identidade da empresa (marca, competidores, canais)
modelos/         -> Moldes para criacao de conteudo
biblioteca/      -> Dados globais reutilizaveis
projetos/        -> Projetos ativos (cada subpasta e independente)
analiticos/      -> Dados de performance (GSC, Meta Ads)
tools/slides/    -> App React para renderizacao de slides
.claude/skills/  -> Skills do framework

Variaveis de Ambiente

Edite o .env com sua chave. So precisa de uma:

| Variavel | Obrigatoria? | Uso | |----------|:---:|-----| | SINCRON_API_KEY | Sim | API unica para YouTube, Instagram, Reddit, imagens, transcricao. Obtenha em creditos.sincronia.digital | | CMS_API_KEY | Nao | Apenas se usar cms-publisher | | META_ACCESS_TOKEN | Nao | Apenas se usar Meta Ads (gerado via /meta-ads-setup) |

Fluxo de Trabalho

Setup -> Pesquisar -> Criar -> Validar -> Publicar -> Medir -> Otimizar
  |         |           |         |          |          |         |
onboarding youtube    content   quality    cms       gsc      content
           keyword    social    gates      publisher analyzer optimizer
           web        slides
           instagram  image

Documentacao Completa

Consulte o arquivo CLAUDE.md para documentacao detalhada do framework, regras de operacao e contexto de projeto.