Communitygithub.com

App Landing SEO — 스토어 정보 → 키워드 페이지 출고

모바일 앱 랜딩 엔드투엔드 SEO: App Store/Play 데이터·에셋, 주키워드+롱테일 리서치, SEO 랜딩+키워드별 가이드, GPT Image 가로 피처 이미지, schema FAQ, sitemap/robots, 슬롭 제거 카피로 바로 출고.

App Landing SEO — 스토어 정보 → 키워드 페이지 출고란 무엇인가요?

Landing Pages 3단계(SEO 출고): AustineA/app-landing-seo. 스토어 리스팅을 키워드 랜딩+가이드로 변환.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/AustineA/app-landing-seo/tree/HEAD/skill/app-landing-seo

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

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

문서

App Landing Page SEO

앱 스토어 리스팅을 전환율이 높고 SEO 최적화된 랜딩 사이트로 전환하는 종합 워크플로우입니다. 긴 꼬리 가이드 페이지도 함께 생성합니다. 기본 스택은 Vite + React with build-time prerendering(3단계 아키텍처 참조)입니다. 저장소에 이미 웹 프레임워크(Next.js, Astro)가 있다면 해당 프레임워크 내에서 빌드하고 출력 경로를 조정하세요. 모든 단계는 검증으로 끝납니다.

이 스킬은 동일한 저장소에 포함된 별도로 설치된 gpt-image 스킬에 의존합니다. 가이드 이미지가 필요하면 해당 스킬을 로드하고 지침을 따르세요. 해당 헬퍼가 이 스킬의 디렉토리 내에 있다고 가정하지 마세요.

1단계 — 스토어 리스팅 가져오기 (진실 공급원)

  1. iTunes lookup API에서 전체 메타데이터 가져오기 (인증 불필요):

    curl -s "https://itunes.apple.com/lookup?id=<APP_ID>&country=us"
    

    추출 항목: name, bundleId, description, price/IAP terms, genres, rating count, screenshots, icon, version, seller. Google Play 리스팅도 확인하세요 (play.google.com/store/apps/details?id=<bundleId>) — iOS 전용이라고 가정하지 마세요.

  2. mzstatic 썸네일 접미사를 다시 작성하여 고해상도 에셋 다운로드:

    • 아이콘: 512x512bb.jpg를 1024x1024bb.png로 교체
    • 스크린샷: 392x696bb.jpg를 1284x2282bb.png로 교체 (정상적으로 폴백; file 명령어로 확인)
  3. 모든 스크린샷을 읽기 도구로 읽으세요. 캡션, 가이드 주제 및 랜딩 카피는 스크린샷에 실제로 표시된 내용을 설명해야 합니다. 또한 브랜드 팔레트와 타이포그래피 스타일을 추출하세요.

  4. 저장소 루트에 app.md 작성: 아이덴티티 테이블, 축어적 설명, 리스팅 + 스크린샷에서 파생된 기능 목록, 에셋 매니페스트, 그리고 키워드 연구(2단계) 및 배치 맵을 포함합니다. 이 파일은 이후 모든 작업의 계약서 역할을 합니다.

2단계 — 전환되는 키워드 연구

  • astro MCP 도구가 연결되어 있으면 get_keyword_suggestions와 search_app_store를 사용하여 App Store 인기/난이도 및 현재 순위를 확인합니다. 오늘 앱의 순위를 기록하세요.
  • WebSearch를 사용하여 Google 측 롱테일 키워드를 검증합니다 (랜딩 페이지는 Google에서 순위를 매기며, App Store가 아닙니다).
  • app.md에 결과를 구조화하여 작성:
    • 기본 키워드 (3–5개의 헤드 용어) → title 태그, H1, 히어로 카피, 메타 설명
    • 보조 키워드 → 섹션 H2, 기능 카피
    • 롱테일 키워드 (6–10개의 질문/작업 구문) → 각각 하나의 가이드 페이지
  • 중요한 규칙:
    • 모든 롱테일 키워드는 앱이 확실히 해결하는 문제에 매핑되어야 합니다 — 이상적으로는 스크린샷에서 볼 수 있어야 합니다. 그래야 트래픽이 전환됩니다.
    • 각 헤드 용어에 대한 실제 SERP를 확인하고 오염된 키워드는 건너뛰세요 (예: "stock tracker"는 주식 시장 앱을 반환하고, "inventory management software"는 엔터프라이즈 벤더를 반환합니다).
    • 블로그가 순위를 매기는 방법에 대한 how-to 구문을 선호하세요 — HowTo/FAQ 스키마가 있는 앱 페이지가 블로그를 이길 수 있습니다.

