Communitygithub.com

Local Business Site Builder — un site statique qui fait sonner

Construit, audite et déploie un site statique de qualité production (HTML, CSS, JS natif) pour un commerce local : conversion par appel, scaffolding piloté par les faits, SEO local et JSON-LD, GA4 après consentement, CSP et auditeur sans dépendances.

Qu'est-ce que Local Business Site Builder — un site statique qui fait sonner ?

Étape 2 de la recette Site de commerce local (construire, auditer, lancer), tirée de PongoDogo/local-business-site-builder (publié le 2026-10-06, MIT, recherches datées du 2026-10-05). Pensé pour les plombiers, cliniques, restaurants et boutiques grecs hébergés chez Hostinger, il parle grec au client, mais la méthode se transpose : ne jamais inventer de faits (téléphone, horaires, prix, avis viennent du propriétaire ou n'apparaissent pas), un seul site-facts.json d'où scaffold.mjs derive régénère JSON-LD, sitemap, robots, manifest et vCard, un docs/DESIGN.md et une seule direction choisie avant de coder, zéro violation CSP, aucun tiers avant consentement, et « fini » seulement quand audit_site.mjs affiche 0 erreur et que verify_live.mjs passe sur le domaine en ligne. Livré avec un site d'exemple, une sonde de débordement multi-largeurs, un rendu d'image OG et un générateur d'icônes. Pas pour l'e-commerce ni WordPress.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Constructeur de site pour entreprise locale (Grèce)

Extrait d'un site réel (Αποφράξεις Τσαβάρης) qui a nécessité des dizaines de prompts à cause de problèmes de plomberie invisibles : configuration serveur, consentement, fichiers SEO, informations incohérentes. Objectif : réussir du premier coup. Parle à l'utilisateur en grec.

Les chemins ci-dessous sont relatifs au dossier de cette compétence. Résolvez-les en chemins absolus avant d'exécuter les scripts ; exécutez les scripts avec deno run -A scripts/<nom>.mjs (ou node). Si aucun n'existe, informez l'utilisateur (installation : winget install DenoLand.Deno, demandez d'abord) et utilisez les listes de vérification manuelles.

Exécution portable

Vérifiez les capacités de l'hôte avant d'exécuter les assistants : accès au terminal et aux fichiers, Node 18+ ou Deno, outils de navigateur, FFmpeg optionnel et permissions réseau. Ne supposez jamais que l'installation fournit ces outils. Utilisez les outils d'image/navigateur équivalents disponibles ou les listes de vérification manuelles de référence ; signalez toute vérification automatisée que vous n'avez pas pu exécuter. Résolvez chaque chemin d'assistance par rapport à ce répertoire de compétence installé. Ne supposez jamais un chemin d'utilisateur Windows ni n'installez de logiciel sans autorisation.

Règles qui ne plient jamais (chacune a coûté du temps ou de l'argent réel)

  1. N'inventez jamais de faits. Téléphone, email, adresse, ΑΦΜ, ΓΕΜΗ, horaires, prix, avis, notes, années d'activité, licences, garanties, délais d'arrivée proviennent du propriétaire. Manquant → demandez, ou laissez de côté ; les marqueurs [ΧΡΕΙΑΖΕΤΑΙ: …] bloquent la mise en ligne. Professions réglementées (médecin, dentiste, avocat, pharmacien) : pas d'avis, pas de déclarations de succès (références/01 §4).
  2. Une seule source de vérité : site-facts.json (en dehors du dossier de déploiement). Les fichiers dérivés (JSON-LD, sitemap, llms.txt, robots, manifeste, vCard) sont regénérés avec scaffold.mjs derive, jamais modifiés à la main.
  3. Le design est décidé par client, jamais copié d'un site précédent : écrivez docs/DESIGN.md, obtenez le choix de l'utilisateur pour UNE direction, puis codez (références/02).
  4. CSP-propre dès la première ligne : pas de script/style/gestionnaire en ligne ; chaque tiers ajouté à la CSP dans la même modification ; une seule CSP appliquée.
  5. Pas de requête tierce avant consentement ou clic. GA4 ne se charge qu'après « Αποδοχή » ; Accepter/Refuser égal ; carte sur clic ; polices auto-hébergées avec glyphes grecs vérifiés (nombreuses polices populaires, p. ex. Poppins/Montserrat, n'en ont pas).
  6. Corrigez les causes racines, pas les correctifs par largeur. Mobile-first ; testez la matrice de largeur avec scripts/overflow_probe.js.
  7. Ne faites jamais confiance à une directive serveur. Hostinger/LiteSpeed ignore <IfModule>, ignore silencieusement les directives non prises en charge et force HTTPS en périphérie : vérifiez en direct avec verify_live.mjs.
  8. Les fichiers SEO sont des livrables : canonical, robots (Allow: / + Sitemap), sitemap, JSON-LD (sous-type LocalBusiness), OG 1200×630, icônes incl. maskable.
  9. Incrémentez ?v= sur chaque page après toute modification CSS/JS (bump_version.mjs) et videz les caches Hostinger.
  10. Vérifiez, ne supposez pas. Dites « fait » seulement après que l'audit montre 0 erreurs sur les fichiers finaux, que le QA navigateur est effectué, et que vous signalez honnêtement ce qui n'est pas vérifié.

