@yoonion/mimi-seed-mcp 0.6.6 → 0.7.0

package/README.md

@@ -42,17 +42,29 @@ npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
 
 브라우저가 열리면 Google 계정으로 로그인. 토큰은 `~/.mimi-seed/tokens.json`에 저장되고 자동 갱신됨.
 
-플랫폼별 추가 인증 (필요한 것만):
+나머지 계정은 **마법사 하나로** 연결하는 게 가장 빠릅니다 — 뭐가 빠졌는지 보여주고, 각 토큰을 어디서
+발급받는지도 알려줍니다:
 
 ```bash
-npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth    # App Store Connect (API Key)
-npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth   # Google Play 서비스 계정 JSON
-npx -y @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth    # BigQuery (Crashlytics export 등)
+npx mimi-seed setup
 ```
 
-- **App Store Connect**: Users and Access → Keys에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력 → `~/.mimi-seed/appstore.json`
-- **Google Play**: Play Console 서비스 계정 JSON 경로 입력 (패키지별 등록)
-- **BigQuery**: Google OAuth 또는 서비스 계정으로 데이터셋 조회 권한 부여
+개별로 실행하고 싶다면 (전부 대화형):
+
+```bash
+npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth     # App Store Connect (API Key)
+npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth    # Google Play 서비스 계정 JSON
+npx -y @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth     # BigQuery
+npx -y @yoonion/mimi-seed-mcp mimi-seed-jenkins-auth      # Jenkins (저장 전 서버 프로브)
+npx -y @yoonion/mimi-seed-mcp mimi-seed-googleads-auth    # Google Ads (저장 전 실제 호출로 검증)
+npx -y @yoonion/mimi-seed-mcp mimi-seed-social-auth       # Facebook / Instagram
+```
+
+각 자격증명을 **어디서 어떻게 발급받는지**는 [`docs/credentials.md`](../../docs/credentials.md) 참고.
+
+- **App Store Connect**: Users and Access → Integrations에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력 → `~/.mimi-seed/appstore.json` (.p8은 **1회만** 다운로드됨)
+- **Google Play**: 서비스 계정은 **선택** — OAuth 토큰이 `androidpublisher` 스코프를 갖고 있어 로컬 작업은 그대로 됩니다. CI/헤드리스에서만 필요.
+- **BigQuery**: 선택 — OAuth로도 동작하며, Workspace 재인증 정책에 막힐 때만 서비스 계정이 필요합니다.
 
 AI 기능(릴리즈 노트 생성, 리뷰 답변)을 쓰려면:
 
@@ -66,8 +78,8 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 | 영역 | 도구 수 | 주요 도구 |
 |------|---------|-----------|
-| App Store Connect | 33 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_product_review_note` / `appstore_upload_product_review_screenshot` |
-| Google Play | 28 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
+| App Store Connect | 34 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_product_review_note` / `appstore_upload_product_review_screenshot` |
+| Google Play | 29 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
 | Firebase | 20 | `firebase_create_project` / `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` |
 | AdMob | 7 | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
 | CI/CD (GitHub Actions · GitLab) | 6 | `ci_trigger_build` / `ci_get_build_status` / `ci_list_workflows` / `ci_cancel_build` |

package/dist/facebook/setup.d.ts

@@ -0,0 +1,6 @@
+export interface ConnectResult {
+    ok: boolean;
+    /** 사용자에게 그대로 보여줄 메시지 (MCP 는 content 로 감싸고, CLI 는 그대로 출력). */
+    text: string;
+}
+export declare function connectFacebook(pageAccessToken: string, pageId?: string): Promise<ConnectResult>;

package/dist/facebook/setup.js