3단계 — 랜딩 페이지 온페이지 SEO

Vite + React SSG 아키텍처 (기본값)

SPA는 JS 렌더링 없이 크롤러에 보이지 않으므로 사전 렌더링된 정적 HTML을 제공하세요. SSG 프레임워크가 필요하지 않습니다 — 약 30줄의 사전 렌더링 스크립트로 충분하며, 페이지는 일반적으로 클라이언트 JS가 전혀 필요하지 않습니다 (자주 묻는 질문 아코디언은 기본 <details> 사용; 상호작용이 없는 것은 하이드레이션하지 마세요):

landing/
  package.json          # build: vite build --ssr src/entry-server.tsx --outDir dist-ssr && node scripts/prerender.mjs
  vite.config.ts        # plugins: [react()], ssr: { noExternal: true }  ← react를 dist-ssr에 번들링하여 prerender.mjs가 독립적으로 가져오기
  index.html            # 개발 전용 셸: <div id="root"> + /src/entry-client.tsx
  public/               # style.css, assets/ (있는 그대로 dist/에 복사됨)
  src/
    data.ts             # 모든 콘텐츠: FAQ 항목, 가이드 본문, 제목, 설명. 단일 진실 공급원.
    seo.ts              # PageMeta 타입 + data.ts에서 읽는 JSON-LD 빌더 (homeJsonld, guideJsonld, breadcrumbJsonld)
    components.tsx      # Header, Footer, StoreBadge, FaqItem, GuideCard, CtaCallout
    pages/              # Home.tsx, GuidePage.tsx, GuidesIndex.tsx
    routes.tsx          # ROUTES: [{ meta: PageMeta, element }] — 페이지당 하나의 항목, 가이드는 data.ts에서 확장
    entry-server.tsx    # renderRoute(route): 전체 HTML 문서 문자열 — head 태그 + JSON-LD + renderToStaticMarkup(body)
    entry-client.tsx    # 개발 전용: matchRoute(location.pathname) → createRoot().render()
  scripts/prerender.mjs # dist-ssr/entry-server.js 가져오기; 라우트당 dist/<path>/index.html + sitemap.xml + robots.txt 작성; cpSync public/ → dist/

이 형태에 포함된 주요 결정 사항:

  • renderToString이 아닌 renderToStaticMarkup 사용 — 하이드레이션 마커 없음, 깔끔한 HTML, 클라이언트 번들이 제공되지 않기 때문.
  • 깔끔한 URL: 라우트 경로는 /로 끝남 (/guides/<slug>/) 및 사전 렌더링은 <path>/index.html을 작성. 내부 링크는 사이트 절대 경로 (/guides/…/)이며, 개발 서버 탐색도 작동.
  • 개발 경험: vite는 HMR과 함께 entry-client.tsx를 제공; 클라이언트 항목은 프로덕션에 제공되지 않음.
  • 수동으로 구축된 head 템플릿에서 esc() 속성 값; JSON-LD는 JSON.stringify 사용 (이스케이프 문제 없음).
  • React 속성은 fetchPriority (camelCase) — 소문자 fetchpriority는 경고를 발생시킴.

온페이지 규칙 (모든 스택)

