#앱 관리 도구

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

#apps-init

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

#파라미터

#사용 예시

// 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": "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

등록된 앱을 검색합니다.

#파라미터

#사용 예시

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

// 이름 또는 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.

#등록된 앱 저장소

앱은 ~/.config/pabal-mcp/registered-apps.json에 저장됩니다:

{
  "apps": [
    {
      "slug": "myapp",
      "name": "My App",
      "appStore": {
        "bundleId": "com.example.myapp",
        "appId": "123456789",
        "name": "My App",
        "supportedLocales": ["en-US", "ko", "ja"]
      },
      "googlePlay": {
        "packageName": "com.example.myapp",
        "name": "My App",
        "supportedLocales": ["en-US", "ko", "ja"]
      }
    }
  ]
}

#참고

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