name: publicar-landing description: 승인된 랜딩 페이지를 고객의 서브도메인에 배포하며, 코드 수정 없이 텍스트와 이미지를 변경할 수 있는 편집 패널을 제공합니다. landing-b2b-index-html, landing-vsl-directa-index-html, landing-inmueble-copy-html, landing-vsl-directa, landing-b2b-alto-ticket 또는 landing-conversion(및 해당 copy+html 버전) 스킬이 생성한 HTML을 가져와 정적 Astro + Keystatic 프로젝트(SSR 없음, 어댑터 없음)로 변환하고, GitHub에 푸시한 후 Cloudflare Pages에 배포합니다(푸시할 때마다 자동 빌드). 모든 고객을 위한 단일 호스팅: Pages는 모든 DNS의 CNAME을 허용하므로 고객의 호스팅은 중요하지 않습니다. Keystatic 패널은 로컬에서 실행되며 배포되지 않습니다(로컬 스토리지). 따라서 GitHub App과 비밀 키가 필요 없습니다. 감사 페이지, 측정(GTM, 픽셀, Microsoft Clarity. 모두 쿠키 동의 후에만 로드됨), GDPR 준수 쿠키 알림 및 Cloudflare D1의 동의 기록(필수, AEPD가 증거를 요구할 수 있음)을 포함합니다. 랜딩 페이지당 하나의 서브도메인. 카피나 목업을 생성하지 않습니다. 이 작업은 랜딩 페이지 스킬이 수행합니다. 사용자가 목업 승인 후 '랜딩 페이지를 게시', '서브도메인에 올려', '온라인에 띄워'라고 말할 때, 또는 다른 랜딩 페이지 스킬이 종료 시 호출할 때 사용합니다. 다중 페이지 기업 웹사이트에는 사용하지 마십시오.
편집 패널과 함께 서브도메인에 랜딩 페이지 게시
이미 승인된 랜딩 페이지를 배포된 패널 사이트로 변환합니다. 카피를 작성하거나 리디자인하지 않습니다. 들어가는 것은 승인된 HTML이고, 나오는 것은 작동하고 측정하며 합법적인 URL입니다.
황금률
목업에 대한 사용자의 명시적 승인 없이는 아무것도 배포되지 않습니다. 랜딩 페이지가 아직 승인되지 않은 경우, 중단하고 해당 랜딩 페이지 스킬에 제어권을 반환합니다.
실행 방법: 자동 조종
디렉시온은 질문에 답하고 싶어하지 않습니다. 스스로 결정하고 진행하세요. 다음 모든 사항은 이미 해결되었으며 질문하지 않습니다:
- 사용할 호스팅 →
dig +short NS에 의해 결정됩니다(0.5단계). - 프로젝트 이름 → 고객의 케밥 케이스 + 각도(
Cliente14-metodo). - 편집 가능한 항목 → 헤드라인, 부제목, 글머리 기호, 버튼 텍스트, 불안 해소, 단계, 리뷰, FAQ, 수치, 이미지, 측정 ID, 쿠키 알림 텍스트 및 감사 페이지의 모든 콘텐츠.
- 감사 페이지 및 데이터베이스 구축 → 기본 포함이며, 추가로 질문하는 사항이 아닙니다.
- 리포지토리 생성, 배포, DNS 레코드 생성, SSL 활성화, 호스팅 워터마크 제거 → 수행하며, 문의하지 않습니다.
- 고객 DNS에 CNAME 또는 TXT 추가 → 추가 작업이며, 수행합니다(0.5단계 참조).
합법적인 중단 세 가지:
- 승인된 HTML이 명확하지 않거나 후보가 여러 개인 경우. 어떤 것인지 묻고 추측하지 마십시오. 디스크에서 가장 명백한 파일이 오래된 버전일 수 있습니다. 의심스러우면 붙여넣도록 요청하세요.
- 발명할 수 없는 데이터가 누락된 경우: GTM 또는 픽셀 ID, 비디오 임베드, 전화번호. 요청하세요. 절대 플레이스홀더로 채우지 마십시오.
- 비밀 또는 결제.
client_secret, 비밀번호 및 구매는 절대 건드리지 마십시오(8단계 참조).
그 외 모든 것은: 진행하고, 마지막에 수행된 사항을 알립니다.
계정, 세션 및 브라우저(2026-09-11 확인)
각 항목에 어떤 계정과 어떤 Chrome이 있는지 알면 세션 시간을 절반으로 줄일 수 있습니다. 비밀번호는 당신을 통과하지 않습니다. 액세스에 비밀번호나 코드가 필요한 경우 중단하고 디렉시온에게 전달합니다.
계정
| 서비스 | 계정 | 용도 |
|---|---|---|
| GitHub | <github-username> (SSH 이미 구성됨) | 랜딩 페이지 리포지토리. ssh -T [email protected]으로 확인 |
| Cloudflare | <work-account-email> | Pages: 모든 랜딩 페이지가 여기에 있습니다. 이미 <github-username>의 GitHub 앱이 연결되어 있습니다. |
| Netlify | ⚠️ 두 개의 계정, 혼동하지 마십시오 | 이전 사이트를 밖으로 마이그레이션하는 데만 사용합니다. 새 항목은 배포되지 않습니다. |
↳ <work-account> 팀 | <work-account-email> | 크레딧 없음("operational credits"): 배포가 일시 중지됨 |
↳ Fb 팀 | <direccion-email> | tiseraconstrucciones.com 보유, 무료 요금제, 마이그레이션 대기 중 |
| Clarity | 랜딩 페이지당 하나의 프로젝트 | clarity.microsoft.com에서 생성됨. ID가 패널로 이동 |
두 개의 Chrome
일반적으로 연결된 두 개의 브라우저가 있습니다. 각각의 세션:
| Chrome | 세션 |
|---|---|
<work-account> | Cloudflare, GitHub, Netlify <work-account> 팀 |
<direccion-email> | 클라이언트의 Sered 클라이언트 영역, Typeform, Netlify Fb 팀 |
- 디렉시온에게 deviceId 중에서 선택하도록 하지 마십시오. 그들에게는 아무 의미가 없습니다.
switch_browser를 사용하고 한 줄로 알리십시오: "Connect 버튼이 나타나면, X가 열려 있는 쪽을 누르세요." - 웹사이트에서 로그인을 요청하고 해당 Chrome에 저장된 계정이 없으면, 묻기 전에 다른 브라우저를 시도하십시오.
- Google이 계정 선택기를 표시하면 계정을 선택하는 것은 비밀번호를 입력하는 것이 아닙니다: 수행할 수 있습니다. 이후에 비밀번호나 코드를 요청하면 중단합니다.
🚨 Sered는 고객의 계정입니다
Chrome <direccion-email>의 Sered 클라이언트 영역은 고객으로 로그인되어 있습니다(클라이언트 14의 경우, "환영합니다, Alejandro").
내부에서는 랜딩 페이지의 레코드만 만집니다(CNAME 및 확인 TXT). 직접 생성하지 않은 영역은 건드리지 마십시오.
경로: 클라이언트 영역 → cPanel에 로그인 → Zone Editor → Manage (도메인).
🚨 Netlify 사이트 삭제는 해당 사이트를 소유한 계정이 필요합니다
Chrome이 다른 팀에 로그인되어 있으면 프로젝트가 존재함에도 Page not found가 표시됩니다. 로그아웃(app.netlify.com/logout)하고 Google로 다시 로그인하여 올바른 계정을 선택해야 합니다. 그러면 해당 Chrome에서 다른 계정의 세션이 종료됩니다: 디렉시온에게 알리십시오.
🚨 React 양식 필드: form_input, 입력하지 마십시오
React로 만들어진 패널(Keystatic 어시스턴트, Pages 양식)에서 computer type으로 입력하면 화면이 하얗게 변합니다. form_input이 값을 직접 설정하고 작동합니다. form_input이 변경하지 않는 드롭다운의 경우 클릭하여 열고 옵션을 선택합니다.
0단계 — 필요한 데이터
- 승인된 HTML. 다른 스킬에서 연결된 경우, 이미 조립된
index.html입니다. 디스크에서 찾는 경우 최신 버전인지 확인하십시오:grep -rl --include="*.html" -i "<client>" ~/Desktop ~/Downloads로 검색하고, 두 개 이상 나타나거나 수업 자료나 고객 폴더가 아닌 폴더에 있는 것처럼 보이면 질문하십시오. 이전 버전을 게시하면 전체 변환을 다시 해야 합니다. - 프로젝트 이름 (케밥 케이스,
Cliente14-metodo). 리포지토리 및 호스팅 프로젝트의 이름입니다. - 서브도메인 (
metodo.cliente.com). DNS가 어디 있는지 묻지 마십시오. 직접 알아냅니다. - 랜딩 페이지에서 사용하는 양식: Tally 또는 Typeform. 묻지 말고 HTML에서 확인하십시오(
grep -oE "data-tf-live|data-tally-src"). 임베드, 숨겨진 필드 및 웹훅을 변경합니다(9단계). - Google Tag Manager 및/또는 Meta 픽셀 ID(있는 경우)(3단계).
- 고객의 파비콘 및 로고(있는 경우)(4단계).
변환하기 전에 HTML에서 채워지지 않은 플레이스홀더를 검사하십시오:
# 파일은 필수입니다: 없으면 grep이 stdin을 읽어 세션을 중단시킵니다.
grep -nE '\{\{[A-Z0-9_]+\}\}|VIDEO_ID|SUBDOMINIO|TODO:|XXXX|LOREM|placeholder|Lorem ipsum' <file.html>
⛔ [A-Z0-9_], 숫자 포함. 여기에 있던 정규식은 [A-Z_]+였고 회사의 플레이스홀더에는 숫자가 포함되어 있습니다: 테스트 결과, {{H1_LINEA_1}}, {{FUD_1}}, {{VP_1_TITULO}}, {{URL_LOGO_PRENSA_1}} 및 {{SUBDOMINIO}} 중 마지막 것만 캡처했습니다. 즉, "플레이스홀더가 절대 게시되지 않도록" 하는 기존 제어 장치가 게시 직전에 다섯 개 중 네 개를 통과시켰습니다.
발견되는 모든 사항은 해당 섹션을 차단하며 질문합니다. 플레이스홀더는 절대 게시되지 않습니다.
⛔ 0.5단계 — 호스팅: 단일 경로(2026-09-11)
랜딩 페이지는 정적입니다. SSR, 어댑터, 결정할 사항이 없습니다.
이전에는 고객의 DNS 위치에 따른 결정 트리가 있었습니다. 더 이상은 아닙니다. Cloudflare Workers의 Custom Domains가 Cloudflare 내의 DNS 영역을 요구했기 때문에 존재했으며, 이는 서버가 필요한 경우에만 중요합니다. 랜딩 페이지에는 필요하지 않습니다.
| 구성 요소 | 실행 위치 |
|---|---|
| 랜딩 페이지 | 정적 HTML |
| 양식 | Tally/Typeform iframe, 브라우저에서 |
| 측정(GTM/픽셀) | 브라우저 |
| 쿠키 알림 | localStorage |
| 리드 | 양식에서 CRM으로, 당사를 거치지 않음 |
| Keystatic 패널 | 로컬, npm run dev. 배포되지 않음 |
호스팅: Cloudflare Pages. 항상, 고객의 호스팅에 관계없이. Pages는 모든 DNS(Sered, IONOS, Hostinger, GoDaddy, 로컬 호스팅의 cPanel 등)의 CNAME을 허용하며, SSR이 없으므로 더 이상 지원되지 않는 어댑터가 필요하지 않습니다.
무료 요금제: 월 500빌드, 100개 프로젝트, 프로젝트당 100개 도메인, 대역폭 무제한.
⚠️ Netlify를 사용하지 않는 이유(2026-09-11 확인, 반복하지 마십시오)
Netlify는 크레딧으로 전환되었습니다: 무료 요금제에서 월 300, 프로덕션 배포당 15 크레딧. 계정의 모든 웹사이트에 대해 월 20회 배포입니다. 패널에 누군가 저장할 때마다 커밋 및 배포가 발생합니다.
그러나 심각한 것은 한도가 아닙니다: 크레딧이 소진되면 Netlify는 모든 웹사이트를 일시 중단하고 방문자는 Site not available을 보게 됩니다. 무료 요금제에서는 하드 한도이며, 더 구매할 수 없습니다. 활성 캠페인이 있는 고객의 랜딩 페이지가 다운됩니다. 이는 단순한 불편이 아니라 고객 작업에 부적합합니다.
⚠️ Vercel을 사용하지 않는 이유(확인됨, 반복하지 마십시오)
Vercel의 무료 요금제(Hobby)는 비상업적 용도로만 사용할 수 있습니다. 자체 문서: "Hobby 요금제는 비상업적, 개인 용도로만 사용자를 제한합니다." 고객의 랜딩 페이지는 상업적 용도이므로 Pro(사용자당 월 20달러)가 필요합니다.
알아내야 할 유일한 것: DNS가 어디에 있는지
호스팅은 DNS와 다릅니다. 네임서버가 중요합니다. 고객은 Sered에 웹사이트를 두고 Cloudflare에 NS를 둘 수 있으며, 이 경우 Sered 패널은 쓸모가 없습니다.
dig +short NS <customer-domain>
이것은 어떤 패널에 액세스를 요청해야 하는지 알려주며, 자격 증명 없이 조회할 수 있습니다. 종종 액세스가 필요하지 않습니다. 이미 작성된 레코드를 전달하면 고객이나 해당 IT 담당자가 2분 안에 생성합니다.
🚨 cPanel 및 Plesk는 CNAME을 깨는 A 레코드를 생성합니다
서브도메인을 생성할 때 cPanel 및 Plesk는 자동으로 서버를 가리키는 A 레코드를 생성합니다. CNAME은 동일한 이름의 A 레코드와 공존할 수 없습니다. 이것이 DNS의 작동 방식이며, 패널의 변덕이 아닙니다.
해당 A 레코드를 삭제해야 합니다. 그렇지 않으면 CNAME이 절대 확인되지 않습니다. 패널이 모든 것을 "올바르게" 표시하기 때문에 가장 많은 시간을 낭비하는 실수입니다.
고객 DNS에 관한 규칙
- 네임서버 이동을 첫 번째 옵션으로 제안하지 마십시오. 고객의 이메일(MX), 웹사이트 및 확인(TXT)이 여기에 달려 있습니다. 레코드를 잘못 복제하면 고객의 이메일이 중단됩니다. 이것은 마지막 수단이며, 명시적 승인을 받아야 합니다.
- 새 CNAME 또는 TXT를 추가하는 것은 DNS를 이동하는 것이 아닙니다. 추가적입니다. MX나 기존 웹사이트에 영향을 주지 않습니다. 이 작업은 과장하지 않고 수행합니다.
- 새 도메인 구매는 옵션이 아닙니다. 절대. 제안하지 마십시오. 플랜 B로도 안 됩니다. 랜딩 페이지는 항상 고객이 이미 가지고 있는 도메인의 서브도메인에 연결됩니다.
- 의문이 있을 때 설명하는 방법:
"오늘 존재하지 않는 서브도메인에 대한 새 레코드입니다. 아무것도 수정하거나 삭제하지 않습니다. 이메일(MX), 웹사이트 및 확인은 그대로 유지됩니다. 문제가 발생하면 해당 레코드를 삭제하면 모든 것이 원래대로 돌아갑니다."
- 고객 패널에 실제로 액세스할 수 없는 경우 랜딩 페이지는
<project>.pages.dev에 남아 있으며 캠페인은 이 주소로 시작됩니다. 임시 방편이며 사전에 알리지만 이를 해결하기 위해 도메인을 구매하지는 마십시오. - 고객 자격 증명: 직접 처리하지 마십시오. 생성할 정확한 레코드를 알려주고 이후에 확인됩니다. 액세스는 디렉시온 또는 고객이 사용합니다.
🚨 서브도메인을 생성하기 전에 조회하지 마십시오
dig +short metodo.cliente.com # ⛔ 레코드를 생성하기 전에 이 작업을 수행하지 마십시오
많은 제공업체의 SOA는 86400초(24시간)의 네거티브 캐싱을 설정합니다. 서브도메인이 존재하기 전에 조회하면 리졸버는 "존재하지 않음"을 하루 동안 캐시합니다(귀하의 리졸버와 때로는 인증 기관의 리졸버). 결과적으로 인증서가 지연되거나 실패하여 구성 오류처럼 보입니다.
서브도메인을 조회하지 않고 SOA를 확인하여 무엇을 직면했는지 확인하십시오:
dig +short SOA <domain> # 마지막 숫자는 네거티브 캐싱 TTL입니다.
1단계 — 프로젝트 설정
최소 스택. Tailwind 및 Fontsource 없음: 랜딩 페이지 스킬은 !important가 포함된 일반 CSS를 생성하고 마스터 블록에 자체 글꼴을 제공합니다. Tailwind를 추가하면 버그만 발생합니다.
그리고 어댑터도 없습니다. @astrojs/netlify 또는 @astrojs/cloudflare를 설치하지 마십시오. 출력은 정적입니다.
npm create astro@latest <project> -- --template minimal --install --no-git --skip-houston --yes
cd <project>
npm install @keystatic/core @keystatic/astro @astrojs/react react react-dom @astrojs/sitemap zod
npm install -D @astrojs/check typescript
실행하여 확인된 버전(2026-09-11): astro 7.3.2 · @keystatic/core 0.6.9 · @keystatic/astro 6.0.0 · @astrojs/react 6.0.5 · react 19.3.0.
astro.config.mjs — 유일한 버전
// @ts-check
import { defineConfig } from 'astro/config';
import react from '@astrojs/react';
import keystatic from '@keystatic/astro';
import sitemap from '@astrojs/sitemap';
// Keystatic는 개발 시에만 사용됩니다. 빌드 시 순수 HTML 출력: /api 경로, React 런타임, 어댑터가 없습니다.
// 패널은 로컬에서 사용되며 커밋됩니다.
const isDev = process.argv.includes('dev');
export default defineConfig({
// 서브도메인이 존재할 때까지 호스팅의 실제 URL을 가리킵니다.
// 확인되지 않는 site:는 표준 및 사이트맵에 잘못된 항목을 내보냅니다.
...
(계속됨...)