@@ -0,0 +1,72 @@
+// Facebook 페이지 연결 — pageId 자동 조회 → 토큰 검증 → 검증 성공 시에만 저장.
+//
+// 이 로직은 MCP 도구(facebook_save_config)와 setup CLI(mimi-seed-social-auth)가 **공유**한다.
+// 둘 중 하나에만 검증이 있으면 "CLI 로 저장했는데 도구가 못 읽는" 류의 드리프트가 생긴다.
+import { saveFacebookConfig } from './config.js';
+import * as api from './api.js';
+const SIXTY_DAYS_MS = 60 * 24 * 60 * 60 * 1000;
+export async function connectFacebook(pageAccessToken, pageId) {
+    let resolvedPageId = pageId;
+    if (!resolvedPageId) {
+        try {
+            const pages = await api.listAccessiblePages(pageAccessToken);
+            if (pages.length === 0) {
+                // 이미 Page Access Token 인 경우 — /me 가 곧 페이지다.
+                const res = await fetch(`https://graph.facebook.com/v21.0/me?fields=id,name&access_token=${pageAccessToken}`);
+                const data = (await res.json());
+                if (data.error)
+                    throw new Error(`${data.error.message} (code ${data.error.code})`);
+                resolvedPageId = data.id;
+            }
+            else if (pages.length === 1) {
+                resolvedPageId = pages[0].id;
+            }
+            else {
+                const list = pages.map((p) => `  • ${p.name} (${p.id})`).join('\n');
+                return {
+                    ok: false,
+                    text: ['여러 페이지에 접근 가능합니다. pageId를 명시해주세요:', list].join('\n'),
+                };
+            }
+        }
+        catch (err) {
+            return { ok: false, text: `❌ pageId 자동 조회 실패: ${err.message}` };
+        }
+    }
+    try {
+        const page = await api.getPage({ pageAccessToken, pageId: resolvedPageId });
+        saveFacebookConfig({
+            pageAccessToken,
+            pageId: resolvedPageId,
+            pageName: page.name,
+            expiresAt: new Date(Date.now() + SIXTY_DAYS_MS).toISOString(),
+        });
+        return {
+            ok: true,
+            text: [
+                '✅ Facebook 페이지 연결 완료',
+                `   페이지: ${page.name}`,
+                `   ID: ${page.id}`,
+                page.category ? `   카테고리: ${page.category}` : '',
+                page.followers_count !== undefined
+                    ? `   팔로워: ${page.followers_count.toLocaleString()}`
+                    : '',
+                page.fan_count !== undefined ? `   좋아요: ${page.fan_count.toLocaleString()}` : '',
+            ]
+                .filter(Boolean)
+                .join('\n'),
+        };
+    }
+    catch (err) {
+        // 검증 실패 → 저장하지 않는다.
+        return {
+            ok: false,
+            text: [
+                '❌ 토큰 검증 실패',
+                `   ${err.message}`,
+                '',
+                'Page Access Token을 다시 확인하거나 facebook_list_pages로 페이지 목록을 조회하세요.',
+            ].join('\n'),
+        };
+    }
+}

package/dist/googleads/setup-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/googleads/setup-cli.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+// mimi-seed-googleads-auth — Google Ads 연결 설정 (~/.mimi-seed/google-ads.json).
+//
+// Ads 는 Google OAuth 토큰의 `adwords` 스코프를 타므로, 개발자 토큰만 있어도 스코프가 없으면
+// 실패한다. 저장 후 listAccessibleCustomers 로 **실제 호출**해서 그 경우를 여기서 잡아낸다.
+import readline from 'node:readline';
+import { loadConfig, saveConfig, normalizeCustomerId } from './config.js';
+import { listAccessibleCustomers } from './tools.js';
+import { getAuthenticatedClient } from '../auth/google-auth.js';
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+const ask = (q) => new Promise((r) => rl.question(q, (a) => r(a.trim())));
+async function main() {
+    console.log('');
+    console.log('  🤖 Mimi Seed — Google Ads 연결');
+    console.log('');
+    const existing = loadConfig();
+    if (existing) {
+        console.log(`  ✅ 이미 연결됨 (customerId: ${existing.customerId})`);
+        const answer = await ask('  다시 설정할래? (y/N): ');
+        if (answer.toLowerCase() !== 'y') {
+            rl.close();
+            return;
+        }
+    }
+    console.log('  필요한 것 2가지:');
+    console.log('  1. Developer Token — Google Ads → 도구 및 설정 → 설정 → API 센터');
+    console.log('     ⚠️  최초 발급은 "테스트" 등급이고, 실계정 조회는 **승인 심사**를 거쳐야 해.');
+    console.log('  2. Customer ID — Google Ads 우상단 계정 번호 (예: 123-456-7890)');
+    console.log('');
+    const developerToken = await ask('  Developer Token: ');
+    const customerId = await ask('  Customer ID (예: 123-456-7890): ');
+    const loginCustomerId = await ask('  MCC(관리자) 계정 ID (선택, 엔터 스킵): ');
+    if (!developerToken || !customerId) {
+        console.log('  ❌ Developer Token 과 Customer ID 는 필수야.');
+        rl.close();
+        process.exit(1);
+    }
+    const cfg = {
+        developerToken,
+        customerId: normalizeCustomerId(customerId),
+        loginCustomerId: loginCustomerId ? normalizeCustomerId(loginCustomerId) : undefined,
+    };
+    // 검증을 **저장보다 먼저** 한다 (jenkins/facebook/instagram 과 같은 규율).
+    // 먼저 저장해버리면 (a) 403 나는 설정인데 doctor 가 ✓ 로 표시하고,
+    // (b) 오타 한 번에 잘 되던 기존 설정이 백업 없이 덮여 날아간다.
+    const auth = getAuthenticatedClient();
+    if (!auth) {
+        console.log('');
+        console.log('  ❌ Google OAuth 토큰이 없어 검증할 수 없어. 저장하지 않았어.');
+        console.log('     먼저: npx -y @yoonion/mimi-seed-mcp mimi-seed-auth');
+        rl.close();
+        process.exit(1);
+    }
+    console.log('');
+    console.log('  🔎 접근 가능한 고객 계정 조회 중...');
+    try {
+        const customers = await listAccessibleCustomers(auth, cfg);
+        console.log(`  ✅ 접근 OK — 계정 ${customers.length}개`);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.log(`  ❌ 검증 실패: ${msg}`);
+        console.log('');
+        if (/scope|insufficient|PERMISSION_DENIED/i.test(msg)) {
+            console.log('  → OAuth 토큰에 `adwords` 스코프가 없을 가능성이 커.');
+            console.log('     재인증: npx -y @yoonion/mimi-seed-mcp mimi-seed-auth --force');
+        }
+        else {
+            console.log('  → Developer Token 등급(테스트/승인)과 Customer ID 를 다시 확인해줘.');
+        }
+        console.log('');
+        console.log('  저장하지 않았어 (기존 설정이 있으면 그대로 유지된다).');
+        rl.close();
+        process.exit(1);
+    }
+    saveConfig(cfg);
+    console.log('');
+    console.log('  ✅ 저장 완료 → ~/.mimi-seed/google-ads.json');
+    console.log('');
+    rl.close();
+}
+main().catch((e) => {
+    console.error(`\n  ❌ ${e instanceof Error ? e.message : String(e)}\n`);
+    rl.close();
+    process.exit(1);
+});

