@yoonion/mimi-seed-mcp 0.15.5 → 0.16.0

package/README.md

@@ -58,6 +58,7 @@ 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 / Threads
+npx -y @yoonion/mimi-seed-mcp mimi-seed-tiktok-business-auth # TikTok Business Organic API
 ```
 
 각 자격증명을 **어디서 어떻게 발급받는지**는 [`docs/credentials.md`](../../docs/credentials.md) 참고.
@@ -74,7 +75,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 ---
 
-## 제공 도구 (150+ 개 · 19개 영역)
+## 제공 도구 (150+ 개 · 21개 영역)
 
 | 영역 | 도구 수 | 주요 도구 |
 |------|---------|-----------|
@@ -89,8 +90,10 @@ export ANTHROPIC_API_KEY=sk-ant-...
 | Google Ads | 6 | `googleads_list_campaigns` / `googleads_get_uac_report` / `googleads_get_campaign_report` |
 | 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` |
+| GCP Billing | 4 | `gcp_get_billing_info` / `gcp_list_billing_projects` / `gcp_list_budgets` / `gcp_create_budget` |
 | BigQuery | 5 | `bigquery_run_query` / `bigquery_list_datasets` / `bigquery_get_table_schema` |
-| Threads | 6 | `threads_post` / `threads_post_carousel` / `threads_refresh_token` |
+| Threads | 7 | `threads_post` / `threads_post_video` / `threads_post_carousel` / `threads_refresh_token` |
+| TikTok Business | 7 | `tiktok_business_plan_video_post` / `tiktok_business_publish_video` / `tiktok_business_get_publish_status` |
 | 점검 / 위험 | 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/assets/agent-guide.md

@@ -69,10 +69,12 @@ you can paste. Pick the row for the job; batching two rows in one `select:` call
 | Firebase apps + services (incl. web) | `select:firebase_list_android_apps,firebase_list_ios_apps,firebase_list_web_apps,firebase_create_web_app,firebase_get_web_config,firebase_enable_service,firebase_list_enabled_services,firebase_delete_android_app,firebase_delete_ios_app,firebase_delete_web_app` |
 | Analytics wiring (Firebase ↔ GA4 ↔ BigQuery) | `select:firebase_link_analytics,firebase_get_analytics_details,ga4_list_account_summaries,ga4_list_properties,ga4_create_property,ga4_list_data_streams,ga4_create_data_stream,ga4_plan_bigquery_link,ga4_create_bigquery_link,ga4_run_report` |
 | BigQuery | `select:bigquery_auth_status,bigquery_list_datasets,bigquery_list_tables,bigquery_get_table_schema,bigquery_run_query` |
+| GCP billing (Blaze 여부 · 비용 범위 · 예산) | `select:gcp_get_billing_info,gcp_list_billing_projects,gcp_list_budgets,gcp_create_budget` |
 | AdMob | `select:admob_list_accounts,admob_list_apps,admob_create_app,admob_create_ad_unit,admob_list_ad_units,admob_get_today_earnings,admob_get_report` |
 | Google Ads (UAC) | `select:googleads_config_status,googleads_save_config,googleads_list_accessible_customers,googleads_list_campaigns,googleads_get_campaign_report,googleads_get_uac_report` |
 | Search Console | `select:gsc_list_sites,gsc_list_sitemaps,gsc_get_sitemap,gsc_submit_sitemap,gsc_inspect_url,gsc_search_analytics` |
-| Social posting (Facebook / Instagram / Threads) | `select:facebook_current_config,facebook_save_config,facebook_list_pages,facebook_get_page,facebook_post_photo,facebook_post_multi_photo,instagram_save_config,instagram_get_account,instagram_post_image,instagram_post_carousel,threads_current_config,threads_save_config,threads_refresh_token,threads_get_account,threads_post,threads_post_carousel` |
+| Social posting (Facebook / Instagram / Threads) | `select:facebook_current_config,facebook_save_config,facebook_list_pages,facebook_get_page,facebook_post_photo,facebook_post_multi_photo,instagram_save_config,instagram_get_account,instagram_post_image,instagram_post_carousel,threads_current_config,threads_save_config,threads_refresh_token,threads_get_account,threads_post,threads_post_video,threads_post_carousel` |
+| TikTok Business video publish | `select:tiktok_business_auth_status,tiktok_business_get_account,tiktok_business_get_video_settings,tiktok_business_plan_video_post,tiktok_business_publish_video,tiktok_business_get_publish_status,tiktok_business_list_publish_audits` |
 | Jenkins credentials + jobs | `select:jenkins_status,jenkins_save_config,jenkins_list_credentials,jenkins_create_credential,jenkins_delete_credential,jenkins_upload_keystore,jenkins_upload_playstore_sa,jenkins_list_jobs,jenkins_get_job_config,jenkins_create_job,jenkins_update_job` |
 | CI (GitHub/GitLab) | `select:ci_save_config,ci_list_workflows,ci_trigger_build,ci_get_build_status,ci_list_recent_builds,ci_cancel_build` |
 | Android signing / keystore | `select:android_signing_setup,android_generate_keystore,jenkins_upload_keystore,jenkins_upload_playstore_sa` |