Pièges (croyances obsolètes ou fausses qui semblent correctes)

  • Le balisage FAQPage/HowTo n'apporte rien : les résultats enrichis FAQ ont été retirés le 7 mai 2026. llms.txt n'a pas d'effet prouvé (Google dit qu'il ne l'utilise pas) : optionnel.
  • N'ajoutez jamais aggregateRating/review JSON-LD pour l'entreprise elle-même ; sameAs seulement pour des profils réels et actifs (jamais un second domaine vide).
  • Un Disallow: / ou noindex de préproduction laissé en production désindexe le site (audit SEO-001/023).
  • Le domaine de prévisualisation Hostinger *.hostingersite.com duplique le site : redirigez-le en 301 et supprimez-le.
  • htaccess sans le point est ignoré ; avec un point, il doit être téléchargé explicitement (fichier caché). Les documents/faits/.md ne doivent pas se trouver dans public_html.
  • Les liens CDN Google Fonts brisent la confidentialité et la CSP ; les conseils de design frontend qui nomment Poppins/DM Sans/Playfair etc. échouent sur le grec.
  • Un lien qui diffère d'un fichier uniquement par la casse fonctionne sous Windows et donne une 404 sur le serveur.
  • Les ancres construites en JS (bannière cookie → /privacy.html#cookies) doivent également exister.
  • Le défi bot en périphérie après ~60 requêtes rapides n'est pas une panne du site : attendez, ne contournez pas.

Workflow (chargez la référence nommée à chaque étape avant de l'exécuter)

  1. Tri : nouveau site · reprise · audit uniquement (passez à 6) · petite modification (passez à 5). Vérifiez quels outils existent (deno/node, outil navigateur, ffmpeg, Edge/Chrome pour render_png).
  2. Recueil → lisez references/01-intake-and-facts.md. Demandez tout en un seul message grec (si personne ne peut répondre, utilisez uniquement les faits donnés, n'inventez jamais, écrivez QUESTIONS.md) ; écrivez site-facts.json à partir de assets/site-facts.example.json ; scaffold.mjs check --facts site-facts.json.
  3. Brief design → references/02-design-direction.md ; remplissez docs/DESIGN.md, proposez 2-3 directions, obtenez un choix.
  4. Échafaudage : scaffold.mjs init --facts site-facts.json --out public --docs docs [--logo logo.svg] (crée pages, CSS de base, JS, .htaccess avec CSP depuis les fonctionnalités, robots, sitemap, llms.txt, manifeste, vCard, documents de passation grecs, AGENTS.md/CLAUDE.md pour le projet).
  5. Construction → references/03-build-and-code.md, 04-conversion-and-content.md, 05-seo-schema-geo.md : jetons + THÈME dans style.css, sections dans index.html (remplacez le marqueur [ΧΡΕΙΑΖΕΤΑΙ…]), ressources via make_icons.mjs, render_png.mjs (image OG depuis une page HTML), images.mjs, font_greek_check.mjs --download. Pour consentement, texte de confidentialité, identité de pied de page, prix ou avis, lisez aussi 06-privacy-consent-legal.md. Un exemple fictif terminé du niveau de qualité se trouve dans assets/example-site/ (étudiez la structure et le ton de la copie, jamais son apparence).
  6. Après tout changement de fait : faits → scaffold.mjs derive → texte visible → bump_version.mjs.
  7. Audit : audit_site.mjs public --facts site-facts.json → corrigez chaque ERREUR, lisez les AVERTISSEMENTS, donnez au propriétaire la liste VÉRIFIER. Résultat peu clair → references/mistake-registry.md.
  8. QA et lancement → references/08-qa-and-launch.md (matrice de largeur, test de consentement, QA de contenu) ; déploiement et détails serveur dans references/07-server-htaccess-deploy.md.
  9. Post-déploiement : verify_live.mjs https://DOMAINE --local public --preview-domain X.hostingersite.com ; remettez au propriétaire docs/. Formulaires, réservation, pages supplémentaires, CMS, e-shop, autres langues, pixels publicitaires → references/09-beyond-the-basics.md et convenez d'abord du périmètre.

Scripts (scripts/)

audit_site.mjs audit pré-lancement (ERREUR/AVERTISSEMENT/VÉRIFIER/INFO ; --json, --strict ; sortie 1 en cas d'erreurs) · verify_live.mjs vérification en direct (redirections, en-têtes, 404, fichiers exposés, identité d'octets ; limité) · 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 (exécuté dans la page). Tous affichent une utilisation de type --help lorsqu'ils sont appelés sans arguments. Ils écrivent uniquement dans les dossiers que vous passez.

Index de référence

01 recueil/faits/professions réglementées · 02 directions de design, polices grecques · 03 construction, performance, accessibilité, largeurs · 04 conversion et copie · 05 SEO/schéma/GBP/recherche IA · 06 vie privée et points de droit grec · 07 serveur Hostinger et déploiement · 08 QA/lancement · 09 au-delà des bases · registre des erreurs. Date de recherche : 2026-10-05 ; les lois et les politiques Google changent : revérifiez avant de vous y fier, et dites quand quelque chose n'est pas vérifié.

Skills associés