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)
- 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). - 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 conscaffold.mjs derive, nunca se editan a mano. - 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). - 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.
- 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).
- Corrige las causas raíz, no los parches por ancho. Móvil primero; prueba la matriz de anchos con
scripts/overflow_probe.js. - 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 converify_live.mjs. - Los archivos SEO son entregables: canonical, robots (
Allow: /+ Sitemap), sitemap, JSON-LD (subtipo LocalBusiness), OG 1200×630, iconos incl. maskable. - Aumenta
?v=en cada página después de cualquier cambio de CSS/JS (bump_version.mjs) y purga las cachés de Hostinger. - 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.txtno tiene efecto probado (Google dice que no lo usa): opcional. - Nunca añadas
aggregateRating/reviewJSON-LD para el propio negocio;sameAssolo para perfiles reales y con contenido (nunca un segundo dominio vacío). - Un
Disallow: /onoindexde staging dejado en producción desindexa el sitio (auditar SEO-001/023). - El dominio de vista previa de Hostinger
*.hostingersite.comduplica el sitio: redirígelo con 301 y elimínalo. htaccesssin el punto se ignora; con punto debe subirse explícitamente (archivo oculto). Los archivos Docs/facts/.mdno deben estar enpublic_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)
- 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). - 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, escribeQUESTIONS.md); escribesite-facts.jsondesdeassets/site-facts.example.json;scaffold.mjs check --facts site-facts.json. - Brief de diseño →
references/02-design-direction.md; completadocs/DESIGN.md, propón 2-3 direcciones, obtén una elección. - Andamiaje:
scaffold.mjs init --facts site-facts.json --out public --docs docs [--logo logo.svg](crea páginas, CSS base, JS,.htaccesscon CSP desde las funcionalidades, robots, sitemap, llms.txt, manifest, vCard, documentos de entrega en griego, AGENTS.md/CLAUDE.md para el proyecto). - Construcción →
references/03-build-and-code.md,04-conversion-and-content.md,05-seo-schema-geo.md: tokens + TEMA enstyle.css, secciones enindex.html(reemplaza el marcador[ΧΡΕΙΑΖΕΤΑΙ…]), activos mediantemake_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én06-privacy-consent-legal.md. Un ejemplo ficticio terminado del nivel de calidad está enassets/example-site/(estudia la estructura y el tono de las copias, nunca su apariencia). - Después de cualquier cambio de hecho: hechos →
scaffold.mjs derive→ texto visible →bump_version.mjs. - 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. - QA y lanzamiento →
references/08-qa-and-launch.md(matriz de anchos, prueba de consentimiento, QA de contenido); detalles de despliegue y servidor enreferences/07-server-htaccess-deploy.md. - Post-despliegue:
verify_live.mjs https://DOMINIO --local public --preview-domain X.hostingersite.com; entregadocs/al propietario. Formularios, reservas, más páginas, CMS, tienda, otros idiomas, píxeles de anuncios →references/09-beyond-the-basics.mdy 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.