@yoonion/mimi-seed-mcp 0.19.13 → 0.19.14

package/dist/googleads/tools.d.ts

@@ -1,5 +1,6 @@
 import type { OAuth2Client } from 'google-auth-library';
 import type { GoogleAdsConfig } from './config.js';
+export declare const REPORT_METRIC_NOTE = "cost is in account currency, not micros. conversions are Google Ads conversions, not necessarily installs. Legacy installs/cpi aliases do not establish install CPI or cohort D7 ROAS.";
 export interface DateRange {
     startDate: string;
     endDate: string;
@@ -16,6 +17,8 @@ export declare function listCampaigns(auth: OAuth2Client, cfg: GoogleAdsConfig):
     dailyBudget: number;
 }[]>;
 export declare function getCampaignReport(auth: OAuth2Client, cfg: GoogleAdsConfig, range: DateRange): Promise<{
+    currencyCode: any;
+    timeZone: any;
     id: any;
     name: any;
     status: any;
@@ -26,6 +29,7 @@ export declare function getCampaignReport(auth: OAuth2Client, cfg: GoogleAdsConf
     cost: number;
     conversions: number;
     conversionsValue: number;
+    costPerConversion: number | null;
     cpi: number;
     ctr: number;
     avgCpc: number;
@@ -38,6 +42,9 @@ export declare function getUacReport(auth: OAuth2Client, cfg: GoogleAdsConfig, r
     clicks: number;
     impressions: number;
     cost: number;
+    conversions: number;
+    conversionsValue: number;
+    costPerConversion: number | null;
     installs: number;
     installsValue: number;
     cpi: number;

package/dist/googleads/tools.js

@@ -1,9 +1,34 @@
 import { fetchWithTimeout } from '../lib/http.js';
+import { googleAdsError } from './errors.js';
 // Google Ads API는 ~13개월 주기로 sunset (항상 최신 3개 major만 유지).
 // v24 = 2026-06 기준 현행 major. 새 major 출시 시 갱신 필요.
 // https://developers.google.com/google-ads/api/docs/sunset-dates
 const API_VERSION = 'v24';
 const BASE = `https://googleads.googleapis.com/${API_VERSION}`;
+export const REPORT_METRIC_NOTE = 'cost is in account currency, not micros. conversions are Google Ads conversions, not necessarily installs. Legacy installs/cpi aliases do not establish install CPI or cohort D7 ROAS.';
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function metricNumber(value) {
+    // Protobuf JSON can omit zero-valued scalars, but explicit malformed values are not zero.
+    if (value === undefined)
+        return 0;
+    if ((typeof value !== 'number' && typeof value !== 'string') ||
+        (typeof value === 'string' && !/^-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?$/.test(value)) ||
+        !Number.isFinite(Number(value)))
+        throw new Error('Google Ads returned an invalid numeric metric.');
+    return Number(value);
+}
+function validateDateRange(range) {
+    for (const value of [range.startDate, range.endDate]) {
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(value) ||
+            !Number.isFinite(Date.parse(value)) || new Date(value).toISOString().slice(0, 10) !== value) {
+            throw new Error('Google Ads dates must be valid YYYY-MM-DD calendar dates.');
+        }
+    }
+    if (range.startDate > range.endDate)
+        throw new Error('Google Ads startDate must not exceed endDate.');
+}
 // ─── 내부 헬퍼 ───────────────────────────────────────────────
 async function getAccessToken(auth) {
     const token = await auth.getAccessToken();
@@ -28,8 +53,10 @@ async function search(auth, cfg, query) {
     const url = `${BASE}/customers/${cfg.customerId}/googleAds:search`;
     const all = [];
     let pageToken;
+    const seenTokens = new Set();
     do {
-        const body = { query, pageSize: 1000 };
+        // Google Ads controls page size; sending pageSize is rejected by current APIs.
+        const body = { query };
         if (pageToken)
             body.pageToken = pageToken;
         const res = await fetchWithTimeout(url, {
@@ -39,27 +66,36 @@ async function search(auth, cfg, query) {
         });
         const text = await res.text();
         if (!res.ok) {
-            let msg = `Google Ads API ${res.status}`;
-            try {
-                const err = JSON.parse(text);
-                const detail = err?.error?.message ?? err?.[0]?.error?.message ?? text;
-                msg += `: ${detail}`;
-            }
-            catch {
-                msg += `: ${text.slice(0, 300)}`;
-            }
-            throw new Error(msg);
+            throw googleAdsError(res.status, text, [accessToken, cfg.developerToken]);
+        }
+        let json;
+        try {
+            json = JSON.parse(text);
+        }
+        catch {
+            throw new Error('Google Ads returned invalid JSON.');
+        }
+        if (!isRecord(json) || 'error' in json ||
+            (json.results !== undefined && !Array.isArray(json.results)) ||
+            (json.nextPageToken !== undefined && typeof json.nextPageToken !== 'string') ||
+            (json.results ?? []).some((row) => !isRecord(row) || !isRecord(row.campaign))) {
+            throw new Error('Google Ads returned an invalid search response.');
         }
-        const json = JSON.parse(text);
         all.push(...(json.results ?? []));
         pageToken = json.nextPageToken ?? undefined;
+        if (pageToken) {
+            if (seenTokens.has(pageToken))
+                throw new Error('Google Ads repeated a page token; refusing partial totals.');
+            seenTokens.add(pageToken);
+        }
     } while (pageToken);
     return all;
 }
 function microsToCurrency(micros) {
-    if (micros == null)
-        return 0;
-    return Number(micros) / 1_000_000;
+    const value = metricNumber(micros);
+    if (!Number.isSafeInteger(value))
+        throw new Error('Google Ads returned unsafe or fractional currency micros.');
+    return value / 1_000_000;
 }
 // ─── 접근 가능한 고객 목록 (API 연결 확인용) ─────────────────────
 export async function listAccessibleCustomers(auth, cfg) {
@@ -71,15 +107,7 @@ export async function listAccessibleCustomers(auth, cfg) {
     });
     const text = await res.text();
     if (!res.ok) {
-        let msg = `Google Ads API ${res.status}`;
-        try {
-            const err = JSON.parse(text);
-            msg += `: ${err?.error?.message ?? text.slice(0, 300)}`;
-        }
-        catch {
-            msg += `: ${text.slice(0, 300)}`;
-        }
-        throw new Error(msg);
+        throw googleAdsError(res.status, text, [accessToken, cfg.developerToken]);
     }
     return JSON.parse(text);
 }
@@ -92,8 +120,8 @@ export async function listCampaigns(auth, cfg) {
       campaign.status,
       campaign.advertising_channel_type,
       campaign.advertising_channel_sub_type,
-      campaign.start_date,
-      campaign.end_date,
+      campaign.start_date_time,
+      campaign.end_date_time,
       campaign_budget.amount_micros
     FROM campaign
     WHERE campaign.status != 'REMOVED'
@@ -107,15 +135,19 @@ export async function listCampaigns(auth, cfg) {
         status: r.campaign?.status,
         channelType: r.campaign?.advertisingChannelType,
         channelSubType: r.campaign?.advertisingChannelSubType,
-        startDate: r.campaign?.startDate,
-        endDate: r.campaign?.endDate,
+        // Keep date-only response fields compatible while querying the supported schema.
+        startDate: r.campaign?.startDateTime?.slice(0, 10),
+        endDate: r.campaign?.endDateTime?.slice(0, 10),
         dailyBudget: microsToCurrency(r.campaignBudget?.amountMicros),
     }));
 }
 // ─── 캠페인 성과 리포트 ────────────────────────────────────────
 export async function getCampaignReport(auth, cfg, range) {
+    validateDateRange(range);
     const query = `
     SELECT
+      customer.currency_code,
+      customer.time_zone,
       campaign.id,
       campaign.name,
       campaign.status,
@@ -130,30 +162,37 @@ export async function getCampaignReport(auth, cfg, range) {
       metrics.ctr,
       metrics.average_cpc
     FROM campaign
-    WHERE campaign.status != 'REMOVED'
-      AND segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
+    WHERE segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
     ORDER BY metrics.cost_micros DESC
-    LIMIT 500
   `;
     const rows = await search(auth, cfg, query);
+    for (const row of rows) {
+        if (!isRecord(row.metrics))
+            throw new Error('Google Ads report row is missing metrics.');
+    }
     return rows.map((r) => ({
+        currencyCode: r.customer?.currencyCode,
+        timeZone: r.customer?.timeZone,
         id: r.campaign?.id,
         name: r.campaign?.name,
         status: r.campaign?.status,
         channelType: r.campaign?.advertisingChannelType,
         channelSubType: r.campaign?.advertisingChannelSubType,
-        clicks: Number(r.metrics?.clicks ?? 0),
-        impressions: Number(r.metrics?.impressions ?? 0),
+        clicks: metricNumber(r.metrics?.clicks),
+        impressions: metricNumber(r.metrics?.impressions),
         cost: microsToCurrency(r.metrics?.costMicros),
-        conversions: Number(r.metrics?.conversions ?? 0),
-        conversionsValue: Number(r.metrics?.conversionsValue ?? 0),
-        cpi: microsToCurrency(r.metrics?.costPerConversion),
-        ctr: Number(r.metrics?.ctr ?? 0),
-        avgCpc: microsToCurrency(r.metrics?.averageCpc),
+        conversions: metricNumber(r.metrics?.conversions),
+        conversionsValue: metricNumber(r.metrics?.conversionsValue),
+        costPerConversion: metricNumber(r.metrics?.conversions) > 0
+            ? metricNumber(r.metrics?.costPerConversion) / 1_000_000 : null,
+        cpi: metricNumber(r.metrics?.costPerConversion) / 1_000_000,
+        ctr: metricNumber(r.metrics?.ctr),
+        avgCpc: metricNumber(r.metrics?.averageCpc) / 1_000_000,
     }));
 }
 // ─── UAC(앱 캠페인) 리포트 ─────────────────────────────────────
 export async function getUacReport(auth, cfg, range) {
+    validateDateRange(range);
     const query = `
     SELECT
       campaign.id,
@@ -173,21 +212,22 @@ export async function getUacReport(auth, cfg, range) {
       AND campaign.advertising_channel_sub_type IN ('APP_CAMPAIGN', 'APP_CAMPAIGN_FOR_ENGAGEMENT', 'APP_CAMPAIGN_FOR_PRE_REGISTRATION')
       AND segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
     ORDER BY segments.date DESC, metrics.cost_micros DESC
-    LIMIT 500
   `;
     const rows = await search(auth, cfg, query);
     const byId = new Map();
     for (const r of rows) {
+        if (!isRecord(r.metrics) || !r.campaign?.id)
+            throw new Error('Google Ads UAC row is missing campaign or metrics.');
         const id = String(r.campaign?.id ?? '');
         const existing = byId.get(id);
         const cost = microsToCurrency(r.metrics?.costMicros);
-        const installs = Number(r.metrics?.conversions ?? 0);
+        const installs = metricNumber(r.metrics?.conversions);
         if (existing) {
-            existing.clicks += Number(r.metrics?.clicks ?? 0);
-            existing.impressions += Number(r.metrics?.impressions ?? 0);
+            existing.clicks += metricNumber(r.metrics?.clicks);
+            existing.impressions += metricNumber(r.metrics?.impressions);
             existing.cost += cost;
             existing.installs += installs;
-            existing.installsValue += Number(r.metrics?.conversionsValue ?? 0);
+            existing.installsValue += metricNumber(r.metrics?.conversionsValue);
             if (r.segments?.date)
                 existing.dates.push(r.segments.date);
         }
@@ -197,11 +237,11 @@ export async function getUacReport(auth, cfg, range) {
                 name: r.campaign?.name ?? '',
                 status: r.campaign?.status ?? '',
                 subType: r.campaign?.advertisingChannelSubType ?? '',
-                clicks: Number(r.metrics?.clicks ?? 0),
-                impressions: Number(r.metrics?.impressions ?? 0),
+                clicks: metricNumber(r.metrics?.clicks),
+                impressions: metricNumber(r.metrics?.impressions),
                 cost,
                 installs,
-                installsValue: Number(r.metrics?.conversionsValue ?? 0),
+                installsValue: metricNumber(r.metrics?.conversionsValue),
                 dates: r.segments?.date ? [r.segments.date] : [],
             });
         }
@@ -214,6 +254,9 @@ export async function getUacReport(auth, cfg, range) {
         clicks: c.clicks,
         impressions: c.impressions,
         cost: c.cost,
+        conversions: c.installs,
+        conversionsValue: c.installsValue,
+        costPerConversion: c.installs > 0 ? c.cost / c.installs : null,
         installs: c.installs,
         installsValue: c.installsValue,
         cpi: c.installs > 0 ? c.cost / c.installs : 0,

package/dist/helpers.d.ts

@@ -8,7 +8,7 @@ export { ensureFreshAccessToken };
  * 기존엔 만료 시 각 OAuth 도구(firebase/admob/iam/googleads/checks)가
  * googleapis GaxiosError 를 그대로 노출 → 사용자는 "재로그인하라"는 안내를 못 받았다.
  */
-export declare function requireAuth(requiredScope?: string): Promise<import("google-auth-library").OAuth2Client>;
+export declare function requireAuth(requiredScope?: string, profile?: string): Promise<import("google-auth-library").OAuth2Client>;
 export declare const PLAY_AUTH_HINT: string;
 export declare const APPSTORE_AUTH_HINT: string;
 /**

package/dist/helpers.js

@@ -4,13 +4,13 @@ import { getServiceAccountClient, getServiceAccountJson } from './auth/playstore
 import { getAppStoreCredentials } from './appstore/auth.js';
 export { ensureFreshAccessToken };
 const REAUTH_CMD = '  npx -y @yoonion/mimi-seed-mcp mimi-seed-auth';
-function formatAuthError(p) {
+function formatAuthError(p, profile) {
     // 재로그인 안내는 needsReauth 인 경우에만 — CONFIG_FETCH_FAILED 처럼 재로그인이
     // 해법이 아닌 에러에 무조건 붙이면 같은 실패를 반복하게 만든다.
     return [
         `❌ [${p.code}] ${p.message}`,
         p.hint ? `→ ${p.hint}` : '',
-        ...(p.needsReauth ? ['', '터미널에서 재로그인:', REAUTH_CMD] : []),
+        ...(p.needsReauth ? ['', '터미널에서 재로그인:', profile === undefined ? REAUTH_CMD : `${REAUTH_CMD} --profile ${profile}`] : []),
     ]
         .filter((l) => l !== '')
         .join('\n');
@@ -28,10 +28,10 @@ function formatAuthError(p) {
  *
  * OAuth 토큰에만 적용된다 — SA JWT 는 자체 scopes 로 토큰을 받으므로 이 검사 대상이 아니다.
  */
-function assertStoredScope(requiredScope) {
+function assertStoredScope(requiredScope, profile) {
     if (!requiredScope)
         return;
-    const scopeStr = getStoredTokens()?.scope;
+    const scopeStr = getStoredTokens(profile)?.scope;
     const missing = scopeStr === undefined
         ? !isPreTrackingScope(requiredScope)
         : !scopeStr.split(' ').filter(Boolean).includes(requiredScope);
@@ -42,7 +42,7 @@ function assertStoredScope(requiredScope) {
         code: 'INSUFFICIENT_SCOPE',
         message: `이 도구는 추가 권한이 필요해 (${requiredScope}). 현재 로그인에 그 권한이 없어.`,
         hint: domainArg
-            ? `mimi-seed-auth --domains ${domainArg} 로 재로그인하면 기존 권한은 유지한 채 이 권한만 추가돼.`
+            ? `mimi-seed-auth${profile === undefined ? '' : ` --profile ${profile}`} --domains ${domainArg} 로 재로그인하면 기존 권한은 유지한 채 이 권한만 추가돼.`
             : 'mimi-seed-auth 로 재로그인하면 새 권한이 부여돼.',
         retriable: false,
         needsReauth: true,
@@ -56,12 +56,12 @@ function assertStoredScope(requiredScope) {
  * 기존엔 만료 시 각 OAuth 도구(firebase/admob/iam/googleads/checks)가
  * googleapis GaxiosError 를 그대로 노출 → 사용자는 "재로그인하라"는 안내를 못 받았다.
  */
-export async function requireAuth(requiredScope) {
-    const result = await ensureFreshAccessToken();
+export async function requireAuth(requiredScope, profile) {
+    const result = await ensureFreshAccessToken(undefined, profile);
     if (result.status === 'unauthenticated' || result.status === 'expired_refresh_failed') {
-        throw new Error(formatAuthError(result.error));
+        throw new Error(formatAuthError(result.error, profile));
     }
-    const client = getAuthenticatedClient();
+    const client = getAuthenticatedClient(profile);
     if (!client) {
         throw new Error(formatAuthError({
             code: 'UNAUTHENTICATED',
@@ -71,7 +71,7 @@ export async function requireAuth(requiredScope) {
             needsReauth: true,
         }));
     }
-    assertStoredScope(requiredScope);
+    assertStoredScope(requiredScope, profile);
     return client;
 }
 export const PLAY_AUTH_HINT = [

package/dist/registers/auth.js

@@ -1,3 +1,5 @@
+import { GOOGLE_PROFILE_ID, listGoogleProfiles, getAuthenticatedClient, getGoogleAuthAttempt } from '../auth/google-auth.js';
+import { verifyYouTubeChannel, YOUTUBE_CHANNEL_ID } from '../auth/youtube-channel.js';
 import { z } from 'zod';
 import { getMcpOAuthClient } from '../auth/constants.js';
 import { classifyError } from '../auth/errors.js';
@@ -281,12 +283,14 @@ export function registerAuthTools(server) {
         'domains 로 필요한 권한 도메인만 골라 요청 가능 (미지정 시 전체). 재로그인 시 기존 부여 권한은 유지되고 새 권한만 추가됨(incremental).',
         '토큰 만료(invalid_rapt) / 재인증 필요 시 사용. 10분 내 완료해야 함.',
     ].join(' '), {
+        profile: z.string().regex(GOOGLE_PROFILE_ID).optional().describe('계정/채널별 Google 로그인 프로필. 생략하면 기존 기본 로그인.'),
+        expectedChannelId: z.string().regex(YOUTUBE_CHANNEL_ID).optional().describe('이 채널로 로그인했는지 검증한 뒤 저장. profile 필수. Google 로그인에서 해당 개인/브랜드 채널을 선택하세요.'),
         domains: z
             .array(z.enum(DOMAIN_IDS))
             .optional()
             .describe(`요청할 권한 도메인 서브셋 (미지정 시 전체). 가능한 값: ${DOMAIN_IDS.join(', ')}. ` +
             '예: ["ga4","googleads"] — 기존에 부여된 다른 도메인 권한은 유지된다.'),
-    }, async ({ domains }) => {
+    }, async ({ domains, profile, expectedChannelId }) => {
         // 설정 조회 실패를 분류된 안내로 — raw throw 는 MCP 클라이언트에 마커 문자열만 노출된다.
         let clientId;
         let clientSecret;
@@ -297,7 +301,7 @@ export function registerAuthTools(server) {
             const p = classifyError(e, { phase: 'login' });
             return textResult(`❌ [${p.code}] ${p.message}${p.hint ? `\n→ ${p.hint}` : ''}`);
         }
-        const { url, wait } = startAuth(clientId, clientSecret, { domains });
+        const { url, wait } = startAuth(clientId, clientSecret, { domains, profile, expectedChannelId });
         // fire-and-forget — 토큰은 콜백 서버가 자동 저장
         wait.then(() => { }, (err) => { console.error('[mimi-seed auth]', err.message); });
         const scopeLine = domains?.length
@@ -312,6 +316,8 @@ export function registerAuthTools(server) {
                         url,
                         '',
                         scopeLine,
+                        `로그인 프로필: ${profile ?? '(기본)'} / 대상 채널: ${expectedChannelId ?? '(로그인 후 확인)'}`,
+                        'YouTube는 Google 로그인에서 선택한 개인/브랜드 채널에 연결됩니다. 완료 후 mimi_seed_auth_status(profile=...)로 실제 채널을 확인하세요.',
                         '',
                         '이 URL을 브라우저에서 열고 Google 계정으로 승인해줘.',
                         '완료되면 localhost:9876으로 자동 리다이렉트되고 토큰이 저장돼.',
@@ -320,10 +326,24 @@ export function registerAuthTools(server) {
                 }],
         };
     });
-    server.tool('mimi_seed_auth_status', 'Mimi Seed MCP 인증 상태 확인 (만료 시 refresh_token으로 자동 갱신 시도)', {}, async () => {
+    server.tool('mimi_seed_auth_status', 'Mimi Seed MCP 인증 상태 확인 (만료 시 refresh_token으로 자동 갱신 시도)', {
+        profile: z.string().regex(GOOGLE_PROFILE_ID).optional().describe('확인할 Google 로그인 프로필. 저장된 프로필 목록도 반환.'),
+    }, async ({ profile }) => {
+        const profiles = listGoogleProfiles();
+        const loginAttempt = getGoogleAuthAttempt(profile);
+        if (profile !== undefined) {
+            const result = await ensureFreshAccessToken(undefined, profile);
+            if (result.status === 'unauthenticated' || result.status === 'expired_refresh_failed') {
+                return textResult(JSON.stringify({ profile, status: result.status, error: result.error, loginAttempt, profiles }));
+            }
+            const client = getAuthenticatedClient(profile);
+            const channel = result.tokens.youtubeChannel && client
+                ? await verifyYouTubeChannel(client, result.tokens.youtubeChannel.id) : null;
+            return textResult(JSON.stringify({ profile, status: result.status, youtubeChannel: channel, loginAttempt, profiles }));
+        }
         const r = await ensureFreshAccessToken();
         const refreshHint = formatLastRefreshHint(getTokensLastRefreshMs());
-        const refreshLine = `   마지막 갱신: ${refreshHint.label}`;
+        const refreshLine = `   마지막 갱신: ${refreshHint.label}\nGoogle profiles: ${JSON.stringify(profiles)}`;
         const recommendation = refreshHint.recommendation ? `\n\n${refreshHint.recommendation}` : '';
         // 도메인 선택형 로그인 이후 토큰은 전체 권한이 아닐 수 있다 — 부여 현황을 함께
         // 보여준다. 유효/갱신된 상태에서만 쓰므로 그 두 arm 에서만 계산한다(불필요한 토큰
@@ -349,6 +369,7 @@ export function registerAuthTools(server) {
                             type: 'text',
                             text: `❌ [${r.error.code}] ${r.error.message}\n` +
                                 (r.error.hint ? `→ ${r.error.hint}\n\n` : '\n') +
+                                `Google profiles: ${JSON.stringify(profiles)}\n` +
                                 '터미널에서 실행:\n  npx -y @yoonion/mimi-seed-mcp mimi-seed-auth',
                         }],
                 };

package/dist/registers/googleads.js

@@ -32,7 +32,7 @@ export function registerGoogleAdsTools(server) {
         const campaigns = await googleads.listCampaigns(auth, cfg);
         return textResult(JSON.stringify(campaigns, null, 2));
     });
-    server.tool('googleads_get_campaign_report', '기간별 캠페인 성과 리포트 (클릭, 노출, 비용, 전환수, CPI, CTR)', {
+    server.tool('googleads_get_campaign_report', '기간별 캠페인 성과 리포트 (클릭, 노출, 계정 통화 비용, 전환수, 전환당 비용). 설치 CPI나 코호트 ROAS가 아님.', {
         startDate: z.string().describe('시작일 (YYYY-MM-DD)'),
         endDate: z.string().describe('종료일 (YYYY-MM-DD)'),
     }, async ({ startDate, endDate }) => {
@@ -48,6 +48,7 @@ export function registerGoogleAdsTools(server) {
                     type: 'text',
                     text: JSON.stringify({
                         period: { startDate, endDate },
+                        metricNote: googleads.REPORT_METRIC_NOTE,
                         summary: {
                             totalCost: Math.round(totalCost * 100) / 100,
                             totalClicks,
@@ -60,7 +61,7 @@ export function registerGoogleAdsTools(server) {
                 }],
         };
     });
-    server.tool('googleads_get_uac_report', '앱 캠페인(UAC) 리포트 — 앱 설치 캠페인별 설치수, CPI, ROAS 집계', {
+    server.tool('googleads_get_uac_report', '앱 캠페인(UAC) 비용·전환 리포트. legacy installs/cpi 필드는 일반 전환 기반 별칭이며 설치수·설치 CPI·D7 ROAS로 단정하지 말 것.', {
         startDate: z.string().describe('시작일 (YYYY-MM-DD)'),
         endDate: z.string().describe('종료일 (YYYY-MM-DD)'),
     }, async ({ startDate, endDate }) => {
@@ -74,9 +75,11 @@ export function registerGoogleAdsTools(server) {
                     type: 'text',
                     text: JSON.stringify({
                         period: { startDate, endDate },
+                        metricNote: googleads.REPORT_METRIC_NOTE,
                         summary: {
                             totalCost: Math.round(totalCost * 100) / 100,
                             totalInstalls,
+                            totalConversions: totalInstalls,
                             avgCpi: totalInstalls > 0 ? Math.round(totalCost / totalInstalls * 100) / 100 : null,
                             campaignCount: report.length,
                         },

package/dist/registers/video.js

@@ -1,3 +1,5 @@
+import { GOOGLE_PROFILE_ID } from '../auth/google-auth.js';
+import { YOUTUBE_CHANNEL_ID } from '../auth/youtube-channel.js';
 import { z } from 'zod';
 import { addLocalAsset, buildTimeline, loadProject, loadTimeline, planStory, savePlan, } from '../video/project.js';
 import { downloadStockAssets, generateImage, researchYouTube, searchStock, } from '../video/providers.js';
@@ -15,12 +17,14 @@ const httpUrl = z.string().url().refine((value) => {
 }, 'HTTP(S) URL만 허용합니다.');
 export function registerVideoTools(server) {
     server.tool('youtube_upload_video', [
-        '로컬 영상 파일을 현재 Google OAuth 계정의 YouTube 채널에 업로드합니다.',
+        '로컬 영상 파일을 선택한 Google 로그인 프로필의 채널에 업로드합니다. expectedChannelId를 실제 인증 채널과 대조한 후 전송합니다.',
         '기본 공개 상태는 private이며 public/unlisted는 같은 턴의 명시 승인 후 confirmVisible=true가 필요합니다.',
         '업로드 후 youtube_get_video_status로 처리 완료 여부와 실제 공개 상태를 확인하세요.',
         '요청이 타임아웃되면 업로드가 뒤늦게 완료될 수 있으므로 YouTube Studio를 먼저 확인하고 중복 재시도하지 마세요.',
         'YouTube OAuth 권한이 없으면 mimi_seed_auth_start(domains=["youtube"])로 증분 연결하세요.',
     ].join(' '), {
+        profile: z.string().regex(GOOGLE_PROFILE_ID).optional().describe('Google 로그인 프로필. 지정한 프로필만 사용하며 기본 계정으로 대체하지 않습니다.'),
+        expectedChannelId: z.string().regex(YOUTUBE_CHANNEL_ID).describe('업로드 대상 채널 ID. 인증된 채널과 다르면 업로드 중단.'),
         filePath: absolutePath.describe('업로드할 .mp4/.mov/.webm 영상 절대경로'),
         title: z.string().min(1).max(100).describe('YouTube 영상 제목'),
         description: z.string().max(5_000).optional().describe('영상 설명과 음원 출처/라이선스 표기'),
@@ -33,24 +37,26 @@ export function registerVideoTools(server) {
         shortsOnly: z.boolean().default(false).describe('true면 세로/정사각형·180초 이하 쇼츠 규격을 강제'),
         confirmVisible: z.boolean().default(false).describe('public/unlisted 게시에 대한 명시 확인'),
     }, async (input) => {
-        const auth = await requireAuth(YOUTUBE_SCOPE);
+        const auth = await requireAuth(YOUTUBE_SCOPE, input.profile);
         return text(await uploadYouTubeVideo(auth, input));
     });
     server.tool('youtube_get_video_status', '내 YouTube 영상의 업로드 처리 상태와 현재 공개 상태를 조회합니다.', {
+        profile: z.string().regex(GOOGLE_PROFILE_ID).optional().describe('영상 소유 채널의 Google 로그인 프로필'),
         videoId: z.string().min(1).max(64).describe('YouTube video ID'),
-    }, async ({ videoId }) => {
-        const auth = await requireAuth(YOUTUBE_SCOPE);
+    }, async ({ videoId, profile }) => {
+        const auth = await requireAuth(YOUTUBE_SCOPE, profile);
         return text(await getYouTubeVideoStatus(auth, videoId));
     });
     server.tool('youtube_update_video_privacy', [
         '내 YouTube 영상의 공개 상태를 변경하고 실제 반영 상태를 다시 조회합니다.',
         'public/unlisted 변경은 같은 턴의 명시 승인 후 confirmVisible=true가 필요합니다.',
     ].join(' '), {
+        profile: z.string().regex(GOOGLE_PROFILE_ID).optional().describe('영상 소유 채널의 Google 로그인 프로필'),
         videoId: z.string().min(1).max(64).describe('YouTube video ID'),
         privacyStatus: z.enum(['private', 'unlisted', 'public']),
         confirmVisible: z.boolean().default(false).describe('public/unlisted 변경에 대한 명시 확인'),
     }, async (input) => {
-        const auth = await requireAuth(YOUTUBE_SCOPE);
+        const auth = await requireAuth(YOUTUBE_SCOPE, input.profile);
         return text(await updateYouTubeVideoPrivacy(auth, input));
     });
     server.tool('video_plan_from_story', [

package/dist/video/schemas.d.ts

@@ -76,8 +76,8 @@ export declare const projectSchema: z.ZodEffects<z.ZodObject<{
         searchQuery: string;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    projectId: string;
     version: 1;
+    projectId: string;
     title: string;
     language: string;
     story: string;
@@ -99,8 +99,8 @@ export declare const projectSchema: z.ZodEffects<z.ZodObject<{
         searchQuery: string;
     }[];
 }, {
-    projectId: string;
     version: 1;
+    projectId: string;
     title: string;
     language: string;
     story: string;
@@ -122,8 +122,8 @@ export declare const projectSchema: z.ZodEffects<z.ZodObject<{
         searchQuery: string;
     }[];
 }>, {
-    projectId: string;
     version: 1;
+    projectId: string;
     title: string;
     language: string;
     story: string;
@@ -145,8 +145,8 @@ export declare const projectSchema: z.ZodEffects<z.ZodObject<{
         searchQuery: string;
     }[];
 }, {
-    projectId: string;
     version: 1;
+    projectId: string;
     title: string;
     language: string;
     story: string;
@@ -314,8 +314,8 @@ export declare const assetManifestSchema: z.ZodObject<{
         attribution?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    projectId: string;
     version: 1;
+    projectId: string;
     assets: {
         id: string;
         path: string;
@@ -332,8 +332,8 @@ export declare const assetManifestSchema: z.ZodObject<{
         attribution?: string | undefined;
     }[];
 }, {
-    projectId: string;
     version: 1;
+    projectId: string;
     assets: {
         id: string;
         path: string;
@@ -449,8 +449,8 @@ export declare const timelineSchema: z.ZodEffects<z.ZodObject<{
         position?: "lower" | "lower-middle" | "center" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    projectId: string;
     version: 1;
+    projectId: string;
     width: number;
     height: number;
     createdAt: string;
@@ -474,8 +474,8 @@ export declare const timelineSchema: z.ZodEffects<z.ZodObject<{
         position?: "lower" | "lower-middle" | "center" | undefined;
     } | undefined;
 }, {
-    projectId: string;
     version: 1;
+    projectId: string;
     width: number;
     height: number;
     createdAt: string;
@@ -499,8 +499,8 @@ export declare const timelineSchema: z.ZodEffects<z.ZodObject<{
         position?: "lower" | "lower-middle" | "center" | undefined;
     } | undefined;
 }>, {
-    projectId: string;
     version: 1;
+    projectId: string;
     width: number;
     height: number;
     createdAt: string;
@@ -524,8 +524,8 @@ export declare const timelineSchema: z.ZodEffects<z.ZodObject<{
         position?: "lower" | "lower-middle" | "center" | undefined;
     } | undefined;
 }, {
-    projectId: string;
     version: 1;
+    projectId: string;
     width: number;
     height: number;
     createdAt: string;
@@ -561,8 +561,8 @@ export declare const renderJobSchema: z.ZodObject<{
     exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    status: "failed" | "completed" | "queued" | "running";
     id: string;
-    status: "completed" | "queued" | "running" | "failed";
     createdAt: string;
     updatedAt: string;
     projectDir: string;
@@ -572,8 +572,8 @@ export declare const renderJobSchema: z.ZodObject<{
     pid?: number | undefined;
     exitCode?: number | null | undefined;
 }, {
+    status: "failed" | "completed" | "queued" | "running";
     id: string;
-    status: "completed" | "queued" | "running" | "failed";
     createdAt: string;
     updatedAt: string;
     projectDir: string;