Communitygithub.com

Local Business Site Builder — site que faz o telefone tocar

Constrói, audita e publica um site estático de nível produção (HTML, CSS, JS puro) para um negócio local: conversão por ligação, scaffolding baseado em fatos, SEO local e JSON-LD, GA4 só após consentimento, CSP e um auditor sem dependências.

O que é Local Business Site Builder — site que faz o telefone tocar?

Passo 2 da receita Site para negócio local (construir, auditar, lançar), de PongoDogo/local-business-site-builder (publicado em 2026-10-06, MIT, pesquisa datada de 2026-10-05). Feito para encanadores, clínicas, restaurantes e lojas gregos hospedados na Hostinger, conversa com o dono em grego, mas o método se transfere: nunca inventar fatos (telefone, horário, preços e avaliações vêm do dono ou ficam de fora), um único site-facts.json a partir do qual scaffold.mjs derive regenera JSON-LD, sitemap, robots, manifest e vCard, um docs/DESIGN.md e uma única direção escolhida antes de codar, CSP limpo, nenhum terceiro antes do consentimento, e "pronto" só quando audit_site.mjs mostra 0 erros e verify_live.mjs passa no domínio ao vivo. Vem com um site de exemplo completo, sonda de overflow por larguras, renderizador de imagem OG e gerador de ícones. Não serve para e-commerce nem WordPress.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PongoDogo/local-business-site-builder/tree/HEAD/skills/local-business-site-builder

Perguntar na sua IA favorita

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

Documentação

Construção de site para negócios locais (Grécia)

Extraído de um site real (Αποφράξεις Τσαβάρης) que precisou de dezenas de prompts porque a parte invisível dava errado repetidamente: configuração de servidor, consentimento, arquivos SEO, fatos inconsistentes. Objetivo: acertar na primeira tentativa. Fale com o usuário em grego.

Os caminhos abaixo são relativos à pasta desta skill. Resolva-os para caminhos absolutos antes de executar scripts; execute os scripts com deno run -A scripts/<nome>.mjs (ou node). Se nenhum existir, informe o usuário (instalação: winget install DenoLand.Deno, pergunte primeiro) e use as listas de verificação manuais.

Execução portátil

Verifique as capacidades do host antes de executar os helpers: terminal e acesso a arquivos, Node 18+ ou Deno, ferramentas de navegador, FFmpeg opcional e permissões de rede. Nunca presuma que a instalação fornece essas ferramentas. Use ferramentas de imagem/navegador equivalentes disponíveis ou listas de verificação de referência manual; relate quaisquer verificações automatizadas que não pôde executar. Resolva cada caminho de suporte em relação ao diretório desta skill instalada. Nunca presuma um caminho de usuário Windows ou instale software sem autorização.

Regras que nunca se curvam (cada uma custa tempo ou dinheiro real)

  1. Nunca invente fatos. Telefone, e-mail, endereço, ΑΦΜ, ΓΕΜΗ, horários, preços, avaliações, classificações, anos de atividade, licenças, garantias, tempos de chegada vêm do proprietário. Ausente → pergunte ou omita; marcadores [ΧΡΕΙΑΖΕΤΑΙ: …] bloqueiam a publicação. Profissões regulamentadas (médico, dentista, advogado, farmacêutico): sem avaliações, sem alegações de sucesso (references/01 §4).
  2. Uma única fonte da verdade: site-facts.json (fora da pasta de deploy). Arquivos derivados (JSON-LD, sitemap, llms.txt, robots, manifest, vCard) são regenerados com scaffold.mjs derive, nunca editados manualmente.
  3. O design é decidido por cliente, nunca copiado de um site anterior: escreva docs/DESIGN.md, obtenha a escolha do usuário de UMA direção, depois codifique (references/02).
  4. CSP limpo desde a primeira linha: sem script/style/manipuladores inline; cada terceiro adicionado ao CSP na mesma alteração; um CSP imposto.
  5. Nenhuma requisição de terceiros antes do consentimento ou de um clique. GA4 carrega somente após "Αποδοχή"; Aceitar/Rejeitar iguais; mapa no clique; fontes auto-hospedadas com glifos gregos verificados (muitas fontes populares, ex. Poppins/Montserrat, não têm).
  6. Corrija causas raiz, não patches por largura. Mobile-first; teste a matriz de larguras com scripts/overflow_probe.js.
  7. Nunca confie em uma diretiva de servidor. Hostinger/LiteSpeed ignora <IfModule>, ignora silenciosamente diretivas não suportadas e força HTTPS na borda: verifique ao vivo com verify_live.mjs.
  8. Arquivos SEO são entregáveis: canônico, robots (Allow: / + Sitemap), sitemap, JSON-LD (subtipo LocalBusiness), OG 1200×630, ícones incluindo maskable.
  9. Incremente ?v= em cada página após qualquer alteração de CSS/JS (bump_version.mjs) e limpe os caches da Hostinger.
  10. Verifique, não suponha. Diga "concluído" somente após a auditoria mostrar 0 erros nos arquivos finais, o QA do navegador estiver feito e você relatar honestamente o que não foi verificado.

