Communitygithub.com

Auditoria de Descobrimento por IA (GEO/AEO)

Executa uma auditoria de descobrimento para assistentes de IA (GEO/AEO) para um negócio de serviços local — verifica acesso de crawlers, llms.txt, extração de conteúdo, perguntas e respostas, schema.org, consistência NAP e testes de citação ao vivo — com saída em tabela de descobertas e lista de ações priorizadas.

O que é AEO)?

Esta habilidade realiza uma auditoria abrangente de discoverability (GEO/AEO) para negócios de serviços locais, focando em como assistentes de IA (como ChatGPT, Claude, Google AI) encontram e citam suas informações. Ela verifica se o site é tecnicamente acessível a crawlers de IA (robots.txt), se possui um arquivo llms.txt, se o conteúdo HTML é extraível (não travado por JavaScript), e se há conteúdo formatado como perguntas e respostas (FAQ) que as IAs possam citar diretamente. Além disso, verifica a consistência de dados estruturados (Schema.org) e a uniformidade do NAP (Nome, Endereço, Telefone) em plataformas de terceiros, e realiza um teste de citação ao vivo para ver o que realmente aparece nos resultados de busca de IA. A saída é uma tabela de descobertas e uma lista de ações priorizadas, divididas em grupos de responsabilidade (cliente, equipe/desenvolvedor, correções técnicas). A auditoria é diagnóstica e não alarmista, garantindo que nenhuma correção seja iniciada sem confirmação do escopo pelo usuário. Suporta integração com ferramentas de busca e análise de sites, mas respeita bloqueios de robots.txt sem tentar contorná-los.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PeakWorkflowSolutions/pws-portfolio/tree/HEAD/skills/ai-discoverability-audit

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Auditoria de Descobrimento por Assistentes de IA (GEO/AEO)

Propósito

Ajudar negócios de serviços locais a se tornarem precisamente descobríveis e citáveis por assistentes de IA. Isso significa: suas informações reais (nome, endereço, telefone, horários, credenciais) são consistentes em todos os lugares onde uma IA possa puxá-las; seu site possui conteúdo genuíno e bem estruturado em formato de resposta, em vez de texto placeholder; seu site é tecnicamente acessível a crawlers de IA; e as lacunas são diagnosticadas primeiro, sem alarmismo, antes de qualquer correção começar.

Este é apenas um passo de pesquisa/auditoria. Não comece a corrigir nada encontrado sem que o usuário confirme o escopo primeiro.

Antes de começar: colete

  • Nome legal completo do cliente como deve aparecer em todo lugar
  • Nome da empresa/corrretora (e nome da equipe, se diferente)
  • Endereço e telefone da empresa
  • URL do site principal
  • Quaisquer perfis conhecidos (site, redes sociais, listagens de diretórios)

Se este for um novo negócio/cliente, sugira armazenar os resultados desta auditoria em um projeto dedicado (ou em um novo documento dentro de um) para que os dados do cliente fiquem separados deste processo reutilizável — um projeto por negócio/cliente mantém as coisas organizadas em vários engajamentos.

Verificações a executar

  1. Acesso de crawler — robots.txt permite bots de IA (GPTBot, ClaudeBot, PerplexityBot, Google-Extended)
  2. Presença de llms.txt
  3. Extrabilidade de conteúdo — HTML puro vs. bloqueado por JS, e se as páginas realmente contêm conteúdo real (não placeholder/modelo)
  4. Conteúdo em formato de resposta — formatação FAQ/resposta direta que uma IA possa extrair e citar
  5. Dados estruturados Schema.org
  6. Consistência de perfil de terceiros (NAP: nome, endereço, telefone) em todas as plataformas encontradas
  7. Teste de citação ao vivo — realmente consultar mecanismos de busca/assistentes de IA e relatar o que aparece, incluindo sites de diretório de baixa qualidade, se encontrados

Ressalvas de ferramentas — espere estas sempre

  • Muitos sites de agências/corrretoras bloqueiam a busca automatizada (robots.txt). Se uma busca for bloqueada, não tente contorná-la — relate o item como "não pode ser verificado automaticamente" e anote que precisa de uma execução manual do PageSpeed Insights (pagespeed.web.dev) e uma verificação manual do código-fonte.
  • Listagens do Google Maps exigem JavaScript, então o status de reivindicação do GBP geralmente não pode ser verificado remotamente. Confirme através de uma pesquisa ao vivo no Google (um prompt "Reivindique esta empresa" significa não reivindicado) ou fazendo o cliente acessar business.google.com diretamente.
  • Não relate algo como uma lacuna confirmada sem uma segunda olhada — conteúdo mais abaixo na página pode ser perdido por uma ferramenta de busca. Se corrigido depois, anote a correção abertamente em vez de editar silenciosamente.