섹션: 히어로, 다운로드, 스크린샷, 작동 방식, 가이드, FAQ, CTA, 푸터.

  • 정확히 하나의 H1, 기본 키워드를 포함. 섹션 제목은 H2 ("Available On" 스타일 제목은 H1이 아니어야 함).
  • <title> ≈ "브랜드 — 대상 고객을 위한 기본 키워드" (≤60자). 메타 설명 ≤155자, 기본 키워드 및 주요 차별점 포함.
  • 페이지당 표준 URL, OG + Twitter 카드, apple-itunes-app 메타 (스마트 앱 배너). Vite 설정에서는 entry-server.tsx에 위치; Next.js: metadataBase, alternates.canonical, title template, itunes.appId.
  • 홈페이지 JSON-LD: SoftwareApplication (offers, installUrl 포함; 약 50개 미만 평점인 경우 aggregateRating 생략), FAQPage, WebSite. seo.ts에서 data.ts의 데이터를 기반으로 객체를 빌드하여 스키마와 표시 카피가 하나의 소스를 공유하도록 함.
  • 스토어 배지/다운로드 CTA 접는 선 위에, 그리고 아래에 반복 CTA 섹션.
  • 스크린샷은 실제 화면을 설명하는 키워드가 포함된 alt 텍스트를 가져야 함. 스토어 PNG를 다시 압축 (종종 각각 1–2MB)하여 ≤200 KB JPEG로 변환 (sips -Z 1386 -s format jpeg -s formatOptions 80); 원본은 public/assets/full/에 보관.
  • FAQ: 8–10개 질문, 각각 실제 검색어, 2–3문장으로 답변, 각각 해당 가이드로 연결되는 "자세히 알아보기 →" 링크 포함. FAQPage JSON-LD는 표시되는 FAQ와 동일한 Q/A 텍스트를 포함해야 함 — 둘 다 동일한 data.ts 배열에서 렌더링됨.
  • sitemap.xml + robots.txt: scripts/prerender.mjs에서 ROUTES 목록을 기반으로 생성되므로 새 가이드가 자동으로 나타남.

4단계 — 가이드 페이지 (롱테일 키워드당 하나)

가이드 콘텐츠를 하나의 데이터 모듈(Vite 설정에서는 src/data.ts, Next.js에서는 lib/guides.ts)에 저장하고 단일 템플릿 컴포넌트를 통해 렌더링하여 스키마, 카드, 푸터 링크 및 사이트맵이 모두 동일한 목록에서 파생되도록 합니다. 각 가이드를 HTML 블롭이 아닌 구조화된 데이터로 모델링: { slug, title, description, h1, intro, featureImage: { src, alt, width, height }, howto?, sections: [{ h2, paras, cta?, figure? }], faq, related } — CTA 콜아웃과 figure는 컴포넌트가 되고, 단락은 검색 가능한 문자열로 유지 (인라인 <em>-수준 HTML은 dangerouslySetInnerHTML을 통해 허용).

GPT 이미지 기능 이미지 워크플로우