package/dist/index.js

@@ -14,6 +14,9 @@ const SUBCOMMANDS = {
     'mimi-seed-playstore-auth': () => import('./auth/playstore-setup-cli.js'),
     'mimi-seed-appstore-auth': () => import('./appstore/setup-cli.js'),
     'mimi-seed-bigquery-auth': () => import('./auth/bigquery-setup-cli.js'),
+    'mimi-seed-jenkins-auth': () => import('./jenkins/setup-cli.js'),
+    'mimi-seed-googleads-auth': () => import('./googleads/setup-cli.js'),
+    'mimi-seed-social-auth': () => import('./social/setup-cli.js'),
     'mimi-seed-firebase': () => import('./firebase/cli.js'),
     'mimi-seed-admob': () => import('./admob/cli.js'),
     'mimi-seed-ga4': () => import('./ga4/cli.js'),

package/dist/instagram/setup.d.ts

@@ -0,0 +1,4 @@
+import type { ConnectResult } from '../facebook/setup.js';
+/** IGAA… = Instagram Login(신규) · EAA… = Facebook Login(FB Page + IG Business 연결 필요) */
+export declare function detectApiType(accessToken: string): string;
+export declare function connectInstagram(accessToken: string, userId?: string, assumeIssuedNow?: boolean): Promise<ConnectResult>;

package/dist/instagram/setup.js

@@ -0,0 +1,70 @@
+// Instagram 연결 — userId 자동 조회 → 토큰 검증 → 검증 성공 시에만 저장.
+// MCP 도구(instagram_save_config)와 setup CLI(mimi-seed-social-auth)가 **공유**하는 구현.
+import { saveInstagramConfig } from './config.js';
+import * as api from './api.js';
+const SIXTY_DAYS_MS = 60 * 24 * 60 * 60 * 1000;
+/** IGAA… = Instagram Login(신규) · EAA… = Facebook Login(FB Page + IG Business 연결 필요) */
+export function detectApiType(accessToken) {
+    return accessToken.startsWith('IGAA') ? 'Instagram Login' : 'Facebook Login';
+}
+export async function connectInstagram(accessToken, userId, assumeIssuedNow = true) {
+    const apiType = detectApiType(accessToken);
+    let resolvedUserId = userId;
+    if (!resolvedUserId) {
+        try {
+            resolvedUserId = await api.fetchUserId(accessToken);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                text: [
+                    `❌ userId 자동 조회 실패 (${apiType})`,
+                    `   ${err.message}`,
+                    '',
+                    'userId를 명시적으로 전달하거나 토큰을 다시 확인하세요.',
+                ].join('\n'),
+            };
+        }
+    }
+    const expiresAt = assumeIssuedNow
+        ? new Date(Date.now() + SIXTY_DAYS_MS).toISOString()
+        : undefined;
+    try {
+        const account = await api.getAccount({ accessToken, userId: resolvedUserId });
+        saveInstagramConfig({
+            accessToken,
+            userId: resolvedUserId,
+            expiresAt,
+            username: account.username,
+        });
+        return {
+            ok: true,
+            text: [
+                `✅ Instagram 연결 확인 완료 (${apiType})`,
+                `   계정: @${account.username}${account.name ? ` (${account.name})` : ''}`,
+                `   ID: ${account.id}`,
+                account.account_type ? `   타입: ${account.account_type}` : '',
+                account.followers_count !== undefined
+                    ? `   팔로워: ${account.followers_count.toLocaleString()}`
+                    : '',
+                account.media_count !== undefined ? `   게시물: ${account.media_count}` : '',
+                expiresAt ? `   토큰 만료(추정): ${expiresAt.slice(0, 10)}` : '',
+            ]
+                .filter(Boolean)
+                .join('\n'),
+        };
+    }
+    catch (err) {
+        // 검증 실패 → 저장하지 않는다.
+        return {
+            ok: false,
+            text: [
+                `❌ 토큰 검증 실패 (${apiType})`,
+                `   userId: ${resolvedUserId}`,
+                `   ${err.message}`,
+                '',
+                '토큰을 다시 발급받거나 userId를 직접 지정해보세요.',
+            ].join('\n'),
+        };
+    }
+}

