Communitygithub.com

Local Business Site Builder:電話が鳴る静的サイト

地元ビジネス向けに本番品質の静的サイト(HTML・CSS・素のJS)を構築・監査・公開。電話での問い合わせを軸に、事実ベースの雛形、ローカルSEOとJSON-LD、同意後のみのGA4、CSP、依存ゼロの監査スクリプトを備えます。

Local Business Site Builder:電話が鳴る静的サイト とは?

地元ビジネスのサイト制作レシピ ステップ2(構築・監査・公開)、PongoDogo/local-business-site-builder より(2026-10-06 公開、MIT、調査日 2026-10-05)。Hostinger 上のギリシャの配管業者、クリニック、飲食店、小売店向けで、店主とはギリシャ語で話しますが、手法はそのまま使えます。事実は捏造しない(電話・営業時間・価格・レビューは店主から得るか載せない)。site-facts.json を唯一の情報源にし、scaffold.mjs derive で JSON-LD・sitemap・robots・manifest・vCard を再生成。コーディング前に docs/DESIGN.md を書いて方向性を1つに決める。CSP を守り、同意前にサードパーティを読み込まない。audit_site.mjs がエラー0、verify_live.mjs が本番ドメインで通るまで完了と言わない。完成済みの作例サイト、幅別のはみ出し検査、OG画像レンダラー、アイコン生成も同梱。ECサイトや WordPress には不向き。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

地元ビジネスサイトビルダー(ギリシャ)

実際のサイト(Αποφράξεις Τσαβάρης)から抽出しました。このサイトは、目に見えない配管の問題が何度も発生したため、数十回のプロンプトを要しました:サーバー設定、同意、SEOファイル、一貫性のない事実。目標:初回で正しく動作させること。ユーザーとは ギリシャ語 で会話します。

以下のパスは、このスキルのフォルダーからの相対パスです。スクリプトを実行する前に、絶対パスに解決してください。スクリプトは deno run -A scripts/<name>.mjs(または node)で実行します。どちらも存在しない場合は、ユーザーに知らせて(インストール:winget install DenoLand.Deno、事前に確認)、手動チェックリストを使用します。

ポータブル実行

ヘルパーを実行する前に、ホストの機能を確認してください:ターミナルとファイルアクセス、Node 18+ または Deno、ブラウザツール、オプションの FFmpeg とネットワーク権限。これらのツールがインストールされていると想定しないでください。利用可能な同等の画像/ブラウザツールまたは手動参照チェックリストを使用し、実行できなかった自動チェックを報告してください。すべてのサポートパスを、インストールされたこのスキルディレクトリに対して解決してください。Windows ユーザーのパスを想定したり、許可なくソフトウェアをインストールしたりしないでください。

決して曲げてはいけないルール(それぞれが実際の時間または費用を要します)

  1. 事実を決して捏造しないこと。 電話番号、メール、住所、ΑΦΜ、ΓΕΜΗ、営業時間、価格、レビュー、評価、営業年数、ライセンス、保証、到着時間はすべて所有者から提供されます。不足している場合は尋ねるか、省略します。[ΧΡΕΙΑΖΕΤΑΙ: …] マーカーは公開をブロックします。規制対象の職業(医師、歯科医、弁護士、薬剤師):レビューなし、成功を主張する表現なし(references/01 §4)。
  2. 単一の情報源: site-facts.json(デプロイフォルダーの外)。派生ファイル(JSON-LD、サイトマップ、llms.txt、robots、マニフェスト、vCard)は scaffold.mjs derive で再生成され、手動で編集されることはありません。
  3. デザインはクライアントごとに決定され、以前のサイトからコピーされることはありません:docs/DESIGN.md を書き、ユーザーに 1 つの方向性を選んでもらい、それからコーディングします(references/02)。
  4. 最初の行から CSP クリーン: インラインスクリプト/スタイル/ハンドラーなし。すべてのサードパーティは、同じ変更で CSP に追加されます。1 つの強制された CSP。
  5. 同意またはクリックの前にサードパーティリクエストなし。 GA4 は「Αποδοχή」の後にのみ読み込まれます。Accept/Reject は同等。地図はクリック時に読み込み。フォントはセルフホストで、ギリシャ文字のグリフが確認されているもの(多くの人気フォント、例:Poppins/Montserrat にはありません)。
  6. 幅ごとのパッチではなく、根本的な原因を修正します。 モバイルファースト。scripts/overflow_probe.js で幅マトリックスをテストします。
  7. サーバーディレクティブを信頼しないでください。 Hostinger/LiteSpeed は <IfModule> を無視し、サポートされていないディレクティブを静かに無視し、エッジで HTTPS を強制します:verify_live.mjs でライブで確認します。
  8. SEO ファイルは成果物です: 正規URL、robots(Allow: / + Sitemap)、サイトマップ、JSON-LD(LocalBusiness サブタイプ)、OG 1200×630、マスク可能なアイコンを含むアイコン。
  9. CSS/JS の変更後は毎回 ?v= を更新し(bump_version.mjs)、Hostinger のキャッシュをパージします。
  10. 確認し、想定しないでください。 最終ファイルの監査で 0 エラー、ブラウザ QA が完了し、未確認の内容を正直に報告した後にのみ「完了」と言います。

