Communitygithub.com

ASO 메타데이터 최적화

Apple App Store 및 Google Play의 제목, 부제목, 키워드, 설명, 프로모션 텍스트 등 모든 메타데이터를 작성, 재작성, 최적화, 비교, 검증 또는 일괄 채울 수 있습니다.

ASO 메타데이터 최적화란 무엇인가요?

이 스킬은 앱 스토어 최적화(ASO)를 위한 전문 기술로, 개발자와 마케터가 Apple App Store와 Google Play의 메타데이터를 체계적으로 관리하고 최적화할 수 있도록 돕습니다. 키워드 연구, 포지셔닝 분석, 콘텐츠 최적화, 플랫폼별 제한 검증, 일괄 채우기까지 전체 워크플로우를 지원합니다. Claude Code, Cursor, Codex 등 AI 에이전트와 함께 사용하도록 설계되었으며, ASO.dev 에디터 데이터를 자동으로 활용하여 수동 추측 없이 정확한 메타데이터를 생성합니다. 특히 실시간 길이 검증, 키워드 중복 감지, 플랫폼별 한도 준수, 검증된 데이터만 최종 출력하는 품질 게이트를 갖추고 있어 실수 없이 바로 복사하여 붙여넣기 할 수 있는 결과물을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/asodevapp/skills/tree/HEAD/skills/metadata-editor

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

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

문서

메타데이터 최적화

검색 가시성, 전환율, 명확성, 규정 준수의 균형을 맞춘 App Store 및 Google Play 메타데이터를 작성합니다.

워크플로우

  1. current-metadata-fetch를 사용하여 현재 값을 읽습니다.
  2. 포지셔닝, 톤, 타겟 사용자, 금지된 주장이 관련된 경우 get_project_context를 사용합니다.
  3. 플랫폼, 국가, 로케일, 타겟 키워드 및 페이지 유형(기본 리스팅, 릴리스 메타데이터, CPP/PPO 초안, Google 리스팅)을 식별합니다.
  4. 타겟 키워드가 없는 경우 먼저 keyword-research를 사용하고, keyword-coverage를 사용하여 선택된 키워드를 분배합니다.
  5. 요청된 로케일과 필드만 초안을 작성합니다.
  6. appMetadata 또는 googleMetadata를 사용하여 validate_ai_companion_data로 검증합니다.
  7. 사용자가 적용/채우기를 요청한 경우 bulk_fill 또는 bulk_fill_google을 사용합니다.

품질 게이트

  • 권장 필드는 바로 복사하여 붙여넣기 할 수 있어야 합니다. 즉, 플레이스홀더, 미해결 대괄호 없이 정확한 문자 수와 플랫폼별 제한을 준수해야 합니다.
  • 앱 포지셔닝, 사용자층, 수익화 모델, 증거 자료, 지원 URL 또는 타겟 키워드가 누락된 경우 질문하거나 분석에서 그 차이를 표시해야 하며, 최종 메타데이터 내에서 임의로 생성해서는 안 됩니다.
  • 영향력이 큰 필드에 대해서는 대안을 제공하되, 하나의 권장 옵션을 명확히 표시합니다.
  • 메타데이터 복사본과 구현 단계를 분리하여 사용자가 추가 정리 없이 필드를 붙여넣을 수 있도록 합니다.

ASO.dev 편집기 컨텍스트

ASO.dev 편집기 데이터를 사용할 수 있는 경우 추측 대신 이를 사용합니다.

  • 스마트 메타데이터 편집기: 현재 값, 길이 검사, 미리보기, 이전 버전 재사용/롤백, 가져오기/내보내기, Fastlane, App Store Connect 직접 저장 및 리뷰 제출 컨텍스트.
  • 일괄 편집기: 모든 현지화, 중복 감지, 이전 버전 복사, AI/Google/DeepL 번역 상태.
  • 교차 현지화: 국가-현지화 조합별 제목/부제목/키워드 커버리지.
  • 타임라인/변경 로그: 이전 메타데이터와 릴리스 내역으로 변경 전/후 비교.
  • 버전 워크플로우: 앱 버전, 릴리스 유형, 빌드 선택, 연령 등급, 서버 알림, 기본 현지화 및 현지화 추가/삭제 상태는 초안 작성 또는 채우기에 영향을 줄 수 있습니다.

플랫폼 한도

Apple App Store

