Communitygithub.com

exiao/skills

구독 및 인앱 결제 표시 이름을 App Store의 모든 로케일에 대해 대량으로 현지화합니다. App Store Connect에서 수동으로 클릭하지 않고 모든 언어에 대한 구독/IAP 이름을 채울 때 사용합니다.

skills란 무엇인가요?

이 스킬은 `asc` CLI를 활용하여 App Store Connect의 모든 지원 로케일에 대해 구독, 구독 그룹, 인앱 구매의 표시 이름(및 설명)을 대량으로 생성하거나 업데이트하는 방법을 제공합니다. 개발자는 각 언어를 수동으로 클릭하는 번거로운 작업 없이 하나의 명령어로 수십 개 로케일에 동일한 표시 이름을 일괄 설정할 수 있습니다. `asc auth login` 또는 환경 변수를 통한 인증이 선행되어야 하며, 앱 ID와 기존 구독 그룹/구독이 필요합니다. 지원되는 로케일 목록(ar-SA, ca, cs, da, de-DE 등 39개)을 기준으로 기존 현지화를 먼저 조회한 후, 누락된 로케일에 대해서만 개별 생성 명령어를 실행합니다. 이 스킬은 Claude Code, Cursor, Codex 등 `asc`와 연동 가능한 모든 CLI 도구에서 사용할 수 있으며, 중복 생성 오류 방지, 업데이트 워크플로, 전체 앱의 모든 구독을 순차적으로 처리하는 방법까지 상세히 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/exiao/skills/tree/HEAD/app-store/app-store-connect/subscription-localization

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

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

문서

asc 구독 현지화

이 스킬을 사용하여 App Store Connect의 모든 로케일에 걸쳐 구독, 구독 그룹 및 인앱 구매의 표시 이름(및 설명)을 대량으로 생성하거나 업데이트할 수 있습니다. App Store Connect에서 각 언어를 클릭하여 동일한 표시 이름을 설정하는 지루한 수동 작업을 없애줍니다.

사전 조건

  • 인증 구성 완료 (asc auth login 또는 ASC_* 환경 변수)
  • 앱 ID 확인 (ASC_APP_ID 또는 --app)
  • 구독 그룹과 구독이 이미 존재해야 함

지원되는 App Store 로케일

다음은 App Store Connect에서 구독 및 IAP 현지화를 지원하는 로케일입니다:

ar-SA, ca, cs, da, de-DE, el, en-AU, en-CA, en-GB, en-US,
es-ES, es-MX, fi, fr-CA, fr-FR, he, hi, hr, hu, id, it,
ja, ko, ms, nl-NL, no, pl, pt-BR, pt-PT, ro, ru, sk,
sv, th, tr, uk, vi, zh-Hans, zh-Hant

워크플로: 구독 대량 현지화

1. ID 확인

# 구독 그룹 찾기
asc subscriptions groups list --app "APP_ID" --output table

# 그룹 내 구독 찾기
asc subscriptions list --group "GROUP_ID" --output table

2. 기존 현지화 확인

asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table

이 명령은 이미 이름이 설정된 로케일을 보여줍니다. 누락된 로케일에 대해서만 현지화를 생성합니다.

3. 누락된 모든 로케일에 대한 현지화 생성

아직 현지화가 없는 각 로케일에 대해 다음 명령을 실행합니다:

asc subscriptions localizations create \
  --subscription-id "SUB_ID" \
  --locale "LOCALE" \
  --name "표시 이름"

예를 들어, 모든 로케일에 "Monthly Pro"를 설정하려면:

# 로케일당 하나의 명령 (이미 존재하는 것은 건너뜁니다)
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ar-SA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ca" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "cs" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "da" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "de-DE" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "el" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-AU" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-GB" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-ES" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-MX" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-FR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "he" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hu" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "id" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "it" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ja" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ko" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ms" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "nl-NL" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "no" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pl" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-BR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-PT" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ro" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ru" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sv" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "th" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "tr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "uk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "vi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hans" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hant" --name "Monthly Pro"

4. 확인

asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table