Formato de saída

  1. Uma tabela de descobertas (uma linha por item, cada uma com um Resultado e uma Razão de uma linha).
  2. Uma lista de ações priorizadas dividida em três grupos: o cliente pode fazer diretamente, precisa de sua equipe/desenvolvedor web/corrretora (sinalize em vez de tratar como uma entrega para o indivíduo), e correções técnicas (abordadas por último).
  3. Uma lista de fontes de cada URL realmente verificada, anotando qualquer coisa tentada mas não acessível.

Tom: factual e não alarmista — isto é um diagnóstico, não um argumento de venda.

Verificação

  • Cada "lacuna confirmada" foi verificada pelo menos duas vezes (busca inicial + uma segunda olhada) antes de ser relatada como confirmada.
  • Cada URL verificada aparece na lista de fontes, incluindo as que foram bloqueadas ou inacessíveis.
  • A lista de ações está dividida nos três grupos de propriedade, não deixada como uma lista plana.
  • Nenhuma correção foi iniciada — a confirmação do escopo pelo usuário/cliente vem primeiro.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

PeakWorkflowSolutions/pws-portfolio

Generates client-ready contractor bids that reproduce a specific business's own template and voice exactly, changing only the job-specific content (scope, price, materials, timeline, client info). Use this skill whenever building, adapting, or troubleshooting a bid/proposal generator for a contractor business, whenever the user mentions "bid generator," "proposal generator," extracting a business's bid style, or onboarding a new contractor client for PWS's bid generation offer. Status: Complete (v1).

PeakWorkflowSolutions/pws-portfolio

Turns a new client's intake answers into a complete, ready-to-deploy PWS lead capture system package — Zap configs, the customized Claude prompt, Google Form fields, Sheet columns, and an owner's one-pager guide, all generated together from one intake conversation. Use this skill whenever onboarding a new client for PWS's missed-call lead capture system, whenever the user mentions "new client," "onboarding," "intake," or wants to set up the lead capture system for a specific business. This skill builds directly on top of lead-capture-skill — read that skill first if it's available, since this skill reuses its finalized prompt structure and system design.

PeakWorkflowSolutions/pws-portfolio

Scans top-performing content in a specific person's industry and local market, then builds a content playbook and tailored post ideas for lead generation. Use for Marcos's own content or any client's team/agents.

PeakWorkflowSolutions/pws-portfolio

Documents PWS's AI-Powered Missed Call Lead Capture System — an OpenPhone + Zapier + Claude + Google Forms/Sheets workflow that turns missed calls into captured leads automatically. Use this skill whenever building, adapting, explaining, or troubleshooting a missed-call lead capture system for a client, whenever the user mentions OpenPhone, Zapier lead capture, missed call automation, or a new client onboarding for PWS's flagship offer.

PeakWorkflowSolutions/pws-portfolio

Acts as Marcos's technical co-builder for a real PWS client automation project: diagnoses the client's actual problem, designs the solution and tool stack, and walks through building the workflow, scripts, or code step by step.

PeakWorkflowSolutions/pws-portfolio

Use when Marcos reports how a sales call went (in any wording, any time of day) so the lead's record in the Notion Prospects database gets updated.

PeakWorkflowSolutions/pws-portfolio

Generates branded, print-ready PWS service agreements, retainer terms, and consent/access forms from a client's real scope — one agreement per build, 20/80 payment, fillable Automation Builds table with auto-totaled price, black-and-white tables, no baked-in discount math.

PeakWorkflowSolutions/pws-portfolio

Use before Marcos's daily cold calls: pulls today's due leads from the Notion Prospects database and builds a researched, honest call script for each.

PeakWorkflowSolutions/pws-portfolio

Turns a recorded client meeting into a structured intake ready for the paperwork skill — pulls the Wispr Flow transcript, checks it against a fixed Scope/Timeline/Pricing/Payment/Access checklist, and publishes an interactive artifact so Marcos can fill in whatever the meeting didn't cover before it ends.

PeakWorkflowSolutions/pws-portfolio

Turns a new PWS video script/transcript into a ready-to-post batch of platform-specific social copy — the established priority channel set, brand voice, and per-platform formatting rules baked in.

PeakWorkflowSolutions/pws-portfolio

Runs the structured intake-to-demo pattern for a PWS website-build client: a fixed discovery questionnaire, a completeness check, and an auto-drafted first demo site built from the client's real answers with honest placeholders.

Habilidades Relacionadas