package/dist/jenkins/config.d.ts

@@ -2,7 +2,17 @@ export interface JenkinsConfig {
     url: string;
     username: string;
     token: string;
+    jobAndroid?: string;
+    jobIos?: string;
 }
 export declare function loadJenkinsConfig(): JenkinsConfig | null;
-export declare function saveJenkinsConfig(config: JenkinsConfig): void;
+/**
+ * jenkins.json 저장 — **기존 값 위에 병합한다** (통째로 덮어쓰지 않는다).
+ *
+ * 이 파일에는 두 종류의 필드가 산다: 연결 정보(url/username/token)는 MCP 도구
+ * `jenkins_save_config` 가, 빌드 잡 이름(jobAndroid/jobIos)은 CLI 의 setup 이 쓴다.
+ * 통째로 덮어쓰면 한쪽이 다른 쪽 값을 지운다 — 예전에 Jenkins 설정이 config.json 과
+ * jenkins.json 으로 갈라졌던 것과 같은 종류의 사고다. undefined 인 필드는 건드리지 않는다.
+ */
+export declare function saveJenkinsConfig(config: Partial<JenkinsConfig> & Pick<JenkinsConfig, 'url' | 'username' | 'token'>): void;
 export declare function requireJenkinsConfig(): JenkinsConfig;

package/dist/jenkins/config.js

@@ -11,11 +11,24 @@ export function loadJenkinsConfig() {
         return null;
     }
 }