워크플로: 구독 그룹 대량 현지화

구독 그룹에도 로케일별 표시 이름이 있습니다(이것은 사용자가 구독 관리 시트에서 보게 되는 "그룹 이름"입니다).

1. 기존 그룹 현지화 확인

asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table

2. 누락된 로케일에 대해 생성

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "그룹 표시 이름"

선택적으로 그룹에 대한 사용자 지정 앱 이름을 설정할 수 있습니다:

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "그룹 표시 이름" \
  --custom-app-name "My App"

3. 확인

asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table

워크플로: 인앱 구매 대량 현지화

IAP는 동일한 패턴의 자체 현지화 명령어가 있습니다.

1. IAP ID 확인

asc iap list --app "APP_ID" --output table

2. 기존 현지화 확인

asc iap localizations list --iap-id "IAP_ID" --paginate --output table

3. 누락된 로케일에 대해 생성

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "표시 이름"

선택적 설명:

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "모든 기능 잠금 해제" \
  --description "모든 프리미엄 기능을 잠금 해제하는 일회성 구매"

4. 확인

asc iap localizations list --iap-id "IAP_ID" --paginate --output table

기존 현지화 업데이트

기존 현지화의 표시 이름을 변경하려면:

구독

asc subscriptions localizations update --id "LOC_ID" --name "새 이름"

구독 그룹

asc subscriptions groups localizations update --id "LOC_ID" --name "새 그룹 이름"

인앱 구매

asc iap localizations update --id "LOC_ID" --name "새 이름"

대량 업데이트하려면 먼저 기존 현지화를 나열하고 ID를 추출한 후 각각 업데이트합니다.

앱 내 모든 구독 대량 현지화

여러 구독 그룹과 구독이 있는 전체 앱의 경우:

# 1. 모든 그룹 나열
asc subscriptions groups list --app "APP_ID" --paginate

# 2. 각 그룹에 대해 그룹 자체 현지화
#    (위의 그룹 현지화 워크플로 반복)

# 3. 각 그룹에 대해 구독 나열
asc subscriptions list --group "GROUP_ID" --paginate

# 4. 각 구독에 대해 현지화
#    (위의 구독 현지화 워크플로 반복)

에이전트 동작

  • 항상 기존 현지화를 먼저 나열하여 중복 생성 오류를 방지합니다.
  • 이미 현지화가 있는 로케일은 건너뛰고 누락된 것만 생성합니다.
  • 사용자가 단일 표시 이름을 제공하면 모든 로케일에 동일한 이름을 사용합니다.
  • 사용자가 로케일별로 번역된 이름을 제공하면 각 로케일에 해당하는 이름을 사용합니다.
  • 설명이 제공되면 생성 시 --description을 전달하고, 그렇지 않으면 생략합니다.
  • 확인 단계에서는 --output table을 사용하여 사용자가 시각적으로 확인할 수 있도록 합니다.
  • 중간 자동화 단계에서는 기본 JSON 출력을 사용합니다.
  • 대량 생성 후에는 항상 list 명령을 실행하여 완전성을 확인합니다.
  • 구독이 많은 앱의 경우 그룹별로 순차적으로 처리하여 출력을 읽기 쉽게 유지합니다.
  • 특정 로케일에 대해 create 호출이 실패하면 로케일과 오류를 기록하고 나머지 로케일을 계속 처리합니다. 배치 완료 후 모든 실패를 함께 보고하여 사용자가 처리할 수 있도록 합니다.

참고 사항

  • 구독 표시 이름은 사용자가 구독 관리 시트와 구매 대화상자에서 보게 되는 이름입니다.
  • 이미 존재하는 로케일에 대해 현지화를 생성하면 실패합니다. 항상 먼저 확인하십시오.
  • 대량 API는 없습니다. 각 로케일마다 별도의 create 호출이 필요합니다.
  • list 명령에 --paginate를 사용하여 모든 기존 현지화가 반환되도록 보장합니다.
  • ID 대신 앱 이름만 있는 경우 asc-id-resolver 스킬을 사용하십시오.

Individual skills in this repo

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

관련 스킬