@yoonion/mimi-seed-mcp 0.21.2 → 0.21.3

package/dist/googleads/config.d.ts

@@ -3,8 +3,11 @@ export interface GoogleAdsConfig {
     customerId: string;
     loginCustomerId?: string;
 }
-/** 하이픈 제거 (API는 숫자만 허용) */
-export declare function normalizeCustomerId(id: string): string;
+/**
+ * 하이픈 제거 (API는 숫자만 허용). 손으로 적은 설정 파일엔 따옴표 없는 숫자(`"customerId": 1234567890`)도
+ * 오므로 숫자도 받는다 — 안 그러면 `.replace` 가 던져 "설정 없음" 으로 읽힌다.
+ */
+export declare function normalizeCustomerId(id: string | number): string;
 export declare function saveConfig(cfg: GoogleAdsConfig): void;
 export declare function loadConfig(): GoogleAdsConfig | null;
 export declare function requireConfig(): GoogleAdsConfig;

package/dist/googleads/config.js

@@ -4,9 +4,12 @@ import os from 'node:os';
 import { writeCredentialJson } from '#core/atomic-write.js';
 const CONFIG_DIR = path.join(os.homedir(), '.mimi-seed');
 const CONFIG_PATH = path.join(CONFIG_DIR, 'google-ads.json');
