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를 쓰고 방향을 하나로 정하며, CSP를 지키고 동의 전에는 서드파티를 불러오지 않고, audit_site.mjs 오류 0과 실제 도메인에서 verify_live.mjs 통과 전에는 완료라고 하지 않습니다. 완성된 예시 사이트, 화면 폭별 넘침 검사, OG 이미지 렌더러, 아이콘 생성기 포함. 쇼핑몰이나 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. 절대 사실을 지어내지 마십시오. 전화, 이메일, 주소, ΑΦΜ, ΓΕΜΗ, 영업 시간, 가격, 리뷰, 평점, 업력, 라이선스, 보증, 도착 시간은 소유자가 제공합니다. 누락 시 → 물어보거나 생략하고, [ΧΡΕΙΑΖΕΤΑΙ: …] 마커는 라이브 전환을 차단합니다. 규제 직종(의사, 치과의사, 변호사, 약사): 리뷰 금지, 성공 주장 금지(참고문헌/01 §4).
  2. 단일 진실 공급원: site-facts.json(배포 폴더 외부). 파생 파일(JSON-LD, 사이트맵, llms.txt, robots, manifes, vCard)은 scaffold.mjs derive로 재생성되며, 수동 편집 금지.
  3. 디자인은 고객별로 결정되며 이전 사이트에서 복사하지 않음: docs/DESIGN.md 작성, 사용자가 하나의 방향을 선택한 후 코딩(참고문헌/02).
  4. 처음부터 CSP-클린: 인라인 스크립트/스타일/핸들러 없음; 모든 타사는 동일한 변경에서 CSP에 추가; 하나의 강제 CSP.
  5. 동의 또는 클릭 전에 타사 요청 금지. GA4는 "Αποδοχή" 이후에만 로드됨; 수락/거절 동등; 지도는 클릭 시 로드; 글꼴은 자체 호스팅되며 그리스어 글리프 확인 필요(많은 인기 글꼴(예: Poppins/Montserrat)에 없음).
  6. 너비별 패치가 아닌 근본 원인 수정. 모바일 우선; scripts/overflow_probe.js로 너비 매트릭스 테스트.
  7. 서버 지시문을 신뢰하지 마십시오. Hostinger/LiteSpeed는 <IfModule>을 무시하고, 지원되지 않는 지시문을 자동으로 무시하며 가장자리에서 HTTPS를 강제합니다. verify_live.mjs로 라이브 확인.
  8. SEO 파일은 결과물: 표준, 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 내부에 구축된 앵커(쿠키 배너 → /privacy.html#cookies)도 존재해야 함.
  • 약 60개의 빠른 요청 후 가장자리 봇 차단은 사이트 오류가 아님: 기다리세요, 우회하지 마십시오.

워크플로우 (각 단계를 수행하기 전에 명명된 참고문헌을 로드)

  1. 분류: 새 사이트 · 재작업 · 감사 전용(6단계로 이동) · 소규모 변경(5단계로 이동). 어떤 도구가 있는지 확인(deno/node, 브라우저 도구, ffmpeg, Edge/Chrome for render_png).
  2. 인테이크 → references/01-intake-and-facts.md 읽기. 모든 것을 하나의 그리스어 메시지로 물어보기(아무도 답할 수 없으면 주어진 사실만 사용, 절대 지어내지 말고 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, 기능에서 CSP가 포함된 .htaccess, robots, 사이트맵, llms.txt, manifes, 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. 사실 변경 후: facts → 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, 전자상거래, 다른 언어, 광고 픽셀 → 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-05; 법률 및 Google 정책은 변경됨: 의존하기 전에 재확인하고, 확인되지 않은 사항이 있으면 말하세요.

관련 스킬