모든 가이드 문서는 자체 가로형 기능 이미지를 얻습니다. gpt-image 스킬을 로드하여 사용하세요. 이 스킬은 OpenAI의 gpt-image-2를 호출합니다. 사용자가 명시적으로 요청하지 않는 한 스톡 이미지, CSS 그라데이션, 스크린샷 또는 다른 이미지 모델로 대체하지 마세요. gpt-image가 설치되지 않은 경우, 이미지 생성 전에 중단하고 이 저장소에서 형제 스킬을 설치하도록 사용자에게 알리세요.

  1. 가이드 제목과 슬러그가 최종 확정된 후, 검색 의도, 구체적인 주제, app.md에 캡처된 앱의 시각적 아이덴티티를 기반으로 가이드당 하나의 이미지 브리프를 만듭니다. 개념은 하나의 구성을 팔레트만 바꾼 것이 아니라 의미 있게 달라야 합니다.
  2. 앱의 브랜드 팔레트에 맞는 편집용 기능 이미지를 프롬프트합니다. 주제, 설정, 구성, 조명, 재료, 카메라/시점, 시각적 여백이 있어야 할 위치를 설명합니다. 모든 프롬프트는 다음으로 끝나야 합니다: 가로형 편집용 기능 이미지, 3:2 구성. 텍스트, 단어, 문자, 숫자, 캡션, 워터마크, 인터페이스 레이블 또는 로그가 전혀 없어야 합니다. 모델에 문서 제목을 렌더링하도록 요청하지 마세요.
  3. GPT_IMAGE_SKILL_DIR을 gpt-image 스킬의 SKILL.md가 포함된 설치된 디렉토리로 설정한 다음, 결정적 대상으로 생성기를 실행합니다:
    "$GPT_IMAGE_SKILL_DIR/scripts/generate_image.py" "<가이드별 프롬프트>" \
      --model gpt-image-2 \
      --aspect-ratio 3:2 \
      --quality high \
      --background opaque \
      --format webp \
      --output "<사이트 public 디렉토리>/assets/guides/<slug>-feature.webp"
    
    이 명령은 1536×1024 가로형 소스를 생성합니다. 필요한 경우 대상 디렉토리를 먼저 만드세요. 생성된 소스를 보존하고, 반복적으로 다시 압축하지 않고 더 작은 반응형 변형을 위해 프레임워크의 이미지 파이프라인을 사용하세요.
  4. 연결하기 전에 모든 이미지를 전체 크기로 검사하세요. 실수로 포함된 텍스트/글리프, 잘못된 개체, 복사된 앱 UI, 의도하지 않은 로고, 관련 없는 주제, 데스크탑 및 카드 종횡비에서의 잘못된 자르기 안전성을 확인하세요. 실패한 이미지만 다시 생성하고, 관찰된 결함을 해결하기 위해 프롬프트를 변경하세요. 동일한 가이드에 대해 두 번 실패한 재생성 후에는 중단하고 나머지 문제를 보고하세요. 무한정 시간을 소비하지 마세요.
  5. 이미지를 width: 1536, height: 1024 및 이미지가 실제로 포함하는 내용을 기반으로 한 간결하고 설명적인 alt 텍스트와 함께 가이드의 구조화된 레코드에 추가하세요. 이를 문서의 접는 선 위 기능 이미지, 가이드 카드 썸네일, 페이지의 og:image/twitter:image로 렌더링하세요. Article.image JSON-LD에 절대 URL로 추가하세요. 검색 키워드를 픽셀을 설명하지 않는 boilerplate alt 텍스트로 사용하지 마세요.

가이드당:

  • URL 슬러그 = 키워드 (/guides/how-to-keep-track-of-inventory-small-business)
  • 답변 우선 시작: 첫 번째 단락은 검색된 질문에 직접 답변 (추천 스니펫 미끼), 그 다음 본문은 앱을 도구로 사용하여 작업을 가르침 — 먼저 가르치고, 그 다음 판매.
  • H2에는 키워드의 보조 표현이 포함됨. 600–900 단어의 실질적인 내용, 채우기 내용 없음.
  • 관련 앱 스크린샷과 설명 캡션, 페이지 중간의 CTA 콜아웃, 해당 가이드에 고유한 2개의 FAQ 질문 (홈페이지 FAQ 질문과 중복되지 않도록 — 스키마 중복).
  • JSON-LD: Article + BreadcrumbList + FAQPage, 가이드가 단계별 형식일 경우 HowTo도 포함.
  • 가이드를 서로 연결하고 홈페이지 섹션으로 다시 연결.
  • 생성된 GPT 이미지 기능 에셋이 존재하고, 문서에 고유하며, 히어로, 카드, 소셜 메타데이터 및 Article.image JSON-LD에 연결됨. 반응형 srcset/프레임워크 이미지 최적화를 사용하고 레이아웃 이동을 방지하기 위해 명시적 크기를 설정. 접는 선 위 기능 이미지는 레이지 로드하지 마세요.

