careerly-data-mcp 3.1.0 → 3.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +79 -53
  2. package/dist/cli/setup.js +3 -3
  3. package/dist/cli/ui.js +1 -1
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -30,10 +30,11 @@
30
30
 
31
31
  ```bash
32
32
  # 1. 셋업 시작 (5분)
33
- npx careerly-data-mcp setup
33
+ npx careerly-data-mcp@latest setup
34
34
 
35
35
  # 2. Claude Code 재시작 후 바로 사용
36
- "지난 7일 세션수 보여줘"
36
+ "SEO와 트래픽 상관관계 분석해줘"
37
+ "앱 웹뷰 사용자 분석해줘"
37
38
  ```
38
39
 
39
40
  ### 자동 설정 기능
@@ -49,38 +50,50 @@ npx careerly-data-mcp setup
49
50
  ## 아키텍처
50
51
 
51
52
  ```
52
- ┌──────────────────────────────────────────────────────────────┐
53
- │ Claude Code │
54
- │ "이번 달 마케팅 성과 분석해줘" │
55
- └──────────────────────┬───────────────────────────────────────┘
56
- │ MCP Protocol
57
- ▼
58
- ┌──────────────────────────────────────────────────────────────┐
59
- │ Careerly Data MCP Server (v3.0) │
60
- │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
61
- │ │ GA4 Tools │ │ BQ Tools │ │ GSC Tools │ │
62
- │ │ (3 tools) │ │ (8 tools) │ │ (3 tools) │ │
63
- │ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
64
- │ │ │ │ │
65
- │ └───────────────┼───────────────┘ │
66
- │ ▼ │
67
- │ ┌─────────────────────┐ │
68
- │ │ Unified Analysis │ ← NEW in v3.0! │
69
- │ │ 통합 분석 도구 │ │
70
- │ └─────────────────────┘ │
71
- └─────────────────────────────────────────────────────────────┘
72
- │
73
- ┌────────────┼────────────┐
74
- ▼ ▼ ▼
75
- ┌─────────┐ ┌─────────┐ ┌─────────┐
76
- │ GA4 API │ │BigQuery │ │ GSC │
77
- │ │ │ │ │ API │
78
- └─────────┘ └─────────┘ └─────────┘
53
+ ┌─────────────────────────────────────────────────────────────────┐
54
+ │ Claude Code │
55
+ │ "SEO와 트래픽 상관관계 분석해줘" │
56
+ │ Tool Description 기반 자동 선택 │
57
+ └────────────────────────────┬────────────────────────────────────┘
58
+ │ MCP Protocol
59
+ ▼
60
+ ┌─────────────────────────────────────────────────────────────────┐
61
+ │ Careerly Data MCP Server (v3.1) │
62
+ │ │
63
+ │ ┌────────────────────────────────────────────────────────────┐ │
64
+ │ │ 🎯 Orchestration Layer (v3.1) │ │
65
+ │ │ ┌──────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ │
66
+ │ │ │ smart_query │ │platform_analysis│ │unified_analysis │ │ │
67
+ │ │ │ 자연어 분석 │ │ 웹+앱 웹뷰 │ │ 통합 분석 │ │ │
68
+ │ │ └──────┬───────┘ └────────┬────────┘ └────────┬────────┘ │ │
69
+ │ └─────────┼──────────────────┼───────────────────┼───────────┘ │
70
+ │ │ │ │ │
71
+ │ ┌─────────┴──────────────────┴───────────────────┴───────────┐ │
72
+ │ │ 📊 Data Sources (14 tools) │ │
73
+ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
74
+ │ │ │ GA4 Tools │ │ BQ Tools │ │ GSC Tools │ │ │
75
+ │ │ │ (3 tools) │ │ (8 tools) │ │ (3 tools) │ │ │
76
+ │ │ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ │
77
+ │ └─────────┼────────────────┼────────────────┼────────────────┘ │
78
+ │ │ │ │ │
79
+ │ ┌─────────┴────────────────┴────────────────┴────────────────┐ │
80
+ │ │ 💡 Insight Engine │ │
81
+ │ │ 이상치 탐지 | 가설 생성 | 교차 분석 │ │
82
+ │ └────────────────────────────────────────────────────────────┘ │
83
+ └─────────────────────────────────────────────────────────────────┘
79
84
  ```