@@ -86,7 +88,7 @@ you can paste. Pick the row for the job; batching two rows in one `select:` call
 
 Before any task, call **`mimi_seed_status`** — the setup doctor. It scans your service
 credentials (Google OAuth · Play SA · App Store · Jenkins · CI · Google Ads · Facebook · Instagram ·
-Threads · BigQuery) and returns a ✅/❌ report plus the exact next tool to call for anything
+Threads · TikTok Business · BigQuery) and returns a ✅/❌ report plus the exact next tool to call for anything
 missing. This avoids a late `401`/`403` deep into a workflow.
 
 > If the repo has a **`.mimi-seed.json`** manifest at its root, `mimi_seed_status` (and
@@ -110,6 +112,7 @@ every credential, which also tells them where to obtain each token
 | GitHub / GitLab CI | `mimi-seed auth ci` |
 | Google Ads | `mimi-seed auth googleads` — needs the `adwords` OAuth scope; an old token may need `mimi-seed auth login --domains googleads` (adds the grant, keeps the rest) |
 | Facebook / Instagram / Threads | `mimi-seed auth facebook` / `mimi-seed auth instagram` / `mimi-seed auth threads` |
+| TikTok Business | `mimi-seed auth tiktok` → verify with `tiktok_business_auth_status` and `tiktok_business_get_account` |
 
 `mimi-seed auth meta` opens the combined social setup entry point when the user wants to review or reconnect
 all three Meta platforms in one pass.
@@ -146,6 +149,8 @@ Credentials live under `~/.mimi-seed/` (legacy `~/.preseed/` is still read):
 | `google-ads.json` | Google Ads developer token + customer id |
 | `facebook.json`, `instagram.json`, `threads.json` | Default/legacy Page / account tokens for social post tools |
 | `social-profiles/<profile>.json` | Named Facebook/Instagram/Threads tokens selected by the current project's `.mimi-seed.json` |
+| `tiktok-business.json` | TikTok API for Business app credentials + short-term/refresh tokens (0600) |
+| `tiktok-business/plans`, `tiktok-business/audit`, `tiktok-business/locks` | Expiring post plans, deduplication/audit records, and atomic publish reservations; signed URL query strings are not written to audit records |
 
 Notes that matter in practice:
 
@@ -181,7 +186,8 @@ per-domain inventory is [`docs/domain/tool-catalog.md`](domain/tool-catalog.md).
 | **Google Ads (UAC)** | `googleads_list_campaigns` · `googleads_get_uac_report` · `googleads_get_campaign_report` · `googleads_config_status` |
 | **Search Console** | `gsc_inspect_url` · `gsc_search_analytics` · `gsc_submit_sitemap` |
 | **Android signing** | `android_signing_setup` · `android_generate_keystore` · `jenkins_upload_playstore_sa` |
-| **Facebook / Instagram / Threads** | `facebook_post_photo` · `instagram_post_carousel` · `threads_post` · `threads_refresh_token` |
+| **Facebook / Instagram / Threads** | `facebook_post_photo` · `instagram_post_carousel` · `threads_post` · `threads_post_video` · `threads_refresh_token` |
+| **TikTok Business** | `tiktok_business_auth_status` · `tiktok_business_plan_video_post` · `tiktok_business_publish_video` · `tiktok_business_get_publish_status` |
 | **Checks** | `playstore_check_submission_risks` · `appstore_check_submission_risks` · `screenshot_validate` · `release_status` |
 | **AI / Auth** | `generate_release_notes_from_commits` · `generate_review_reply` · `mimi_seed_status` · `mimi_seed_auth_start` · `mimi_seed_auth_status` · `mimi_seed_remote_sync_credentials` |
 | **Video production** | `youtube_upload_video` · `youtube_get_video_status` · `youtube_update_video_privacy` · `video_plan_from_story` · `video_research_youtube` · `video_search_stock_assets` · `video_synthesize_research` · `video_generate_image` · `video_build_timeline` · `video_render` · `video_job_status` · `video_validate` |

package/dist/billing/tools.d.ts

@@ -0,0 +1,50 @@
+import type { OAuth2Client } from 'google-auth-library';
+/** `01F1F4-FD007B-2973A7` / `billingAccounts/01F1F4-...` 어느 형태로 줘도 정규화. */
+export declare function normalizeBillingAccount(input: string): string;
+export type BillingInfo = {
+    projectId: string;
+    billingEnabled: boolean;
+    billingAccountName: string | null;
+    /** 사람이 읽을 판정 — Blaze/Spark 오판을 막기 위해 문장으로 준다. */
+    verdict: string;
+};
+export declare function getBillingInfo(auth: OAuth2Client, projectId: string): Promise<BillingInfo>;
+/**
+ * 결제 계정에 붙은 프로젝트 목록 = **비용 범위 확인**.
+ * 여기서 프로젝트가 여러 개면 계정 전체 예산은 의미가 없고 프로젝트 필터를 써야 한다.
+ */
+export declare function listBillingProjects(auth: OAuth2Client, billingAccount: string, quotaProjectId?: string): Promise<{
+    billingAccount: string;
+    count: number;
+    shared: boolean;
+    projects: {
+        projectId: string | null | undefined;
+        billingEnabled: boolean;
+    }[];
+}>;
+export declare function listBudgets(auth: OAuth2Client, billingAccount: string, quotaProjectId?: string): Promise<{
+    name: string | null | undefined;
+    displayName: string | null | undefined;
+    amount: string;
+    projects: string[];
+    thresholds: (number | null | undefined)[];
+}[]>;
+export type CreateBudgetInput = {
+    billingAccount: string;
+    displayName: string;
+    /** 통화 단위 정수 금액 (KRW 는 소수 없음 — 10000 = ₩10,000). */
+    amountUnits: number;
+    currencyCode?: string;
+    /** 감시할 프로젝트 ID 목록. **비우면 결제 계정 전체** — 공용 계정이면 소음이 된다. */
+    projectIds?: string[];
+    /** 알림 임계 비율 (0~1). 기본 0.5 / 0.9 / 1.0. */
+    thresholds?: number[];
+    /** quota 주체 프로젝트 — Billing Budget API 를 켜 둔 프로젝트. quotaHeaders 주석 참고. */
+    quotaProjectId?: string;
+};
+export declare function createBudget(auth: OAuth2Client, input: CreateBudgetInput): Promise<{
+    name: string | null | undefined;
+    displayName: string | null | undefined;
+    projects: string[];
+    thresholds: number[];
+}>;

package/dist/billing/tools.js

@@ -0,0 +1,138 @@
+import { google } from '../lib/googleapis-lite.js';
+/**
+ * Cloud Billing + Billing Budgets 래퍼.
+ *
+ * 앱마다 전용 Firebase/GCP 프로젝트를 만드는 컨벤션이라, 새 프로젝트가 생길 때마다
+ * "이 프로젝트가 Blaze 인가 → 결제 계정이 공용인가 → 예산 알림을 걸었나"가 반복 작업이 된다.
+ *
+ * 실제로 겪은 함정 2개가 이 모듈의 존재 이유다:
+ *
+ * 1. **Billing API 가 꺼져 있으면 조회 자체가 403** 이고, 그 403 을 "Spark 이라서"로
+ *    오해하기 쉽다. 실제로는 이미 Blaze 였다. `getBillingInfo` 는 이 구분을 명확히 한다
+ *    (API 미활성 → firebase_enable_service 안내 / 활성인데 billingEnabled=false → 진짜 Spark).
+ *
+ * 2. **결제 계정이 회사 공용이면 계정 전체 예산은 쓸 수 없다.** 기존 지출(BigQuery export 등)만으로
+ *    즉시 임계를 넘겨 알림이 소음이 된다. 그래서 `createBudget` 은 `projects` 필터를 1급으로 받는다 —
+ *    프로젝트 범위 예산이 신규 앱 감시의 기본형이다.
+ *
+ * ⚠️ 예산은 **알림만 한다. 지출을 막지 않는다.** 하드 차단은 Pub/Sub → 결제 해제 함수뿐이고
+ *    그건 앱을 죽이는 조치다. 실질 방어는 각 서비스의 상한(예: functions maxInstances)이다.
+ *
+ * ⚠️ 권한은 **결제 계정 레벨 IAM** 이다(프로젝트 IAM 과 별개). 서비스 계정 키로는 대개 403 이고
+ *    사용자 OAuth(cloud-platform)로 호출해야 한다.
+ */
+const billing = () => google.cloudbilling('v1');
+const budgets = () => google.billingbudgets('v1');
+/**
+ * 🔴 quota 프로젝트 지정이 **필수**다.
+ *
+ * 사용자 OAuth 로 호출하면 GCP 는 quota/billing 을 **OAuth 클라이언트의 프로젝트**에 청구한다.
+ * mimi-seed 의 OAuth 클라이언트 프로젝트에는 Cloud Billing API 가 없으므로, 지정하지 않으면
+ * 대상 프로젝트가 아무리 정상이어도 항상 이렇게 실패한다 (2026-08-04 실측):
+ *
+ *   "Cloud Billing API has not been used in project <OAuth 클라이언트 프로젝트 번호> before or it is disabled"
+ *
+ * 이 메시지의 프로젝트 번호는 **우리가 조회하려는 프로젝트가 아니라 OAuth 클라이언트 쪽**이다 —
+ * 그래서 "대상 프로젝트에서 API 를 켰는데도 왜 403 이냐"로 헤매게 된다.
+ * `x-goog-user-project` 로 우리가 통제하는(그리고 API 를 켜 둔) 프로젝트를 quota 주체로 넘긴다.
+ */
+function quotaHeaders(quotaProjectId) {
+    return quotaProjectId ? { headers: { 'x-goog-user-project': quotaProjectId } } : {};
+}
+/** `01F1F4-FD007B-2973A7` / `billingAccounts/01F1F4-...` 어느 형태로 줘도 정규화. */
+export function normalizeBillingAccount(input) {
+    const trimmed = input.trim();
+    return trimmed.startsWith('billingAccounts/') ? trimmed : `billingAccounts/${trimmed}`;
+}
+export async function getBillingInfo(auth, projectId) {
+    // 조회 대상 프로젝트 자신을 quota 주체로 쓴다 — 거기 Billing API 가 켜져 있어야 한다.
+    const res = await billing().projects.getBillingInfo({
+        auth,
+        name: `projects/${projectId}`,
+        ...quotaHeaders(projectId),
+    });
+    const enabled = res.data.billingEnabled ?? false;
+    const account = res.data.billingAccountName ?? null;
+    return {
+        projectId,
+        billingEnabled: enabled,
+        billingAccountName: account,
+        verdict: enabled
+            ? `Blaze — 결제 계정 ${account} 연결됨. Cloud Functions/Run 배포 가능.`
+            : 'Spark — 결제 계정 미연결. Cloud Functions 등 유료 서비스 배포 불가.',
+    };
+}
+/**
+ * 결제 계정에 붙은 프로젝트 목록 = **비용 범위 확인**.
+ * 여기서 프로젝트가 여러 개면 계정 전체 예산은 의미가 없고 프로젝트 필터를 써야 한다.
+ */
+export async function listBillingProjects(auth, billingAccount, quotaProjectId) {
+    const name = normalizeBillingAccount(billingAccount);
+    const res = await billing().billingAccounts.projects.list({
+        auth,
+        name,
+        pageSize: 200,
+        ...quotaHeaders(quotaProjectId),
+    });
+    const projects = (res.data.projectBillingInfo ?? []).map((p) => ({
+        projectId: p.projectId,
+        billingEnabled: p.billingEnabled ?? false,
+    }));
+    return {
+        billingAccount: name,
+        count: projects.length,
+        shared: projects.length > 1,
+        projects,
+    };
+}
+export async function listBudgets(auth, billingAccount, quotaProjectId) {
+    const parent = normalizeBillingAccount(billingAccount);
+    const res = await budgets().billingAccounts.budgets.list({
+        auth,
+        parent,
+        pageSize: 200,
+        ...quotaHeaders(quotaProjectId),
+    });
+    return (res.data.budgets ?? []).map((b) => ({
+        name: b.name,
+        displayName: b.displayName,
+        amount: b.amount?.specifiedAmount
+            ? `${b.amount.specifiedAmount.units ?? '0'} ${b.amount.specifiedAmount.currencyCode ?? ''}`.trim()
+            : b.amount?.lastPeriodAmount
+                ? '(직전 기간 금액)'
+                : '(미지정)',
+        projects: b.budgetFilter?.projects ?? [],
+        thresholds: (b.thresholdRules ?? []).map((t) => t.thresholdPercent),
+    }));
+}
+export async function createBudget(auth, input) {
+    const parent = normalizeBillingAccount(input.billingAccount);
+    const thresholds = input.thresholds?.length ? input.thresholds : [0.5, 0.9, 1.0];
+    const res = await budgets().billingAccounts.budgets.create({
+        auth,
+        parent,
+        requestBody: {
+            displayName: input.displayName,
+            budgetFilter: {
+                // projects 는 `projects/<번호 또는 ID>` 형태를 받는다.
+                ...(input.projectIds?.length
+                    ? { projects: input.projectIds.map((p) => (p.startsWith('projects/') ? p : `projects/${p}`)) }
+                    : {}),
+            },
+            amount: {
+                specifiedAmount: {
+                    currencyCode: input.currencyCode ?? 'KRW',
+                    units: String(input.amountUnits),
+                },
+            },
+            thresholdRules: thresholds.map((t) => ({ thresholdPercent: t })),
+        },
+        ...quotaHeaders(input.quotaProjectId),
+    });
+    return {
+        name: res.data.name,
+        displayName: res.data.displayName,
+        projects: res.data.budgetFilter?.projects ?? [],
+        thresholds,
+    };
+}

package/dist/index.js

@@ -17,6 +17,7 @@ const SUBCOMMANDS = {
     '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-tiktok-business-auth': () => import('./tiktok-business/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/lib/googleapis-lite.d.ts

@@ -16,6 +16,8 @@ import { analyticsadmin } from 'googleapis/build/src/apis/analyticsadmin/index.j
 import { analyticsdata } from 'googleapis/build/src/apis/analyticsdata/index.js';
 import { androidpublisher } from 'googleapis/build/src/apis/androidpublisher/index.js';
 import { bigquery } from 'googleapis/build/src/apis/bigquery/index.js';
+import { billingbudgets } from 'googleapis/build/src/apis/billingbudgets/index.js';
+import { cloudbilling } from 'googleapis/build/src/apis/cloudbilling/index.js';
 import { cloudresourcemanager } from 'googleapis/build/src/apis/cloudresourcemanager/index.js';
 import { firebase } from 'googleapis/build/src/apis/firebase/index.js';
 import { iam } from 'googleapis/build/src/apis/iam/index.js';
@@ -30,6 +32,8 @@ export declare const google: {
     analyticsdata: typeof analyticsdata;
     androidpublisher: typeof androidpublisher;
     bigquery: typeof bigquery;
+    billingbudgets: typeof billingbudgets;
+    cloudbilling: typeof cloudbilling;
     cloudresourcemanager: typeof cloudresourcemanager;
     firebase: typeof firebase;
     iam: typeof iam;

package/dist/lib/googleapis-lite.js

@@ -16,6 +16,8 @@ import { analyticsadmin } from 'googleapis/build/src/apis/analyticsadmin/index.j
 import { analyticsdata } from 'googleapis/build/src/apis/analyticsdata/index.js';
 import { androidpublisher } from 'googleapis/build/src/apis/androidpublisher/index.js';
 import { bigquery } from 'googleapis/build/src/apis/bigquery/index.js';
+import { billingbudgets } from 'googleapis/build/src/apis/billingbudgets/index.js';
+import { cloudbilling } from 'googleapis/build/src/apis/cloudbilling/index.js';
 import { cloudresourcemanager } from 'googleapis/build/src/apis/cloudresourcemanager/index.js';
 import { auth, firebase } from 'googleapis/build/src/apis/firebase/index.js';
 import { iam } from 'googleapis/build/src/apis/iam/index.js';
@@ -29,6 +31,8 @@ export const google = {
     analyticsdata,
     androidpublisher,
     bigquery,
+    billingbudgets,
+    cloudbilling,
     cloudresourcemanager,
     firebase,
     iam,

package/dist/registers/auth.js

@@ -11,6 +11,8 @@ 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 { loadTikTokBusinessConfig } from '../tiktok-business/config.js';
+import { tokenFreshness as tiktokTokenFreshness } from '../tiktok-business/auth.js';
 import { metaTokenFreshness } from '../lib/meta-auth.js';
 import { readPackageRootText } from '../lib/package-root.js';
 import { resolveBigQueryAuth } from '../auth/bigquery-auth.js';
@@ -114,7 +116,7 @@ export function registerAuthTools(server) {
     // ── 전체 연결 상태 진단 ────────────────────────────────────────────────────
     server.tool('mimi_seed_status', [
         '⭐ 새 세션을 시작하거나 "뭐가 연결됐지?" 라는 질문엔 이 도구를 먼저 호출하세요.',
-        '전체 서비스(Google OAuth / Play SA / App Store / Jenkins / CI / Google Ads / Facebook / Instagram / Threads / BigQuery)',
+        '전체 서비스(Google OAuth / Play SA / App Store / Jenkins / CI / Google Ads / Facebook / Instagram / Threads / TikTok Business / BigQuery)',
         '설정 상태를 한 번에 스캔해 ✅ / ❌ 트래픽 라이트 리포트와 번호 매긴 다음 단계를 반환합니다.',
         '미설정 서비스마다 어떤 도구를 호출하면 되는지 구체적으로 알려줍니다.',
     ].join(' '), {}, async () => {
@@ -197,7 +199,22 @@ export function registerAuthTools(server) {
         const threadsTarget = resolveSocialConfigTarget('threads');
         const threads = loadThreadsConfig();
         lines.push(renderMetaConnection('Threads', threads, `${threadsTarget.profile ? `profile: ${threadsTarget.profile}, ` : ''}userId: ${threads?.userId ?? ''}`, `mimi-seed auth threads${threadsTarget.profile ? ` --profile ${threadsTarget.profile}` : ''}`));
-        // 10. BigQuery — resolveBigQueryAuth 기준(서비스 계정 우선, OAuth fallback).
+        // 10. TikTok Business — 네트워크 없이 refresh token 만료 상태까지 판정.
+        const tiktok = loadTikTokBusinessConfig();
+        const tiktokFreshness = tiktokTokenFreshness(tiktok);
+        if (!tiktok) {
+            lines.push('❌ TikTok Business    — 미설정 → mimi-seed auth tiktok  (선택)');
+        }
+        else if (tiktokFreshness.state === 'refresh_expired') {
+            lines.push(`❌ TikTok Business    — refresh token 만료 (${tiktok.openId}) → mimi-seed auth tiktok`);
+        }
+        else if (tiktokFreshness.state === 'access_expired') {
+            lines.push(`⚠️  TikTok Business    — 연결됨, 다음 호출에서 access token 자동 갱신 (${tiktok.openId})`);
+        }
+        else {
+            lines.push(`✅ TikTok Business    — Organic API 연결됨 (${tiktok.openId})`);
+        }
+        // 11. BigQuery — resolveBigQueryAuth 기준(서비스 계정 우선, OAuth fallback).
         // 이전엔 SA 파일만 검사해 OAuth fallback 이 살아있어도 ❌ 로 오표기했다.
         const bqAuth = resolveBigQueryAuth();
         if (bqAuth?.source === 'service-account') {

package/dist/registers/billing.d.ts

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

package/dist/registers/billing.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import * as billing from '../billing/tools.js';
+import { requireAuth } from '../helpers.js';
+import { CLOUD_PLATFORM_SCOPE } from '../auth/scopes.js';
+import { jsonResult } from '../lib/mcp-response.js';
+export function registerBillingTools(server) {
+    server.tool('gcp_get_billing_info', [
+        '프로젝트의 결제 상태 조회 — Blaze(결제 계정 연결) 여부와 연결된 결제 계정 ID.',
+        'Cloud Functions/Run 배포 전 필수 확인.',
+        '⚠️ Cloud Billing API 가 꺼져 있으면 403 이 난다 — 그건 "Spark 이라서"가 아니라 조회 자체가 막힌 것이다.',
+        '그 경우 firebase_enable_service(projectId, "cloudbilling.googleapis.com") 로 먼저 켠 뒤 다시 호출.',
+    ].join(' '), {
+        projectId: z.string().describe('GCP/Firebase 프로젝트 ID'),
+    }, async ({ projectId }) => {
+        const auth = await requireAuth(CLOUD_PLATFORM_SCOPE);
+        return jsonResult(await billing.getBillingInfo(auth, projectId));
+    });
+    server.tool('gcp_list_billing_projects', [
+        '결제 계정에 붙은 프로젝트 목록 = **비용 범위 확인**.',
+        '프로젝트가 2개 이상이면(shared=true) 그 계정은 공용이므로 **계정 전체 예산은 쓰지 말 것** —',
+        '기존 지출만으로 임계를 즉시 넘겨 알림이 소음이 된다. gcp_create_budget 에 projectIds 를 넘겨 범위를 좁힌다.',
+    ].join(' '), {
+        billingAccount: z
+            .string()
+            .describe('결제 계정 ID (예: 01F1F4-FD007B-2973A7 또는 billingAccounts/01F1F4-...)'),
+        quotaProjectId: z
+            .string()
+            .optional()
+            .describe('quota 주체 프로젝트 — Cloud Billing/Budget API 를 켜 둔 프로젝트 ID. 생략하면 OAuth 클라이언트 프로젝트로 quota 가 잡혀 403 이 난다(에러 메시지의 프로젝트 번호는 조회 대상이 아니라 OAuth 쪽이다).'),
+    }, async ({ billingAccount, quotaProjectId }) => {
+        const auth = await requireAuth(CLOUD_PLATFORM_SCOPE);
+        return jsonResult(await billing.listBillingProjects(auth, billingAccount, quotaProjectId));
+    });
+    server.tool('gcp_list_budgets', '결제 계정의 예산 목록 (금액·프로젝트 필터·알림 임계). 중복 생성 전 확인용.', {
+        billingAccount: z.string().describe('결제 계정 ID'),
+        quotaProjectId: z
+            .string()
+            .optional()
+            .describe('quota 주체 프로젝트 — Cloud Billing/Budget API 를 켜 둔 프로젝트 ID. 생략하면 OAuth 클라이언트 프로젝트로 quota 가 잡혀 403 이 난다(에러 메시지의 프로젝트 번호는 조회 대상이 아니라 OAuth 쪽이다).'),
+    }, async ({ billingAccount, quotaProjectId }) => {
+        const auth = await requireAuth(CLOUD_PLATFORM_SCOPE);
+        return jsonResult(await billing.listBudgets(auth, billingAccount, quotaProjectId));
+    });
+    server.tool('gcp_create_budget', [
+        '예산 + 알림 임계 생성.',
+        '⚠️ **예산은 알림만 한다. 지출을 막지 않는다.** 하드 차단은 Pub/Sub→결제해제 함수뿐이고 그건 앱을 죽인다.',
+        '실질 방어는 각 서비스의 상한(예: Cloud Functions maxInstances)이고 예산은 트립와이어다.',
+        '⚠️ GCP 에 **일 예산은 없다** — 기간은 월(기본)/분기/연/사용자지정뿐. "하루 N원"을 원하면 월 환산하거나,',
+        '실사용이 적을 때는 작은 월 예산을 알람으로 쓰는 게 더 빨리 잡힌다.',
+        'projectIds 를 반드시 고려할 것 — 공용 결제 계정에서 생략하면 알림이 소음이 된다(gcp_list_billing_projects 로 먼저 확인).',
+        '권한은 결제 계정 레벨 IAM 이라 서비스 계정 키로는 대개 403 — 사용자 OAuth 로 호출된다.',
+    ].join(' '), {
+        billingAccount: z.string().describe('결제 계정 ID'),
+        displayName: z.string().describe('예산 이름 (예: "my-app functions 감시")'),
+        amountUnits: z
+            .number()
+            .int()
+            .positive()
+            .describe('통화 단위 정수 금액. KRW 는 소수 없음 — 10000 = ₩10,000'),
+        currencyCode: z.string().optional().describe('통화 코드 (기본 KRW). 결제 계정 통화와 일치해야 한다'),
+        projectIds: z
+            .array(z.string())
+            .optional()
+            .describe('감시할 프로젝트 ID 목록. 생략하면 결제 계정 전체 — 공용 계정이면 권장하지 않음'),
+        thresholds: z
+            .array(z.number().min(0).max(1))
+            .optional()
+            .describe('알림 임계 비율 0~1 (기본 [0.5, 0.9, 1.0])'),
+        quotaProjectId: z
+            .string()
+            .optional()
+            .describe('quota 주체 프로젝트 — Cloud Billing/Budget API 를 켜 둔 프로젝트 ID. 생략하면 OAuth 클라이언트 프로젝트로 quota 가 잡혀 403 이 난다(에러 메시지의 프로젝트 번호는 조회 대상이 아니라 OAuth 쪽이다).'),
+    }, async ({ billingAccount, displayName, amountUnits, currencyCode, projectIds, thresholds, quotaProjectId, }) => {
+        const auth = await requireAuth(CLOUD_PLATFORM_SCOPE);
+        const budget = await billing.createBudget(auth, {
+            billingAccount,
+            displayName,
+            amountUnits,
+            currencyCode,
+            projectIds,
+            thresholds,
+            quotaProjectId,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        '✓ 예산 생성 완료',
+                        '',
+                        `**name**: \`${budget.name}\``,
+                        `**displayName**: ${budget.displayName}`,
+                        `**범위**: ${budget.projects.length ? budget.projects.join(', ') : '결제 계정 전체'}`,
+                        `**알림 임계**: ${budget.thresholds.map((t) => `${Math.round(t * 100)}%`).join(' / ')}`,
+                        '',
+                        '⚠️ 이 예산은 **알림만** 한다 — 임계를 넘어도 지출은 계속된다.',
+                    ].join('\n'),
+                },
+            ],
+        };
+    });
+}

package/dist/registers/threads.js

@@ -94,6 +94,30 @@ export function registerThreadsTools(server) {
                 }],
         };
     });
+    server.tool('threads_post_video', [
+        'public URL의 영상을 Threads에 게시합니다.',
+        'Meta가 videoUrl을 직접 가져가므로 외부에서 인증 없이 접근 가능한 URL이어야 합니다.',
+        '3-step API: VIDEO container 생성 → 처리 완료 자동 대기 → threads_publish.',
+        '공개 게시 작업이므로 같은 턴에 사용자의 명시 승인을 받은 뒤 호출하세요.',
+    ].join(' '), {
+        videoUrl: z.string().url().describe('Threads가 가져갈 영상의 public URL'),
+        text: z.string().max(500).default('').describe('게시할 텍스트 (선택, 최대 500자)'),
+        altText: z.string().optional().describe('영상 접근성 대체 텍스트 (선택)'),
+        profile: profileSchema,
+    }, async ({ videoUrl, text, altText, profile }) => {
+        const cfg = requireThreadsConfig({ profile });
+        const result = await api.postVideo(cfg, videoUrl, text, altText);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✅ 영상 게시 완료',
+                        `   media_id: ${result.id}`,
+                        result.permalink ? `   URL: ${result.permalink}` : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
     // 진단용 — 현재 저장된 Threads 설정 요약 (facebook_current_config 와 동일한 패턴).
     server.tool('threads_current_config', '현재 선택된 Threads 연결 설정을 확인합니다. 프로젝트 매핑 또는 profile 인자를 따릅니다.', { profile: profileSchema }, async ({ profile }) => {
         const options = { profile };

package/dist/registers/tiktok.d.ts

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

package/dist/registers/tiktok.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { getBusinessAccount, getVideoSettings, inspectAccessToken } from '../tiktok-business/api.js';
+import { ensureFreshTikTokConfig, ensureTikTokPublishConfig, safeTokenInspection, tokenFreshness, } from '../tiktok-business/auth.js';
+import { safeTikTokBusinessConfig } from '../tiktok-business/config.js';
+import { checkPublishStatus, listPublishAudits, planVideoPost, publishPlannedVideo, } from '../tiktok-business/posting.js';
+import { jsonResult } from '../lib/mcp-response.js';
+const absolutePath = z.string().min(1).refine((value) => value.startsWith('/') || /^[A-Za-z]:[\\/]/.test(value), {
+    message: '절대경로만 허용합니다.',
+});
+const httpsUrl = z.string().url().refine((value) => new URL(value).protocol === 'https:', {
+    message: 'HTTPS URL만 허용합니다.',
+});
+export function registerTikTokBusinessTools(server) {
+    server.tool('tiktok_business_auth_status', [
+        'TikTok API for Business Organic API 연결과 권한 상태를 확인합니다.',
+        '만료 5분 전이면 refresh token으로 access token을 자동 갱신합니다.',
+        '토큰·앱 시크릿은 응답하지 않습니다. 미연결이면 `mimi-seed auth tiktok`을 실행하세요.',
+    ].join(' '), {}, async () => {
+        const config = await ensureFreshTikTokConfig();
+        const tokenInfo = await inspectAccessToken(config);
+        return jsonResult({
+            connected: true,
+            ...safeTikTokBusinessConfig(config),
+            freshness: tokenFreshness(config).state,
+            tokenInfo: safeTokenInspection(config, tokenInfo),
+        });
+    });
+    server.tool('tiktok_business_get_account', '연결된 owned TikTok Business Account 프로필을 조회하고 현재 토큰으로 접근 가능한지 검증합니다.', {}, async () => jsonResult(await getBusinessAccount(await ensureFreshTikTokConfig())));
+    server.tool('tiktok_business_get_video_settings', '게시 전에 계정별 최대 영상 길이와 댓글·듀엣·스티치 설정을 조회합니다.', {}, async () => jsonResult(await getVideoSettings(await ensureTikTokPublishConfig())));
+    server.tool('tiktok_business_plan_video_post', [
+        'TikTok 공개 게시 전용 계획을 만들고 30분 동안 로컬에 보관합니다.',
+        '로컬 원본을 ffprobe로 검사하고 SHA-256으로 중복 게시를 차단하며 계정별 영상 설정과 대조합니다.',
+        'videoUrl은 TikTok 앱에서 검증한 도메인의 HTTPS URL이어야 하고 최소 30분 이상 유효해야 합니다.',
+        '이 도구는 TikTok에 게시하지 않습니다. 검토 후 tiktok_business_publish_video를 별도로 호출하세요.',
+    ].join(' '), {
+        sourceFilePath: absolutePath.describe('검증·중복 판정할 로컬 .mp4/.mov/.webm 절대경로'),
+        videoUrl: httpsUrl.describe('TikTok 서버가 가져갈 영상의 검증된 HTTPS URL'),
+        customThumbnailUrl: httpsUrl.optional().describe('선택 썸네일 HTTPS URL'),
+        caption: z.string().max(2_200).optional().describe('UTF-16 기준 최대 2,200자, 멘션 최대 30개'),
+        isBrandOrganic: z.boolean().default(false).describe('브랜드 자체 홍보 콘텐츠 여부'),
+        isBrandedContent: z.boolean().default(false).describe('유료 파트너십/브랜디드 콘텐츠 여부'),
+        disableComment: z.boolean().default(false),
+        disableDuet: z.boolean().default(false),
+        disableStitch: z.boolean().default(false),
+        thumbnailOffsetMs: z.number().int().min(0).optional().describe('영상 시작 기준 썸네일 오프셋(ms)'),
+        isAiGenerated: z.boolean().default(true).describe('AI 생성·변형 영상 고지'),
+        ffmpegPath: z.string().optional().describe('FFmpeg 절대경로. 생략하면 PATH의 ffprobe 사용'),
+    }, async (input) => jsonResult(await planVideoPost(input)));
+    server.tool('tiktok_business_publish_video', [
+        '검증된 30분짜리 계획을 owned TikTok Business Account에 공개 게시합니다.',
+        '외부 공개 작업이므로 같은 턴에 사용자의 명시 승인을 받은 뒤 confirmPublish=true로 호출해야 합니다.',
+        'POST 타임아웃은 결과 불명으로 감사 로그에 남고 자동 재시도를 막습니다.',
+        '성공 응답은 보통 pending이며 tiktok_business_get_publish_status로 완료를 확인하세요.',
+    ].join(' '), {
+        planId: z.string().regex(/^[a-f0-9]{32}$/),
+        confirmPublish: z.boolean().default(false).describe('사용자의 공개 게시 명시 승인 확인'),
+    }, async ({ planId, confirmPublish }) => jsonResult(await publishPlannedVideo(planId, confirmPublish)));
+    server.tool('tiktok_business_get_publish_status', 'TikTok 게시 처리 상태를 조회하고 로컬 감사 로그의 pending/published/failed 상태를 갱신합니다.', { publishId: z.string().min(1).max(128).describe('publish 응답의 share_id 또는 publish_id') }, async ({ publishId }) => jsonResult(await checkPublishStatus(publishId)));
+    server.tool('tiktok_business_list_publish_audits', '로컬 TikTok 게시 감사 로그를 최신순으로 조회합니다. 토큰·앱 시크릿·서명 URL 쿼리는 저장하거나 반환하지 않습니다.', { limit: z.number().int().min(1).max(100).default(20) }, async ({ limit }) => jsonResult(listPublishAudits(limit)));
+}

package/dist/server.js

@@ -3,6 +3,7 @@ import { registerFirebaseTools } from './registers/firebase.js';
 import { registerAdmobTools } from './registers/admob.js';
 import { registerPlaystoreTools } from './registers/playstore.js';
 import { registerIamTools } from './registers/iam.js';
+import { registerBillingTools } from './registers/billing.js';
 import { registerAppstoreTools } from './registers/appstore.js';
 import { registerChecksTools } from './registers/checks.js';
 import { registerAiTools } from './registers/ai.js';
@@ -18,6 +19,7 @@ import { registerGa4Tools } from './registers/ga4.js';
 import { registerJenkinsTools } from './registers/jenkins.js';
 import { registerAndroidTools } from './registers/android.js';
 import { registerVideoTools } from './registers/video.js';
+import { registerTikTokBusinessTools } from './registers/tiktok.js';
 import { registerPrompts } from './prompts.js';
 import { registerResources } from './resources.js';
 /**
@@ -37,6 +39,7 @@ export function buildServer(version) {
     registerAdmobTools(server);
     registerPlaystoreTools(server);
     registerIamTools(server);
+    registerBillingTools(server);
     registerAppstoreTools(server);
     registerChecksTools(server);
     registerAiTools(server);
@@ -52,6 +55,7 @@ export function buildServer(version) {
     registerJenkinsTools(server);
     registerAndroidTools(server);
     registerVideoTools(server);
+    registerTikTokBusinessTools(server);
     registerPrompts(server);
     registerResources(server);
     return server;

package/dist/threads/api.d.ts

@@ -20,4 +20,6 @@ export interface PublishResult {
 }
 /** 텍스트 전용 게시 — Threads 의 핵심 유스케이스. imageUrl 을 주면 이미지 게시. */
 export declare function postText(cfg: ThreadsConfig, text: string, imageUrl?: string): Promise<PublishResult>;
+/** public URL의 영상을 Threads 미디어 컨테이너로 만든 뒤 처리 완료 후 게시한다. */
+export declare function postVideo(cfg: ThreadsConfig, videoUrl: string, text?: string, altText?: string): Promise<PublishResult>;
 export declare function postCarousel(cfg: ThreadsConfig, imageUrls: string[], text: string): Promise<PublishResult>;

package/dist/threads/api.js

@@ -126,6 +126,20 @@ export async function postText(cfg, text, imageUrl) {
         await waitForContainer(cfg, container.id); // 미디어만 처리 대기
     return publish(cfg, container.id);
 }
+/** public URL의 영상을 Threads 미디어 컨테이너로 만든 뒤 처리 완료 후 게시한다. */
+export async function postVideo(cfg, videoUrl, text = '', altText) {
+    const params = {
+        media_type: 'VIDEO',
+        video_url: videoUrl,
+        text,
+        access_token: cfg.accessToken,
+    };
+    if (altText)
+        params.alt_text = altText;
+    const container = await thFetch(cfg.accessToken, '/me/threads', params, 'POST');
+    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}).`);