@yoonion/mimi-seed-mcp 0.9.3 → 0.10.0

package/README.md

@@ -57,7 +57,7 @@ npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth    # Google Play 서비
 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
+npx -y @yoonion/mimi-seed-mcp mimi-seed-social-auth       # Facebook / Instagram / Threads
 ```
 
 각 자격증명을 **어디서 어떻게 발급받는지**는 [`docs/credentials.md`](../../docs/credentials.md) 참고.
@@ -74,7 +74,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 ---
 
-## 제공 도구 (150+ 개 · 17개 영역)
+## 제공 도구 (150+ 개 · 18개 영역)
 
 | 영역 | 도구 수 | 주요 도구 |
 |------|---------|-----------|
@@ -90,6 +90,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 | Facebook | 6 | `facebook_post_photo` / `facebook_post_multi_photo` / `facebook_list_pages` |
 | Google Cloud IAM | 5 | `iam_create_service_account` / `iam_create_key` / `iam_add_iam_policy_binding` |
 | BigQuery | 5 | `bigquery_run_query` / `bigquery_list_datasets` / `bigquery_get_table_schema` |
+| Threads | 6 | `threads_post` / `threads_post_carousel` / `threads_refresh_token` |
 | 점검 / 위험 | 4 | `playstore_check_submission_risks` / `appstore_check_submission_risks` / `screenshot_validate` / `release_status` |
 | Instagram | 4 | `instagram_post_image` / `instagram_post_carousel` / `instagram_save_config` |
 | Android 서명 | 3 | `android_signing_setup` / `android_generate_keystore` / `jenkins_upload_playstore_sa` |

package/dist/auth/google-auth.js

@@ -15,6 +15,10 @@ const SCOPES = [
     'https://www.googleapis.com/auth/adwords', // Google Ads API (googleads_* tools)
     'https://www.googleapis.com/auth/webmasters', // Search Console API (gsc_* tools, 사이트맵 제출 포함)
     'https://www.googleapis.com/auth/analytics.edit', // GA4 Analytics Admin API (ga4_* tools — property/data stream 생성·조회)
+    // GA4 **Data API**(analyticsdata — ga4_run_report)는 analytics.edit 을 받지 않는다.
+    // Admin API 전용 스코프이기 때문. 이게 빠져 있으면 property 목록은 보이는데 리포트만
+    // 403 으로 막혀서, "API 가 꺼졌나" 로 오진하기 쉽다. (2026-07 실사고)
+    'https://www.googleapis.com/auth/analytics.readonly',
 ];
 // Primary config dir. Legacy `~/.preseed` is read as a fallback during the
 // rebrand so existing auth sessions don't force a re-login; new writes go to

package/dist/facebook/api.js

@@ -1,3 +1,4 @@
+import { metaApiError } from '../lib/meta-auth.js';
 const BASE = 'https://graph.facebook.com/v21.0';
 async function fbPost(pageAccessToken, endpoint, params) {
     const body = new URLSearchParams({ ...params, access_token: pageAccessToken });
@@ -12,21 +13,28 @@ async function fbPost(pageAccessToken, endpoint, params) {
         json = JSON.parse(text);
     }
     catch {
-        throw new Error(`HTTP ${res.status}: ${text}`);
+        throw metaApiError('facebook', res.status, text);
     }
     if (json.error) {
         const err = json.error;
-        throw new Error(`${err.message} (code ${err.code})`);
+        throw metaApiError('facebook', res.status, `${err.message} (code ${err.code})`, err.code);
     }
     return json;
 }
 async function fbGet(pageAccessToken, endpoint, params = {}) {
     const qs = new URLSearchParams({ ...params, access_token: pageAccessToken });
     const res = await fetch(`${BASE}${endpoint}?${qs}`);
-    const json = await res.json();
+    const text = await res.text();
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        throw metaApiError('facebook', res.status, text);
+    }
     if (json.error) {
         const err = json.error;
-        throw new Error(`${err.message} (code ${err.code})`);
+        throw metaApiError('facebook', res.status, `${err.message} (code ${err.code})`, err.code);
     }
     return json;
 }
@@ -92,7 +100,8 @@ export async function listAccessiblePages(userAccessToken) {
     });
     const res = await fetch(`${BASE}/me/accounts?${qs}`);
     const json = await res.json();
-    if (json.error)
-        throw new Error(`${json.error.message} (code ${json.error.code})`);
+    if (json.error) {
+        throw metaApiError('facebook', res.status, `${json.error.message} (code ${json.error.code})`, json.error.code);
+    }
     return json.data ?? [];
 }

package/dist/facebook/config.js

@@ -4,7 +4,11 @@ import os from 'node:os';
 const CONFIG_PATH = path.join(os.homedir(), '.mimi-seed', 'facebook.json');
 export function loadFacebookConfig() {
     try {
-        return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+        const cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+        if (typeof cfg.pageAccessToken !== 'string' || !cfg.pageAccessToken ||
+            typeof cfg.pageId !== 'string' || !cfg.pageId)
+            return null;
+        return cfg;
     }
     catch {
         return null;

package/dist/ga4/cli.js

@@ -53,7 +53,9 @@ runDomainCli({
             bundleId: flag(p, 'bundle'),
         }),
         streams: async (p) => ga4.listDataStreams(await requireAuth(ga4.GA4_SCOPE), requireFlag(p, 'property')),
-        report: async (p) => ga4.runReport(await requireAuth(ga4.GA4_SCOPE), requireFlag(p, 'property'), {
+        report: async (p) => 
+        // Data API 는 analytics.readonly — Admin 스코프(analytics.edit)로는 403 이다
+        ga4.runReport(await requireAuth(ga4.GA4_DATA_SCOPE), requireFlag(p, 'property'), {
             startDate: requireFlag(p, 'start'),
             endDate: requireFlag(p, 'end'),
             dimensions: flagList(p, 'dimensions'),

package/dist/ga4/tools.d.ts

@@ -1,6 +1,15 @@
 import type { OAuth2Client } from 'google-auth-library';
-/** GA4 도구가 요구하는 OAuth 스코프 — requireAuth() pre-flight 검사에 사용. */
+/** Admin API(analyticsadmin — property/data stream 생성·조회)가 요구하는 스코프. */
 export declare const GA4_SCOPE = "https://www.googleapis.com/auth/analytics.edit";
+/**
+ * Data API(analyticsdata — runReport)가 요구하는 스코프.
+ *
+ * ⚠️ analytics.edit 은 **Admin API 전용**이라 Data API 가 받아주지 않는다. 둘을 같은
+ * 스코프로 묶으면 pre-flight 는 통과시켜 놓고 구글이 403 을 던져서, "API 가 꺼졌나"로
+ * 오진하게 된다 — property 목록은 멀쩡히 보이는데 리포트만 막히는 형태라 더 헷갈린다.
+ * (2026-07 실사고: 맑음 D1 지표를 뽑으려다 Analytics API 활성화 문제로 오인.)
+ */
+export declare const GA4_DATA_SCOPE = "https://www.googleapis.com/auth/analytics.readonly";
 export type Ga4Auth = OAuth2Client;
 export type DataStreamPlatform = 'web' | 'android' | 'ios';
 /** '123' | 'accounts/123' → 'accounts/123' */

package/dist/ga4/tools.js

@@ -11,8 +11,17 @@ import { google } from 'googleapis';
  */
 const admin = () => google.analyticsadmin('v1beta');
 const data = () => google.analyticsdata('v1beta');
-/** GA4 도구가 요구하는 OAuth 스코프 — requireAuth() pre-flight 검사에 사용. */
+/** Admin API(analyticsadmin — property/data stream 생성·조회)가 요구하는 스코프. */
 export const GA4_SCOPE = 'https://www.googleapis.com/auth/analytics.edit';
+/**
+ * Data API(analyticsdata — runReport)가 요구하는 스코프.
+ *
+ * ⚠️ analytics.edit 은 **Admin API 전용**이라 Data API 가 받아주지 않는다. 둘을 같은
+ * 스코프로 묶으면 pre-flight 는 통과시켜 놓고 구글이 403 을 던져서, "API 가 꺼졌나"로
+ * 오진하게 된다 — property 목록은 멀쩡히 보이는데 리포트만 막히는 형태라 더 헷갈린다.
+ * (2026-07 실사고: 맑음 D1 지표를 뽑으려다 Analytics API 활성화 문제로 오인.)
+ */
+export const GA4_DATA_SCOPE = 'https://www.googleapis.com/auth/analytics.readonly';
 // ─── 경로 정규화 (순수 함수 — 테스트 대상) ───
 /** '123' | 'accounts/123' → 'accounts/123' */
 export function normalizeAccountName(accountId) {

package/dist/instagram/api.js

@@ -1,3 +1,4 @@
+import { metaApiError } from '../lib/meta-auth.js';
 // 두 가지 Meta API:
 //   IGAA... = Instagram API with Instagram Login (2024 신규) — graph.instagram.com
 //   EAA...  = Instagram Graph API via Facebook Login                — graph.facebook.com
@@ -24,14 +25,16 @@ async function igFetch(token, endpoint, params, method = 'GET') {
     const text = await res.text();
     if (!res.ok) {
         let msg = text;
+        let code;
         try {
             const parsed = JSON.parse(text);
             if (parsed.error) {
+                code = parsed.error.code;
                 msg = `${parsed.error.message} (code ${parsed.error.code}${parsed.error.error_subcode ? `/${parsed.error.error_subcode}` : ''})`;
             }
         }
         catch { /* fall through with raw text */ }
-        throw new Error(`Instagram API ${res.status}: ${msg}`);
+        throw metaApiError('instagram', res.status, msg, code);
     }
     return JSON.parse(text);
 }

package/dist/instagram/config.js

@@ -4,7 +4,11 @@ import os from 'node:os';
 const CONFIG_PATH = path.join(os.homedir(), '.mimi-seed', 'instagram.json');
 export function loadInstagramConfig() {
     try {
-        return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+        const cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+        if (typeof cfg.accessToken !== 'string' || !cfg.accessToken ||
+            typeof cfg.userId !== 'string' || !cfg.userId)
+            return null;
+        return cfg;
     }
     catch {
         return null;

package/dist/lib/meta-auth.d.ts

@@ -0,0 +1,12 @@
+export type MetaPlatform = 'facebook' | 'instagram' | 'threads';
+export interface MetaTokenFreshness {
+    state: 'unknown' | 'fresh' | 'expiring' | 'expired';
+    daysRemaining?: number;
+}
+/** 저장된 만료 시각만 보는 빠른 로컬 판정. 실제 유효성은 provider API가 최종 판정한다. */
+export declare function metaTokenFreshness(expiresAt: string | undefined, now?: number): MetaTokenFreshness;
+export declare function metaExpiryMessage(expiresAt: string | undefined, fix: string): string;
+/** Provider 원문은 유지하되 access token 모양은 절대 오류 메시지에 남기지 않는다. */
+export declare function redactMetaSecrets(message: string): string;
+/** Meta OAuth 만료/철회를 사용자가 바로 복구할 수 있는 명령으로 번역한다. */
+export declare function metaApiError(platform: MetaPlatform, status: number, message: string, code?: number): Error;

package/dist/lib/meta-auth.js

@@ -0,0 +1,60 @@
+const LABEL = {
+    facebook: 'Facebook',
+    instagram: 'Instagram',
+    threads: 'Threads',
+};
+const FIX = {
+    facebook: 'mimi-seed auth facebook',
+    instagram: 'mimi-seed auth instagram',
+    threads: 'mimi-seed auth threads',
+};
+const EXPIRING_SOON_MS = 7 * 24 * 60 * 60 * 1000;
+/** 저장된 만료 시각만 보는 빠른 로컬 판정. 실제 유효성은 provider API가 최종 판정한다. */
+export function metaTokenFreshness(expiresAt, now = Date.now()) {
+    if (!expiresAt)
+        return { state: 'unknown' };
+    const expiresMs = Date.parse(expiresAt);
+    if (!Number.isFinite(expiresMs))
+        return { state: 'unknown' };
+    const remainingMs = expiresMs - now;
+    if (remainingMs <= 0)
+        return { state: 'expired', daysRemaining: 0 };
+    const daysRemaining = Math.max(1, Math.ceil(remainingMs / 86_400_000));
+    if (remainingMs <= EXPIRING_SOON_MS)
+        return { state: 'expiring', daysRemaining };
+    return { state: 'fresh', daysRemaining };
+}
+export function metaExpiryMessage(expiresAt, fix) {
+    const freshness = metaTokenFreshness(expiresAt);
+    if (freshness.state === 'expired')
+        return `❌ 토큰 만료 — ${fix}`;
+    if (freshness.state === 'expiring') {
+        return `⚠️ 토큰 ${freshness.daysRemaining}일 남음 — 지금 갱신 권장: ${fix}`;
+    }
+    if (freshness.state === 'fresh')
+        return `토큰: ${freshness.daysRemaining}일 남음`;
+    return `⚠️ 토큰 만료일 미상 — 계정 조회로 검증하고 필요하면 ${fix}`;
+}
+/** Provider 원문은 유지하되 access token 모양은 절대 오류 메시지에 남기지 않는다. */
+export function redactMetaSecrets(message) {
+    return message
+        .replace(/(["']?access_token["']?\s*[:=]\s*["']?)([^"'&\s,}]+)/gi, '$1[REDACTED]')
+        .replace(/(\bBearer\s+)[A-Za-z0-9._|~-]+/gi, '$1[REDACTED]')
+        .replace(/\b(?:EAA|IGAA)[A-Za-z0-9_-]+\b/g, '[REDACTED]')
+        .replace(/\bTH[A-Za-z0-9_|-]{8,}\b/g, '[REDACTED]');
+}
+/** Meta OAuth 만료/철회를 사용자가 바로 복구할 수 있는 명령으로 번역한다. */
+export function metaApiError(platform, status, message, code) {
+    const safeMessage = redactMetaSecrets(message);
+    const needsReconnect = code === 190 ||
+        status === 401 ||
+        /(?:session|access token|token).*(?:expired|invalid|revoked)|error validating access token/i.test(safeMessage);
+    if (needsReconnect) {
+        return new Error([
+            `❌ ${LABEL[platform]} 연결이 만료되었거나 취소되었습니다.`,
+            `복구: ${FIX[platform]}`,
+            `Meta 응답: ${safeMessage}`,
+        ].join('\n'));
+    }
+    return new Error(`${LABEL[platform]} API ${status}: ${safeMessage}`);
+}

package/dist/registers/auth.js

@@ -10,6 +10,8 @@ import { loadCiConfig } from '../ci/config.js';
 import { loadConfig as loadGoogleAdsConfig } from '../googleads/config.js';
 import { loadFacebookConfig } from '../facebook/config.js';
 import { loadInstagramConfig } from '../instagram/config.js';
+import { loadThreadsConfig } from '../threads/config.js';
+import { metaTokenFreshness } from '../lib/meta-auth.js';
 import { resolveBigQueryAuth } from '../auth/bigquery-auth.js';
 import { syncRemoteCredentials } from '../remote-sync.js';
 import { findProjectManifest, manifestServiceEntries, } from '../lib/project-manifest.js';
@@ -39,6 +41,21 @@ function formatLastRefreshHint(lastMs) {
     }
     return { label };
 }
+function renderMetaConnection(label, config, detail, fix) {
+    const padded = label.padEnd(18);
+    if (!config)
+        return `❌ ${padded} — 미설정 → ${fix}  (선택)`;
+    const freshness = metaTokenFreshness(config.expiresAt);
+    if (freshness.state === 'expired')
+        return `❌ ${padded} — 토큰 만료 → ${fix}`;
+    if (freshness.state === 'expiring') {
+        return `⚠️  ${padded} — ${freshness.daysRemaining}일 후 만료 (${detail}) → ${fix}`;
+    }
+    if (freshness.state === 'unknown') {
+        return `⚠️  ${padded} — 설정됨, 만료일 미상 (${detail}) → 계정 조회 도구로 검증`;
+    }
+    return `✅ ${padded} — 연결됨 (${detail}, ${freshness.daysRemaining}일 남음)`;
+}
 // 매니페스트 서비스별 셋업 명령. status/doctor 가 "정확한 다음 명령"으로 안내한다.
 const MANIFEST_FIX = {
     oauth: () => 'mimi_seed_auth_start  (Google 로그인 — Firebase/AdMob/Play/GSC/GA4)',
@@ -94,7 +111,7 @@ export function registerAuthTools(server) {
     // ── 전체 연결 상태 진단 ────────────────────────────────────────────────────
     server.tool('mimi_seed_status', [
         '⭐ 새 세션을 시작하거나 "뭐가 연결됐지?" 라는 질문엔 이 도구를 먼저 호출하세요.',
-        '9개 서비스(Google OAuth / Play SA / App Store / Jenkins / CI / Google Ads / Facebook / Instagram / BigQuery)',
+        '10개 서비스(Google OAuth / Play SA / App Store / Jenkins / CI / Google Ads / Facebook / Instagram / Threads / BigQuery)',
         '설정 상태를 한 번에 스캔해 ✅ / ❌ 트래픽 라이트 리포트와 번호 매긴 다음 단계를 반환합니다.',
         '미설정 서비스마다 어떤 도구를 호출하면 되는지 구체적으로 알려줍니다.',
     ].join(' '), {}, async () => {
@@ -161,21 +178,14 @@ export function registerAuthTools(server) {
         }
         // 7. Facebook
         const fb = loadFacebookConfig();
-        if (fb) {
-            lines.push(`✅ Facebook          — 연결됨 (pageId: ${fb.pageId})`);
-        }
-        else {
-            lines.push('❌ Facebook          — 미설정 → facebook_save_config  (선택)');
-        }
+        lines.push(renderMetaConnection('Facebook', fb, `pageId: ${fb?.pageId ?? ''}`, 'mimi-seed auth facebook'));
         // 8. Instagram
         const ig = loadInstagramConfig();
-        if (ig) {
-            lines.push(`✅ Instagram         — 연결됨 (userId: ${ig.userId})`);
-        }
-        else {
-            lines.push('❌ Instagram         — 미설정 → instagram_save_config  (선택)');
-        }
-        // 9. BigQuery — resolveBigQueryAuth 기준(서비스 계정 우선, OAuth fallback).
+        lines.push(renderMetaConnection('Instagram', ig, `userId: ${ig?.userId ?? ''}`, 'mimi-seed auth instagram'));
+        // 9. Threads
+        const threads = loadThreadsConfig();
+        lines.push(renderMetaConnection('Threads', threads, `userId: ${threads?.userId ?? ''}`, 'mimi-seed auth threads'));
+        // 10. BigQuery — resolveBigQueryAuth 기준(서비스 계정 우선, OAuth fallback).
         // 이전엔 SA 파일만 검사해 OAuth fallback 이 살아있어도 ❌ 로 오표기했다.
         const bqAuth = resolveBigQueryAuth();
         if (bqAuth?.source === 'service-account') {

package/dist/registers/facebook.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { loadFacebookConfig, requireFacebookConfig } from '../facebook/config.js';
 import { connectFacebook } from '../facebook/setup.js';
 import * as api from '../facebook/api.js';
+import { metaExpiryMessage } from '../lib/meta-auth.js';
 export function registerFacebookTools(server) {
     server.tool('facebook_save_config', [
         'Facebook 페이지 액세스 토큰을 ~/.mimi-seed/facebook.json (mode 0600)에 저장합니다.',
@@ -41,9 +42,6 @@ export function registerFacebookTools(server) {
     server.tool('facebook_get_page', 'Facebook 페이지 정보 조회 + 저장된 토큰 유효성 검증.', {}, async () => {
         const cfg = requireFacebookConfig();
         const page = await api.getPage(cfg);
-        const remainingDays = cfg.expiresAt
-            ? Math.round((new Date(cfg.expiresAt).getTime() - Date.now()) / (24 * 60 * 60 * 1000))
-            : null;
         return {
             content: [{
                     type: 'text',
@@ -52,13 +50,7 @@ export function registerFacebookTools(server) {
                         page.category ? `   카테고리: ${page.category}` : '',
                         page.followers_count !== undefined ? `   팔로워: ${page.followers_count.toLocaleString()}` : '',
                         page.fan_count !== undefined ? `   좋아요: ${page.fan_count.toLocaleString()}` : '',
-                        remainingDays !== null
-                            ? remainingDays > 7
-                                ? `   토큰: ${remainingDays}일 남음`
-                                : remainingDays > 0
-                                    ? `   ⚠️ 토큰 ${remainingDays}일 남음 — 갱신 필요`
-                                    : `   ❌ 토큰 만료 — facebook_save_config로 재저장`
-                            : '',
+                        `   ${metaExpiryMessage(cfg.expiresAt, 'mimi-seed auth facebook')}`,
                     ].filter(Boolean).join('\n'),
                 }],
         };
@@ -117,7 +109,7 @@ export function registerFacebookTools(server) {
                     type: 'text',
                     text: [
                         `페이지: ${cfg.pageName ?? '(미확인)'} (${cfg.pageId})`,
-                        cfg.expiresAt ? `토큰 만료(추정): ${cfg.expiresAt.slice(0, 10)}` : '',
+                        metaExpiryMessage(cfg.expiresAt, 'mimi-seed auth facebook'),
                     ].filter(Boolean).join('\n'),
                 }],
         };

package/dist/registers/ga4.js

@@ -78,7 +78,8 @@ export function registerGa4Tools(server) {
         dimensions: z.string().optional().describe('쉼표 구분 dimension (예: date,country). 생략 시 전체 합계'),
         metrics: z.string().optional().describe('쉼표 구분 metric (기본 activeUsers,eventCount)'),
     }, async ({ propertyId, startDate, endDate, dimensions, metrics }) => {
-        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        // Data API 는 analytics.readonly 를 요구한다 — Admin 스코프로 검사하면 통과시켜 놓고 403 이 난다
+        const auth = await requireAuth(ga4Raw.GA4_DATA_SCOPE);
         const report = await ga4.runReport(auth, propertyId, {
             startDate,
             endDate,

package/dist/registers/instagram.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { requireInstagramConfig } from '../instagram/config.js';
 import { connectInstagram } from '../instagram/setup.js';
 import * as api from '../instagram/api.js';
+import { metaExpiryMessage } from '../lib/meta-auth.js';
 export function registerInstagramTools(server) {
     server.tool('instagram_save_config', [
         'Instagram 토큰을 ~/.mimi-seed/instagram.json (mode 0600)에 저장합니다.',
@@ -22,9 +23,6 @@ export function registerInstagramTools(server) {
     server.tool('instagram_get_account', 'Instagram 계정 정보 조회 + 저장된 토큰 유효성 검증.', {}, async () => {
         const cfg = requireInstagramConfig();
         const account = await api.getAccount(cfg);
-        const remainingDays = cfg.expiresAt
-            ? Math.round((new Date(cfg.expiresAt).getTime() - Date.now()) / (24 * 60 * 60 * 1000))
-            : null;
         return {
             content: [{
                     type: 'text',
@@ -34,13 +32,7 @@ export function registerInstagramTools(server) {
                         account.account_type ? `   타입: ${account.account_type}` : '',
                         account.followers_count !== undefined ? `   팔로워: ${account.followers_count.toLocaleString()}` : '',
                         account.media_count !== undefined ? `   게시물: ${account.media_count}` : '',
-                        remainingDays !== null
-                            ? remainingDays > 7
-                                ? `   토큰: ${remainingDays}일 남음`
-                                : remainingDays > 0
-                                    ? `   ⚠️ 토큰 ${remainingDays}일 남음 — 곧 갱신 필요`
-                                    : `   ❌ 토큰 만료됨 — instagram_save_config로 재저장`
-                            : '',
+                        `   ${metaExpiryMessage(cfg.expiresAt, 'mimi-seed auth instagram')}`,
                     ].filter(Boolean).join('\n'),
                 }],
         };

package/dist/registers/threads.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerThreadsTools(server: McpServer): void;

package/dist/registers/threads.js

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+import { loadThreadsConfig, requireThreadsConfig } from '../threads/config.js';
+import { connectThreads, refreshThreadsToken } from '../threads/setup.js';
+import * as api from '../threads/api.js';
+import { metaExpiryMessage } from '../lib/meta-auth.js';
+export function registerThreadsTools(server) {
+    server.tool('threads_save_config', [
+        'Threads 토큰을 ~/.mimi-seed/threads.json (mode 0600)에 저장합니다.',
+        'accessToken은 Threads Graph API long-lived 토큰 (약 60일).',
+        'userId 미입력 시 토큰으로 자동 조회 (GET /me).',
+        '저장 직후 토큰 유효성도 자동 검증.',
+        'Instagram 과 별개 계정·별개 토큰입니다 (threads_basic, threads_content_publish 권한 필요).',
+    ].join(' '), {
+        accessToken: z.string().describe('Threads Graph API long-lived access token (약 60일)'),
+        userId: z.string().optional().describe('Threads user ID (생략 시 자동 조회)'),
+        assumeIssuedNow: z.boolean().default(true).describe('expiresAt = 지금 + 60일 자동 계산'),
+    }, async ({ accessToken, userId, assumeIssuedNow }) => {
+        // 구현은 threads/setup.ts 에 있다 — mimi-seed-social-auth CLI 와 공유한다.
+        const result = await connectThreads(accessToken, userId, assumeIssuedNow);
+        return { content: [{ type: 'text', text: result.text }] };
+    });
+    server.tool('threads_refresh_token', [
+        '저장된 Threads long-lived 토큰을 만료 전에 공식 refresh_access_token endpoint로 갱신합니다.',
+        '성공하면 새 토큰과 실제 expires_in을 저장하고 계정을 다시 검증합니다.',
+        '이미 만료·철회된 토큰은 갱신할 수 없으므로 mimi-seed auth threads로 재연결하세요.',
+    ].join(' '), {}, async () => {
+        const cfg = requireThreadsConfig();
+        const result = await refreshThreadsToken(cfg.accessToken);
+        return { content: [{ type: 'text', text: result.text }], isError: !result.ok };
+    });
+    server.tool('threads_get_account', 'Threads 계정 정보 조회 + 저장된 토큰 유효성 검증.', {}, async () => {
+        const cfg = requireThreadsConfig();
+        const account = await api.getAccount(cfg);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `@${account.username}${account.name ? ` (${account.name})` : ''}`,
+                        `   ID: ${account.id}`,
+                        account.threads_biography ? `   소개: ${account.threads_biography}` : '',
+                        `   ${metaExpiryMessage(cfg.expiresAt, 'mimi-seed auth threads')}`,
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('threads_post', [
+        'Threads에 게시합니다. 텍스트 전용이 기본이며, imageUrl을 주면 이미지 게시.',
+        'text에는 링크·멘션(@)·해시태그를 포함할 수 있고 줄바꿈 \\n 사용. 게시물당 최대 500자.',
+        'imageUrl은 public URL이어야 합니다 (Graph API 제약). 로컬 파일은 미리 S3/R2/Cloudinary 등에 업로드 필요.',
+        '2-step API: container 생성(/threads) → threads_publish. 이미지는 처리 완료까지 자동 대기.',
+    ].join(' '), {
+        text: z.string().max(500).describe('게시할 텍스트 (최대 500자, 멘션/해시태그/줄바꿈 가능)'),
+        imageUrl: z.string().url().optional().describe('이미지의 public URL (생략 시 텍스트 전용 게시)'),
+    }, async ({ text, imageUrl }) => {
+        const cfg = requireThreadsConfig();
+        const result = await api.postText(cfg, text, imageUrl);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✅ 게시 완료',
+                        `   media_id: ${result.id}`,
+                        result.permalink ? `   URL: ${result.permalink}` : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('threads_post_carousel', [
+        '여러 이미지를 캐러셀로 Threads에 게시합니다. 2~20장 (인스타는 10장, Threads는 20장).',
+        '모든 이미지는 public URL이어야 함. 각 이미지 처리 완료까지 자동 대기.',
+        '3-step API: 각 이미지 children container → carousel container → publish.',
+    ].join(' '), {
+        imageUrls: z.array(z.string().url()).min(2).max(20).describe('이미지 URL 배열 (2~20장)'),
+        text: z.string().max(500).describe('캡션 텍스트 (최대 500자)'),
+    }, async ({ imageUrls, text }) => {
+        const cfg = requireThreadsConfig();
+        const result = await api.postCarousel(cfg, imageUrls, text);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `✅ 캐러셀 ${imageUrls.length}장 게시 완료`,
+                        `   media_id: ${result.id}`,
+                        result.permalink ? `   URL: ${result.permalink}` : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    // 진단용 — 현재 저장된 Threads 설정 요약 (facebook_current_config 와 동일한 패턴).
+    server.tool('threads_current_config', '현재 저장된 Threads 연결 설정을 확인합니다 (~/.mimi-seed/threads.json).', {}, async () => {
+        const cfg = loadThreadsConfig();
+        if (!cfg) {
+            return {
+                content: [{ type: 'text', text: '❌ Threads 미설정 → threads_save_config 또는 mimi-seed auth threads' }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✅ Threads 연결됨',
+                        `   @${cfg.username ?? '(username 미저장)'}`,
+                        `   userId: ${cfg.userId}`,
+                        `   ${metaExpiryMessage(cfg.expiresAt, 'mimi-seed auth threads')}`,
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+}

package/dist/server.js

@@ -10,6 +10,7 @@ import { registerBigqueryTools } from './registers/bigquery.js';
 import { registerAuthTools } from './registers/auth.js';
 import { registerCiTools } from './registers/ci.js';
 import { registerInstagramTools } from './registers/instagram.js';
+import { registerThreadsTools } from './registers/threads.js';
 import { registerFacebookTools } from './registers/facebook.js';
 import { registerGoogleAdsTools } from './registers/googleads.js';
 import { registerGscTools } from './registers/gsc.js';
@@ -42,6 +43,7 @@ export function buildServer(version) {
     registerAuthTools(server);
     registerCiTools(server);
     registerInstagramTools(server);
+    registerThreadsTools(server);
     registerFacebookTools(server);
     registerGoogleAdsTools(server);
     registerGscTools(server);

package/dist/social/setup-cli.js

@@ -9,25 +9,29 @@
 //   mimi-seed-social-auth              → 무엇을 연결할지 물어봄
 //   mimi-seed-social-auth facebook     → Facebook 만
 //   mimi-seed-social-auth instagram    → Instagram 만
+//   mimi-seed-social-auth threads      → Threads 만
+//   mimi-seed-social-auth all          → 세 플랫폼을 순서대로
 //
-// 주의: connectFacebook / connectInstagram 이 돌려주는 result.text 는 MCP 도구와 공유하는
-// 텍스트라 여기서 번역하지 않는다 (그대로 출력한다).
+// 주의: connectFacebook / connectInstagram / connectThreads 이 돌려주는 result.text 는 MCP 도구와
+// 공유하는 텍스트라 여기서 번역하지 않는다 (그대로 출력한다).
 import readline from 'node:readline';
 import { loadFacebookConfig } from '../facebook/config.js';
 import { loadInstagramConfig } from '../instagram/config.js';
+import { loadThreadsConfig } from '../threads/config.js';
 import { connectFacebook } from '../facebook/setup.js';
 import { connectInstagram } from '../instagram/setup.js';
+import { connectThreads, refreshThreadsToken } from '../threads/setup.js';
 import { resolveLang } from '../lib/lang.js';
 // ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
 const ko = {
-    title: '  🤖 Mimi Seed — 소셜 계정 연결 (Facebook / Instagram)',
+    title: '  🤖 Mimi Seed — 소셜 계정 연결 (Facebook / Instagram / Threads)',
     already: (label, detail) => `  ✅ ${label} 이미 연결됨 (${detail})`,
     reconnect: '  다시 설정할래? (y/N): ',
     skipped: '  건너뜀.',
     cancelled: '  취소됨.',
     verifying: '  🔎 토큰 검증 중...',
     notSaved: '\n  (검증 실패 — 저장하지 않았어.)',
-    which: '\n  무엇을 연결할까? [f] Facebook  [i] Instagram  [b] 둘 다: ',
+    which: '\n  무엇을 연결할까? [f] Facebook  [i] Instagram  [t] Threads  [a] 전부: ',
     fbHeader: '  ── Facebook 페이지 ──',
     fbHowTo: '  Page Access Token 발급:',
     fbStep1: '   1. Meta 앱 → Graph API Explorer',
@@ -44,16 +48,27 @@ const ko = {
     igNote: '  (userId 는 토큰에서 자동 조회돼. 토큰 수명은 약 60일.)',
     igAskToken: '  Access Token (IGAA… 또는 EAA…): ',
     igAskUserId: '  Instagram Business Account ID (선택, 엔터 시 자동 조회): ',
+    thHeader: '  ── Threads ──',
+    thHowTo: '  Threads Graph API long-lived 토큰 발급:',
+    thStep1: '   1. developers.facebook.com → 앱 → "Use cases" 에서 Threads API 추가',
+    thStep2: '   2. 권한: threads_basic, threads_content_publish',
+    thStep3: '   3. Threads 로그인으로 authorize → short-lived → long-lived 토큰 교환',
+    thNote: '  (Instagram 과 **별개 계정·별개 토큰**. userId 는 토큰에서 자동 조회돼. 수명 약 60일.)',
+    thAskToken: '  Threads Access Token: ',
+    thAskUserId: '  Threads user ID (선택, 엔터 시 자동 조회): ',
+    thExistingAction: '  [Enter/y] 기존 토큰 자동 갱신  [r] 새 토큰으로 재연결  [n] 건너뛰기: ',
+    thRefreshing: '  🔄 기존 Threads 토큰 갱신 중...',
+    thRefreshFallback: '  자동 갱신에 실패했습니다. 새 토큰을 입력해 재연결할 수 있습니다.',
 };
 const en = {
-    title: '  🤖 Mimi Seed — Connect social accounts (Facebook / Instagram)',
+    title: '  🤖 Mimi Seed — Connect social accounts (Facebook / Instagram / Threads)',
     already: (label, detail) => `  ✅ ${label} already connected (${detail})`,
     reconnect: '  Set it up again? (y/N): ',
     skipped: '  Skipped.',
     cancelled: '  Cancelled.',
     verifying: '  🔎 Verifying the token...',
     notSaved: '\n  (Verification failed — nothing was saved.)',
-    which: '\n  What do you want to connect? [f] Facebook  [i] Instagram  [b] both: ',
+    which: '\n  What do you want to connect? [f] Facebook  [i] Instagram  [t] Threads  [a] all: ',
     fbHeader: '  ── Facebook Page ──',
     fbHowTo: '  Get a Page Access Token:',
     fbStep1: '   1. Meta app → Graph API Explorer',
@@ -70,6 +85,17 @@ const en = {
     igNote: '  (userId is looked up from the token. Tokens last about 60 days.)',
     igAskToken: '  Access Token (IGAA… or EAA…): ',
     igAskUserId: '  Instagram Business Account ID (optional, Enter to look it up): ',
+    thHeader: '  ── Threads ──',
+    thHowTo: '  Get a long-lived Threads Graph API token:',
+    thStep1: '   1. developers.facebook.com → your app → add the Threads API use case',
+    thStep2: '   2. Permissions: threads_basic, threads_content_publish',
+    thStep3: '   3. Authorize with Threads login → exchange short-lived for a long-lived token',
+    thNote: '  (A **separate account and token** from Instagram. userId is looked up from the token. ~60 days.)',
+    thAskToken: '  Threads Access Token: ',
+    thAskUserId: '  Threads user ID (optional, Enter to look it up): ',
+    thExistingAction: '  [Enter/y] refresh current token  [r] reconnect with a new token  [n] skip: ',
+    thRefreshing: '  🔄 Refreshing the existing Threads token...',
+    thRefreshFallback: '  Automatic refresh failed. You can reconnect with a new token.',
 };
 const M = resolveLang() === 'en' ? en : ko;
 const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
@@ -145,6 +171,45 @@ async function setupInstagram() {
         console.log(M.notSaved);
     return result.ok;
 }
+async function setupThreads() {
+    console.log('');
+    console.log(M.thHeader);
+    const existing = loadThreadsConfig();
+    if (existing) {
+        console.log(M.already('Threads', existing.username ?? existing.userId));
+        const action = (await ask(M.thExistingAction)).toLowerCase();
+        if (action === 'n')
+            return true;
+        if (action !== 'r') {
+            console.log(M.thRefreshing);
+            const refreshed = await refreshThreadsToken(existing.accessToken);
+            console.log('');
+            console.log(indent(refreshed.text));
+            if (refreshed.ok)
+                return true;
+            console.log(M.thRefreshFallback);
+        }
+    }
+    console.log(M.thHowTo);
+    console.log(M.thStep1);
+    console.log(M.thStep2);
+    console.log(M.thStep3);
+    console.log(M.thNote);
+    console.log('');
+    const token = await ask(M.thAskToken);
+    if (!token) {
+        console.log(M.skipped);
+        return true;
+    }
+    const userId = await ask(M.thAskUserId);
+    console.log(M.verifying);
+    const result = await connectThreads(token, userId || undefined);
+    console.log('');
+    console.log(indent(result.text));
+    if (!result.ok)
+        console.log(M.notSaved);
+    return result.ok;
+}
 function indent(text) {
     return text
         .split('\n')
@@ -162,6 +227,15 @@ async function main() {
     else if (target === 'instagram' || target === 'ig') {
         ok = await setupInstagram();
     }
+    else if (target === 'threads' || target === 'th') {
+        ok = await setupThreads();
+    }
+    else if (target === 'all' || target === 'meta') {
+        const fb = await setupFacebook();
+        const ig = await setupInstagram();
+        const th = await setupThreads();
+        ok = fb && ig && th;
+    }
     else {
         const which = await ask(M.which);
         const c = which.toLowerCase();
@@ -169,11 +243,20 @@ async function main() {
             ok = await setupFacebook();
         else if (c === 'i')
             ok = await setupInstagram();
+        else if (c === 't')
+            ok = await setupThreads();
         else if (c === 'b') {
+            // 기존 b=Facebook+Instagram 동작을 유지한다.
             const fb = await setupFacebook();
             const ig = await setupInstagram();
             ok = fb && ig;
         }
+        else if (c === 'a') {
+            const fb = await setupFacebook();
+            const ig = await setupInstagram();
+            const th = await setupThreads();
+            ok = fb && ig && th;
+        }
         else {
             console.log(M.cancelled);
         }

package/dist/threads/api.d.ts

@@ -0,0 +1,23 @@
+import type { ThreadsConfig } from './config.js';
+export interface ThreadsAccount {
+    id: string;
+    username: string;
+    name?: string;
+    threads_profile_picture_url?: string;
+    threads_biography?: string;
+}
+export declare function getAccount(cfg: ThreadsConfig): Promise<ThreadsAccount>;
+export declare function fetchUserId(accessToken: string): Promise<string>;
+export interface RefreshedToken {
+    accessToken: string;
+    expiresInSeconds: number;
+}
+/** 만료 전 long-lived Threads 토큰을 새 60일 토큰으로 갱신한다. */
+export declare function refreshAccessToken(accessToken: string): Promise<RefreshedToken>;
+export interface PublishResult {
+    id: string;
+    permalink?: string;
+}
+/** 텍스트 전용 게시 — Threads 의 핵심 유스케이스. imageUrl 을 주면 이미지 게시. */
+export declare function postText(cfg: ThreadsConfig, text: string, imageUrl?: string): Promise<PublishResult>;
+export declare function postCarousel(cfg: ThreadsConfig, imageUrls: string[], text: string): Promise<PublishResult>;

package/dist/threads/api.js

@@ -0,0 +1,147 @@
+import { metaApiError } from '../lib/meta-auth.js';
+// Threads Graph API. Instagram 과 달리 base 가 하나뿐이라 토큰 prefix 분기가 없다.
+//   graph.threads.net/v1.0
+// 게시 흐름은 인스타와 같은 2단계: container 생성(/threads) → publish(/threads_publish).
+// 차이: (1) 텍스트 전용 게시가 1급 시민(media_type=TEXT), (2) 미디어 컨테이너는 처리 시간이
+//       필요해 publish 전에 status 를 폴링해야 한다, (3) 캐러셀 최대 20장(인스타는 10장).
+const BASE = 'https://graph.threads.net/v1.0';
+const AUTH_BASE = 'https://graph.threads.net';
+async function thFetch(token, endpoint, params, method = 'GET') {
+    const url = new URL(`${BASE}${endpoint}`);
+    let body;
+    if (method === 'GET') {
+        Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+    }
+    else {
+        body = new URLSearchParams(params).toString();
+    }
+    const res = await fetch(url.toString(), {
+        method,
+        body,
+        headers: method === 'POST' ? { 'Content-Type': 'application/x-www-form-urlencoded' } : undefined,
+    });
+    const text = await res.text();
+    if (!res.ok) {
+        let msg = text;
+        let code;
+        try {
+            const parsed = JSON.parse(text);
+            if (parsed.error) {
+                code = parsed.error.code;
+                msg = `${parsed.error.message} (code ${parsed.error.code}${parsed.error.error_subcode ? `/${parsed.error.error_subcode}` : ''})`;
+            }
+        }
+        catch { /* fall through with raw text */ }
+        throw metaApiError('threads', res.status, msg, code);
+    }
+    return JSON.parse(text);
+}
+export async function getAccount(cfg) {
+    return thFetch(cfg.accessToken, `/${cfg.userId}`, {
+        fields: 'id,username,name,threads_profile_picture_url,threads_biography',
+        access_token: cfg.accessToken,
+    });
+}
+// 토큰만으로 Threads user ID 자동 조회 — GET /me?fields=id,username
+export async function fetchUserId(accessToken) {
+    const res = await thFetch(accessToken, '/me', { fields: 'id,username', access_token: accessToken });
+    if (!res.id) {
+        throw new Error('Threads user ID를 조회하지 못했습니다. 토큰에 threads_basic 권한이 있는지 확인하세요.');
+    }
+    return res.id;
+}
+/** 만료 전 long-lived Threads 토큰을 새 60일 토큰으로 갱신한다. */
+export async function refreshAccessToken(accessToken) {
+    const url = new URL(`${AUTH_BASE}/refresh_access_token`);
+    url.searchParams.set('grant_type', 'th_refresh_token');
+    url.searchParams.set('access_token', accessToken);
+    const res = await fetch(url);
+    const text = await res.text();
+    if (!res.ok) {
+        let message = text;
+        let code;
+        try {
+            const parsed = JSON.parse(text);
+            if (parsed.error) {
+                code = parsed.error.code;
+                message = `${parsed.error.message} (code ${parsed.error.code})`;
+            }
+        }
+        catch { /* raw response */ }
+        throw metaApiError('threads', res.status, message, code);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error('Threads 토큰 갱신 응답을 해석하지 못했습니다. 새 토큰을 발급해 다시 연결하세요.');
+    }
+    if (!parsed.access_token || !Number.isFinite(parsed.expires_in) || parsed.expires_in <= 0) {
+        throw new Error('Threads 토큰 갱신 응답에 access_token 또는 expires_in이 없습니다.');
+    }
+    return { accessToken: parsed.access_token, expiresInSeconds: parsed.expires_in };
+}
+async function fetchPermalink(cfg, mediaId) {
+    try {
+        const meta = await thFetch(cfg.accessToken, `/${mediaId}`, { fields: 'permalink', access_token: cfg.accessToken });
+        return meta.permalink;
+    }
+    catch {
+        return undefined;
+    }
+}
+// 미디어(이미지/비디오/캐러셀) 컨테이너는 서버 처리 후에야 publish 가 된다.
+// status 가 FINISHED 가 될 때까지 폴링한다. 텍스트 컨테이너는 즉시 FINISHED 라 호출자가 생략한다.
+async function waitForContainer(cfg, containerId) {
+    const MAX_ATTEMPTS = 20;
+    const INTERVAL_MS = 3000; // 최대 ~60초 대기
+    for (let i = 0; i < MAX_ATTEMPTS; i++) {
+        const { status, error_message } = await thFetch(cfg.accessToken, `/${containerId}`, { fields: 'status,error_message', access_token: cfg.accessToken });
+        if (status === 'FINISHED')
+            return;
+        if (status === 'ERROR' || status === 'EXPIRED') {
+            throw new Error(`미디어 처리 실패 (${status})${error_message ? `: ${error_message}` : ''}`);
+        }
+        await new Promise((r) => setTimeout(r, INTERVAL_MS));
+    }
+    throw new Error('미디어 처리 대기 시간 초과 (60초). 잠시 후 다시 시도하세요.');
+}
+async function publish(cfg, creationId) {
+    const published = await thFetch(cfg.accessToken, `/${cfg.userId}/threads_publish`, { creation_id: creationId, access_token: cfg.accessToken }, 'POST');
+    return { id: published.id, permalink: await fetchPermalink(cfg, published.id) };
+}
+/** 텍스트 전용 게시 — Threads 의 핵심 유스케이스. imageUrl 을 주면 이미지 게시. */
+export async function postText(cfg, text, imageUrl) {
+    const params = {
+        media_type: imageUrl ? 'IMAGE' : 'TEXT',
+        text,
+        access_token: cfg.accessToken,
+    };
+    if (imageUrl)
+        params.image_url = imageUrl;
+    const container = await thFetch(cfg.accessToken, `/${cfg.userId}/threads`, params, 'POST');
+    if (imageUrl)
+        await waitForContainer(cfg, container.id); // 미디어만 처리 대기
+    return publish(cfg, container.id);
+}
+export async function postCarousel(cfg, imageUrls, text) {
+    if (imageUrls.length < 2 || imageUrls.length > 20) {
+        throw new Error(`캐러셀은 2~20장의 이미지가 필요합니다 (받은 수: ${imageUrls.length}).`);
+    }
+    // Step 1: 각 이미지를 children container 로 생성 (sequential — 부분 실패 시 명확)
+    const childIds = [];
+    for (const url of imageUrls) {
+        const child = await thFetch(cfg.accessToken, `/${cfg.userId}/threads`, { media_type: 'IMAGE', image_url: url, is_carousel_item: 'true', access_token: cfg.accessToken }, 'POST');
+        childIds.push(child.id);
+    }
+    // children 이 모두 처리될 때까지 대기 (아무거나 처리 중이면 carousel 생성이 실패한다)
+    for (const id of childIds)
+        await waitForContainer(cfg, id);
+    // Step 2: carousel container 생성
+    const carousel = await thFetch(cfg.accessToken, `/${cfg.userId}/threads`, { media_type: 'CAROUSEL', children: childIds.join(','), text, access_token: cfg.accessToken }, 'POST');
+    // 부모 컨테이너도 비동기로 조립되므로 완료 전에 publish 하지 않는다.
+    await waitForContainer(cfg, carousel.id);
+    // Step 3: publish
+    return publish(cfg, carousel.id);
+}

package/dist/threads/config.d.ts

@@ -0,0 +1,9 @@
+export interface ThreadsConfig {
+    accessToken: string;
+    userId: string;
+    expiresAt?: string;
+    username?: string;
+}
+export declare function loadThreadsConfig(): ThreadsConfig | null;
+export declare function saveThreadsConfig(cfg: ThreadsConfig): void;
+export declare function requireThreadsConfig(): ThreadsConfig;

package/dist/threads/config.js

@@ -0,0 +1,35 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const CONFIG_PATH = path.join(os.homedir(), '.mimi-seed', 'threads.json');
+export function loadThreadsConfig() {
+    try {
+        const cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+        if (typeof cfg.accessToken !== 'string' || !cfg.accessToken ||
+            typeof cfg.userId !== 'string' || !cfg.userId)
+            return null;
+        return cfg;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveThreadsConfig(cfg) {
+    const dir = path.dirname(CONFIG_PATH);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2));
+    if (process.platform !== 'win32') {
+        fs.chmodSync(CONFIG_PATH, 0o600);
+    }
+}
+export function requireThreadsConfig() {
+    const cfg = loadThreadsConfig();
+    if (!cfg) {
+        throw new Error('Threads 설정이 없습니다.\n' +
+            'threads_save_config 도구로 먼저 설정해주세요.\n' +
+            '예: threads_save_config(accessToken="...", userId="...")');
+    }
+    return cfg;
+}

package/dist/threads/setup.d.ts

@@ -0,0 +1,4 @@
+import type { ConnectResult } from '../facebook/setup.js';
+export declare function connectThreads(accessToken: string, userId?: string, assumeIssuedNow?: boolean): Promise<ConnectResult>;
+/** 기존 long-lived 토큰을 만료 전에 갱신하고, 계정 검증 성공 시에만 덮어쓴다. */
+export declare function refreshThreadsToken(currentAccessToken: string): Promise<ConnectResult>;

package/dist/threads/setup.js

@@ -0,0 +1,93 @@
+// Threads 연결 — userId 자동 조회 → 토큰 검증 → 검증 성공 시에만 저장.
+// MCP 도구(threads_save_config)와 setup CLI(mimi-seed-social-auth)가 **공유**하는 구현.
+import { saveThreadsConfig } from './config.js';
+import * as api from './api.js';
+const SIXTY_DAYS_MS = 60 * 24 * 60 * 60 * 1000;
+export async function connectThreads(accessToken, userId, assumeIssuedNow = true) {
+    let resolvedUserId = userId;
+    if (!resolvedUserId) {
+        try {
+            resolvedUserId = await api.fetchUserId(accessToken);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                text: [
+                    '❌ userId 자동 조회 실패',
+                    `   ${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 });
+        saveThreadsConfig({
+            accessToken,
+            userId: resolvedUserId,
+            expiresAt,
+            username: account.username,
+        });
+        return {
+            ok: true,
+            text: [
+                '✅ Threads 연결 확인 완료',
+                `   계정: @${account.username}${account.name ? ` (${account.name})` : ''}`,
+                `   ID: ${account.id}`,
+                expiresAt ? `   토큰 만료(추정): ${expiresAt.slice(0, 10)}` : '',
+            ]
+                .filter(Boolean)
+                .join('\n'),
+        };
+    }
+    catch (err) {
+        // 검증 실패 → 저장하지 않는다.
+        return {
+            ok: false,
+            text: [
+                '❌ 토큰 검증 실패',
+                `   userId: ${resolvedUserId}`,
+                `   ${err.message}`,
+                '',
+                '토큰을 다시 발급받거나 userId를 직접 지정해보세요.',
+            ].join('\n'),
+        };
+    }
+}
+/** 기존 long-lived 토큰을 만료 전에 갱신하고, 계정 검증 성공 시에만 덮어쓴다. */
+export async function refreshThreadsToken(currentAccessToken) {
+    try {
+        const refreshed = await api.refreshAccessToken(currentAccessToken);
+        const userId = await api.fetchUserId(refreshed.accessToken);
+        const account = await api.getAccount({ accessToken: refreshed.accessToken, userId });
+        const expiresAt = new Date(Date.now() + refreshed.expiresInSeconds * 1000).toISOString();
+        saveThreadsConfig({
+            accessToken: refreshed.accessToken,
+            userId,
+            username: account.username,
+            expiresAt,
+        });
+        return {
+            ok: true,
+            text: [
+                '✅ Threads 토큰 갱신 완료',
+                `   계정: @${account.username}`,
+                `   새 만료일: ${expiresAt.slice(0, 10)}`,
+            ].join('\n'),
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            text: [
+                '❌ Threads 토큰 자동 갱신 실패 — 기존 설정은 보존했습니다.',
+                `   ${err.message}`,
+                '   복구: mimi-seed auth threads 에서 새 토큰으로 다시 연결하세요.',
+            ].join('\n'),
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.9.3",
+  "version": "0.10.0",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {