Communitygithub.com

Landing Launch — Cloudflare 호스팅, 전환 이벤트, 리드 폼

완성된 랜딩 페이지의 런칭을 준비합니다. Workers 정적 호스팅, 쿠키 없는 Web Analytics, 단 하나의 CTA 전환 이벤트, 작동하는 리드 폼 Worker, 선택적 A/B 테스트, landing/launch.md 체크리스트까지. 모두 로컬에서 먼저 테스트하며 사용자 승인 없이는 배포하거나 DNS를 건드리지 않습니다.

Landing Launch — Cloudflare 호스팅, 전환 이벤트, 리드 폼란 무엇인가요?

Landing Pages 레시피 3단계(출시): Im-Fran/landing-skills의 landing-launch. 빌드 결과물과 landing/brief.md를 읽고 스택(순수 HTML, Astro, Vite/React, Next.js)을 파악한 뒤 호스팅 설정, 폼 Worker, 분석 스니펫, Workers Analytics Engine 전환 카운터를 작성합니다. Cloudflare 명령은 2026-10-04 문서와 대조했고 Wrangler 4.147.0으로 실행 확인했습니다. 재확인을 권하고 Cloudflare 외 경로도 제공하며, 개인정보 고지와 연락처는 제공될 때까지 눈에 띄는 플레이스홀더로 둡니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-launch

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

랜딩 페이지 런칭

빌드된 랜딩 페이지를 런칭할 준비를 합니다: 호스팅, 페이지 분석, 하나의 콜투액션에 대한 전환 이벤트, 작동하는 리드 폼, 선택적 A/B 테스트, 그리고 런칭 체크리스트를 포함합니다. 이 스킬은 모든 것을 로컬에서 준비하고 테스트합니다. 사용자의 승인 없이는 배포하거나 DNS를 변경하지 않습니다.

Cloudflare 명령어, 구성 키 및 한도는 변경됩니다. 여기에 포함된 내용은 2026-10-04 기준 Cloudflare 문서와 Wrangler 4.147.0으로 실행된 Worker 코드를 확인한 것입니다. 명령어나 한도에 의존하기 전에 현재 Cloudflare 문서에서 확인하고, 이 스킬과 문서가 다를 경우 문서를 신뢰하세요.

입력

먼저 파일을 읽고 사용자가 열어둔 정보에 대해서만 한 번의 메시지로 질문하세요.

입력위치누락된 경우
빌드된 페이지, /thanks/ 및 /form-error/ (폼이 이 스킬의 Worker로 전송될 때)빌드 출력 (dist/, public/, 내보내기 폴더), landing-skills:landing-build에 의해 작성됨빌드를 실행합니다. 페이지가 아직 없으면 중단하고 페이지가 먼저 필요하다고 말합니다 (landing-skills:landing-build).
전환 액션: 폼, 외부 페이지, 폼의 필드, 엔드포인트 상태 (없음 또는 URL), 또는 외부 URLlanding/brief.md의 Conversion action페이지에서 읽습니다: 폼의 action과 모든 필드의 name, 또는 기본 링크. 한 가지 질문으로 사용자에게 확인합니다.
폼이 제출하는 모든 필드 name과 엔드포인트 상태빌드 핸드오프; 그렇지 않으면 빌드된 폼의 name 속성빌드된 폼에서 읽습니다.
도메인landing/brief.md의 Domain질문합니다. unknown으로 남아 있으면 workers.dev 주소를 사용하고 도메인 항목을 보류로 표시합니다.
/form-error/ 및 푸터용 연락처 경로landing/brief.md의 Contact routes질문합니다. 답변을 받을 때까지 [PLACEHOLDER: ...]를 표시하고 항목을 보류 상태로 둡니다.
폼, 감사 및 오류 메시지landing/copy.md페이지 언어로 짧고 간결한 메시지를 작성하고 사용자 승인을 위해 나열합니다.
호스팅 선택사용자Cloudflare를 권장합니다 (아래 참조). 거절하면 Cloudflare 사용 안 함으로 이동합니다.
개인정보 고지페이지 푸터 및 폼사용자에게 요청합니다. 그때까지 [PLACEHOLDER: ...]를 표시하고 항목을 보류 상태로 둡니다. 절대 임의로 생성하지 마십시오.

이 스킬이 작성하는 것: 호스팅 구성, 필요한 경우 폼 Worker, 분석 스니펫 및 전환 이벤트, 체크리스트가 포함된 landing/launch.md. 복사본을 작성하거나 빌드된 페이지를 다시 작성하지 않습니다.

구성을 작성하기 전에 스택(일반 HTML, Astro, React를 사용한 Vite, Next.js)과 출력 폴더를 식별하세요.

권장 사항

세 가지 작업 모두에 Cloudflare를 제안하고 그 이유를 다음과 같이 설명하세요:

  • 호스팅: Workers 정적 자산이 페이지를 제공합니다. 정적 요청은 무제한이며 무료 플랜에서 무료입니다. Cloudflare는 새 프로젝트에 Pages보다 Workers를 권장합니다. 동일한 프로젝트가 폼용 소형 Worker를 실행할 수 있으므로 페이지에 다른 백엔드가 필요하지 않습니다.
  • 분석: Cloudflare Web Analytics는 쿠키나 핑거프린팅 없이 트래픽과 Core Web Vitals를 측정합니다. 사용자 지정 이벤트가 없으므로 전환은 동일한 계정의 Workers Analytics Engine에서 Worker가 계산하며, 무료 플랜에서 무료입니다.
  • A/B 테스트: 동일한 Worker가 페이지가 제공되기 전에 에지에서 변형을 할당할 수 있습니다. 클라이언트 측 테스트 스크립트, 깜빡임이 없으며 JavaScript가 꺼져 있어도 작동합니다.

비용도 명시하세요: 사용자 지정 도메인은 도메인의 DNS를 Cloudflare에 두어야 하며, Worker를 실행하는 모든 요청은 무료 플랜에서 하루 100,000회로 제한됩니다.

