careerly-data-mcp 2.1.1 → 2.2.0

package/README.md

@@ -1,6 +1,6 @@
 # Careerly Data MCP Server
 
-Claude Code에서 **자연어로 GA4와 BigQuery 데이터를 분석**하는 MCP(Model Context Protocol) 서버입니다.
+Claude Code에서 **자연어로 GA4, BigQuery, Search Console 데이터를 분석**하는 MCP(Model Context Protocol) 서버입니다.
 
 ## 왜 MCP를 쓰나요? (vs API 직접 호출)
 
@@ -16,6 +16,7 @@ BigQuery 분석하고 싶다 → SQL 작성 → UNNEST 문법 검색 → 쿼리
 ```
 "지난 7일 세션수 보여줘" → 끝!
 "page_view → post_detail_view 전환율 분석해줘" → 끝!
+"검색어별 클릭수 보여줘" → 끝!
 ```
 
 ### 핵심 장점
@@ -58,7 +59,8 @@ npx careerly-data-mcp setup
 1. [Google Cloud Console](https://console.cloud.google.com/)에서 프로젝트 생성
 2. **Google Analytics Data API** 활성화
 3. **BigQuery API** 활성화
-4. **서비스 계정** 생성 후 JSON 키 다운로드
+4. **Search Console API** 활성화
+5. **서비스 계정** 생성 후 JSON 키 다운로드
 
 ### 2. GA4 권한 설정
 
@@ -69,6 +71,11 @@ npx careerly-data-mcp setup
 
 - IAM & Admin > 서비스 계정에 **BigQuery 데이터 뷰어** 역할 추가
 
+### 4. Search Console 권한 설정 (선택)
+
+- [Search Console](https://search.google.com/search-console) > 설정 > 사용자 및 권한
+- 서비스 계정 이메일 추가 (전체 권한 또는 제한된 권한)
+
 ---
 
 ## 제공 도구 (Tools)
@@ -90,7 +97,7 @@ npx careerly-data-mcp setup
 | `bq_status` | 연결 상태 확인 | 연결 문제 진단 |
 | `bq_ga4_events` | GA4 Export 이벤트 조회 | event_params 자동 추출 |
 
-### BigQuery 고급 도구 (v2.1.0 신규)
+### BigQuery 고급 도구 (v2.1.0)
 
 | Tool | 설명 | 언제 쓰나요? |
 |------|------|------------|
@@ -99,6 +106,14 @@ npx careerly-data-mcp setup
 | `bq_user_journey` | 사용자 여정 분석 | 특정 사용자가 어떤 행동을 했는지 |
 | `bq_funnel` | 퍼널 분석 | 단계별 전환율 자동 계산 |
 
+### Google Search Console 도구 (v2.2.0 신규)
+
+| Tool | 설명 | 언제 쓰나요? |
+|------|------|------------|
+| `gsc_query` | 검색 분석 데이터 조회 | 검색어/페이지별 클릭, 노출, CTR, 순위 |
+| `gsc_status` | 연결 상태 확인 | 연결 문제 진단 |
+| `gsc_sites` | 등록된 사이트 목록 | 접근 가능한 사이트 확인 |
+
 ---
 
 ## 사용 예시
@@ -123,6 +138,15 @@ Claude Code에서 자연어로 질문하세요:
 "디바이스별 전환율 비교해줘"
 ```
 
+### Search Console 질의 (v2.2.0)
+
+```
+"최근 28일 검색어별 클릭수 보여줘"
+"클릭률이 낮은 페이지 찾아줘"
+"모바일 vs 데스크톱 검색 성과 비교해줘"
+"순위가 높은데 CTR이 낮은 키워드 분석해줘"
+```
+
 ### 실제 결과 예시 (퍼널 분석)
 
 ```
@@ -142,6 +166,28 @@ page_view → post_create_start 전환율: 2.3% | 1,215 → 28명
 
 ---
 
+## v2.2.0 주요 업데이트 (최신)
+
+### Google Search Console 통합
+
+- **3개 새 도구 추가**: `gsc_query`, `gsc_status`, `gsc_sites`
+- 검색어/페이지별 클릭수, 노출수, CTR, 평균 순위 분석
+- 국가별, 디바이스별 필터링 지원
+- 16개월 이전 데이터까지 조회 가능
+
+### 새 환경변수
+
+| 변수 | 설명 |
+|------|------|
+| `GSC_SITE_URL` | 기본 사이트 URL (예: `https://example.com/` 또는 `sc-domain:example.com`) |
+
+### GSC 권한 설정
+
+1. Search Console > 설정 > 사용자 및 권한
+2. Service Account 이메일 추가 (전체 권한 또는 제한된 권한)
+
+---
+
 ## v2.1.0 주요 업데이트
 
 ### 버그 수정
@@ -226,6 +272,7 @@ claude mcp add careerly-ga4 \
   -s user \
   -e GA4_PROPERTY_ID=123456789 \
   -e BQ_PROJECT_ID=your-project-id \
+  -e GSC_SITE_URL=https://example.com/ \
   -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json \
   -- npx -y careerly-data-mcp serve
 ```
@@ -243,6 +290,7 @@ claude mcp add careerly-ga4 \
       "env": {
         "GA4_PROPERTY_ID": "123456789",
         "BQ_PROJECT_ID": "your-project-id",
+        "GSC_SITE_URL": "https://example.com/",
         "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/key.json"
       }
     }

package/dist/cli/setup.d.ts

@@ -1,6 +1,6 @@
 /**
  * setup 명령어 - GUI 스타일
- * GA4 + BigQuery 설정 + Claude Code 자동 설정
+ * GA4 + BigQuery + Search Console 설정 + Claude Code 자동 설정
  */
 /**
  * GA4 설정
@@ -20,9 +20,17 @@ export declare function runBigQuerySetup(): Promise<{
     connected: boolean;
 }>;
 /**
- * 통합 설정 (GA4 + BigQuery)
+ * 통합 설정 (GA4 + BigQuery + GSC)
  */
 export declare function runSetup(): Promise<void>;
+/**
+ * Search Console 설정
+ */
+export declare function runGSCSetup(existingCredentialsPath?: string): Promise<{
+    siteUrl: string;
+    credentialsPath: string;
+    connected: boolean;
+}>;
 /**
  * 인터랙티브 메뉴
  */

package/dist/cli/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqSH;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CAgED;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CA4FD;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAoJ9C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAmIxD"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwTH;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CAgED;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CA4FD;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAgL9C;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,uBAAuB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CA2ID;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4JxD"}

package/dist/cli/setup.js

@@ -1,6 +1,6 @@
 /**
  * setup 명령어 - GUI 스타일
- * GA4 + BigQuery 설정 + Claude Code 자동 설정
+ * GA4 + BigQuery + Search Console 설정 + Claude Code 자동 설정
  */
 import * as fs from "fs/promises";
 import * as path from "path";
@@ -10,6 +10,7 @@ import ora from "ora";
 import { input, confirm, select, checkbox } from "@inquirer/prompts";
 import { GA4Client } from "../ga4/index.js";
 import { BigQueryClient } from "../bigquery/index.js";
+import { GSCClient } from "../gsc/index.js";
 const CLAUDE_SETTINGS_PATH = path.join(process.env.HOME || "~", ".claude", "settings.json");
 const CLAUDE_SETTINGS_LOCAL_PATH = path.join(process.env.HOME || "~", ".claude", "settings.local.json");
 /**
@@ -82,7 +83,7 @@ async function findServiceAccountKeys() {
 function printHeader() {
     console.log("");
     console.log(chalk.cyan.bold("  Careerly Data MCP Server"));
-    console.log(chalk.gray("  GA4 + BigQuery 통합 분석"));
+    console.log(chalk.gray("  GA4 + BigQuery + Search Console 통합 분석"));
     console.log(chalk.gray("  ─────────────────────────────────────"));
     console.log("");
 }
@@ -102,6 +103,12 @@ function printStatus(config) {
         : config.bqProjectId
             ? chalk.yellow("○ configured")
             : chalk.gray("- not set");
+    // GSC 상태
+    const gscStatus = config.gscConnected
+        ? chalk.green("✓ connected")
+        : config.gscSiteUrl
+            ? chalk.yellow("○ configured")
+            : chalk.gray("- not set");
     console.log(chalk.white.bold("GA4:         ") + ga4Status);
     if (config.ga4PropertyId) {
         console.log(chalk.gray("             Property: " + config.ga4PropertyId));
@@ -110,6 +117,10 @@ function printStatus(config) {
     if (config.bqProjectId) {
         console.log(chalk.gray("             Project: " + config.bqProjectId));
     }
+    console.log(chalk.white.bold("GSC:         ") + gscStatus);
+    if (config.gscSiteUrl) {
+        console.log(chalk.gray("             Site: " + config.gscSiteUrl));
+    }
     if (config.credentialsPath) {
         const shortPath = config.credentialsPath.replace(process.env.HOME || "", "~");
         console.log(chalk.white.bold("Credentials: ") + chalk.gray(shortPath));
@@ -144,6 +155,9 @@ async function runClaudeMcpAdd(config) {
         if (config.bqLocation) {
             envParts.push(`-e BQ_LOCATION=${config.bqLocation}`);
         }
+        if (config.gscSiteUrl) {
+            envParts.push(`-e GSC_SITE_URL=${config.gscSiteUrl}`);
+        }
         envParts.push(`-e GOOGLE_APPLICATION_CREDENTIALS=${config.credentialsPath}`);
         // claude mcp add 실행
         const cmd = [
@@ -364,7 +378,7 @@ export async function runBigQuerySetup() {
     };
 }
 /**
- * 통합 설정 (GA4 + BigQuery)
+ * 통합 설정 (GA4 + BigQuery + GSC)
  */
 export async function runSetup() {
     printHeader();
@@ -374,6 +388,7 @@ export async function runSetup() {
         choices: [
             { name: "GA4 Data API", value: "ga4", checked: true },
             { name: "BigQuery", value: "bigquery", checked: true },
+            { name: "Search Console", value: "gsc", checked: true },
         ],
     });
     if (services.length === 0) {
@@ -382,6 +397,7 @@ export async function runSetup() {
     }
     let ga4Config = {};
     let bqConfig = {};
+    let gscConfig = {};
     let credentialsPath = "";
     // GA4 설정
     if (services.includes("ga4")) {
@@ -416,8 +432,24 @@ export async function runSetup() {
             }
         }
     }
+    // Search Console 설정
+    if (services.includes("gsc")) {
+        try {
+            const result = await runGSCSetup(credentialsPath);
+            gscConfig = { siteUrl: result.siteUrl, connected: result.connected };
+            // credentials가 아직 없으면 사용
+            if (!credentialsPath) {
+                credentialsPath = result.credentialsPath;
+            }
+        }
+        catch (error) {
+            if (error.message === "설정 취소됨") {
+                console.log(chalk.yellow("\nSearch Console 설정이 취소되었습니다."));
+            }
+        }
+    }
     // 설정할 내용이 있는지 확인
-    if (!ga4Config.propertyId && !bqConfig.projectId) {
+    if (!ga4Config.propertyId && !bqConfig.projectId && !gscConfig.siteUrl) {
         console.log(chalk.yellow("\n설정된 서비스가 없습니다."));
         return;
     }
@@ -428,6 +460,7 @@ export async function runSetup() {
         ga4PropertyId: ga4Config.propertyId,
         bqProjectId: bqConfig.projectId,
         bqLocation: bqConfig.location,
+        gscSiteUrl: gscConfig.siteUrl,
         credentialsPath,
     });
     if (mcpResult.success) {
@@ -449,6 +482,9 @@ export async function runSetup() {
         if (bqConfig.location) {
             env.BQ_LOCATION = bqConfig.location;
         }
+        if (gscConfig.siteUrl) {
+            env.GSC_SITE_URL = gscConfig.siteUrl;
+        }
         const mcpConfig = {
             command: "npx",
             args: ["-y", "careerly-data-mcp", "serve"],
@@ -480,10 +516,12 @@ export async function runSetup() {
     printStatus({
         ga4PropertyId: ga4Config.propertyId,
         bqProjectId: bqConfig.projectId,
+        gscSiteUrl: gscConfig.siteUrl,
         credentialsPath,
         ga4Connected: ga4Config.connected,
         bqConnected: bqConfig.connected,
-        tools: 7,
+        gscConnected: gscConfig.connected,
+        tools: 14,
     });
     console.log(chalk.cyan("  Claude Code를 재시작하면 사용할 수 있습니다."));
     console.log("");
@@ -495,6 +533,144 @@ export async function runSetup() {
     console.log(chalk.white('    "BigQuery 데이터셋 목록 보여줘"'));
     console.log(chalk.white('    "GA4 이벤트 데이터에서 page_view 조회해줘"'));
     console.log("");
+    console.log(chalk.gray("  Search Console 사용 예시:"));
+    console.log(chalk.white('    "검색어별 클릭수 보여줘"'));
+    console.log(chalk.white('    "페이지별 순위 분석해줘"'));
+    console.log("");
+}
+/**
+ * Search Console 설정
+ */
+export async function runGSCSetup(existingCredentialsPath) {
+    printHeader();
+    console.log(chalk.cyan.bold("  Search Console 설정"));
+    console.log("");
+    // 1. Service Account 키 파일 선택 (이미 있으면 재사용 제안)
+    let absolutePath;
+    if (existingCredentialsPath) {
+        const reuseCredentials = await confirm({
+            message: `기존 키 파일 사용? (${path.basename(existingCredentialsPath)})`,
+            default: true,
+        });
+        if (reuseCredentials) {
+            absolutePath = existingCredentialsPath;
+        }
+        else {
+            console.log("");
+            absolutePath = await selectServiceAccountKey();
+        }
+    }
+    else {
+        absolutePath = await selectServiceAccountKey();
+    }
+    // 2. 연결 테스트 및 사이트 목록 조회
+    console.log("");
+    const spinner = ora("Search Console 연결 테스트 중...").start();
+    process.env.GOOGLE_APPLICATION_CREDENTIALS = absolutePath;
+    let siteUrl = "";
+    let connected = false;
+    try {
+        const client = new GSCClient();
+        const result = await client.testConnection();
+        if (result.success && result.sites && result.sites.length > 0) {
+            spinner.succeed(chalk.green("Search Console 연결 성공!"));
+            connected = true;
+            // 사이트 선택
+            console.log("");
+            const choices = [
+                ...result.sites.map((site) => ({
+                    name: site,
+                    value: site,
+                })),
+                {
+                    name: chalk.gray("직접 입력..."),
+                    value: "__manual__",
+                },
+            ];
+            const selected = await select({
+                message: "분석할 사이트 선택",
+                choices,
+            });
+            if (selected === "__manual__") {
+                siteUrl = await input({
+                    message: "Site URL (예: https://example.com/ 또는 sc-domain:example.com)",
+                    validate: (value) => {
+                        if (!value)
+                            return "Site URL을 입력해주세요";
+                        if (!value.startsWith("http") && !value.startsWith("sc-domain:")) {
+                            return "https:// 또는 sc-domain: 형식이어야 합니다";
+                        }
+                        return true;
+                    },
+                });
+            }
+            else {
+                siteUrl = selected;
+            }
+        }
+        else if (result.success) {
+            spinner.warn(chalk.yellow("연결됐지만 접근 가능한 사이트가 없습니다."));
+            // 수동 입력
+            siteUrl = await input({
+                message: "Site URL (예: https://example.com/ 또는 sc-domain:example.com)",
+                validate: (value) => {
+                    if (!value)
+                        return "Site URL을 입력해주세요";
+                    if (!value.startsWith("http") && !value.startsWith("sc-domain:")) {
+                        return "https:// 또는 sc-domain: 형식이어야 합니다";
+                    }
+                    return true;
+                },
+            });
+        }
+        else {
+            spinner.fail(chalk.red(`Search Console 연결 실패: ${result.message}`));
+            const continueSetup = await confirm({
+                message: "연결에 실패했습니다. 계속 진행하시겠습니까?",
+                default: false,
+            });
+            if (!continueSetup) {
+                throw new Error("설정 취소됨");
+            }
+            // 수동 입력
+            siteUrl = await input({
+                message: "Site URL (예: https://example.com/ 또는 sc-domain:example.com)",
+                validate: (value) => {
+                    if (!value)
+                        return "Site URL을 입력해주세요";
+                    if (!value.startsWith("http") && !value.startsWith("sc-domain:")) {
+                        return "https:// 또는 sc-domain: 형식이어야 합니다";
+                    }
+                    return true;
+                },
+            });
+        }
+    }
+    catch (error) {
+        if (error.message === "설정 취소됨")
+            throw error;
+        spinner.fail(chalk.red(`Search Console 연결 실패: ${error instanceof Error ? error.message : error}`));
+        const continueSetup = await confirm({
+            message: "계속 진행하시겠습니까?",
+            default: false,
+        });
+        if (!continueSetup) {
+            throw new Error("설정 취소됨");
+        }
+        // 수동 입력
+        siteUrl = await input({
+            message: "Site URL (예: https://example.com/ 또는 sc-domain:example.com)",
+            validate: (value) => {
+                if (!value)
+                    return "Site URL을 입력해주세요";
+                if (!value.startsWith("http") && !value.startsWith("sc-domain:")) {
+                    return "https:// 또는 sc-domain: 형식이어야 합니다";
+                }
+                return true;
+            },
+        });
+    }
+    return { siteUrl, credentialsPath: absolutePath, connected };
 }
 /**
  * 인터랙티브 메뉴
@@ -502,7 +678,7 @@ export async function runSetup() {
 export async function runInteractiveMenu() {
     printHeader();
     // 현재 설정 상태 확인
-    let currentConfig = { ga4Connected: false, bqConnected: false };
+    let currentConfig = { ga4Connected: false, bqConnected: false, gscConnected: false };
     // settings 파일에서 현재 설정 읽기
     const settingsPath = (await fileExists(CLAUDE_SETTINGS_LOCAL_PATH))
         ? CLAUDE_SETTINGS_LOCAL_PATH
@@ -515,6 +691,7 @@ export async function runInteractiveMenu() {
         if (mcpConfig?.env) {
             currentConfig.ga4PropertyId = mcpConfig.env.GA4_PROPERTY_ID;
             currentConfig.bqProjectId = mcpConfig.env.BQ_PROJECT_ID;
+            currentConfig.gscSiteUrl = mcpConfig.env.GSC_SITE_URL;
             currentConfig.credentialsPath =
                 mcpConfig.env.GOOGLE_APPLICATION_CREDENTIALS;
             // GA4 연결 테스트
@@ -547,13 +724,26 @@ export async function runInteractiveMenu() {
                     currentConfig.bqConnected = false;
                 }
             }
+            // GSC 연결 테스트
+            if (currentConfig.gscSiteUrl && currentConfig.credentialsPath) {
+                process.env.GSC_SITE_URL = currentConfig.gscSiteUrl;
+                process.env.GOOGLE_APPLICATION_CREDENTIALS = currentConfig.credentialsPath;
+                try {
+                    const client = new GSCClient();
+                    const result = await client.testConnection();
+                    currentConfig.gscConnected = result.success;
+                }
+                catch {
+                    currentConfig.gscConnected = false;
+                }
+            }
         }
     }
     printStatus({
         ...currentConfig,
-        tools: 7,
+        tools: 14,
     });
-    const isConfigured = currentConfig.ga4Connected || currentConfig.bqConnected;
+    const isConfigured = currentConfig.ga4Connected || currentConfig.bqConnected || currentConfig.gscConnected;
     // 메뉴 선택
     const action = await select({
         message: "선택하세요",
@@ -566,7 +756,7 @@ export async function runInteractiveMenu() {
             {
                 name: isConfigured ? "Reconfigure" : "Setup",
                 value: "setup",
-                description: "GA4 + BigQuery 설정",
+                description: "GA4 + BigQuery + Search Console 설정",
             },
             {
                 name: "Setup GA4 only",
@@ -578,6 +768,11 @@ export async function runInteractiveMenu() {
                 value: "setup-bq",
                 description: "BigQuery만 설정",
             },
+            {
+                name: "Setup Search Console only",
+                value: "setup-gsc",
+                description: "Search Console만 설정",
+            },
             {
                 name: "Test connections",
                 value: "test",
@@ -603,6 +798,9 @@ export async function runInteractiveMenu() {
         case "setup-bq":
             await runBigQuerySetupOnly();
             break;
+        case "setup-gsc":
+            await runGSCSetupOnly();
+            break;
         case "test":
             await testConnections();
             break;
@@ -614,6 +812,39 @@ export async function runInteractiveMenu() {
             break;
     }
 }
+/**
+ * Search Console만 설정
+ */
+async function runGSCSetupOnly() {
+    try {
+        const result = await runGSCSetup();
+        // Claude Code MCP 설정
+        console.log("");
+        const settingsSpinner = ora("Claude Code MCP 설정 중...").start();
+        const mcpResult = await runClaudeMcpAdd({
+            gscSiteUrl: result.siteUrl,
+            credentialsPath: result.credentialsPath,
+        });
+        if (mcpResult.success) {
+            settingsSpinner.succeed(chalk.green("Claude Code MCP 서버 등록 완료"));
+        }
+        else {
+            await saveSettingsManually({
+                gscSiteUrl: result.siteUrl,
+                credentialsPath: result.credentialsPath,
+            });
+        }
+        console.log("");
+        console.log(chalk.green.bold("  ✓ Search Console 설정 완료!"));
+        console.log(chalk.cyan("  Claude Code를 재시작하면 사용할 수 있습니다."));
+        console.log("");
+    }
+    catch (error) {
+        if (error.message === "설정 취소됨") {
+            console.log(chalk.yellow("\n설정이 취소되었습니다."));
+        }
+    }
+}
 /**
  * GA4만 설정
  */
@@ -699,6 +930,9 @@ async function saveSettingsManually(config) {
     if (config.bqLocation) {
         env.BQ_LOCATION = config.bqLocation;
     }
+    if (config.gscSiteUrl) {
+        env.GSC_SITE_URL = config.gscSiteUrl;
+    }
     const mcpConfig = {
         command: "npx",
         args: ["-y", "careerly-data-mcp", "serve"],
@@ -727,11 +961,10 @@ async function saveSettingsManually(config) {
  */
 async function showTools() {
     console.log("");
-    console.log(chalk.white.bold("  GA4 Data API Tools:"));
+    console.log(chalk.white.bold("  GA4 Data API Tools (3):"));
     console.log("");
     console.log(chalk.cyan("  ga4_query"));
     console.log(chalk.gray("    GA4 데이터 조회 및 인사이트 생성"));
-    console.log(chalk.gray("    예: 지난 7일 세션수, 채널별 전환수"));
     console.log("");
     console.log(chalk.cyan("  ga4_metadata"));
     console.log(chalk.gray("    사용 가능한 지표/차원 목록 확인"));
@@ -739,15 +972,13 @@ async function showTools() {
     console.log(chalk.cyan("  ga4_status"));
     console.log(chalk.gray("    GA4 연결 상태 확인"));
     console.log("");
-    console.log(chalk.white.bold("  BigQuery Tools:"));
+    console.log(chalk.white.bold("  BigQuery Tools (8):"));
     console.log("");
     console.log(chalk.cyan("  bq_query"));
     console.log(chalk.gray("    BigQuery 테이블 파라미터 기반 조회"));
-    console.log(chalk.gray("    예: 특정 테이블에서 조건별 데이터 조회"));
     console.log("");
     console.log(chalk.cyan("  bq_ga4_events"));
     console.log(chalk.gray("    GA4 Export 이벤트 데이터 조회"));
-    console.log(chalk.gray("    예: page_view, purchase 이벤트 분석"));
     console.log("");
     console.log(chalk.cyan("  bq_metadata"));
     console.log(chalk.gray("    데이터셋/테이블 목록 및 스키마 조회"));
@@ -755,6 +986,29 @@ async function showTools() {
     console.log(chalk.cyan("  bq_status"));
     console.log(chalk.gray("    BigQuery 연결 상태 확인"));
     console.log("");
+    console.log(chalk.cyan("  bq_raw_sql"));
+    console.log(chalk.gray("    SQL 직접 실행 (SELECT/WITH만 허용)"));
+    console.log("");
+    console.log(chalk.cyan("  bq_event_params"));
+    console.log(chalk.gray("    event_params 쉽게 추출"));
+    console.log("");
+    console.log(chalk.cyan("  bq_user_journey"));
+    console.log(chalk.gray("    사용자별 이벤트 시퀀스 분석"));
+    console.log("");
+    console.log(chalk.cyan("  bq_funnel"));
+    console.log(chalk.gray("    전환 퍼널 자동 계산"));
+    console.log("");
+    console.log(chalk.white.bold("  Search Console Tools (3):"));
+    console.log("");
+    console.log(chalk.cyan("  gsc_query"));
+    console.log(chalk.gray("    검색어/페이지별 클릭, 노출, CTR, 순위 분석"));
+    console.log("");
+    console.log(chalk.cyan("  gsc_sites"));
+    console.log(chalk.gray("    접근 가능한 사이트 목록"));
+    console.log("");
+    console.log(chalk.cyan("  gsc_status"));
+    console.log(chalk.gray("    Search Console 연결 상태 확인"));
+    console.log("");
     await select({
         message: "",
         choices: [{ name: "← Back", value: "back" }],
@@ -796,6 +1050,21 @@ async function testConnections() {
     catch (error) {
         bqSpinner.fail(chalk.red(`BigQuery: ${error instanceof Error ? error.message : error}`));
     }
+    // Search Console 테스트
+    const gscSpinner = ora("Search Console 연결 테스트 중...").start();
+    try {
+        const client = new GSCClient();
+        const result = await client.testConnection();
+        if (result.success) {
+            gscSpinner.succeed(chalk.green(`Search Console: ${result.message}`));
+        }
+        else {
+            gscSpinner.fail(chalk.red(`Search Console: ${result.message}`));
+        }
+    }
+    catch (error) {
+        gscSpinner.fail(chalk.red(`Search Console: ${error instanceof Error ? error.message : error}`));
+    }
     console.log("");
     await select({
         message: "",