5단계 — 카피 디슬롭핑 (Wikipedia: AI 작성 신호)

배송 전에 작성한 모든 콘텐츠(가이드, FAQ 답변, 히어로/섹션 카피)에 대해 이 작업을 실행하세요. 신호는 중요도 순으로 다음과 같습니다:

  1. Em 대시 — 가장 큰 신호. 예산: 사이트 전체에 걸쳐 소수, 단락당이 아님. 마침표, 쉼표, 콜론, 괄호로 대체.
  2. 부정 병렬 — "It's not X, it's Y", "not just X but Y", "X, not Y". 사이트당 최대 1개, 자격이 있는 경우에만.
  3. 3의 법칙 — "no A, no B, no C", "adj, adj, adj". 쌍 또는 실제 목록으로 분할.
  4. 공식적 구조 — 페이지 전체에서 동일한 시작 (예: 모든 가이드가 동일한 굵은 명제 템플릿으로 시작). 다양화: 직접 답변, 시나리오, 평범한 주장.
  5. 균일한 경쾌한 운율 — 짧은 문장이 연속적으로 강한 인상을 남김. 문장 길이를 다양화. 일부 문장은 단순히 정보를 전달하도록 함.
  6. 어휘 블랙리스트: delve, tapestry, testament, pivotal, crucial, vibrant, seamless, effortless, boasts, leverage, elevate, robust, meticulous, landscape, underscore, showcase, foster, transformative, game-changing, revolutionize, empower, streamline, "killer feature", "single source of truth", "with confidence", 반복되는 "Here's how/Here's the...".
  7. Copula 회피 — "serves as", "stands as", "represents"를 "is"가 작동하는 곳에 사용. "is"를 사용하세요.
  8. 피상적 분석 분사 — 문장 끝에 붙은 "...highlighting", "...underscoring", "...reflecting" 절.
  9. 격언을 구체적인 세부 사항(가격, 월, 명명된 객체)으로 대체. 구체적인 내용은 인간적이고, 일반적인 내용은 생성된 것으로 읽힘.

기계적 확인 (경로 조정):

grep -o "—" <콘텐츠 파일> | wc -l   # 목표: 사이트 전체에서 한 자리 수
grep -inE "delve|tapestry|testament|pivotal|crucial|vibrant|seamless|effortless|boasts|leverage|elevate|robust|meticulous|landscape|underscore|showcas|foster|transformativ|game.chang|revolutioniz|empower|streamlin|serves as|stands as|it's not just|isn't just|not only" <콘텐츠 파일>

CSS 클래스 이름(예: transition-transform)은 오탐지되므로 무시하세요. 유지하는 내용은 "바쁜 인간이 이 문장을 쓸까?"라는 질문에 견뎌야 합니다.

디슬롭핑하는 동안 그대로 유지: 슬러그, 제목/키워드, 내부 링크, 스키마 (다시 작성된 소스에서 스키마를 다시 생성하여 표시되는 텍스트와 JSON-LD가 동일하게 유지).

6단계 — 검증

  • npm run build가 통과해야 하며, 그런 다음 dist/**/index.html에 대해 스크립트된 검사를 실행: 페이지당 정확히 하나의 H1, 표준 URL 존재, 모든 <script type="application/ld+json"> 구문 분석, 모든 내부 href/src가 dist의 파일로 확인됨 (후행 슬래시 URL을 <path>/index.html에 매핑), 모든 sitemap <loc>이 실제 파일에 매핑되며, 홈페이지의 표시되는 FAQ 질문이 FAQPage JSON-LD name과 동일.
  • 모든 가이드 레코드에 고유한 가로형 기능 이미지가 있고, 빌드된 출력에 모든 파일이 존재하며, 본질적 차원이 세로보다 넓고, HTML 너비/높이 속성이 소스와 일치하며, 각 가이드의 Open Graph, Twitter 및 Article.image URL이 다음으로 확인됨을 확인...

…

[번역을 위해 잘림]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