+/**
+ * jenkins.json 저장 — **기존 값 위에 병합한다** (통째로 덮어쓰지 않는다).
+ *
+ * 이 파일에는 두 종류의 필드가 산다: 연결 정보(url/username/token)는 MCP 도구
+ * `jenkins_save_config` 가, 빌드 잡 이름(jobAndroid/jobIos)은 CLI 의 setup 이 쓴다.
+ * 통째로 덮어쓰면 한쪽이 다른 쪽 값을 지운다 — 예전에 Jenkins 설정이 config.json 과
+ * jenkins.json 으로 갈라졌던 것과 같은 종류의 사고다. undefined 인 필드는 건드리지 않는다.
+ */
 export function saveJenkinsConfig(config) {
     if (!fs.existsSync(CONFIG_DIR)) {
         fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
     }
-    fs.writeFileSync(JENKINS_CONFIG_PATH, JSON.stringify(config, null, 2), { mode: 0o600 });
+    const existing = loadJenkinsConfig() ?? {};
+    const merged = { ...existing, ...stripUndefined(config) };
+    fs.writeFileSync(JENKINS_CONFIG_PATH, JSON.stringify(merged, null, 2), { mode: 0o600 });
+}
+function stripUndefined(o) {
+    return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
 }
 export function requireJenkinsConfig() {
     const cfg = loadJenkinsConfig();

package/dist/jenkins/setup-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/jenkins/setup-cli.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+// mimi-seed-jenkins-auth — Jenkins 연결 설정 (~/.mimi-seed/jenkins.json).
+//
+// jenkins_save_config 도구와 달리 저장 **전에** 실제 서버를 프로브한다 (listCredentials).
+// 잘못된 URL/토큰이 조용히 저장돼서 deploy 때 터지는 걸 막는다.
+import readline from 'node:readline';
+import { loadJenkinsConfig, saveJenkinsConfig } from './config.js';
+import { listCredentials } from './credentials.js';
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+const ask = (q) => new Promise((r) => rl.question(q, (a) => r(a.trim())));
+async function main() {
+    console.log('');
+    console.log('  🤖 Mimi Seed — Jenkins 연결');
+    console.log('');
+    const existing = loadJenkinsConfig();
+    if (existing) {
+        console.log(`  ✅ 이미 연결됨 (${existing.url})`);
+        const answer = await ask('  다시 설정할래? (y/N): ');
+        if (answer.toLowerCase() !== 'y') {
+            rl.close();
+            return;
+        }
+    }
+    console.log('  API Token 발급: Jenkins → [사용자 이름] → 설정 → API Token → "Add new Token"');
+    console.log('  로컬 Jenkins 가 없어도 회사·원격 서버 URL 을 그대로 쓰면 돼.');
+    console.log('');
+    const url = await ask('  Jenkins URL (예: https://jenkins.company.com): ');
+    const username = await ask('  Jenkins 사용자 ID: ');
+    const token = await ask('  Jenkins API Token: ');
+    if (!url || !username || !token) {
+        console.log('  ❌ URL / 사용자 ID / 토큰은 모두 필요해.');
+        rl.close();
+        process.exit(1);
+    }
+    console.log('');
+    console.log('  🔎 연결 확인 중...');
+    const cfg = { url: url.replace(/\/+$/, ''), username, token };
+    try {
+        const creds = await listCredentials(cfg);
+        console.log(`  ✅ 연결 OK — 크리덴셜 ${creds.length}개 조회됨`);
+    }
+    catch (e) {
+        console.log(`  ❌ 연결 실패: ${e instanceof Error ? e.message : String(e)}`);
+        console.log('');
+        console.log('  확인할 것:');
+        console.log('   • URL 이 Jenkins 대시보드 주소와 같은지 (예: https://jenkins.company.com)');
+        console.log('   • 비밀번호가 아니라 **API Token** 을 넣었는지');
+        console.log('   • 그 계정에 Credentials 조회 권한이 있는지');
+        console.log('');
+        console.log('  저장하지 않았어. 값을 확인하고 다시 실행해줘.');
+        rl.close();
+        process.exit(1);
+    }
+    // deploy 가 트리거할 잡 이름 (선택) — 같은 파일에 함께 저장한다.
+    // 재설정(토큰 교체 등) 시 엔터로 넘기면 **기존 값을 유지한다** — 조용히 지워버리면
+    // 다음 `mimi-seed deploy` 가 "job 이 설정되지 않았습니다" 로 죽는다.
+    const keep = (cur) => (cur ? ` (현재: ${cur}, 엔터=유지)` : ' (선택, 엔터 스킵)');
+    const jobAndroid = await ask(`  Android 빌드 Job 이름${keep(existing?.jobAndroid)}: `);
+    const jobIos = await ask(`  iOS 빌드 Job 이름${keep(existing?.jobIos)}: `);
+    saveJenkinsConfig({
+        ...cfg,
+        jobAndroid: jobAndroid || existing?.jobAndroid,
+        jobIos: jobIos || existing?.jobIos,
+    });
+    console.log('');
+    console.log('  ✅ 저장 완료 → ~/.mimi-seed/jenkins.json');
+    console.log('     확인: mimi-seed doctor  ·  빌드: mimi-seed deploy');
+    console.log('');
+    rl.close();
+}
+main().catch((e) => {
+    console.error(`\n  ❌ ${e instanceof Error ? e.message : String(e)}\n`);
+    rl.close();
+    process.exit(1);
+});

package/dist/registers/auth.js

@@ -121,7 +121,9 @@ export function registerAuthTools(server) {
             lines.push(`✅ Play Store SA     — ${saCount}개 등록 (${detail})`);
         }
         else {
-            lines.push('❌ Play Store SA     — 미설정 → playstore_register_service_account 또는 setup_playstore_connection');
+            // SA 는 CI/헤드리스 전용 — 로컬은 OAuth(androidpublisher scope)로 대부분의 Play 작업이 된다.
+            // (helpers.ts requirePlayStoreAuth 가 SA → OAuth 로 폴백한다.) "필수"로 표기하면 안 된다.
+            lines.push('⚠️  Play Store SA     — 미설정 (선택 — 로컬은 OAuth 로 가능, CI/헤드리스는 필수) → setup_playstore_connection');
         }
         // 3. App Store Connect
         const asc = getAppStoreCredentials();
@@ -188,12 +190,11 @@ export function registerAuthTools(server) {
         if (oauthResult.status !== 'fresh' && oauthResult.status !== 'refreshed') {
             missing.push('  1. mimi_seed_auth_start  (Google 계정 로그인 — Firebase/AdMob/GSC 등 필수)');
         }
-        if (saCount === 0) {
-            missing.push('  2. setup_playstore_connection(packageName=..., projectId=...)  (Play Store 배포 필수)');
-        }
         if (!asc) {
-            missing.push('  3. npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth  (App Store 배포 필수)');
+            missing.push('  2. npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth  (App Store 배포 필수)');
         }
+        // Play SA 는 "다음 단계 (필수)" 에 넣지 않는다 — OAuth 로 대부분의 Play 작업이 되므로.
+        // CI/헤드리스에서만 필요하고, 그 안내는 위 상태 줄(⚠️)에 이미 있다.
         if (missing.length > 0) {
             lines.push('', '── 다음 단계 (필수) ─────────────────────────────', ...missing);
         }

package/dist/registers/facebook.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { loadFacebookConfig, requireFacebookConfig, saveFacebookConfig } from '../facebook/config.js';
+import { loadFacebookConfig, requireFacebookConfig } from '../facebook/config.js';
+import { connectFacebook } from '../facebook/setup.js';
 import * as api from '../facebook/api.js';
 export function registerFacebookTools(server) {
     server.tool('facebook_save_config', [
@@ -11,80 +12,9 @@ export function registerFacebookTools(server) {
         pageAccessToken: z.string().describe('Facebook Page Access Token (EAA..., long-lived 권장)'),
         pageId: z.string().optional().describe('Facebook Page ID (생략 시 토큰에서 자동 조회)'),
     }, async ({ pageAccessToken, pageId }) => {
-        // Resolve pageId
-        let resolvedPageId = pageId;
-        if (!resolvedPageId) {
-            try {
-                const me = await api.listAccessiblePages(pageAccessToken);
-                if (me.length === 0) {
-                    // Try /me directly (already a Page Access Token)
-                    const res = await fetch(`https://graph.facebook.com/v21.0/me?fields=id,name&access_token=${pageAccessToken}`);
-                    const data = await res.json();
-                    if (data.error)
-                        throw new Error(`${data.error.message} (code ${data.error.code})`);
-                    resolvedPageId = data.id;
-                }
-                else if (me.length === 1) {
-                    resolvedPageId = me[0].id;
-                }
-                else {
-                    const list = me.map(p => `  • ${p.name} (${p.id})`).join('\n');
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: [
-                                    '여러 페이지에 접근 가능합니다. pageId를 명시해주세요:',
-                                    list,
-                                ].join('\n'),
-                            }],
-                    };
-                }
-            }
-            catch (err) {
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `❌ pageId 자동 조회 실패: ${err.message}`,
-                        }],
-                };
-            }
-        }
-        try {
-            const cfg = { pageAccessToken, pageId: resolvedPageId };
-            const page = await api.getPage(cfg);
-            saveFacebookConfig({
-                pageAccessToken,
-                pageId: resolvedPageId,
-                pageName: page.name,
-                expiresAt: new Date(Date.now() + 60 * 24 * 60 * 60 * 1000).toISOString(),
-            });
-            return {
-                content: [{
-                        type: 'text',
-                        text: [
-                            `✅ Facebook 페이지 연결 완료`,
-                            `   페이지: ${page.name}`,
-                            `   ID: ${page.id}`,
-                            page.category ? `   카테고리: ${page.category}` : '',
-                            page.followers_count !== undefined ? `   팔로워: ${page.followers_count.toLocaleString()}` : '',
-                            page.fan_count !== undefined ? `   좋아요: ${page.fan_count.toLocaleString()}` : '',
-                        ].filter(Boolean).join('\n'),
-                    }],
-            };
-        }
-        catch (err) {
-            return {
-                content: [{
-                        type: 'text',
-                        text: [
-                            `❌ 토큰 검증 실패`,
-                            `   ${err.message}`,
-                            ``,
-                            `Page Access Token을 다시 확인하거나 facebook_list_pages로 페이지 목록을 조회하세요.`,
-                        ].join('\n'),
-                    }],
-            };
-        }
+        // 구현은 facebook/setup.ts 에 있다 — mimi-seed-social-auth CLI 와 공유한다.
+        const result = await connectFacebook(pageAccessToken, pageId);
+        return { content: [{ type: 'text', text: result.text }] };
     });
     server.tool('facebook_list_pages', 'User Access Token으로 접근 가능한 Facebook 페이지 목록을 조회합니다. 페이지별 Page Access Token도 함께 반환.', {
         userAccessToken: z.string().describe('Facebook User Access Token (EAA...)'),

package/dist/registers/instagram.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { requireInstagramConfig, saveInstagramConfig } from '../instagram/config.js';
+import { requireInstagramConfig } from '../instagram/config.js';
+import { connectInstagram } from '../instagram/setup.js';
 import * as api from '../instagram/api.js';
 export function registerInstagramTools(server) {
     server.tool('instagram_save_config', [
@@ -14,70 +15,9 @@ export function registerInstagramTools(server) {
         userId: z.string().optional().describe('Instagram Business Account ID (생략 시 자동 조회)'),
         assumeIssuedNow: z.boolean().default(true).describe('expiresAt = 지금 + 60일 자동 계산'),
     }, async ({ accessToken, userId, assumeIssuedNow }) => {
-        const apiType = accessToken.startsWith('IGAA') ? 'Instagram Login' : 'Facebook Login';
-        // userId 자동 조회
-        let resolvedUserId = userId;
-        if (!resolvedUserId) {
-            try {
-                resolvedUserId = await api.fetchUserId(accessToken);
-            }
-            catch (err) {
-                return {
-                    content: [{
-                            type: 'text',
-                            text: [
-                                `❌ userId 자동 조회 실패 (${apiType})`,
-                                `   ${err.message}`,
-                                ``,
-                                `userId를 명시적으로 전달하거나 토큰을 다시 확인하세요.`,
-                            ].join('\n'),
-                        }],
-                };
-            }
-        }
-        const expiresAt = assumeIssuedNow
-            ? new Date(Date.now() + 60 * 24 * 60 * 60 * 1000).toISOString()
-            : undefined;
-        // 검증 — 잘못된 토큰이면 즉시 알림
-        try {
-            const account = await api.getAccount({ accessToken, userId: resolvedUserId });
-            // 검증 성공 → 최종 저장
-            saveInstagramConfig({
-                accessToken,
-                userId: resolvedUserId,
-                expiresAt,
-                username: account.username,
-            });
-            return {
-                content: [{
-                        type: 'text',
-                        text: [
-                            `✅ Instagram 연결 확인 완료 (${apiType})`,
-                            `   계정: @${account.username}${account.name ? ` (${account.name})` : ''}`,
-                            `   ID: ${account.id}`,
-                            account.account_type ? `   타입: ${account.account_type}` : '',
-                            account.followers_count !== undefined ? `   팔로워: ${account.followers_count.toLocaleString()}` : '',
-                            account.media_count !== undefined ? `   게시물: ${account.media_count}` : '',
-                            expiresAt ? `   토큰 만료(추정): ${expiresAt.slice(0, 10)}` : '',
-                        ].filter(Boolean).join('\n'),
-                    }],
-            };
-        }
-        catch (err) {
-            // 검증 실패 — 저장은 하지 않고 사용자에게 알림
-            return {
-                content: [{
-                        type: 'text',
-                        text: [
-                            `❌ 토큰 검증 실패 (${apiType})`,
-                            `   userId: ${resolvedUserId}`,
-                            `   ${err.message}`,
-                            ``,
-                            `토큰을 다시 발급받거나 userId를 직접 지정해보세요.`,
-                        ].join('\n'),
-                    }],
-            };
-        }
+        // 구현은 instagram/setup.ts 에 있다 — mimi-seed-social-auth CLI 와 공유한다.
+        const result = await connectInstagram(accessToken, userId, assumeIssuedNow);
+        return { content: [{ type: 'text', text: result.text }] };
     });
     server.tool('instagram_get_account', 'Instagram 계정 정보 조회 + 저장된 토큰 유효성 검증.', {}, async () => {
         const cfg = requireInstagramConfig();

package/dist/social/setup-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/social/setup-cli.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+// mimi-seed-social-auth — Facebook 페이지 / Instagram 계정 연결.
+//
+// 검증·저장 구현은 facebook/setup.ts · instagram/setup.ts 에 있고, MCP 도구
+// (facebook_save_config / instagram_save_config)와 **같은 코드**를 호출한다.
+// 토큰이 유효하지 않으면 저장하지 않는다.
+//
+// 사용:
+//   mimi-seed-social-auth              → 무엇을 연결할지 물어봄
+//   mimi-seed-social-auth facebook     → Facebook 만
+//   mimi-seed-social-auth instagram    → Instagram 만
+import readline from 'node:readline';
+import { loadFacebookConfig } from '../facebook/config.js';
+import { loadInstagramConfig } from '../instagram/config.js';
+import { connectFacebook } from '../facebook/setup.js';
+import { connectInstagram } from '../instagram/setup.js';
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+const ask = (q) => new Promise((r) => rl.question(q, (a) => r(a.trim())));
+async function confirmReconnect(label, detail) {
+    console.log(`  ✅ ${label} 이미 연결됨 (${detail})`);
+    const answer = await ask('  다시 설정할래? (y/N): ');
+    return answer.toLowerCase() === 'y';
+}
+async function setupFacebook() {
+    console.log('');
+    console.log('  ── Facebook 페이지 ──');
+    const existing = loadFacebookConfig();
+    if (existing && !(await confirmReconnect('Facebook', existing.pageName ?? existing.pageId))) {
+        return true;
+    }
+    console.log('  Page Access Token 발급:');
+    console.log('   1. Meta 앱 → Graph API Explorer');
+    console.log('   2. 권한: pages_show_list, pages_manage_posts, pages_read_engagement');
+    console.log('   3. User Token 생성 → /me/accounts 호출 → 그 페이지의 access_token (EAA…)');
+    console.log('  (long-lived 토큰 권장. pageId 는 토큰에서 자동 조회돼.)');
+    console.log('');
+    const token = await ask('  Page Access Token (EAA…): ');
+    if (!token) {
+        console.log('  건너뜀.');
+        return true;
+    }
+    let pageId = await ask('  Page ID (선택, 엔터 시 자동 조회): ');
+    console.log('  🔎 토큰 검증 중...');
+    let result = await connectFacebook(token, pageId || undefined);
+    // 토큰이 여러 페이지에 닿으면 connectFacebook 은 목록만 주고 저장하지 않는다.
+    // 다시 실행하라고 내보내지 말고, 여기서 바로 골라 받는다.
+    if (!result.ok && result.text.includes('여러 페이지에')) {
+        console.log('');
+        console.log(indent(result.text));
+        pageId = await ask('\n  어느 페이지를 쓸까? Page ID: ');
+        if (!pageId) {
+            console.log('  건너뜀.');
+            return true;
+        }
+        console.log('  🔎 토큰 검증 중...');
+        result = await connectFacebook(token, pageId);
+    }
+    console.log('');
+    console.log(indent(result.text));
+    if (!result.ok)
+        console.log('\n  (검증 실패 — 저장하지 않았어.)');
+    return result.ok;
+}
+async function setupInstagram() {
+    console.log('');
+    console.log('  ── Instagram ──');
+    const existing = loadInstagramConfig();
+    if (existing && !(await confirmReconnect('Instagram', existing.username ?? existing.userId))) {
+        return true;
+    }
+    console.log('  Long-lived 토큰 두 형식 모두 지원 (자동 감지):');
+    console.log('   • IGAA… — Instagram Login (Meta 신규, Facebook 페이지 불필요)');
+    console.log('   • EAA…  — Facebook Login (IG **비즈니스** 계정 + FB 페이지 연결 필요)');
+    console.log('  (userId 는 토큰에서 자동 조회돼. 토큰 수명은 약 60일.)');
+    console.log('');
+    const token = await ask('  Access Token (IGAA… 또는 EAA…): ');
+    if (!token) {
+        console.log('  건너뜀.');
+        return true;
+    }
+    const userId = await ask('  Instagram Business Account ID (선택, 엔터 시 자동 조회): ');
+    console.log('  🔎 토큰 검증 중...');
+    const result = await connectInstagram(token, userId || undefined);
+    console.log('');
+    console.log(indent(result.text));
+    if (!result.ok)
+        console.log('\n  (검증 실패 — 저장하지 않았어.)');
+    return result.ok;
+}
+function indent(text) {
+    return text
+        .split('\n')
+        .map((l) => `  ${l}`)
+        .join('\n');
+}
+async function main() {
+    const target = (process.argv[2] ?? '').toLowerCase();
+    console.log('');
+    console.log('  🤖 Mimi Seed — 소셜 계정 연결 (Facebook / Instagram)');
+    let ok = true;
+    if (target === 'facebook' || target === 'fb') {
+        ok = await setupFacebook();
+    }
+    else if (target === 'instagram' || target === 'ig') {
+        ok = await setupInstagram();
+    }
+    else {
+        const which = await ask('\n  무엇을 연결할까? [f] Facebook  [i] Instagram  [b] 둘 다: ');
+        const c = which.toLowerCase();
+        if (c === 'f')
+            ok = await setupFacebook();
+        else if (c === 'i')
+            ok = await setupInstagram();
+        else if (c === 'b') {
+            const fb = await setupFacebook();
+            const ig = await setupInstagram();
+            ok = fb && ig;
+        }
+        else {
+            console.log('  취소됨.');
+        }
+    }
+    console.log('');
+    rl.close();
+    // 토큰이 거부됐는데 exit 0 이면 호출한 마법사/스크립트가 성공으로 오인한다.
+    if (!ok)
+        process.exit(1);
+}
+main().catch((e) => {
+    console.error(`\n  ❌ ${e instanceof Error ? e.message : String(e)}\n`);
+    rl.close();
+    process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {
@@ -9,6 +9,9 @@
     "mimi-seed-appstore-auth": "dist/appstore/setup-cli.js",
     "mimi-seed-playstore-auth": "dist/auth/playstore-setup-cli.js",
     "mimi-seed-bigquery-auth": "dist/auth/bigquery-setup-cli.js",
+    "mimi-seed-jenkins-auth": "dist/jenkins/setup-cli.js",
+    "mimi-seed-googleads-auth": "dist/googleads/setup-cli.js",
+    "mimi-seed-social-auth": "dist/social/setup-cli.js",
     "mimi-seed-firebase": "dist/firebase/cli.js",
     "mimi-seed-admob": "dist/admob/cli.js",
     "mimi-seed-ga4": "dist/ga4/cli.js"