zark-seo 1.0.0

package/templates/seo-local-auditor-SKILL.md

@@ -0,0 +1,420 @@
+---
+name: seo-local-auditor
+description: Auditoria completa de SEO Local para empresas brasileiras com presença física, a partir de URL do site e/ou link do Google Business Profile. Use SEMPRE que o usuário pedir para "auditar SEO", "analisar Google Meu Negócio", "ver como meu site está", "fazer auditoria local", "diagnosticar SEO local", "analisar empresa no Google Maps", "por que não estou rankeando", ou pedir análise de presença digital de qualquer negócio com endereço físico (clínicas, lojas, prestadores de serviço, advogados, médicos, oficinas, restaurantes, etc.). Acionar mesmo quando o usuário não falar a palavra "auditoria" — qualquer pedido de diagnóstico de SEO de empresa local cabe aqui. Produz relatório markdown estruturado em camadas (críticos, técnicos, conteúdo, off-site, plano 90 dias) seguindo o padrão ZARK de auditoria.
+---
+
+# SEO Local Auditor — Padrão ZARK
+
+Skill especialista em auditoria de SEO Local para o mercado brasileiro. Diagnóstica empresas com presença física e produz relatório acionável priorizado.
+
+## Filosofia de auditoria
+
+Auditoria boa é honesta, priorizada e acionável. Não enumera 200 problemas — separa **crítico de cosmético**, ordena por impacto × esforço, e entrega um plano que cabe em 90 dias.
+
+**Princípios não-negociáveis:**
+
+1. **Não invente dados.** Se uma informação não está acessível (ex: dados internos do GBP, Search Console, Analytics), declare explicitamente que não foi possível verificar e peça ao usuário. Nunca fabrique métricas.
+2. **Priorize por impacto real.** Schema sem H1 corrigido é otimizar a sobremesa enquanto o prato principal está cru. Sempre comece pelo que move ranking.
+3. **Reconheça o que está bom.** Antes de listar problemas, mencione 3-7 pontos positivos. Cliente que recebe só pancadaria fecha o documento.
+4. **Quick wins primeiro.** Toda auditoria deve listar correções de menos de 1 hora que já movem agulha — separadas das ações de longo prazo.
+5. **Contexto brasileiro.** Tudo é otimizado pra Brasil: diretórios BR, telefones com formato +55, CEP, CNPJ, idioma PT-BR, particularidades de mercado local.
+
+## Fluxo de execução
+
+Quando esta skill é acionada, siga este fluxo na ordem:
+
+### Etapa 1 — Coleta inicial
+
+Confirme com o usuário antes de mergulhar:
+
+1. **URL do site** da empresa (se houver)
+2. **Link do Google Business Profile** (preferencialmente o link `business.google.com` do painel ou o `share.google` do perfil público)
+3. **Nicho/serviço principal** da empresa
+4. **Cidade e região atendida**
+5. **Cliente principal**: B2B, B2C ou misto
+6. **CNPJ** se possível (permite cruzamento de dados públicos)
+
+Se algum desses estiver ausente e for crítico, pergunte explicitamente. **Não chute.**
+
+### Etapa 2 — Coleta automatizada
+
+Execute em paralelo o que for possível:
+
+- **web_fetch** da URL principal do site (extrair title, meta, H1-H6, schema, conteúdo)
+- **web_fetch** das principais páginas internas se descobertas
+- **web_search** com `site:dominio.com.br` para verificar indexação
+- **web_search** por dados públicos do CNPJ (se fornecido) — Receita, Casa dos Dados, Econodata
+- **web_search** por concorrentes top do nicho × cidade
+- **web_search** pelo nome da empresa para identificar redes sociais, menções, reviews externos
+- **image_search** se relevante para validar identidade visual
+
+**Importante:** o link `share.google` do GBP é bloqueado por robots.txt e **não é acessível por web_fetch**. Quando o usuário fornecer apenas esse link, peça os dados do GBP em texto/screenshot conforme Etapa 4.
+
+### Etapa 3 — Análise técnica do site
+
+Para cada página acessível, levante:
+
+**On-page essencial:**
+- Title tag (presente? duplica nome? respeita ~60 caracteres? tem keyword principal?)
+- Meta description (presente? respeita ~160 caracteres? CTA + keyword?)
+- H1 (único? completo? contém keyword principal?)
+- Hierarquia H2-H6 (lógica? semântica?)
+- Open Graph e Twitter Card (presente? aponta pra imagem do próprio domínio?)
+- Canonical (correto? aponta pra HTTPS?)
+- Lang declarado (pt-BR?)
+- Robots meta (não bloqueia indexação por engano?)
+
+**Schema / Dados estruturados:**
+- JSON-LD presente? Tipo correto? (LocalBusiness genérico é fraco; tipo específico como Plumber, Dentist, AutoRepair é ideal)
+- Campos críticos preenchidos: name, address, geo, telephone, openingHoursSpecification, areaServed, priceRange, sameAs
+- FAQPage schema presente se há FAQ?
+- BreadcrumbList em páginas internas?
+- Organization no nível de site?
+
+**Arquitetura:**
+- Site é one-page (só home com âncoras) ou tem páginas internas reais?
+- Tem páginas por serviço? Por cidade atendida? Por produto?
+- URLs amigáveis (sem `?page_id=123`)?
+- Internal linking entre páginas?
+
+**Performance e técnica:**
+- HTTPS forçado?
+- Mobile-first (viewport configurado)?
+- Imagens hospedadas no próprio domínio (não em CDN de terceiros não-controlados)?
+- Imagens com alt text descritivo?
+- Lazy loading?
+- Versão do CMS atualizada?
+
+**NAP (Name, Address, Phone):**
+- Nome consistente em todo o site?
+- Endereço completo e correto (bate com Receita Federal)?
+- Telefone único e funcional?
+- Aparece visivelmente na home, no rodapé e na página de contato?
+
+**E-E-A-T:**
+- Página "Sobre" robusta com história, equipe, fotos, CNPJ visível?
+- Author markup em conteúdos (blog)?
+- Selos, certificações, parcerias declaradas?
+- Depoimentos com nome real e contexto (não "João S.")?
+
+### Etapa 4 — Análise do Google Business Profile
+
+Se o usuário forneceu acesso/dados, audite:
+
+- **Categoria primária**: a mais importante decisão do GBP. Está alinhada com o serviço-âncora? Para casos de dúvida: a categoria primária deve ser aquela em que a empresa quer rankear pra busca-tipo de maior volume.
+- **Categorias secundárias**: existem? Cobrem serviços relevantes sem diluir foco?
+- **Endereço**: bate com site e Receita?
+- **Telefone**: bate com site?
+- **Site cadastrado**: aponta pra URL principal (não pra link de compartilhamento)?
+- **Service Area**: configurada se a empresa entrega/atende fora do endereço físico? (crítico para desentupidoras, locadoras de equipamento, prestadores que vão até o cliente)
+- **Horário de funcionamento**: completo e atualizado? Inclui horários especiais (feriados)?
+- **Descrição**: 750 caracteres usados com keyword natural + diferencial?
+- **Fotos**: ao menos 10 fotos do estabelecimento, equipe e serviços? Geotagueadas?
+- **Posts**: frequência? Pelo menos 1 por semana?
+- **Produtos/Serviços cadastrados**: cada serviço como item próprio com descrição e foto?
+- **Atributos**: preenchidos (acessibilidade, formas de pagamento, atende mulher etc.)?
+- **Q&A**: empresa populou perguntas frequentes? Responde questões da comunidade?
+- **Reviews**: volume, nota média, recência (últimas 30/90 dias), taxa de resposta, qualidade das respostas?
+
+Se o usuário não forneceu acesso, **liste explicitamente os 7-10 itens que precisa** para fechar essa parte da auditoria. Não invente status.
+
+### Etapa 5 — Análise off-site
+
+- **Citations / Diretórios**: empresa aparece nos principais BR? (Apontador, Telelistas, GuiaMais, Foursquare, Solutudo, Yelp BR, Bing Places, Apple Business Connect)
+- **NAP cross-platform**: dado consistente entre site, GBP, Receita, diretórios e redes sociais?
+- **Redes sociais**: Instagram, Facebook, LinkedIn ativos? Linkados via sameAs no schema?
+- **Backlinks**: site recebe links de imprensa local, parceiros, associações? (busca por "[nome empresa]" -site:dominio para detectar menções)
+
+### Etapa 6 — Análise competitiva
+
+Identifique top 3-5 concorrentes que rankeiam pra keyword principal × cidade. Para cada um:
+
+- Posição no Maps
+- Nº de reviews + nota média
+- Categoria primária do GBP
+- Tem site? É mais robusto?
+- Tem schema? Tem páginas de cidade?
+
+Use isso pra calibrar o gap real e o esforço necessário pra ultrapassar.
+
+### Etapa 7 — Composição do relatório
+
+Use **exatamente** esta estrutura. É o padrão ZARK de auditoria.
+
+## Estrutura obrigatória do relatório
+
+```markdown
+# 🔍 AUDITORIA SEO — [NOME DA EMPRESA]
+
+## 🚨 ACHADOS CRÍTICOS (resolver essa semana)
+
+### CRÍTICO #1 — [Título do problema mais grave]
+[Descrição clara do problema, por que é crítico, o que afeta]
+**Ação:** [O que fazer, em 1-2 frases acionáveis]
+
+### CRÍTICO #2 — [...]
+[...]
+
+[Liste de 2 a 5 críticos. Mais que 5 vira lista de afazeres, perde priorização.]
+
+---
+
+## ✅ O QUE ESTÁ BOM (reconhecer antes da pancadaria)
+
+[Liste 3 a 7 pontos positivos reais. Não invente. Se o site é fraco mas a copy é boa, mencione. Se a empresa tem 10 anos de mercado, isso é E-E-A-T forte. Se já tem GBP verificado, é um avanço. Reconheça.]
+
+1. **[Ponto positivo]** — [Por que importa]
+2. **[Ponto positivo]** — [Por que importa]
+[...]
+
+---
+
+## 📊 AUDITORIA TÉCNICA DETALHADA
+
+### TITLE & META
+**Atual:**
+- Title: `[texto atual]`
+- Description: `[texto atual]`
+
+**Problemas:**
+- [Problema 1]
+- [Problema 2]
+
+**Recomendação (substituir manualmente):**
+```
+Title: [novo title em ~60 caracteres]
+Meta description: [nova description em ~160 caracteres]
+```
+
+### H1 / HIERARQUIA
+[Análise + recomendação]
+
+### SCHEMA / DADOS ESTRUTURADOS
+**Atual:** [presente/ausente, qual tipo]
+**Recomendação:** [referenciar skill schema-jsonld-builder se aplicável, ou esboço do JSON-LD ideal]
+
+### CONTEÚDO E INTENÇÃO DE BUSCA
+[Tabela de cobertura de intenção × keyword × página dedicada]
+
+| Intenção do usuário | Keyword exemplo | Tem página dedicada? | Status |
+|---|---|---|---|
+| [...] | [...] | ✅/❌ | [...] |
+
+**Cobertura atual:** X/Y intenções.
+
+### PERFORMANCE & TÉCNICA
+[Lista de problemas observáveis e recomendações]
+
+### NAP (Name, Address, Phone)
+- Site: [...]
+- GBP: [...]
+- Receita: [...]
+- Diretórios: [...]
+**Status:** [consistente / inconsistente em X locais]
+
+### REDES SOCIAIS
+[Status de Instagram, Facebook, LinkedIn]
+
+---
+
+## 🏢 AUDITORIA GOOGLE BUSINESS PROFILE
+
+[Se dados disponíveis: análise item por item.]
+[Se dados indisponíveis: lista do que pedir, organizada como checklist]
+
+**Categoria primária atual:** [...]
+**Categoria primária recomendada:** [...]
+**Justificativa:** [...]
+
+[continue com cada item]
+
+---
+
+## 🎯 ARQUITETURA RECOMENDADA (próxima fase)
+
+[Árvore de URLs proposta para o site, com base no nicho e cliente]
+
+```
+dominio.com.br/
+├── /
+├── /servicos/
+│   ├── /servicos/[serviço-1]
+│   └── /servicos/[serviço-2]
+├── /atendemos/
+│   ├── /atendemos/[cidade-1]
+│   └── /atendemos/[cidade-2]
+├── /blog/
+└── /contato
+```
+
+---
+
+## 📋 PLANO DE EXECUÇÃO PRIORIZADO (90 DIAS)
+
+### Semana 1-2 — Higiene técnica
+1. ✅ [Ação 1]
+2. ✅ [Ação 2]
+[...]
+
+### Semana 3-6 — Construção das páginas-chave
+[...]
+
+### Semana 7-10 — Service Area e off-site
+[...]
+
+### Semana 11-12 — Conteúdo e autoridade
+[...]
+
+---
+
+## 📍 PLANO DE CITATIONS (Local SEO Off-Site)
+
+**Top 1 (cadastrar essa semana):**
+- Apontador.com.br
+- Telelistas.net
+- GuiaMais.com.br
+- Foursquare
+- Bing Places
+- Apple Business Connect
+- Yelp Brasil
+
+**Setoriais (pelo nicho [nicho-da-empresa]):**
+- [Diretório setorial 1]
+- [Diretório setorial 2]
+
+**Ficha-mestra NAP (copiar e colar idêntico em todos):**
+- Nome: [Nome exato]
+- Endereço: [Endereço completo, padronizado]
+- Telefone: [+55-DD-NNNNN-NNNN]
+- Site: [URL]
+- E-mail: [E-mail]
+
+---
+
+## ❓ DADOS QUE AINDA PRECISO PARA FECHAR A AUDITORIA 360°
+
+[Lista clara do que o usuário precisa fornecer pra completar análise — GBP, Search Console, Analytics, etc. Sempre presente quando há lacuna.]
+
+---
+
+## 📝 RESUMO EXECUTIVO
+
+**Em uma frase:** [Frase única que sintetiza o estado da empresa em SEO Local + maior oportunidade.]
+
+**Top 3 ações de maior impacto:**
+1. [...]
+2. [...]
+3. [...]
+
+**Estimativa de impacto:** com execução das ações priorizadas, [empresa] tem potencial de [X-Y]x crescimento em tráfego orgânico em 90-180 dias.
+```
+
+## Checklist mental antes de entregar o relatório
+
+Antes de devolver o documento ao usuário, verifique:
+
+- [ ] Listou de 2 a 5 críticos (não 1, não 10)?
+- [ ] Reconheceu pontos positivos antes da crítica?
+- [ ] Cada recomendação é específica e acionável (não "melhore o SEO")?
+- [ ] Tem plano em fases temporais (não lista solta)?
+- [ ] Não inventou dados que não verificou?
+- [ ] Pediu o que falta de forma explícita?
+- [ ] Resumo executivo em uma frase está claro?
+- [ ] NAP está consistente entre fontes verificadas?
+- [ ] Schema recomendado é do tipo específico (não LocalBusiness genérico)?
+- [ ] Plano de citations inclui setoriais do nicho específico?
+
+## Como lidar com pontos cegos
+
+Há limites técnicos do que dá pra ver via web:
+
+**Não dá pra acessar:**
+- Painel administrativo do GBP (só dados públicos)
+- Google Search Console
+- Google Analytics
+- Backlinks reais (precisa Ahrefs/Majestic)
+- Volume exato de keyword (precisa Semrush/Keyword Planner)
+- Heatmap de ranking por bairro (precisa Local Falcon/BrightLocal)
+- Métricas internas de conversão
+
+Quando precisar dessas informações, **declare explicitamente** que não foi possível medir e ofereça duas saídas:
+1. Lista do que o usuário pode coletar e enviar
+2. Estimativas qualitativas baseadas em sinais públicos (com nota de incerteza)
+
+**Nunca finja ter acesso ao que não tem.**
+
+## Escolha de tipo Schema por nicho (referência rápida)
+
+Use sempre o tipo **mais específico** disponível em vez de LocalBusiness genérico:
+
+- Advogado/escritório → `LegalService` ou `Attorney`
+- Médico/clínica → `MedicalBusiness`, `MedicalClinic`, `Dentist`, `Physiotherapy`
+- Loja física → `Store` (e subtipos: `ClothingStore`, `HardwareStore`, `JewelryStore`, `FurnitureStore`, `ElectronicsStore`)
+- Restaurante/bar → `Restaurant`, `BarOrPub`, `CafeOrCoffeeShop`, `FastFoodRestaurant`
+- Beleza → `BeautySalon`, `HairSalon`, `NailSalon`, `DaySpa`
+- Automotivo → `AutoRepair`, `AutoDealer`, `AutoBodyShop`, `GasStation`
+- Casa/construção → `Plumber`, `Electrician`, `RoofingContractor`, `HVACBusiness`, `Locksmith`, `HousePainter`
+- Pets → `VeterinaryCare`
+- Educação → `School`, `EducationalOrganization`
+- Hospedagem → `LodgingBusiness`, `Hotel`, `BedAndBreakfast`
+- Limpeza/dedetização → `LocalBusiness` + `additionalType` apontando pra concept específico (ex: schema.org não tem `PestControl` nativo, então use `LocalBusiness` + `description` clara + `serviceType` no Service)
+- Segurança eletrônica → `SecuritySystemInstaller` (subtipo de HomeAndConstructionBusiness)
+- Aluguel de equipamentos → `Store` + `OfferCatalog` com Services de aluguel
+
+Quando o nicho não tem tipo específico, use `LocalBusiness` + `additionalType` (URL para Wikipedia/Wikidata) + descrição rica.
+
+## Diretórios brasileiros priorizados
+
+Lista canônica para citations no Brasil, em ordem de importância:
+
+**Tier 1 — universais (sempre cadastrar):**
+1. Google Business Profile (já considerado)
+2. Bing Places (irmão do GBP, gratuito)
+3. Apple Business Connect (Maps da Apple)
+4. Apontador.com.br
+5. Telelistas.net
+6. GuiaMais.com.br
+7. Foursquare
+8. Yelp Brasil
+
+**Tier 2 — relevância média:**
+9. Solutudo (forte em BH/MG, varia por região)
+10. Achei Empresa
+11. Cylex Brasil
+12. Encontra Fácil
+13. Hagah (regional)
+
+**Tier 3 — setoriais (verificar se aplicável):**
+- Saúde: Doctoralia, BoaConsulta, CatalogoMedico
+- Advocacia: OAB-XX (registro estadual), JusBrasil
+- Beleza: Singu, GetNinjas (parcialmente)
+- Pets: Pet em Casa, Petlove parceiros
+- Hospedagem: Booking, Airbnb, Decolar
+- Restaurantes: iFood, Rappi, TripAdvisor
+- Construção/serviços: GetNinjas, Habitissimo, Triider
+- B2B/condomínios: SECOVI estadual, ABRASCA, ABRAINC
+
+**Para cada cliente:** identificar 2-3 setoriais relevantes e cadastrar antes de partir para Tier 2 universais.
+
+## Tom e estilo do relatório
+
+- **Direto, sem rodeios.** Cliente brasileiro paga pra saber o problema, não pra ouvir poema.
+- **Português técnico mas não jargão excessivo.** "Schema" pode aparecer, mas explique brevemente "(dados estruturados)" na primeira ocorrência.
+- **Use emojis sparingly** — só nos cabeçalhos de seção (🚨 ✅ 📊 🎯 📋 📍 📝). Nunca dentro do texto corrido.
+- **Tabelas pra dados comparativos**, prosa pra análise.
+- **Negrito pra ações**, não pra emoção.
+- **Nunca elogie demais nem destrua demais.** Equilíbrio honesto.
+
+## Exemplo de invocação esperada
+
+**Usuário:** "Claude, faz uma auditoria do site da minha pizzaria: pizzariadojose.com.br, tô perdendo cliente pra concorrência."
+
+**Resposta esperada:** acionar essa skill, fazer Etapa 1 (perguntar GBP, cidade, cliente típico), depois Etapa 2 em diante até entregar relatório completo no formato canônico.
+
+**Usuário:** "Olha esse link do Google Maps da minha clínica, o que você acha?"
+
+**Resposta esperada:** acionar essa skill, explicar limitação técnica do `share.google`, pedir os dados do GBP e a URL do site, prosseguir.
+
+**Usuário:** "Por que meu site não aparece no Google?"
+
+**Resposta esperada:** acionar essa skill (mesmo sem palavra "auditoria"), pedir URL e contexto, executar diagnóstico completo.