80
85
 
81
86
  ---
82
87
 
83
- ## 기능 (15개 Tools)
88
+ ## 기능 (17개 Tools)
89
+
90
+ ### 🎯 Orchestration Layer (3개) - NEW in v3.1!
91
+
92
+ | Tool | 설명 | 사용 예시 |
93
+ |------|------|----------|
94
+ | `smart_query` | 자연어 → 자동 소스 선택 → 교차 인사이트 | "SEO와 트래픽 상관관계 분석해줘" |
95
+ | `platform_analysis` | 웹 브라우저 vs 앱 웹뷰 분석 | "앱 웹뷰 사용자 분석해줘" |
96
+ | `unified_analysis` | 사전정의 통합 분석 (5가지 유형) | "comprehensive 분석해줘" |
84
97
 
85
98
  ### GA4 Data API (3개)
86
99
 
@@ -111,12 +124,6 @@ npx careerly-data-mcp setup
111
124
  | `gsc_sites` | 등록된 사이트 목록 | "접근 가능한 사이트 보여줘" |
112
125
  | `gsc_status` | 연결 상태 확인 | "GSC 연결 상태" |
113
126
 
114
- ### 통합 분석 (1개) - NEW in v3.0!
115
-
116
- | Tool | 설명 | 사용 예시 |
117
- |------|------|----------|
118
- | `unified_analysis` | GA4+BQ+GSC 통합 분석 | "이번 달 마케팅 성과 종합 분석해줘" |
119
-
120
127
  ---
121
128
 
122
129
  ## 사용 예시
@@ -142,11 +149,25 @@ npx careerly-data-mcp setup
142
149
  "전환율이 가장 높은 채널 찾아줘"
143
150
  ```
144
151
 
145
- ### 통합 분석 (v3.0)
152
+ ### 🎯 스마트 쿼리 (v3.1) - 자연어로 통합 분석
153
+ ```
154
+ "SEO와 트래픽 상관관계 분석해줘"
155
+ "지난 30일 채널별 전환율 보여줘"
156
+ "검색 순위와 세션 관계 분석해줘"
157
+ ```
158
+
159
+ ### 📱 플랫폼 분석 (v3.1) - 웹+앱 웹뷰
160
+ ```
161
+ "앱 웹뷰 트래픽 분석해줘"
162
+ "iOS와 Android 사용자 비교해줘"
163
+ "플랫폼별 참여도 분석해줘"
164
+ ```
165
+
166
+ ### 통합 분석
146
167
  ```
147
168
  "이번 달 마케팅 성과 종합 분석해줘"
148
169
  "트래픽 하락 원인을 데이터 기반으로 분석해줘"