필드한도검색 역할
title30인덱싱됨, 가장 높은 가중치
subtitle30인덱싱됨
keywords100 (결합된 문자)인덱싱됨, 숨김
promotionalText170전환용, 인덱싱되지 않음, 앱 버전 없이 변경 가능
description4000전환용, App Store 검색으로 인덱싱되지 않음
whatsNew4000업데이트 커뮤니케이션

Google Play

필드한도검색 역할
title30인덱싱됨
shortDescription80인덱싱되고 표시됨
fullDescription4000인덱싱되고 전환에 영향

최적화 프레임워크

제목

  • 가능한 경우 가장 강력한 타겟 키워드를 자연스럽게 포함시킵니다.
  • 브랜드가 알려진 브랜드이고 의미 있는 검색 수요 또는 신뢰 가치가 있는 경우에만 브랜드로 시작합니다.
  • 덜 알려진 앱의 경우 가장 중요한 기능 키워드/의도로 시작하고 브랜드 포함이 여전히 필요한 경우 브랜드를 끝에 배치합니다. 이렇게 하면 App Store 제안 및 구문이 우선순위가 높은 키워드부터 먼저 형성됩니다.
  • 검색 결과에서 읽기 쉽게 유지합니다.
  • 법적 표시가 필요하지 않은 경우 문자를 낭비하지 않습니다.
  • 제목을 최적화할 때는 3가지 옵션을 제공합니다.

좋은 구조 예시:

  • 주요 키워드: 혜택 구문
  • 주요 키워드 - 보조 의도
  • 주요 키워드 by 브랜드
  • 알려진 브랜드: 주요 키워드

Apple 부제목

  • 보조 키워드와 혜택 언어를 추가합니다.
  • 명확한 전략적 이유가 없는 한 제목의 키워드 단어를 반복하지 않습니다.
  • 단순한 키워드 목록이 아니라 전환 친화적으로 만듭니다.
  • 부제목을 최적화할 때는 3가지 옵션을 제공합니다.

Apple 키워드 필드

  • 쉼표로 구분하고 공백을 넣지 않습니다.
  • MCP 페이로드의 경우 내부적으로 배열로 처리합니다.
  • 의도적이지 않은 한 제목이나 부제목에 이미 있는 단어는 반복하지 않습니다.
  • 데이터가 복수형을 지원하지 않는 한 단수형을 선호합니다.
  • 앱 이름, 경쟁사 브랜드, app, free는 포함하지 않습니다.
  • 먼저 관련성으로 우선순위를 정한 다음 인기/기회로 정합니다.

Apple 설명

  • App Store 검색은 이를 인덱싱하지 않습니다. 주로 전환을 위해 작성합니다.
  • 처음 2-3줄은 사용자가 "더 보기"를 탭하기 전에 핵심 사용자 혜택을 전달해야 합니다.
  • 기능 목록보다 혜택을 먼저 제시합니다.
  • 사용자가 제공한 실제 증거(평점, 수상, 언론 보도, 사용량 수치 또는 사용후기)만 포함합니다.
  • 브랜드 톤이 지원하지 않는 한 이모지를 추가하지 않습니다.

권장 구조:

  1. 후크
  2. 주요 혜택
  3. 주요 기능
  4. 작동 방식
  5. 신뢰/증거
  6. 클릭 유도 문구

Google 설명

  • 전환율과 자연스러운 키워드 커버리지의 균형을 맞춥니다.
  • 첫 번째 단락에 가장 관련성 높은 용어를 앞쪽에 배치합니다. 확장되기 전에 처음 ~250자가 독립적으로 의미를 전달해야 합니다.
  • 변형 및 동의어를 사용하고 키워드 채우기를 하지 않습니다.
  • 스캔하기 쉽도록 글머리 기호와 줄 바꿈을 사용합니다.
  • 밀도를 자연스럽고 읽기 쉽게 유지합니다.

프로모션 텍스트

시기적절한 메시징에 사용합니다.

  • 기능 출시
  • 시즌별 캠페인
  • 인앱 이벤트
  • 기간 한정 콘텐츠
  • 실제 수상 또는 이정표

현재 데이터나 사용자가 확인하지 않는 한 가격, 날짜, 할인 또는 가용성을 하드코딩하지 않습니다.