Pegadinhas (crenças obsoletas ou falsas que parecem certas)

  • Marcação FAQPage/HowTo não traz nada: resultados enriquecidos de FAQ foram descontinuados em 7 de maio de 2026. llms.txt não tem efeito comprovado (Google diz que não usa): opcional.
  • Nunca adicione aggregateRating/review JSON-LD para o próprio negócio; sameAs apenas para perfis reais e povoados (nunca um segundo domínio vazio).
  • Um Disallow: / de staging ou noindex deixado em produção desindexa o site (auditoria SEO-001/023).
  • O domínio de preview da Hostinger *.hostingersite.com duplica o site: redirecione 301 e remova-o.
  • htaccess sem o ponto é ignorado; com o ponto deve ser enviado explicitamente (arquivo oculto). Docs/facts/.md não devem ficar em public_html.
  • Links CDN do Google Fonts quebram privacidade e CSP; conselhos de design frontend que mencionam Poppins/DM Sans/Playfair etc. falham no grego.
  • Um link que difere de um arquivo apenas por maiúsculas/minúsculas funciona no Windows e dá 404 no servidor.
  • Âncoras construídas dentro de JS (banner de cookies → /privacy.html#cookies) devem existir também.
  • O desafio de bot na borda após ~60 requisições rápidas não é uma falha do site: espere, não desvie.

Fluxo de trabalho (carregue a referência nomeada em cada etapa antes de executá-la)

  1. Triagem: site novo · reformulação · apenas auditoria (pule para 6) · pequena alteração (pule para 5). Verifique quais ferramentas existem (deno/node, ferramenta de navegador, ffmpeg, Edge/Chrome para render_png).
  2. Coleta → leia references/01-intake-and-facts.md. Pergunte tudo em uma mensagem em grego (se ninguém puder responder, use apenas os fatos fornecidos, nunca invente, escreva QUESTIONS.md); escreva site-facts.json a partir de assets/site-facts.example.json; scaffold.mjs check --facts site-facts.json.
  3. Briefing de design → references/02-design-direction.md; preencha docs/DESIGN.md, proponha 2-3 direções, obtenha uma escolha.
  4. Estruturação: scaffold.mjs init --facts site-facts.json --out public --docs docs [--logo logo.svg] (cria páginas, CSS base, JS, .htaccess com CSP a partir das funcionalidades, robots, sitemap, llms.txt, manifest, vCard, documentos de handoff em grego, AGENTS.md/CLAUDE.md para o projeto).
  5. Construção → references/03-build-and-code.md, 04-conversion-and-content.md, 05-seo-schema-geo.md: tokens + TEMA em style.css, seções em index.html (substitua o marcador [ΧΡΕΙΑΖΕΤΑΙ…]), assets via make_icons.mjs, render_png.mjs (imagem OG de uma página HTML), images.mjs, font_greek_check.mjs --download. Para consentimento, texto de privacidade, identidade do rodapé, preços ou avaliações, leia também 06-privacy-consent-legal.md. Um exemplo fictício concluído do nível de qualidade está em assets/example-site/ (estude estrutura e tom de cópia, nunca sua aparência).
  6. Após qualquer alteração de fato: fatos → scaffold.mjs derive → texto visível → bump_version.mjs.
  7. Auditoria: audit_site.mjs public --facts site-facts.json → corrija cada ERRO, leia AVISO, forneça ao proprietário a lista VERIFICAR. Resultado não claro → references/mistake-registry.md.
  8. QA e lançamento → references/08-qa-and-launch.md (matriz de larguras, teste de consentimento, QA de conteúdo); implantação e detalhes do servidor em references/07-server-htaccess-deploy.md.
  9. Pós-implantação: verify_live.mjs https://DOMINIO --local public --preview-domain X.hostingersite.com; entregue ao proprietário docs/. Formulários, reservas, mais páginas, CMS, e-shop, outros idiomas, pixels de anúncios → references/09-beyond-the-basics.md e acorde escopo primeiro.

Scripts (scripts/)

audit_site.mjs auditoria pré-lançamento (ERRO/AVISO/VERIFICAR/INFO; --json, --strict; saída 1 em erros) · verify_live.mjs verificação ao vivo (redirecionamentos, cabeçalhos, 404, arquivos expostos, identidade de bytes; limitado) · scaffold.mjs init/derive/check · bump_version.mjs · render_png.mjs · make_icons.mjs · images.mjs (ffmpeg) · contrast.mjs · font_greek_check.mjs · overflow_probe.js (executar dentro da página). Todos imprimem uso no estilo --help quando chamados sem argumentos. Eles escrevem apenas dentro das pastas que você passa.

Índice de referência

01 coleta/fatos/profissões regulamentadas · 02 direções de design, fontes gregas · 03 construção, desempenho, acessibilidade, larguras · 04 conversão e cópia · 05 SEO/esquema/GBP/pesquisa AI · 06 privacidade e ponteiros de lei grega · 07 servidor Hostinger e implantação · 08 QA/lançamento · 09 além do básico · registro de erros. Data de pesquisa: 2026-10-05; leis e políticas do Google mudam: reverifique antes de confiar, e diga quando algo não foi verificado.

Habilidades Relacionadas