deepanshumohan/organic-growth

Crescimento Orgânico

Você executa o sistema descrito em PLAYBOOK.md no projeto atual. Leia-o uma vez no início, depois leia um módulo apenas quando chegar na fase que o utiliza. Escreva todas as descobertas em docs/seo/ no projeto (copie os modelos de templates/) e faça commit após cada fase.

Mapa

#	Fase	Leia	Saída no projeto
0	Reconhecimento + linha de base	PLAYBOOK.md §0	docs/seo/00-baseline.md
1	SEO técnico	checklists/technical-seo.md	código + seo.config.mjs
2	Search Console + Bing	checklists/search-console.md	números da linha de base
3	Pesquisa: Tendências, disposição a pagar, autocomplete, Ahrefs/Semrush, Search Console, fontes	modules/research.md	docs/seo/research/*.md, 09-sources-log.md
4	Plano de crescimento	modules/pseo-2.md, modules/tool-led-seo.md, modules/money-pages.md, modules/linkable-assets.md	docs/seo/03-seo-plan.md
5	Limpeza + construção	PLAYBOOK.md §5, briefs 04/07/08	páginas, redirecionamentos, 05-consolidation-map.md
6	GEO + conversão	modules/geo-ai-search.md, modules/seo-to-revenue.md	robots, formato da página, CTAs, eventos
7	Lançamento + medição	PLAYBOOK.md §7	docs/seo/06-launch-log.md

O usuário pode pedir apenas uma parte ("só SEO de ferramentas", "audite meu site", "plano pSEO"). Nesse caso, execute apenas aquela fase, mas ainda execute a fase 0 rapidamente primeiro.

Pergunte primeiro (apenas o que o código não pode lhe dizer)

1. Domínio de produção e host preferido (apex ou www).
2. Países e idiomas alvo. Nunca presuma a partir da localização do fundador.
3. Acesso ao Search Console / analytics.
4. Ferramentas de palavras-chave pagas (Ahrefs, Semrush). Capturas de tela ou exportações são suficientes.
5. As classificações, contagens de avaliações ou alegações de "usado por" no site são reais?

Scripts (Node 18+, sem dependências; em scripts/)

Script	Uso
check-live.sh <url>	O que os rastreadores obtêm do site ao vivo: redirecionamentos, 404, robots, sitemap, título/canonical/H1 por página sem JS
prerender.mjs --config seo.config.mjs	SPA → HTML estático por rota + 404.html + spa.html + sitemap.xml
audit.mjs <dist> --base <url>	Verifica o HTML construído: títulos, descrições, canonicals, H1, páginas finas, JSON-LD, consistência do sitemap, schema de avaliação
overlap.mjs <dist> --prefix /<cluster>/	Portal de conteúdo duplicado: shingle Jaccard de 5 palavras, <40% e ≥800 palavras
autocomplete.mjs "<seed>" --gl us,gb,au --expand	Consultas reais de autocomplete do Google por país (evidência de demanda)

Regras aprendidas da maneira mais difícil

• Pesquise no idioma do mercado-alvo. Autocomplete do país errado já produziu um lote inteiro de páginas do mercado errado.
• Salve cada coleta de pesquisa como um arquivo datado em docs/seo/research/, e registre todos os fatos da página em 09-sources-log.md (fontes oficiais para fatos legais; fatos de concorrentes datados e re verificados a cada 90 dias; alegações não verificáveis omitidas).
• A ferramenta gratuita do Ahrefs tem uma verificação humana que o usuário deve passar. Peça capturas de tela, nunca tente contorná-la.
• As páginas existem porque a demanda existe. Cada página planejada nomeia sua evidência.
• O portal de qualidade não é opcional. <40% de sobreposição com irmãos, ≥800 palavras, seus próprios dados/ferramenta/saída. Trocas de {city} com modelo recebem noindex e saem do sitemap. Penalidades de conteúdo em escala atingem todo o domínio.
• Ferramentas são páginas, não widgets. Cada ferramenta precisa de um guia editorial único, FAQ e schema em HTML estático, ou é uma página fina.
• Menos páginas, mais profundas. Mescle postagens finas em guias aprofundados e faça 301 de cada slug antigo.
• Nenhum número inventado ou prova social. Preços obtidos ou calculados na página; fatos de concorrentes datados; schema de avaliação apenas quando o proprietário confirma que é real.
• Rastreadores (e rastreadores de IA) devem ver o conteúdo sem JavaScript.
• Um host, uma URL, erros 404 reais, um sitemap gerado a partir dos mesmos dados das páginas.
• Lance em lotes de 10–20; expanda apenas o que obtém impressões.
• Cada página termina em um CTA relevante; rastreie conversões por grupo de página.

Estilo de trabalho

• Alterações que afetam a produção (redirecionamentos, robots.txt, noindex, excluir páginas) recebem uma confirmação de uma linha do usuário primeiro, com a lista.
• Cliques no Search Console, DNS e analytics são do usuário; forneça etapas exatas.
• Execute audit.mjs após cada build e check-live.sh após cada deploy, e cole o resumo.
• Registre números datados em 06-launch-log.md para que a próxima sessão possa comparar.

Frameworks

prerender.mjs é para SPAs renderizadas no cliente (Vite, CRA, React Router). Next.js, Astro, Nuxt, SvelteKit, Remix: use suas APIs de metadados e plugins de sitemap, e ainda execute audit.mjs na saída do build. WordPress/Webflow/Shopify: pule código da fase 1, use o checklist contra o site ao vivo com check-live.sh.