melgarafael/youtube-growth/geo

GEO — otimização da presença web do canal para citação por IA

Filosofia: GEO-first, SEO-supported. A busca com IA está comendo a busca

tradicional. Esta skill otimiza o que o canal possui na web (site, blog,

link-in-bio) para que o conteúdo — e as entidades por trás dele — seja citado

pelos motores de resposta com IA. Complementa a youtube-geo-growth (que cuida dos

vídeos): aqui o alvo são as páginas próprias que sustentam a autoridade do canal.

As invocações abaixo usam $YTG_CONFIG_DIR (o config dir por-canal criado pela skill

connect) e <plugin> = a raiz onde o plugin youtube-growth foi instalado.

Substitua <plugin> pelo caminho real de instalação.

Setup (uma vez)

Esta skill tem dependências Python próprias (BeautifulSoup, requests, lxml, rich). Instale no venv do canal:

"$YTG_CONFIG_DIR/.venv/bin/pip" install -r <plugin>/skills/geo/requirements.txt

Scripts (o que embarca de fato)

Rode cada script pelo venv do canal para as deps resolverem:

Templates de schema JSON-LD ficam em <plugin>/skills/geo/schema/ (organization, local-business, article-author, product-ecommerce, software-saas, website-searchaction) — copie e preencha para o site do canal.

Fluxo de auditoria (o agente conduz)

1. Descoberta. Buscar o HTML da home (script fetch_page.py <url> full, ou WebFetch). Detectar o tipo de negócio/página e extrair as páginas-chave do sitemap.xml ou dos links internos (foco nas ~10-20 mais importantes; teto de 50).

2. Análise. Para cada página relevante:

• Citabilidade: citability_scorer.py <url> — passagens diretas, respondíveis, com

dado/entidade explícita pontuam mais.

• Crawlers de IA: fetch_page.py <url> robots — confirmar que GPTBot,

ClaudeBot, PerplexityBot, Google-Extended não estão bloqueados sem querer.

• llms.txt: llmstxt_generator.py <url> validate (ou generate para criar um).
• Menções da marca: brand_scanner.py "<marca do canal>" <dominio> — presença em

plataformas que a IA cita (fóruns, YouTube, wiki, etc.).

• Schema: detectar o JSON-LD existente e propor o que falta a partir de schema/.

3. Síntese. Consolidar num relatório com GEO Score (0-100) e um plano de ação priorizado. Gravar via Write (ex.: GEO-AUDIT.md) no diretório do canal.

Detecção de tipo de página (ajusta as recomendações)

Metodologia de score

Regras de qualidade

• Limite de crawl: máx. 50 páginas por auditoria (qualidade > quantidade).
• Timeout: 30s por página.
• Rate limit: ~1s entre requisições; respeitar sempre o robots.txt.
• Dedup: pular páginas com >80% de similaridade de conteúdo.

Contexto de mercado (por que GEO importa)

A busca com IA cresce rápido (Google AI Overviews, ChatGPT, Perplexity com centenas de milhões de usuários); tráfego referido por IA converte melhor que orgânico tradicional; e menções à marca correlacionam mais forte com citação por IA do que backlinks. Otimizar a presença web do canal agora é chegar onde o tráfego está indo.