Communitygithub.com

Local Business Site Builder — web que hace sonar el teléfono

Construye, audita y publica una web estática de nivel producción (HTML, CSS, JS nativo) para un negocio local: conversión por llamada, scaffolding basado en datos reales, SEO local y JSON-LD, GA4 tras consentimiento, CSP y un auditor sin dependencias.

¿Qué es Local Business Site Builder — web que hace sonar el teléfono?

Paso 2 de la receta Web para negocio local (construir, auditar, lanzar), de PongoDogo/local-business-site-builder (publicado el 2026-10-06, MIT, investigación fechada el 2026-10-05). Pensado para fontaneros, clínicas, restaurantes y tiendas griegos alojados en Hostinger, habla con el dueño en griego, pero el método se traslada: nunca inventar datos (teléfono, horario, precios y reseñas vienen del dueño o no aparecen), un único site-facts.json desde el que scaffold.mjs derive regenera JSON-LD, sitemap, robots, manifest y vCard, un docs/DESIGN.md y una sola dirección elegida antes de programar, CSP limpio, ningún tercero antes del consentimiento, y «terminado» solo cuando audit_site.mjs marca 0 errores y verify_live.mjs pasa en el dominio en vivo. Incluye una web de ejemplo terminada, una sonda de desbordamiento por anchos, un renderizador de imagen OG y un generador de iconos. No sirve para tiendas online ni WordPress.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Constructor de sitios para negocios locales (Grecia)

Destilado de un sitio real (Αποφράξεις Τσαβάρης) que requirió docenas de indicaciones porque la fontanería invisible falló una y otra vez: configuración del servidor, consentimiento, archivos SEO, hechos inconsistentes. Objetivo: hacerlo bien a la primera. Habla al usuario en griego.

Las rutas siguientes son relativas a la carpeta de esta habilidad. Resuélvelas a rutas absolutas antes de ejecutar scripts; ejecuta los scripts con deno run -A scripts/<nombre>.mjs (o node). Si no existe ninguno, informa al usuario (instalación: winget install DenoLand.Deno, pregunta primero) y usa las listas de verificación manuales.

Ejecución portable

Verifica las capacidades del host antes de ejecutar asistentes: acceso a terminal y archivos, Node 18+ o Deno, herramientas de navegador, FFmpeg opcional y permisos de red. Nunca asumas que la instalación proporciona estas herramientas. Usa herramientas equivalentes de imagen/navegador disponibles o listas de verificación de referencia manuales; informa sobre cualquier comprobación automatizada que no hayas podido ejecutar. Resuelve cada ruta de soporte con respecto a este directorio de habilidad instalado. Nunca asumas una ruta de usuario de Windows ni instales software sin autorización.

Reglas que nunca se doblan (cada una cuesta tiempo o dinero real)

  1. Nunca inventes hechos. Teléfono, correo electrónico, dirección, ΑΦΜ, ΓΕΜΗ, horario, precios, reseñas, calificaciones, años de actividad, licencias, garantías, tiempos de llegada provienen del propietario. Faltante → pregunta, u omite; los marcadores [ΧΡΕΙΑΖΕΤΑΙ: …] bloquean la publicación en vivo. Profesiones reguladas (médico, dentista, abogado, farmacéutico): sin reseñas, sin afirmaciones de éxito (referencias/01 §4).
  2. Una única fuente de verdad: site-facts.json (fuera de la carpeta de despliegue). Los archivos derivados (JSON-LD, sitemap, llms.txt, robots, manifest, vCard) se regeneran con scaffold.mjs derive, nunca se editan a mano.
  3. El diseño se decide por cliente, nunca se copia de un sitio anterior: escribe docs/DESIGN.md, obtén la elección del usuario de UNA dirección, luego programa (referencias/02).
  4. CSP limpio desde la primera línea: sin scripts/estilos/manejadores en línea; cada tercero añadido a la CSP en el mismo cambio; una CSP aplicada.
  5. Sin solicitudes a terceros antes del consentimiento o un clic. GA4 se carga solo después de «Αποδοχή»; Aceptar/Rechazar iguales; mapa al hacer clic; fuentes autoalojadas con glifos griegos verificados (muchas fuentes populares, ej. Poppins/Montserrat, no los tienen).
  6. Corrige las causas raíz, no los parches por ancho. Móvil primero; prueba la matriz de anchos con scripts/overflow_probe.js.
  7. Nunca confíes en una directiva del servidor. Hostinger/LiteSpeed ignora <IfModule>, ignora silenciosamente directivas no soportadas y fuerza HTTPS en el borde: verifica en vivo con verify_live.mjs.
  8. Los archivos SEO son entregables: canonical, robots (Allow: / + Sitemap), sitemap, JSON-LD (subtipo LocalBusiness), OG 1200×630, iconos incl. maskable.
  9. Aumenta ?v= en cada página después de cualquier cambio de CSS/JS (bump_version.mjs) y purga las cachés de Hostinger.
  10. Verifica, no asumas. Di «listo» solo después de que la auditoría muestre 0 errores en los archivos finales, la QA del navegador esté hecha, e informes honestamente lo que no está verificado.