프로세스

  1. 입력을 읽습니다. landing/brief.md에서 전환 액션(폼 또는 외부 페이지, 필드, 엔드포인트 상태), 도메인 및 연락처 경로를 가져옵니다. 빌드된 페이지에서 모든 폼(action 및 필드 이름)과 모든 콜투액션 링크를 기록합니다. 누락된 항목에 대해서만 질문합니다.

    그런 다음 케이스를 선택하여 추가할 내용을 결정합니다:

    • 폼, 엔드포인트 없음 (/api/lead로 전송되며 아직 제공되는 것이 없음): 폼 Worker, 4단계 및 5단계.
    • 폼, 엔드포인트 있음: 폼 Worker 및 Turnstile이 없습니다. 폼이 해당 엔드포인트로 전송되는지 확인하고 결과 페이지가 반환되는 것과 일치하는지 확인합니다. 유효성 검사 및 스팸 방지가 해당 엔드포인트의 작업임을 기록합니다.
    • 외부 페이지 (체크아웃, 예약, 앱 스토어): 처리할 폼이 없습니다. 링크는 실제 URL로 연결되며 클릭은 5단계의 비콘으로 계산됩니다. 체크리스트의 폼 항목은 n/a입니다.
  2. 먼저 막다른 길을 수정합니다. 빌드에서 액션이 없거나 제출이 취소된 폼, 감사 메시지만 표시하는 제출 핸들러, 빈 #에 대한 링크, 그리고 해당 섹션에 대한 링크 버튼을 검색합니다. 이러한 각각은 전환이 존재하지 않음을 의미합니다. 폼은 4단계에서 Worker 엔드포인트를 얻습니다. 링크는 사용자의 실제 URL 또는 [PLACEHOLDER: ...]와 보류 중인 체크리스트 항목을 얻습니다.

  3. 호스팅 구성. 스택에 맞게 wrangler.jsonc를 작성하고, 프로젝트에 Wrangler를 설치하고, 누락된 경우 404.html을 추가하고, 넣을 내용이 있을 때만 _headers 또는 _redirects를 추가합니다. references/hosting.md를 읽으세요.

  4. 폼 엔드포인트 (폼, 엔드포인트 없음). 폼 Worker를 추가합니다: 서버 유효성 검사, Siteverify를 통한 Turnstile 확인, D1 스토리지, JavaScript 및 no-JavaScript 응답 경로. 빌드의 폼에 Turnstile 위젯을 추가합니다. 빌드의 마크업 및 향상 스크립트를 유지합니다. /thanks/ 및 /form-error/가 존재하는지 확인하고 /form-error/가 브리프의 연락처 경로를 제공하는지 확인합니다. 누락된 경우에만 결과 페이지를 생성하고 절대 덮어쓰지 않습니다: landing-skills:landing-build가 소유합니다. references/forms.md를 읽으세요.

    모든 필드는 처리됩니다. 폼이 제출하는 모든 필드 name을 나열하고 각각에 Worker의 FIELDS 테이블(필수 여부, 길이 제한, 의미 있는 형식 검사, 그렇지 않으면 텍스트와 제한)에 항목을 부여하고, leads 테이블에 컬럼을 부여하며, 이에 맞는 MAX_BYTES를 부여합니다. 유효성 검사 없이 저장되는 것은 없습니다. Worker가 처리하지 않는 제출된 필드는 체크리스트에 실패합니다. Worker는 unknown_field와 함께 해당 POST를 거부하여 테스트에서 격차를 볼 수 있게 하지만 방문자의 제출은 필드가 추가될 때까지 손실됩니다.

  5. 분석 및 전환 이벤트. 모든 페이지에 Web Analytics 스니펫을 추가하고 Analytics Engine에서 전환을 기록합니다: 추가한 경우 폼 Worker에서, 링크의 경우 비콘으로. 기존 엔드포인트의 경우 전환은 해당 엔드포인트의 레코드에서 계산되며 비콘은 옵션입니다. references/analytics.md를 읽으세요.

  6. A/B 테스트, 요청된 경우에만. 코드를 작성하기 전에 하나의 변경 사항, 기준선, 조치를 취할 가치가 있는 최소 차이 및 샘플 크기에 동의합니다. 그런 다음 변형 파일과 A/B Worker를 추가합니다. references/ab-testing.md를 읽으세요.

  7. 로컬에서 테스트합니다. .dev.vars에 Turnstile 테스트 키를 사용하여 npx wrangler dev를 실행하고 curl 및 브라우저로 모든 경로를 실행합니다: 유효한 모든 필드 POST, 잘못된 이메일, 각 필드 제한 초과, 실패한 Turnstile, JavaScript 끄기, 테스트의 경우: 할당, 두 번째 요청 시 고정 쿠키, 전환 엔드포인트. 그런 다음 npx wrangler deploy --dry-run을 실행하고 자산 수와 크기를 확인합니다. 로컬 실행은 계정이 필요하지 않습니다. 계속하기 전에 실패한 항목을 수정합니다.

  8. 승인을 위해 중지합니다. 배포, 미리보기 생성, 사용자 지정 도메인 또는 경로 추가, D1 데이터베이스 생성, d1 execute --remote 실행, 비밀 설정, Turnstile 위젯 생성, Web Analytics에 사이트 추가는 모두 사용자의 Cloudflare 계정을 변경하며, 배포 또는 DNS 변경은 공개적으로 즉시 표시됩니다. 사용자가 검토 중일 수 있고, 도메인이 여전히 이전 사이트를 제공할 수 있으며, 잘못된 DNS 변경은 라이브 사이트를 다운시킬 수 있습니다. 따라서 각 외부 단계를 정확한 명령어와 변경 사항과 함께 나열하고, 사용자가 그 순간에 동의할 때만 각 단계를 실행하세요. 한 단계에 대한 동의는 다음 단계에 대한 동의가 아닙니다. 사용자가 직접 실행하기를 선호하는 경우 명령어를 순서대로 전달하세요.

  9. 배포 후 (사용자와 함께). 라이브 폼을 한 번 제출하고 D1의 행과 Analytics Engine의 전환을 확인하고 Web Analytics가 방문을 표시하는지 확인하며 라이브에서만 확인할 수 있는 체크리스트 항목을 확인합니다.

  10. landing/launch.md를 작성합니다. 호스팅 설정, 전환 액션 및 계산 방법, A/B 계획(있는 경우), 외부 단계 명령어, 각 항목이 done, pending, fail 또는 n/a로 표시되고 done이 아닌 각 항목에 대한 이유가 있는 런칭 체크리스트를 기록합니다. 체크리스트를 사용자에게 보여줍니다.