Apple 규칙

  • Apple 키워드는 공백 없이 쉼표로 구분해야 합니다.
  • 의도적인 경우가 아니라면 제목, 부제목 및 키워드 전반에 걸쳐 중복 키워드 단어를 피합니다.
  • 경쟁사 상표나 입증되지 않은 주장을 추가하지 않습니다.
  • 명시적으로 요청하지 않는 한 URL, 개인정보 보호 텍스트 또는 법적 문구를 변경하지 않습니다.
  • "Welcome to..."와 같은 약한 후크 또는 일반적인 "best app for..." 주장에 플래그를 지정합니다.
  • 문자를 추가하면 관련성이나 전환율이 향상되는 경우에만 사용되지 않은 문자 예산에 플래그를 지정합니다.

출력

# 메타데이터 최적화 패키지

앱:
플랫폼:
국가:
로케일:
타겟 키워드:

## 진단
| 로케일 | 필드 | 문제점 | 수정 방안 |
|---|---|---|---|

## 권장 메타데이터
### locale-code
| 필드 | 권장사항 | 문자 수 | 커버된 키워드 | 근거 |
|---|---:|---|---|

## 대안
| 필드 | 옵션 | 복사본 | 문자 수 | 방향 |
|---|---|---|---:|---|

## 키워드 커버리지 매트릭스
| 키워드 | 제목 | 부제목/짧은 설명 | 키워드 필드 | 설명 | 비고 |
|---|---|---|---|---|---|

## 변경 전/후
| 필드 | 현재 | 권장 | 개선 사항 |
|---|---|---|---|

## 검증
- 문자 제한:
- 키워드 중복:
- 키워드 연구 출처:
- 입증되지 않은 주장:
- URL/개인정보/법률 변경 없음:
- MCP 검증:
- `bulk_fill` 준비 완료:

채우기 페이로드 규칙

Apple 메타데이터를 채울 때는 다음을 전송합니다.

{
  "locales": ["ko-KR"],
  "fields": ["title", "subtitle", "keywords"],
  "data": {
    "ko-KR": {
      "title": "...",
      "subtitle": "...",
      "keywords": ["keyword", "keyword2"]
    }
  }
}

Individual skills in this repo

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

asodevapp/skills

Use when the user wants Google Play Store or Android ASO: Play listing title, short description, full description, keyword strategy, feature graphic, screenshots, ratings/reviews, Play Store Experiments, localization, or Google Play-specific metadata via ASO.dev.

asodevapp/skills

Use when the user wants to interpret ASO.dev Measurements or App Store Connect metrics: downloads, impressions, product page views, conversion, revenue, retention, sessions, active devices, ratings, reviews, release markers, experiment impact, or before/after ASO performance.

asodevapp/skills

Use to read, create, or update ASO.dev per-app project context before metadata, localization, keywords, screenshots, IAP, subscriptions, pricing, In-App Events, nominations, or review work.

asodevapp/skills

Use when the user wants a full ASO audit or health check for an app: metadata, keyword coverage, cross-localization, screenshots, reviews, ratings, update history, In-App Events, IAP/subscriptions, CPP/PPO, competitors, rankings, or ASO.dev ASO Check interpretation.

asodevapp/skills

Use when the user wants App Store Custom Product Pages, Product Page Optimization, A/B testing, conversion rate optimization, product page variants, screenshot/icon/app preview tests, campaign pages, keyword/ad alignment, or CPP/PPO drafts in ASO.dev.

asodevapp/skills

Use when the user wants to create, plan, audit, optimize, localize, or fill App Store In-App Events in ASO.dev: event cards for Today/Games/Apps tabs, search, product pages, re-engagement, challenges, competitions, live events, premieres, seasons, major updates, and special events.

asodevapp/skills

Use for App Store consumable and non-consumable In-App Purchases: metadata, localization, pricing/availability notes, promoted IAP readiness, validation, and ASO.dev local MCP fill when that surface is available.

asodevapp/skills

Use for keyword ideas, keyword prioritization, keyword/search query CSV-derived shortlists, competitor keyword gaps, Search Ads Popularity interpretation, and keyword distribution across metadata/locales.

asodevapp/skills

Use when the user wants to analyze, respond to, report, or improve App Store reviews and ratings in ASO.dev: negative reviews, ratings trend, review replies, review complaints, review health, product insights, uploaded review CSV analysis, sentiment, missing feature requests, or rating prompt strategy.

asodevapp/skills

Use to prepare screenshot copy, screenshot order, creative briefs, and App Store / Google Play visual messaging.

관련 스킬