Trampas (creencias obsoletas o falsas que parecen correctas)

  • El marcado FAQPage/HowTo no aporta nada: los resultados enriquecidos de FAQ se retiraron el 7 de mayo de 2026. llms.txt no tiene efecto probado (Google dice que no lo usa): opcional.
  • Nunca añadas aggregateRating/review JSON-LD para el propio negocio; sameAs solo para perfiles reales y con contenido (nunca un segundo dominio vacío).
  • Un Disallow: / o noindex de staging dejado en producción desindexa el sitio (auditar SEO-001/023).
  • El dominio de vista previa de Hostinger *.hostingersite.com duplica el sitio: redirígelo con 301 y elimínalo.
  • htaccess sin el punto se ignora; con punto debe subirse explícitamente (archivo oculto). Los archivos Docs/facts/.md no deben estar en public_html.
  • Los enlaces CDN de Google Fonts rompen la privacidad y la CSP; el consejo de diseño frontend que menciona Poppins/DM Sans/Playfair etc. falla en griego.
  • Un enlace que difiere de un archivo solo por mayúsculas/minúsculas funciona en Windows y da 404 en el servidor.
  • Los anclajes construidos dentro de JS (banner de cookies → /privacy.html#cookies) también deben existir.
  • El desafío del bot perimetral después de ~60 solicitudes rápidas no es una falla del sitio: espera, no lo evites.

Flujo de trabajo (carga la referencia nombrada en cada paso antes de hacerlo)

  1. Triaje: sitio nuevo · reelaboración · solo auditoría (salta a 6) · cambio pequeño (salta a 5). Verifica qué herramientas existen (deno/node, herramienta de navegador, ffmpeg, Edge/Chrome para render_png).
  2. Toma de datos → lee references/01-intake-and-facts.md. Pregunta todo en un mensaje en griego (si nadie puede responder, usa solo los hechos dados, nunca inventes, escribe QUESTIONS.md); escribe site-facts.json desde assets/site-facts.example.json; scaffold.mjs check --facts site-facts.json.
  3. Brief de diseño → references/02-design-direction.md; completa docs/DESIGN.md, propón 2-3 direcciones, obtén una elección.
  4. Andamiaje: scaffold.mjs init --facts site-facts.json --out public --docs docs [--logo logo.svg] (crea páginas, CSS base, JS, .htaccess con CSP desde las funcionalidades, robots, sitemap, llms.txt, manifest, vCard, documentos de entrega en griego, AGENTS.md/CLAUDE.md para el proyecto).
  5. Construcción → references/03-build-and-code.md, 04-conversion-and-content.md, 05-seo-schema-geo.md: tokens + TEMA en style.css, secciones en index.html (reemplaza el marcador [ΧΡΕΙΑΖΕΤΑΙ…]), activos mediante make_icons.mjs, render_png.mjs (imagen OG desde una página HTML), images.mjs, font_greek_check.mjs --download. Para consentimiento, texto de privacidad, identidad del pie de página, precios o reseñas lee también 06-privacy-consent-legal.md. Un ejemplo ficticio terminado del nivel de calidad está en assets/example-site/ (estudia la estructura y el tono de las copias, nunca su apariencia).
  6. Después de cualquier cambio de hecho: hechos → scaffold.mjs derive → texto visible → bump_version.mjs.
  7. Auditoría: audit_site.mjs public --facts site-facts.json → corrige cada ERROR, lee las ADVERTENCIAS, entrega al propietario la lista de VERIFICACIÓN. Hallazgo poco claro → references/mistake-registry.md.
  8. QA y lanzamiento → references/08-qa-and-launch.md (matriz de anchos, prueba de consentimiento, QA de contenido); detalles de despliegue y servidor en references/07-server-htaccess-deploy.md.
  9. Post-despliegue: verify_live.mjs https://DOMINIO --local public --preview-domain X.hostingersite.com; entrega docs/ al propietario. Formularios, reservas, más páginas, CMS, tienda, otros idiomas, píxeles de anuncios → references/09-beyond-the-basics.md y acuerda el alcance primero.

Scripts (scripts/)

audit_site.mjs auditoría previa al lanzamiento (ERROR/ADVERTENCIA/VERIFICAR/INFO; --json, --strict; salida 1 en errores) · verify_live.mjs comprobación en vivo (redirecciones, cabeceras, 404, archivos expuestos, identidad 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 (ejecutar dentro de la página). Todos imprimen uso al estilo --help cuando se llaman sin argumentos. Escriben solo dentro de las carpetas que pases.

Índice de referencias

01 intake/hechos/profesiones reguladas · 02 direcciones de diseño, fuentes griegas · 03 construcción, rendimiento, accesibilidad, anchos · 04 conversión y copia · 05 SEO/esquema/GBP/búsqueda IA · 06 privacidad y referencias legales griegas · 07 servidor Hostinger y despliegue · 08 QA/lanzamiento · 09 más allá de lo básico · registro de errores. Fecha de investigación: 2026-10-05; las leyes y políticas de Google cambian: vuelve a verificar antes de confiar en ellas, y di cuando algo no esté verificado.

Skills relacionados