런칭 체크리스트

이것을 landing/launch.md에 복사하고 모든 줄을 done, pending (reason), fail (reason) 또는 n/a (reason)로 표시하세요. 확인할 수 없는 항목은 done이 아닌 pending입니다. 콜투액션이 외부 페이지인 경우 폼 항목은 n/a입니다.

전환

  • 콜투액션이 작동하는 액션으로 이어집니다: 폼이 /api/lead(또는 사용자의 기존 엔드포인트)로 전송되거나 링크가 사용자의 실제 URL로 연결됩니다. href="#", 자체 앵커, 가짜 성공이 없습니다.
  • 폼이 제출하는 모든 필드 name에 길이 제한과 leads 컬럼이 있는 FIELDS 항목이 있습니다. 처리되지 않은 필드는 통과가 아닌 실패입니다.
  • 기존 엔드포인트의 경우: Accept: application/json에 대해 JSON으로 ok를 응답하고 그렇지 않으면 /thanks/ 또는 /form-error/로 리디렉션하거나 결과 페이지가 반환되는 것과 일치합니다. 유효성 검사 및 스팸 방지는 해당 엔드포인트의 작업으로 기록됩니다.
  • 폼이 이 스킬의 Worker로 전송되는 경우: /thanks/ 및 /form-error/가 존재하고(빌드 자체 페이지, 덮어쓰지 않음), /form-error/는 브리프의 연락처 경로를 제공합니다. 기존 엔드포인트의 경우 페이지는 반환되는 것과 일치합니다. 외부 링크의 경우 n/a입니다.
  • 폼이 로컬에서 테스트됨: 유효한 POST, 잘못된 이메일, 실패한 Turnstile, JavaScript 끄기(/form-error/에 도달).
  • 전송 중에 버튼이 비활성화됩니다. 성공 및 오류는 role="status" 요소에 공지됩니다.
  • 허니팟은 시각 및 보조 기술에서 숨겨집니다.
  • 배포 후 라이브 폼이 한 번 테스트됨. 행이 D1에 있습니다.
  • 사용자가 이메일을 보낼 방법이 없는 한 확인 이메일을 약속하지 않습니다.

측정

  • 모든 페이지에 실제 토큰이 있는 Web Analytics 스니펫이 라이브입니다 (보류: 스니펫이 토큰이 존재할 때까지 HTML 주석에 있음). /thanks/, /form-error/ 및 404.html을 포함합니다.
  • 전환이 Analytics Engine에 기록되며 라이브 테스트 전환이 SQL 쿼리에 표시됩니다.
  • Web Analytics가 라이브 방문을 표시합니다.
  • A/B 테스트 중: 변형별 방문자 및 전환 수가 나타나며 샘플 크기와 종료 규칙이 landing/launch.md에 기록됩니다.

호스팅

  • npx wrangler deploy --dry-run 통과; 자산 파일 20,000개 미만, 각각 25 MiB 미만.
  • 사용자 지정 도메인이 HTTPS를 통해 페이지를 제공합니다. workers_dev는 사용자가 원하는 대로 설정됩니다.
  • _redirects의 리디렉션이 라이브에서 테스트됨.
  • 알 수 없는 경로는 사용자 지정 404.html을 상태 404와 함께 반환합니다.