-/** 하이픈 제거 (API는 숫자만 허용) */
+/**
+ * 하이픈 제거 (API는 숫자만 허용). 손으로 적은 설정 파일엔 따옴표 없는 숫자(`"customerId": 1234567890`)도
+ * 오므로 숫자도 받는다 — 안 그러면 `.replace` 가 던져 "설정 없음" 으로 읽힌다.
+ */
 export function normalizeCustomerId(id) {
-    return id.replace(/-/g, '');
+    return String(id).replace(/-/g, '');
 }
 export function saveConfig(cfg) {
     const normalized = {
@@ -16,6 +19,14 @@ export function saveConfig(cfg) {
     };
     writeCredentialJson(CONFIG_PATH, normalized);
 }
+/** 손으로 적은 ID 는 문자열이거나 따옴표 없는 정수다. 그 밖(빈 값 · 객체 · 소수)은 설정이 아니다. */
+function readCustomerId(value) {
+    if (typeof value === 'string' && value.trim())
+        return normalizeCustomerId(value.trim());
+    if (typeof value === 'number' && Number.isSafeInteger(value) && value > 0)
+        return normalizeCustomerId(value);
+    return null;
+}
 export function loadConfig() {
     if (!fs.existsSync(CONFIG_PATH))
         return null;
@@ -23,13 +34,15 @@ export function loadConfig() {
         const cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
         // 읽기 시점에도 정규화 — 하이픈 포함 값이 손으로 적히거나 구버전이 쓴 경우에도
         // URL/login-customer-id 헤더가 항상 숫자만 포함하도록 보장 (write 경로 의존 제거).
-        return {
-            ...cfg,
-            customerId: normalizeCustomerId(cfg.customerId),
-            loginCustomerId: cfg.loginCustomerId
-                ? normalizeCustomerId(cfg.loginCustomerId)
-                : undefined,
-        };
+        const customerId = readCustomerId(cfg.customerId);
+        if (typeof cfg.developerToken !== 'string' || !cfg.developerToken || !customerId)
+            return null;
+        // 비어 있지 않은 loginCustomerId 가 이상하면 조용히 버리지 않는다 — MCC 헤더 없이 호출하면 엉뚱한 권한 오류가 난다.
+        const hasLogin = cfg.loginCustomerId !== undefined && cfg.loginCustomerId !== null && cfg.loginCustomerId !== '';
+        const loginCustomerId = hasLogin ? readCustomerId(cfg.loginCustomerId) : undefined;
+        if (loginCustomerId === null)
+            return null;
+        return { ...cfg, developerToken: cfg.developerToken, customerId, loginCustomerId };
     }
     catch {
         return null;

package/dist/googleads/errors.js

@@ -1,29 +1,37 @@
 /** Preserve provider diagnostics without exposing authentication material. */
 export function googleAdsError(status, body, secrets) {
     let message = `Google Ads API ${status}`;
+    let parsed;
     try {
-        const parsed = JSON.parse(body);
-        const error = (Array.isArray(parsed) ? parsed[0] : parsed)?.error;
-        if (typeof error?.message === 'string')
-            message += `: ${error.message}`;
-        for (const detail of Array.isArray(error?.details) ? error.details : []) {
-            for (const item of Array.isArray(detail.errors) ? detail.errors : []) {
-                const codes = item.errorCode && typeof item.errorCode === 'object'
-                    ? Object.entries(item.errorCode).map(([key, value]) => `${key}=${String(value)}`).join(', ')
-                    : '';
-                message += `\n${codes}${typeof item.message === 'string' ? `: ${item.message}` : ''}`;
-            }
-            for (const item of Array.isArray(detail.fieldViolations) ? detail.fieldViolations : []) {
-                message += `\n${String(item.field ?? '')}: ${String(item.description ?? '')}`;
-            }
-            if (typeof detail.requestId === 'string')
-                message += `\nrequestId=${detail.requestId}`;
-        }
+        parsed = JSON.parse(body);
     }
     catch {
         // HTML/proxy bodies can contain arbitrary data; do not echo them.
+        parsed = undefined;
         message += ': non-JSON response';
     }
+    // Only the parse decides "non-JSON": a JSON body with odd entries (`details: [null]`) is walked
+    // null-safely instead of throwing into the non-JSON branch and mislabelling a real provider error.
+    const error = (Array.isArray(parsed) ? parsed[0] : parsed)?.error;
+    if (typeof error?.message === 'string')
+        message += `: ${error.message}`;
+    for (const detail of Array.isArray(error?.details) ? error.details : []) {
+        for (const item of Array.isArray(detail?.errors) ? detail.errors : []) {
+            if (!item || typeof item !== 'object')
+                continue;
+            const codes = item?.errorCode && typeof item.errorCode === 'object'
+                ? Object.entries(item.errorCode).map(([key, value]) => `${key}=${String(value)}`).join(', ')
+                : '';
+            message += `\n${codes}${typeof item?.message === 'string' ? `: ${item.message}` : ''}`;
+        }
+        for (const item of Array.isArray(detail?.fieldViolations) ? detail.fieldViolations : []) {
+            if (!item || typeof item !== 'object')
+                continue;
+            message += `\n${String(item?.field ?? '')}: ${String(item?.description ?? '')}`;
+        }
+        if (typeof detail?.requestId === 'string')
+            message += `\nrequestId=${detail.requestId}`;
+    }
     for (const secret of secrets.filter(Boolean).sort((a, b) => b.length - a.length)) {
         message = message.split(secret).join('[REDACTED]');
     }

package/dist/googleads/setup-cli.js

@@ -104,7 +104,7 @@ async function main() {
     console.log(M.probing);
     try {
         const customers = await listAccessibleCustomers(auth, cfg);
-        console.log(M.probeOk(customers.length));
+        console.log(M.probeOk(customers.resourceNames.length));
     }
     catch (e) {
         const msg = e instanceof Error ? e.message : String(e);

package/dist/googleads/tools.d.ts

@@ -5,7 +5,14 @@ export interface DateRange {
     startDate: string;
     endDate: string;
 }
-export declare function listAccessibleCustomers(auth: OAuth2Client, cfg: GoogleAdsConfig): Promise<any>;
+/**
+ * 응답은 배열이 아니라 `{ resourceNames: ['customers/<id>', …] }` 다 — 계정이 없으면 protobuf JSON 이
+ * 필드를 생략하므로 빈 배열로 채운다. 반환 타입을 고정해 두지 않으면 호출부가 `.length` 를 읽어도
+ * 컴파일러가 못 잡는다(setup-cli 가 "계정 undefined개" 를 찍었다).
+ */
+export declare function listAccessibleCustomers(auth: OAuth2Client, cfg: GoogleAdsConfig): Promise<{
+    resourceNames: string[];
+}>;
 export declare function listCampaigns(auth: OAuth2Client, cfg: GoogleAdsConfig): Promise<{
     id: string | undefined;
     name: string | undefined;

package/dist/googleads/tools.js

@@ -98,6 +98,11 @@ function microsToCurrency(micros) {
     return value / 1_000_000;
 }
 // ─── 접근 가능한 고객 목록 (API 연결 확인용) ─────────────────────
+/**
+ * 응답은 배열이 아니라 `{ resourceNames: ['customers/<id>', …] }` 다 — 계정이 없으면 protobuf JSON 이
+ * 필드를 생략하므로 빈 배열로 채운다. 반환 타입을 고정해 두지 않으면 호출부가 `.length` 를 읽어도
+ * 컴파일러가 못 잡는다(setup-cli 가 "계정 undefined개" 를 찍었다).
+ */
 export async function listAccessibleCustomers(auth, cfg) {
     const accessToken = await getAccessToken(auth);
     const url = `${BASE}/customers:listAccessibleCustomers`;
@@ -109,7 +114,20 @@ export async function listAccessibleCustomers(auth, cfg) {
     if (!res.ok) {
         throw googleAdsError(res.status, text, [accessToken, cfg.developerToken]);
     }
-    return JSON.parse(text);
+    // SyntaxError 메시지는 본문 앞부분을 그대로 싣는다 — search() 와 같이 프록시 본문을 노출하지 않는다.
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        throw new Error('Google Ads returned invalid JSON.');
+    }
+    // search() 와 같이 200 + error 본문도 거절한다 — 안 그러면 setup 이 "계정 0개" 로 저장해 버린다.
+    const names = isRecord(json) && !('error' in json) ? json.resourceNames ?? [] : null;
+    if (!Array.isArray(names) || names.some((name) => typeof name !== 'string')) {
+        throw new Error('Google Ads returned an invalid accessible-customers response.');
+    }
+    return { resourceNames: names };
 }
 // ─── 캠페인 목록 ─────────────────────────────────────────────
 export async function listCampaigns(auth, cfg) {

package/dist/playstore/products.d.ts

@@ -38,7 +38,7 @@ export declare function updateSubscriptionListings(auth: OAuth2Client | JWT, pac
     productId: string;
     created: string[];
     updated: string[];
-    listings: StoredListing[];
+    listings: import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$SubscriptionListing[];
 }>;
 export declare function updatePurchaseOptionState(auth: OAuth2Client | JWT, packageName: string, productId: string, purchaseOptionId: string, action: 'activate' | 'deactivate'): Promise<{
     productId: string;

package/dist/playstore/products.js

@@ -121,7 +121,7 @@ export async function updateSubscriptionListings(auth, packageName, productId, l
         productId,
         created,
         updated,
-        listings: (res.data?.listings ?? merged),
+        listings: res.data?.listings ?? merged,
     };
 }
 // ─── 구매 옵션 상태 (DRAFT ↔ ACTIVE) ───

package/dist/registers/appstore/apps.d.ts

@@ -0,0 +1,4 @@
+/** App Store Connect 앱 조회와 API 키 검증. */
+import type { ToolRegistrar } from '../../lib/tool-registrar.js';
+/** appstore_list_apps · appstore_verify_credentials · appstore_get_app */
+export declare function registerAppTools(server: ToolRegistrar): void;

package/dist/registers/appstore/apps.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import * as appstore from '../../appstore/tools.js';
+import * as appstoreSales from '../../appstore/sales.js';
+import { jsonResult, textResult } from '../../lib/mcp-response.js';
+/** appstore_list_apps · appstore_verify_credentials · appstore_get_app */
+export function registerAppTools(server) {
+    server.tool('appstore_list_apps', 'App Store Connect 앱 목록 조회', {}, async () => {
+        const apps = await appstore.listApps();
+        return jsonResult(apps);
+    });
+    server.tool('appstore_verify_credentials', [
+        'App Store Connect API 키(appstore.json) 유효성 검증 — JWT 서명 + GET /apps 호출로',
+        'creds/sign/auth/api 단계별 진단. 첫 도구 호출에서 401로 늦게 터지기 전에 setup 직후 확인용.',
+        '매출 리포트 접근 가능 여부도 함께 확인한다 — 그쪽만 요구 롤이 달라서',
+        '(Admin/Finance/Sales and Reports) 앱 메타데이터는 다 되는데 매출만 403 인 키가 흔하다.',
+        '인자 없음.',
+    ].join(' '), {}, async () => {
+        const r = await appstore.verifyAppStoreCredentials();
+        if (r.ok) {
+            // 키가 유효할 때만 물어본다 — 인증 자체가 깨졌으면 403/401 구분이 무의미하다.
+            const reports = await appstoreSales.probeReportsAccess();
+            const reportsIcon = reports.status === 'ok' ? '✓' : reports.status === 'forbidden' ? '✗' : '·';
+            return textResult([
+                '✓ App Store Connect 인증 유효',
+                r.appCount != null ? `   접근 가능 앱: ${r.appCount}개` : '',
+                r.firstApp ? `   예: ${r.firstApp.name ?? r.firstApp.id}` : '',
+                `${reportsIcon} 매출 리포트: ${reports.detail}`,
+                reports.status === 'forbidden'
+                    ? '   → 키 롤은 나중에 못 바꾸는 경우가 있다. 그때는 위 롤로 새 키를 발급해 다시 등록할 것.'
+                    : '',
+            ].filter(Boolean));
+        }
+        return textResult([
+            `✗ 검증 실패 (stage: ${r.stage}${r.httpStatus ? `, HTTP ${r.httpStatus}` : ''})`,
+            '',
+            r.message,
+        ]);
+    });
+    server.tool('appstore_get_app', 'App Store Connect 앱 상세 정보', { appId: z.string().describe('앱 ID (숫자)') }, async ({ appId }) => {
+        const app = await appstore.getApp(appId);
+        return jsonResult(app);
+    });
+}

package/dist/registers/appstore/customer-reviews.d.ts

@@ -0,0 +1,4 @@
+/** App Store 고객 리뷰 조회와 개발자 답변. */
+import type { ToolRegistrar } from '../../lib/tool-registrar.js';
+/** appstore_list_reviews · appstore_reply_review */
+export declare function registerCustomerReviewTools(server: ToolRegistrar): void;

package/dist/registers/appstore/customer-reviews.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import * as appstore from '../../appstore/tools.js';
+import { jsonResult, textResult } from '../../lib/mcp-response.js';
+/** appstore_list_reviews · appstore_reply_review */
+export function registerCustomerReviewTools(server) {
+    server.tool('appstore_list_reviews', [
+        'App Store 받은 고객 리뷰 조회 (최신순).',
+        'response 필드에 개발자 답변 존재 여부와 내용이 함께 포함됨 (없으면 null).',
+        'territory(예: KOR/USA — ISO 3166 alpha-3) / rating(1~5)으로 필터 가능.',
+    ].join(' '), {
+        appId: z.string().describe('App Store 앱 ID (appstore_list_apps 결과)'),
+        limit: z.number().int().positive().max(200).optional().describe('가져올 개수 (기본 50, 최대 200)'),
+        territory: z.string().optional().describe("국가 코드 (예: 'KOR', 'USA' — alpha-3)"),
+        rating: z.union([z.literal(1), z.literal(2), z.literal(3), z.literal(4), z.literal(5)]).optional().describe('별점 필터 (1~5)'),
+    }, async ({ appId, limit, territory, rating }) => {
+        const reviews = await appstore.listCustomerReviews(appId, { limit, territory, rating });
+        return jsonResult(reviews);
+    });
+    server.tool('appstore_reply_review', [
+        'App Store 고객 리뷰에 개발자 답변을 등록 (또는 갱신).',
+        '동일 리뷰에 한 번만 답변 가능 — 기존 답변이 있으면 Apple이 새 응답으로 대체함.',
+        'reviewId는 appstore_list_reviews 결과의 id.',
+        '답변 본문은 5970자 이내.',
+    ].join(' '), {
+        reviewId: z.string().describe('리뷰 ID (appstore_list_reviews 결과)'),
+        responseBody: z.string().describe('답변 본문 (5970자 이내)'),
+    }, async ({ reviewId, responseBody }) => {
+        const result = await appstore.createReviewResponse(reviewId, responseBody);
+        return textResult(`✅ 리뷰 ${reviewId}에 답변 등록됐어.\n\n${JSON.stringify(result, null, 2)}`);
+    });
+}

package/dist/registers/appstore/declarations.d.ts

@@ -0,0 +1,4 @@
+/** 심사 제출 전 선언 — 연령 등급 설문, 수출 규정(암호화), 판매 지역. */
+import type { ToolRegistrar } from '../../lib/tool-registrar.js';
+/** appstore_{get,update}_age_rating · appstore_declare_encryption · appstore_get_availability · appstore_set_territory_availability */
+export declare function registerDeclarationTools(server: ToolRegistrar): void;

package/dist/registers/appstore/declarations.js

@@ -0,0 +1,163 @@
+import { z } from 'zod';
+import * as appstoreDeclarations from '../../appstore/declarations.js';
+import { textResult } from '../../lib/mcp-response.js';
+/** appstore_{get,update}_age_rating · appstore_declare_encryption · appstore_get_availability · appstore_set_territory_availability */
+export function registerDeclarationTools(server) {
+    // ─── 심사 제출 전 선언 ───
+    // 비어 있으면 제출이 막히거나 심사에서 반려되는 항목들. Console 에서만 되는 줄 알았던 것들이다.
+    server.tool('appstore_get_age_rating', [
+        '앱의 연령 등급 설문(ageRatingDeclaration) 현재 값을 읽는다 — 읽기 전용.',
+        'appInfo 에 딸린 단일 리소스이며, 편집 가능한 appInfo 를 자동으로 고른다.',
+        '수정 전에 이걸로 현재 답변을 먼저 확인할 것.',
+    ].join(' '), { appId: z.string().describe('App Store 앱 ID (appstore_list_apps 결과)') }, async ({ appId }) => {
+        const { appInfoId, declarationId, declaration } = await appstoreDeclarations.getAgeRating(appId);
+        const filled = Object.entries(declaration).filter(([, v]) => v !== undefined && v !== null);
+        return textResult([
+            `연령 등급 선언 (appInfo ${appInfoId}${declarationId ? ` · declaration ${declarationId}` : ' · 선언 없음'})`,
+            ...filled.map(([k, v]) => `  ${k}: ${v}`),
+            filled.length === 0 ? '  (아직 답변된 항목 없음)' : '',
+        ].filter(Boolean));
+    });
+    const FREQ = z.enum(['NONE', 'INFREQUENT_OR_MILD', 'FREQUENT_OR_INTENSE', 'INFREQUENT', 'FREQUENT']);
+    const freq = (what) => FREQ.optional().describe(`${what} — NONE / INFREQUENT_OR_MILD / FREQUENT_OR_INTENSE`);
+    server.tool('appstore_update_age_rating', [
+        '연령 등급 설문을 갱신한다 — PATCH /v1/ageRatingDeclarations/{id}.',
+        '넘긴 필드만 바뀐다 (부분 갱신). 전체를 다시 보낼 필요 없다.',
+        '미완성이면 심사 제출이 막히므로 첫 출시 전 반드시 채워야 한다.',
+        'Play 의 콘텐츠 등급 설문과 달리 Apple 은 이렇게 API 로 답변할 수 있다.',
+    ].join(' '), {
+        appId: z.string().describe('App Store 앱 ID'),
+        violenceCartoonOrFantasy: freq('만화/판타지 폭력'),
+        violenceRealistic: freq('사실적 폭력'),
+        violenceRealisticProlongedGraphicOrSadistic: freq('지속적·잔혹한 사실적 폭력'),
+        profanityOrCrudeHumor: freq('욕설/저속한 유머'),
+        matureOrSuggestiveThemes: freq('성인/암시적 주제'),
+        horrorOrFearThemes: freq('공포/공포 유발 주제'),
+        sexualContentOrNudity: freq('성적 콘텐츠 또는 노출'),
+        sexualContentGraphicAndNudity: freq('노골적 성적 콘텐츠·노출'),
+        alcoholTobaccoOrDrugUseOrReferences: freq('음주/흡연/약물'),
+        medicalOrTreatmentInformation: freq('의료/치료 정보'),
+        gamblingSimulated: freq('모의 도박'),
+        contests: freq('경품/콘테스트'),
+        gunsOrOtherWeapons: freq('총기·무기'),
+        gambling: z.boolean().optional().describe('실제 도박 포함 여부'),
+        lootBox: z.boolean().optional().describe('확률형 아이템(루트박스) 포함 여부'),
+        unrestrictedWebAccess: z.boolean().optional().describe('제한 없는 웹 접근'),
+        userGeneratedContent: z.boolean().optional().describe('사용자 생성 콘텐츠'),
+        socialMedia: z.boolean().optional().describe('UGC를 피드·탐색 방식으로 재배포·확산·상호작용하는 소셜 미디어 기능'),
+        socialMediaAgeRestricted: z.boolean().optional().describe('소셜 미디어 기능을 13세 미만 사용자에게 비활성화'),
+        messagingAndChat: z.boolean().optional().describe('메시지/채팅 기능'),
+        advertising: z.boolean().optional().describe('광고 포함'),
+        healthOrWellnessTopics: z.boolean().optional().describe('건강/웰니스 주제'),
+        parentalControls: z.boolean().optional().describe('자녀 보호 기능 제공'),
+        ageAssurance: z.boolean().optional().describe('연령 확인 장치 제공'),
+        kidsAgeBand: z
+            .enum(['FIVE_AND_UNDER', 'SIX_TO_EIGHT', 'NINE_TO_ELEVEN'])
+            .optional()
+            .describe('키즈 카테고리 대상 연령대 (키즈 앱만)'),
+        ageRatingOverrideV2: z
+            .enum(['NONE', 'NINE_PLUS', 'THIRTEEN_PLUS', 'SIXTEEN_PLUS', 'EIGHTEEN_PLUS', 'UNRATED'])
+            .optional()
+            .describe('산출 등급을 더 높게 덮어쓸 때만'),
+        koreaAgeRatingOverride: z
+            .enum(['NONE', 'FIFTEEN_PLUS', 'NINETEEN_PLUS'])
+            .optional()
+            .describe('한국 등급 별도 지정 (게임물관리위원회 등급을 반영해야 할 때)'),
+        developerAgeRatingInfoUrl: z.string().optional().describe('등급 근거 안내 URL'),
+    }, async ({ appId, ...declaration }) => {
+        const { declarationId, declaration: after } = await appstoreDeclarations.updateAgeRating({
+            appId,
+            declaration: declaration,
+        });
+        const changed = Object.keys(declaration).filter((k) => declaration[k] !== undefined);
+        return textResult([
+            `✅ 연령 등급 갱신 (${changed.length}개 항목) — declaration ${declarationId}`,
+            ...changed.map((k) => `  ${k}: ${String(after[k])}`),
+        ]);
+    });
+    server.tool('appstore_declare_encryption', [
+        '수출 규정(암호화) 선언을 만들고 선택한 빌드에 연결한다 — POST /v1/appEncryptionDeclarations.',
+        'Info.plist 의 ITSAppUsesNonExemptEncryption 이 있으면 보통 이 선언이 필요 없다 —',
+        '그게 없어서 ASC 가 "수출 규정 정보 누락"으로 제출을 막을 때 쓰는 경로다.',
+        '⚠️ 법적 신고 성격의 선언이다. 값은 반드시 사용자에게 확인받고 넣을 것.',
+    ].join(' '), {
+        appId: z.string().describe('App Store 앱 ID'),
+        appDescription: z.string().describe('앱이 사용하는 암호화에 대한 설명 (심사용)'),
+        containsProprietaryCryptography: z.boolean().describe('자체 개발한 암호화를 포함하는가'),
+        containsThirdPartyCryptography: z.boolean().describe('서드파티 암호화를 포함하는가'),
+        availableOnFrenchStore: z.boolean().describe('프랑스 스토어에 배포하는가 (프랑스는 별도 신고 규정)'),
+        buildIds: z
+            .array(z.string())
+            .optional()
+            .describe('이 선언을 연결할 빌드 ID들 (appstore_list_builds 결과). 생략 시 선언만 생성'),
+    }, async ({ appId, buildIds, ...attrs }) => {
+        const r = await appstoreDeclarations.declareEncryption({ appId, buildIds, ...attrs });
+        return textResult([
+            '✅ 수출 규정 선언 생성',
+            `  declarationId: ${r.declarationId}`,
+            `  상태: ${r.state ?? '(응답에 없음)'}`,
+            `  연결된 빌드: ${r.attachedBuilds}개`,
+            r.state === 'IN_REVIEW' ? '  Apple 검토 중 — 승인되면 빌드에 반영된다.' : '',
+        ].filter(Boolean));
+    });
+    server.tool('appstore_get_availability', [
+        '앱의 판매 지역 상태를 읽는다 — GET /v1/apps/{id}/appAvailabilityV2.',
+        '판매 중/중지 지역 수와 신규 지역 자동 포함 여부를 보여준다.',
+        'includeTerritories=true 면 지역별 행(id·available·releaseDate)까지 — 이 id 가 변경 도구의 입력이다.',
+    ].join(' '), {
+        appId: z.string().describe('App Store 앱 ID'),
+        includeTerritories: z.boolean().optional().describe('지역 목록까지 반환 (기본 false)'),
+    }, async ({ appId, includeTerritories }) => {
+        const r = await appstoreDeclarations.getAvailability({ appId, includeTerritories });
+        const lines = [
+            `판매 지역 (availability ${r.availabilityId ?? '없음'})`,
+            `  판매 중: ${r.availableCount}개 · 중지: ${r.unavailableCount}개`,
+            `  신규 지역 자동 포함: ${r.availableInNewTerritories === undefined ? '알 수 없음' : r.availableInNewTerritories}`,
+        ];
+        if (r.territories) {
+            for (const t of r.territories) {
+                lines.push(`  ${t.id}: ${t.available ? '판매' : '중지'}` +
+                    (t.releaseDate ? ` · 출시일 ${t.releaseDate}` : '') +
+                    (t.preOrderEnabled ? ' · 사전주문' : ''));
+            }
+        }
+        return textResult(lines.join('\n'));
+    });
+    server.tool('appstore_set_territory_availability', [
+        '지역별 판매 여부·출시일을 바꾼다 — PATCH /v1/territoryAvailabilities/{id}.',
+        'id 는 appstore_get_availability(includeTerritories=true) 결과에서 가져올 것 — 지역 코드를 추측해 넣지 말 것.',
+        '한 지역이 실패해도 나머지는 계속 진행하고, 지역별 성공/실패를 그대로 보고한다.',
+        '⚠️ available=false 는 그 지역에서 앱을 내리는 동작이다.',
+    ].join(' '), {
+        territories: z
+            .array(z.object({
+            id: z.string().describe('territoryAvailability 리소스 id'),
+            available: z.boolean().optional().describe('판매 여부'),
+            releaseDate: z.string().optional().describe('출시일 (YYYY-MM-DD)'),
+            preOrderEnabled: z.boolean().optional().describe('사전주문 활성화'),
+        }))
+            .min(1)
+            .describe('변경할 지역 목록'),
+        confirm: z.boolean().optional().describe('true 명시 시에만 실제 변경. 생략/false 면 변경 예정 목록만 반환.'),
+    }, async ({ territories, confirm }) => {
+        if (!confirm) {
+            return textResult([
+                `🛑 dry-run — ${territories.length}개 지역, 아직 바꾸지 않았다.`,
+                ...territories.map((t) => `  ${t.id}: ` +
+                    [
+                        t.available === undefined ? '' : `판매=${t.available}`,
+                        t.releaseDate ? `출시일=${t.releaseDate}` : '',
+                        t.preOrderEnabled === undefined ? '' : `사전주문=${t.preOrderEnabled}`,
+                    ].filter(Boolean).join(' · ')),
+                '',
+                '실행하려면 confirm: true 로 다시 호출.',
+            ]);
+        }
+        const results = await appstoreDeclarations.setTerritoryAvailability({ territories });
+        const ok = results.filter((r) => r.ok).length;
+        return textResult([
+            `지역 변경: 성공 ${ok} / 실패 ${results.length - ok}`,
+            ...results.filter((r) => !r.ok).map((r) => `  ✗ ${r.id}: ${r.error}`),
+        ]);
+    });
+}

package/dist/registers/appstore/media.d.ts

@@ -0,0 +1,6 @@
+/** 제품 페이지 미디어 — 스크린샷 세트와 미리보기 동영상. */
+import type { ToolRegistrar } from '../../lib/tool-registrar.js';
+/** appstore_list_screenshots · appstore_upload_screenshot · appstore_delete_screenshot(_set) */
+export declare function registerScreenshotTools(server: ToolRegistrar): void;
+/** appstore_list_previews · appstore_upload_preview · appstore_delete_preview */
+export declare function registerPreviewTools(server: ToolRegistrar): void;

package/dist/registers/appstore/media.js

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+import * as appstoreScreenshots from '../../appstore/screenshots.js';
+import * as previews from '../../appstore/previews.js';
+import { jsonResult, textResult } from '../../lib/mcp-response.js';
+/** appstore_list_screenshots · appstore_upload_screenshot · appstore_delete_screenshot(_set) */
+export function registerScreenshotTools(server) {
+    server.tool('appstore_list_screenshots', "App Store 스크린샷 셋 + 이미지 목록 조회 (로컬라이제이션 단위). 디스플레이 타입별로 그룹핑됨", { localizationId: z.string().describe('로컬라이제이션 ID (appstore_get_metadata 결과의 id)') }, async ({ localizationId }) => {
+        const sets = await appstoreScreenshots.listScreenshotSets(localizationId);
+        return jsonResult(sets);
+    });
+    server.tool('appstore_upload_screenshot', [
+        "App Store 스크린샷 업로드 (자동 4단계: 셋 확보 → 예약 → 청크 업로드 → 커밋).",
+        "파일 경로는 로컬 절대경로. displayType은 Apple 공식 enum:",
+        "APP_IPHONE_69 (6.9\", 1290x2796) / APP_IPHONE_67 (6.7\", 1290x2796) /",
+        "APP_IPHONE_65 (6.5\", 1242x2688) / APP_IPHONE_61 (6.1\", 1170x2532) /",
+        "APP_IPHONE_58 (5.8\") / APP_IPHONE_55 (5.5\", 1242x2208) /",
+        "APP_IPAD_PRO_3GEN_129 (13\", 2064x2752) / APP_IPAD_PRO_3GEN_11 (11\", 1668x2388) /",
+        "APP_IPAD_PRO_129 (12.9\", 2048x2732) / APP_DESKTOP (2560x1600+).",
+        "해상도 틀리면 검수에서 리젝됨. 수정 가능한 버전 상태에서만 반영됨.",
+    ].join(' '), {
+        localizationId: z.string().describe('로컬라이제이션 ID'),
+        displayType: z.string().describe('Apple 스크린샷 디스플레이 타입 (예: APP_IPHONE_69)'),
+        filePath: z.string().describe('업로드할 이미지 파일의 절대경로'),
+    }, async ({ localizationId, displayType, filePath }) => {
+        const result = await appstoreScreenshots.uploadScreenshot(localizationId, displayType, filePath);
+        return textResult(`✅ 스크린샷 업로드 완료 (${displayType})\n\n${JSON.stringify(result, null, 2)}`);
+    });
+    server.tool('appstore_delete_screenshot', 'App Store 개별 스크린샷 삭제', { screenshotId: z.string().describe('스크린샷 ID (appstore_list_screenshots 결과)') }, async ({ screenshotId }) => {
+        const result = await appstoreScreenshots.deleteScreenshot(screenshotId);
+        return textResult(`✅ 스크린샷 삭제됨\n${JSON.stringify(result, null, 2)}`);
+    });
+    server.tool('appstore_delete_screenshot_set', 'App Store 스크린샷 셋 전체 삭제 (디스플레이 타입 교체 시 먼저 정리)', { setId: z.string().describe('스크린샷 셋 ID (appstore_list_screenshots 결과)') }, async ({ setId }) => {
+        const result = await appstoreScreenshots.deleteScreenshotSet(setId);
+        return textResult(`✅ 셋 삭제됨\n${JSON.stringify(result, null, 2)}`);
+    });
+}
+/** appstore_list_previews · appstore_upload_preview · appstore_delete_preview */
+export function registerPreviewTools(server) {
+    // ─── 제품 페이지 미리보기 동영상 ───
+    // 스크린샷과 같은 4단계 업로드지만, 커밋 후 Apple 인코딩이 남는다 — 업로드 성공 ≠ 노출 가능.
+    const PREVIEW_TYPES = [
+        'IPHONE_67', 'IPHONE_61', 'IPHONE_65', 'IPHONE_58', 'IPHONE_55', 'IPHONE_47', 'IPHONE_40', 'IPHONE_35',
+        'IPAD_PRO_3GEN_129', 'IPAD_PRO_3GEN_11', 'IPAD_PRO_129', 'IPAD_105', 'IPAD_97',
+        'DESKTOP', 'APPLE_TV', 'APPLE_VISION_PRO',
+    ];
+    server.tool('appstore_list_previews', [
+        '버전 로케일의 미리보기 동영상 세트를 조회한다 — 읽기 전용.',
+        '세트별 previewType 과 각 동영상의 처리 상태(assetDeliveryState)·포스터 프레임·videoUrl 을 보여준다.',
+        '업로드 직후 인코딩이 끝났는지 확인할 때도 이걸 쓴다.',
+    ].join(' '), {
+        localizationId: z
+            .string()
+            .describe('appStoreVersionLocalization ID (appstore_get_metadata 결과의 로케일별 id)'),
+    }, async ({ localizationId }) => {
+        const sets = await previews.listPreviewSets(localizationId);
+        if (sets.length === 0) {
+            return textResult('미리보기 세트 없음.');
+        }
+        const lines = [];
+        for (const s of sets) {
+            lines.push(`${s.previewType ?? '?'} (set ${s.id}) — ${s.previews.length}개`);
+            for (const p of s.previews) {
+                lines.push(`  ${p.id}: ${p.fileName ?? '?'} · ${p.state ?? '상태 미상'}` +
+                    (p.previewFrameTimeCode ? ` · 포스터 ${p.previewFrameTimeCode}` : '') +
+                    (p.videoUrl ? ' · 재생 가능' : ''));
+            }
+        }
+        return textResult(lines.join('\n'));
+    });
+    server.tool('appstore_upload_preview', [
+        '제품 페이지 미리보기 **동영상**을 업로드한다 — appPreviewSets/appPreviews 4단계 업로드.',
+        'previewType 세트가 없으면 만들고, 예약 → 조각 업로드 → 커밋까지 한 번에 처리한다.',
+        '⚠️ 커밋 후 Apple 인코딩이 남는다 — 성공 응답이 곧 노출 가능은 아니다. appstore_list_previews 로 확인할 것.',
+        'Apple 제약: 길이 15~30초, previewType 별 해상도 고정, 로케일·타입당 최대 3개. 어기면 인코딩 단계에서 거부된다.',
+        'previewFrameTimeCode(HH:MM:SS:FF)로 포스터 프레임을 지정할 수 있다.',
+        '파일은 절대경로로 넘긴다 (대용량이라 조각 업로드하며, 동영상 바이트는 대화에 싣지 않는다).',
+    ].join(' '), {
+        localizationId: z.string().describe('appStoreVersionLocalization ID'),
+        previewType: z.enum(PREVIEW_TYPES).describe('미리보기 타입 (기기군)'),
+        filePath: z.string().describe('동영상 파일 절대경로 (.mp4 / .mov / .m4v)'),
+        previewFrameTimeCode: z
+            .string()
+            .optional()
+            .describe('포스터 프레임 시각 HH:MM:SS:FF (예: 00:00:03:00)'),
+    }, async ({ localizationId, previewType, filePath, previewFrameTimeCode }) => {
+        const r = await previews.uploadPreview({ localizationId, previewType, filePath, previewFrameTimeCode });
+        return textResult([
+            '✅ 미리보기 업로드 완료 (인코딩 대기)',
+            `  id: ${r.id}`,
+            `  파일: ${r.fileName} (${(r.fileSize / 1024 / 1024).toFixed(1)} MB)`,
+            `  타입: ${r.previewType}`,
+            `  상태: ${r.state ?? '처리 중'}`,
+            'Apple 인코딩이 끝나야 노출된다 — appstore_list_previews 로 상태를 확인할 것.',
+        ]);
+    });
+    server.tool('appstore_delete_preview', [
+        '미리보기 동영상 또는 세트를 삭제한다 — DELETE /v1/appPreviews/{id} 또는 /appPreviewSets/{id}.',
+        '⚠️ 되돌릴 수 없다. 세트를 지우면 그 안의 동영상이 모두 사라진다. confirm 필요.',
+    ].join(' '), {
+        previewId: z.string().optional().describe('삭제할 미리보기 ID (set 과 둘 중 하나)'),
+        setId: z.string().optional().describe('삭제할 미리보기 세트 ID (안의 동영상 전부 삭제)'),
+        confirm: z.boolean().optional().describe('true 명시 시에만 삭제'),
+    }, async ({ previewId, setId, confirm }) => {
+        if (!previewId && !setId)
+            throw new Error('previewId 또는 setId 중 하나는 필요하다.');
+        if (!confirm) {
+            return textResult(previewId
+                ? `🛑 dry-run — 미리보기 ${previewId} 를 삭제할 참이다. confirm: true 로 다시 호출.`
+                : `🛑 dry-run — 세트 ${setId} 와 그 안의 동영상 전부를 삭제할 참이다. confirm: true 로 다시 호출.`);
+        }
+        const r = previewId
+            ? await previews.deletePreview(previewId)
+            : await previews.deletePreviewSet(setId);
+        return textResult(`✅ 삭제 완료 — ${r.id}`);
+    });
+}

package/dist/registers/appstore/metadata.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 스토어 메타데이터 — 버전 로컬라이제이션(설명 · 키워드 · What's New), 심사 리뷰어 노트,
+ * appInfo 와 그 로컬라이제이션(앱 이름 · 부제 · 개인정보 URL).
+ */
+import type { ToolRegistrar } from '../../lib/tool-registrar.js';
+/** appstore_get_metadata · appstore_update_localization */
+export declare function registerVersionLocalizationTools(server: ToolRegistrar): void;
+/** appstore_update_whats_new · appstore_update_review_notes · appstore_get_review_notes */
+export declare function registerWhatsNewAndReviewNoteTools(server: ToolRegistrar): void;
+/** appstore_get_app_info · appstore_{list,update,create}_app_info_localization(s) */
+export declare function registerAppInfoTools(server: ToolRegistrar): void;