落とし穴(正しく見えるが時代遅れまたは誤った信念)

  • FAQPage/HowTo マークアップは効果がありません。FAQ リッチリザルトは 2026 年 5 月 7 日に廃止されました。llms.txt には実証済みの効果はありません(Google は使用していないと述べています):オプション。
  • ビジネス自体に aggregateRating/review JSON-LD を追加しないでください。sameAs は、実際にアクティブなプロファイルにのみ使用します(空のセカンドドメインには使用しない)。
  • ステージング環境の Disallow: / または noindex を本番環境に残すと、サイトがインデックスから削除されます(監査 SEO-001/023)。
  • Hostinger のプレビュードメイン *.hostingersite.com はサイトを複製します:301 リダイレクトして削除します。
  • ドットなしの htaccess は無視されます。ドットがある場合は、明示的にアップロードする必要があります(隠しファイル)。Docs/facts/.md は public_html に配置してはいけません。
  • Google Fonts CDN リンクはプライバシーと CSP を破ります。Poppins/DM Sans/Playfair などを提案するフロントエンドデザインのアドバイスは、ギリシャ語では機能しません。
  • ファイルと大文字小文字のみが異なるリンクは、Windows では機能し、サーバーでは 404 になります。
  • JS 内に組み込まれたアンカー(Cookie バナー → /privacy.html#cookies)も存在する必要があります。
  • 約 60 の高速リクエスト後のエッジボットチャレンジは、サイトの障害ではありません:待機し、バイパスしないでください。

ワークフロー(各ステップを実行する前に、名前付きのリファレンスを読み込んでください)

  1. トリアージ: 新規サイト · 再構築 · 監査のみ(6 へジャンプ) · 小さな変更(5 へジャンプ)。どのツールが存在するか確認します(deno/node、ブラウザツール、ffmpeg、Edge/Chrome for render_png)。
  2. インテーク → references/01-intake-and-facts.md を読みます。すべてを 1 つのギリシャ語メッセージで尋ねます(誰も答えられない場合は、与えられた事実のみを使用し、決して捏造せず、QUESTIONS.md を書きます)。assets/site-facts.example.json から site-facts.json を書き込みます。scaffold.mjs check --facts site-facts.json を実行します。
  3. デザインブリーフ → references/02-design-direction.md;docs/DESIGN.md を埋め、2〜3 の方向性を提案し、選択を得ます。
  4. スキャフォールド: scaffold.mjs init --facts site-facts.json --out public --docs docs [--logo logo.svg](ページ、ベース CSS、JS、.htaccess(CSP 含む)、robots、サイトマップ、llms.txt、マニフェスト、vCard、ギリシャ語ハンドオフドキュメント、プロジェクト用の AGENTS.md/CLAUDE.md を作成します)。
  5. ビルド → references/03-build-and-code.md、04-conversion-and-content.md、05-seo-schema-geo.md:style.css のトークン + THEME、index.html のセクション([ΧΡΕΙΑΖΕΤΑΙ…] マーカーを置き換える)、make_icons.mjs、render_png.mjs(HTML ページからの OG 画像)、images.mjs、font_greek_check.mjs --download を使用したアセット。同意、プライバシーテキスト、フッター ID、価格、またはレビューの場合は、06-privacy-consent-legal.md も読みます。品質基準の完成した架空の例は assets/example-site/ にあります(構造とコピーのトーンを研究し、見た目をコピーしないでください)。
  6. 事実の変更後: 事実 → scaffold.mjs derive → 表示テキスト → bump_version.mjs。
  7. 監査: audit_site.mjs public --facts site-facts.json → すべての ERROR を修正し、WARN を読み、所有者に VERIFY リストを渡します。不明な発見 → references/mistake-registry.md。
  8. QA とローンチ → references/08-qa-and-launch.md(幅マトリックス、同意テスト、コンテンツ QA)。デプロイとサーバーの詳細は references/07-server-htaccess-deploy.md にあります。
  9. デプロイ後: verify_live.mjs https://DOMAIN --local public --preview-domain X.hostingersite.com を実行します。所有者に docs/ を渡します。 フォーム、予約、追加ページ、CMS、E ショップ、他の言語、広告ピクセル → references/09-beyond-the-basics.md を参照し、最初にスコープに同意します。

スクリプト(scripts/)

audit_site.mjs ローンチ前監査(ERROR/WARN/VERIFY/INFO;--json、--strict;エラー時に exit 1) · verify_live.mjs ライブチェック(リダイレクト、ヘッダー、404、公開ファイル、バイト同一性;スロットリングあり) · 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(ページ内で実行)。すべて、引数なしで呼び出された場合に --help スタイルの使用法を表示します。渡されたフォルダー内にのみ書き込みます。

リファレンスインデックス

01 インテーク/事実/規制対象職業 · 02 デザインの方向性、ギリシャ語フォント · 03 ビルド、パフォーマンス、アクセシビリティ、幅 · 04 コンバージョンとコピー · 05 SEO/スキーマ/GBP/AI 検索 · 06 プライバシーとギリシャ法のポイント · 07 Hostinger サーバーとデプロイ · 08 QA/ローンチ · 09 基本を超えて · ミスレジストリ。調査日:2026 年 10 月 5 日。法律と Google ポリシーは変更されます:依存する前に再確認し、何かが未確認である場合はその旨を伝えてください。

関連スキル