페이지

  • 제목, 메타 설명, 표준 URL 및 Open Graph 및 소셜 카드 태그가 있습니다. 카드 이미지가 라이브 URL에서 로드되고 링크가 공유 디버거 또는 채팅 앱에 붙여넣어졌을 때 미리보기가 올바르게 보입니다.
  • robots.txt 및 라이브 URL을 나열하는 사이트맵이 있습니다. 결과 페이지 및 미리보기는 noindex입니다.
  • 파비콘이 있습니다.
  • 개인정보 고지가 폼 옆과 푸터에 연결되어 있으며 Turnstile(Cloudflare 스크립트) 및 폼이 저장하는 모든 필드를 이름별로 명명하고 연락처 세부 정보(이메일, 전화 또는 대상이 실제로 사용하는 메시징 채널)와 사이트 운영자를 포함합니다.
  • "쿠키 없음" 진술이 여전히 사실입니다 (A/B 테스트가 쿠키를 설정하는 동안에는 사실이 아님).
  • 모든 [PLACEHOLDER: ...]가 해결됨: 실제 사진 및 스크린샷이 제자리에 있고 가격 및 날짜가 확인됨.

계정 및 비밀

  • 프로덕션 호스트 이름에 대해 Turnstile 위젯이 생성됨. 실제 사이트키가 HTML에 있습니다.
  • TURNSTILE_SECRET이 wrangler secret put으로 설정됨 (절대 커밋되지 않음). .dev.vars* 및 .wrangler/가 .gitignore에 있습니다.
  • 모든 외부 단계가 실행 전에 사용자에 의해 확인됨.

Cloudflare 사용 안 함

빌드는 일반 정적 출력입니다: HTML, CSS, JavaScript 및 자산이 하나의 폴더에 있습니다. 모든 정적 호스트 또는 사용자 자신의 서버가 그대로 제공할 수 있습니다.

사용자가 Cloudflare를 원하지 않는 경우 Cloudflare 파일을 추가하지 마세요: wrangler.jsonc, Worker, Turnstile, Web Analytics 스니펫, .dev.vars 없음. 세션 중에 이전에 추가한 것을 제거하십시오. 그런 다음 바로 런칭 체크리스트로 가서 Cloudflare 제품을 명명하지 않는 항목을 처리하십시오. 폼 및 전환의 경우 체크리스트 항목이 여전히 적용됩니다: 폼은 사용자의 서버 또는 서비스에 실제 엔드포인트가 필요하며 서버에서 유효성이 검사되어야 하고 전환은 계산될 방법이 필요합니다. 누락된 것을 명명하고 보류로 표시하며 도구 선택은 사용자에게 맡깁니다. 이 스킬은 다른 호스트에 대한 레시피를 제공하지 않습니다.

자체 점검

보고하기 전에:

  • 해당 단계에 대한 동의 없이 사용자 계정에 아무것도 배포, 미리보기, 라우팅 또는 생성되지 않았습니다.
  • 모든 구성 변경이 npx wrangler deploy --dry-run을 통과했으며 로컬 curl 확인이 예상 상태 코드를 제공했습니다.
  • Web Analytics가 클릭 또는 전환을 계산한다고 주장하는 파일이 없습니다.
  • 비밀, 토큰 또는 계정 ID가 커밋된 파일에 기록되지 않았습니다.
  • landing/launch.md가 존재하고 모든 체크리스트 줄이 표시되었으며 done이 아닌 각 항목에 이유가 있고 제출된 폼 필드가 처리되지 않은 채로 남아 있지 않습니다.

참고 자료

  • references/hosting.md: 스택별 구성, 명령어, dry run, 사용자 정의 도메인, _redirects 및 _headers, 캐싱, 404, 미리보기. 3단계에서 읽으십시오.
  • references/forms.md: 폼 마크업, 테스트된 폼 Worker, Turnstile 테스트 키를 사용한 로컬 테스트, 프로덕션 설정. 페이지에 폼이 있을 때 4단계에서 읽으십시오.
  • references/analytics.md: Web Analytics 설정, Analytics Engine의 전환 이벤트, 쿼리, 개인정보 보호 진술, 배포 후 확인할 사항. 5단계에서 읽으십시오.
  • references/ab-testing.md: 무료 플랜의 비용, 테스트된...

…[번역을 위해 잘림]

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

관련 스킬