149
- "SEO와 유입 트래픽 상관관계 분석해줘"
170
+ "comprehensive 분석해줘"
150
171
  ```
151
172
 
152
173
  ### 실제 결과 예시 (퍼널 분석)
@@ -169,26 +190,25 @@ page_view → post_create_start 전환율: 2.3% | 1,215 → 28명
169
190
 
170
191
  ---
171
192
 
172
- ## v3.0.0 주요 업데이트
193
+ ## v3.1.0 주요 업데이트
173
194
 
174
- ### Enhanced Insight Engine
195
+ ### 🎯 Smart Query Orchestrator
175
196
 
176
- - **자동 이상치 탐지**: Z-Score 기반 통계적 이상치 탐지
177
- - **가설 자동 생성**: 데이터 패턴 기반 가설 제안
178
- - **신뢰도 표시**: High/Medium/Low로 인사이트 신뢰도 표시
179
- - **권장 조치**: 각 인사이트에 대한 구체적인 다음 액션 제안
197
+ - **자연어 분석**: "SEO와 트래픽 상관관계 분석해줘"처럼 질문
198
+ - **의도 자동 감지**: SEO, 트래픽, 전환, 참여도, 플랫폼 등 9가지 의도
199
+ - **소스 자동 선택**: 질문에 맞는 GA4/BigQuery/GSC 자동 조합
200
+ - **교차 인사이트**: 여러 소스 데이터를 통합 분석
180
201
 
181
- ### Unified Analysis 도구
202
+ ### 📱 Platform Analysis
182
203
 
183
- - **통합 분석**: GA4 + BigQuery + GSC 데이터를 한 번에 조회
184
- - **교차 소스 인사이트**: 여러 데이터 소스 간 상관관계 분석
185
- - **분석 유형**: performance, seo, conversion, traffic, comprehensive
204
+ - **웹뷰 트래픽 감지**: 모바일 (direct)/(none) 패턴으로 앱 웹뷰 구분
205
+ - **iOS vs Android 비교**: 플랫폼별 사용자 행동 분석
206
+ - **참여도 비교**: 웹 브라우저 vs 앱 웹뷰 참여도 비교
186
207
 
187
- ### Setup UI 개선
208
+ ### Tool Description 강화
188
209
 
189
- - **ASCII 아트 배너**: 세련된 CLI 경험
190
- - **상태 표시 개선**: 색상 코딩된 연결 상태
191
- - **진행률 표시**: 단계별 설정 진행 상황
210
+ - **자동 도구 선택**: Claude가 상황에 맞는 도구를 자동 선택하도록 가이드
211
+ - **도구 간 연계**: 관련 도구 추천으로 더 나은 분석 유도
192
212
 
193
213
  ---
194
214
 
@@ -336,7 +356,13 @@ npx careerly-data-mcp setup
336
356
 
337
357
  ## 버전 히스토리
338
358
 
339
- ### v3.0.0 (Current)
359
+ ### v3.1.0 (Current)
360
+ - **Smart Query Orchestrator** - 자연어 → 자동 소스 선택 → 교차 인사이트
361
+ - **Platform Analysis** - 웹+앱 웹뷰 트래픽 구분 분석
362
+ - **Tool Description 강화** - Claude 자동 도구 선택 개선
363
+ - 총 17개 도구 지원
364
+
365
+ ### v3.0.0
340
366
  - Enhanced Insight Engine 추가
341
367
  - Unified Analysis 도구 추가
342
368
  - 셋업 UI 개선 (ASCII 아트 배너)
package/dist/cli/setup.js CHANGED
@@ -499,7 +499,7 @@ export async function runSetup() {
499
499
  ga4: ga4Config.connected,
500
500
  bigquery: bqConfig.connected,
501
501
  gsc: gscConfig.connected,
502
- tools: 15,
502
+ tools: 17,
503
503
  });
504
504
  printStatusInfo({
505
505
  ga4PropertyId: ga4Config.propertyId,
@@ -509,7 +509,7 @@ export async function runSetup() {
509
509
  ga4Connected: ga4Config.connected,
510
510
  bqConnected: bqConfig.connected,
511
511
  gscConnected: gscConfig.connected,
512
- tools: 15,
512
+ tools: 17,
513
513
  });
514
514
  printExamples();
515
515
  }
@@ -717,7 +717,7 @@ export async function runInteractiveMenu() {
717
717
  }
718
718
  printStatusInfo({
719
719
  ...currentConfig,
720
- tools: 15,
720
+ tools: 17,
721
721
  });
722
722
  const isConfigured = currentConfig.ga4Connected || currentConfig.bqConnected || currentConfig.gscConnected;
723
723
  // 메뉴 선택
package/dist/cli/ui.js CHANGED
@@ -3,7 +3,7 @@
3
3
  * Premium CLI 경험을 위한 UI 모듈
4
4
  */
5
5
  import chalk from "chalk";
6
- const VERSION = "3.0.0";
6
+ const VERSION = "3.1.0";
7
7
  /**
8
8
  * ASCII 아트 배너
9
9
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "careerly-data-mcp",
3
- "version": "3.1.0",
3
+ "version": "3.1.2",
4
4
  "description": "GA4 + BigQuery + Search Console 데이터 분석 MCP 서버 for Claude Code",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",