Skip to content

apps.md

Latest commit

 

History

History
202 lines (143 loc) · 6 KB

apps.md

File metadata and controls

202 lines (143 loc) · 6 KB
Raw

앱 관리 도구

App Store Connect와 Google Play Console에서 앱을 등록하고 관리하는 도구입니다.

registered-apps.json은 등록된 앱 메타데이터를 ~/.config/pabal-mcp/registered-apps.json에 저장하는 파일입니다. apps-init, apps-add, apps-search가 함께 사용하며, 보통 직접 작성하지 않고 도구가 생성/업데이트합니다.

형식:

{
  "apps": [
    {
      "slug": "myapp", // 도구에서 쓰는 로컬 ID
      "name": "My App", // 표시 이름
      "appStore": {
        "bundleId": "com.example.myapp", // App Store 번들 ID
        "appId": "123456789", // App Store Connect 앱 ID
        "name": "My App",
        "supportedLocales": ["en-US", "ko", "ja"], // 선택 값, 스토어 지원 언어
      },
      "googlePlay": {
        "packageName": "com.example.myapp", // Google Play 패키지명
        "name": "My App",
        "supportedLocales": ["en-US", "ko", "ja"], // 선택 값, 스토어 지원 언어
      },
    },
  ],
}

앱 하나에는 appStore, googlePlay, 또는 둘 다 포함할 수 있습니다. 도구는 slug, App Store bundleId, Google Play packageName 중 하나로 앱을 찾을 수 있습니다.

apps-init

스토어 API에서 앱을 가져와 자동 등록합니다.

파라미터

파라미터 타입 필수 기본값 설명
store "appStore" | "googlePlay" 아니오 "appStore" 대상 스토어
packageName string 조건부 - store가 "googlePlay"일 때 필수

사용 예시

// App Store 앱 자동 등록
{ "store": "appStore" }

// Google Play 앱 등록 (packageName 필수)
{ "store": "googlePlay", "packageName": "com.example.app" }

동작 방식

  • App Store: 출시된 모든 앱을 조회하여 자동 등록
  • Google Play: 앱 목록 조회를 지원하지 않으므로 packageName을 명시해야 함
  • 각 앱에 대해 bundleId/packageName의 마지막 부분으로 slug 생성 (예: com.example.myapp → myapp)
  • 두 스토어가 설정된 경우, App Store 앱에 대해 Google Play 존재 여부도 확인

응답

📱 **App Setup Complete**

✅ **Registered** (2):
  • My App (🍎+🤖) → slug: "myapp"
    🍎 App Store: en-US, ko, ja
    🤖 Google Play: en-US, ko, ja

⏭️ **Skipped** (1):
  • Other App (com.example.other) - already registered

apps-add

bundleId 또는 packageName으로 단일 앱을 등록합니다.

파라미터

파라미터 타입 필수 기본값 설명
identifier string 예 - 앱 식별자 (bundleId 또는 packageName)
slug string 아니오 자동 생성 앱의 커스텀 slug
store "appStore" | "googlePlay" | "both" 아니오 "both" 검색할 스토어

사용 예시

// 앱 등록 (모든 스토어 검색)
{ "identifier": "com.example.app" }

// 커스텀 slug로 등록
{ "identifier": "com.example.app", "slug": "myapp" }

// Google Play만 등록
{ "identifier": "com.example.app", "store": "googlePlay" }

동작 방식

  • 지정된 스토어에서 앱 검색
  • slug가 제공되지 않으면 identifier의 마지막 부분으로 자동 생성
  • 각 스토어의 지원 언어 정보를 가져와 저장
  • 앱이 이미 존재하면 언어 정보 업데이트

응답

신규 등록:

✅ App registration complete (🍎+🤖)

**Registration Info:**
• Slug: `myapp`
• Name: My App
• App Store: com.example.app (ID: 123456789)
• Google Play: com.example.app

**Supported Languages:**
  • App Store locales: en-US, ko, ja
  • Google Play locales: en-US, ko, ja

**Search Results:**
  • 🍎 App Store: ✅ Found (My App) (3 locales)
  • 🤖 Google Play: ✅ Found (My App) (3 locales)

You can now reference this app in other tools using the `app: "myapp"` parameter.

이미 등록됨:

⏭️ App is already registered.

• Slug: `myapp`
• Name: My App
• App Store: ✅ com.example.app
• Google Play: ✅ com.example.app

apps-search

등록된 앱을 검색합니다.

파라미터

파라미터 타입 필수 기본값 설명
query string 아니오 - 검색어 (slug, bundleId, packageName, 이름). 비어있으면 모든 앱 반환
store "all" | "appStore" | "googlePlay" 아니오 "all" 스토어 필터

사용 예시

// 모든 등록된 앱 조회
{}

// 이름 또는 slug로 검색
{ "query": "myapp" }

// 스토어로 필터링
{ "store": "appStore" }

// 검색어와 스토어 필터 함께 사용
{ "query": "example", "store": "googlePlay" }

응답

📋 Registered app list: 2

📱 **My App** (`myapp`)
   🍎 App Store: `com.example.myapp`
      App ID: 123456789
   🤖 Google Play: `com.example.myapp`

📱 **Other App** (`other`)
   🍎 App Store: `com.example.other`
      App ID: 987654321

결과 없음:

❌ No apps found matching "query".

💡 Register apps using apps-add or apps-init tools.

참고

  • auth-check - 스토어 자격 증명 확인
  • aso-pull - 등록된 앱의 ASO 데이터 가져오기