careerly-data-mcp 2.3.0 → 3.0.0

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.
package/README.md CHANGED
@@ -1,45 +1,39 @@
1
- # Careerly Data MCP Server
1
+ # Careerly Data MCP
2
2
 
3
- Claude Code에서 **자연어로 GA4, BigQuery, Search Console 데이터를 분석**하는 MCP(Model Context Protocol) 서버입니다.
3
+ > GA4, BigQuery, Search Console 데이터를 Claude Code에서 **자연어로** 분석
4
4
 
5
- ## 왜 MCP를 쓰나요? (vs API 직접 호출)
5
+ [![npm version](https://badge.fury.io/js/careerly-data-mcp.svg)](https://www.npmjs.com/package/careerly-data-mcp)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
+ [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/)
6
8
 
7
- ### 기존 방식의 문제점
9
+ ## 도구인가?
8
10
 
9
- ```
10
- GA4 데이터 보고 싶다 → GA4 API 문서 읽기 → 인증 설정 → 코드 작성 → 결과 해석
11
- BigQuery 분석하고 싶다 → SQL 작성 → UNNEST 문법 검색 → 쿼리 수정 → 결과 해석
12
- ```
11
+ 데이터 분석에 드는 시간을 획기적으로 줄여줍니다.
13
12
 
14
- ### MCP 방식
13
+ | 기존 방식 | Careerly Data MCP |
14
+ |----------|-------------------|
15
+ | GA4 UI에서 수동으로 리포트 탐색 | **자연어로 즉시 분석** |
16
+ | BigQuery SQL 직접 작성 필요 | **대화형 쿼리 자동 생성** |
17
+ | 3개 도구를 따로 열어서 확인 | **통합 분석 한 번에** |
18
+ | 데이터 → 인사이트 도출 20분 | **2분 내 인사이트 제공** |
15
19
 
16
- ```
17
- "지난 7일 세션수 보여줘" → 끝!
18
- "page_view → post_detail_view 전환율 분석해줘" → 끝!
19
- "검색어별 클릭수 보여줘" → 끝!
20
- ```
20
+ ### 핵심 가치
21
21
 
22
- ### 핵심 장점
23
-
24
- | 기존 API 직접 호출 | MCP 사용 |
25
- |------------------|---------|
26
- | API 문서 읽고 코드 작성 필요 | 자연어로 질문하면 끝 |
27
- | GA4 event_params 추출 = 복잡한 UNNEST SQL | `bq_event_params` 도구로 한 줄 |
28
- | 퍼널 분석 = 10줄 이상 SQL | `bq_funnel` 도구로 자동 계산 |
29
- | 결과는 숫자만 | **인사이트 + 다음 액션 제안**까지 |
22
+ - **자연어 쿼리**: "지난 7일 채널별 세션수 보여줘"처럼 말하면 됩니다
23
+ - **통합 분석**: GA4 + BigQuery + Search Console 데이터를 한 번에 조회
24
+ - **자동 인사이트**: 이상치 탐지, 가설 제안, 권장 조치까지 자동 생성
25
+ - **안전한 접근**: Service Account 기반 읽기 전용 접근
30
26
 
31
27
  ---
32
28
 
33
- ## 빠른 시작
29
+ ## Quick Start
34
30
 
35
31
  ```bash
36
- # 1. Service Account JSON 키 파일이 있는 폴더에서 실행
37
- cd /path/to/your/project
38
-
39
- # 2. 설정 실행 (키 파일 자동 탐지 + Claude Code 자동 등록)
32
+ # 1. 셋업 시작 (5분)
40
33
  npx careerly-data-mcp setup
41
34
 
42
- # 3. Claude Code 재시작 후 /mcp 확인!
35
+ # 2. Claude Code 재시작 후 바로 사용
36
+ "지난 7일 세션수 보여줘"
43
37
  ```
44
38
 
45
39
  ### 자동 설정 기능
@@ -47,104 +41,112 @@ npx careerly-data-mcp setup
47
41
  `setup` 명령어가 알아서 처리합니다:
48
42
 
49
43
  1. **Service Account 키 파일 자동 탐지** - 폴더에서 JSON 파일 스캔
50
- 2. **GA4 + BigQuery 연결 테스트** - Property ID와 키 파일 검증
44
+ 2. **GA4 + BigQuery + GSC 연결 테스트** - Property ID와 키 파일 검증
51
45
  3. **Claude Code MCP 자동 등록** - 재시작만 하면 바로 사용 가능
52
46
 
53
47
  ---
54
48
 
55
- ## 사전 준비 (관리자)
56
-
57
- ### 1. Google Cloud 설정
58
-
59
- 1. [Google Cloud Console](https://console.cloud.google.com/)에서 프로젝트 생성
60
- 2. **Google Analytics Data API** 활성화
61
- 3. **BigQuery API** 활성화
62
- 4. **Search Console API** 활성화
63
- 5. **서비스 계정** 생성 후 JSON 키 다운로드
64
-
65
- ### 2. GA4 권한 설정
66
-
67
- - GA4 Admin > 속성 설정 > 속성 액세스 관리
68
- - 서비스 계정 이메일 추가 (뷰어 권한)
69
-
70
- ### 3. BigQuery 권한 설정
71
-
72
- - IAM & Admin > 서비스 계정에 **BigQuery 데이터 뷰어** 역할 추가
49
+ ## 아키텍처
73
50
 
74
- ### 4. Search Console 권한 설정 (선택)
75
-
76
- - [Search Console](https://search.google.com/search-console) > 설정 > 사용자 및 권한
77
- - 서비스 계정 이메일 추가 (전체 권한 또는 제한된 권한)
51
+ ```
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
+ └─────────┘ └─────────┘ └─────────┘
79
+ ```
78
80
 
79
81
  ---
80
82
 
81
- ## 제공 도구 (Tools)
83
+ ## 기능 (15개 Tools)
82
84
 
83
- ### GA4 Data API 도구
85
+ ### GA4 Data API (3개)
84
86
 
85
- | Tool | 설명 | 언제 쓰나요? |
86
- |------|------|------------|
87
- | `ga4_query` | GA4 데이터 조회 + 인사이트 | 세션, 사용자, 전환 등 기본 지표 |
88
- | `ga4_metadata` | 지표/차원 목록 | 어떤 데이터를 있는지 확인 |
89
- | `ga4_status` | 연결 상태 확인 | 연결 문제 진단 |
87
+ | Tool | 설명 | 사용 예시 |
88
+ |------|------|----------|
89
+ | `ga4_query` | GA4 데이터 조회 + 인사이트 | "채널별 전환율 분석해줘" |
90
+ | `ga4_metadata` | 사용 가능한 지표/차원 목록 | "GA4에서 있는 지표 알려줘" |
91
+ | `ga4_status` | 연결 상태 확인 | "GA4 연결 상태 확인해줘" |
90
92
 
91
- ### BigQuery 기본 도구
93
+ ### BigQuery (8개)
92
94
 
93
- | Tool | 설명 | 언제 쓰나요? |
94
- |------|------|------------|
95
- | `bq_query` | BigQuery 테이블 조회 | 일반 테이블 데이터 조회 |
96
- | `bq_metadata` | 스키마/테이블 목록 | 데이터 구조 파악 |
97
- | `bq_status` | 연결 상태 확인 | 연결 문제 진단 |
98
- | `bq_ga4_events` | GA4 Export 이벤트 조회 | event_params 자동 추출 |
95
+ | Tool | 설명 | 사용 예시 |
96
+ |------|------|----------|
97
+ | `bq_query` | 파라미터 기반 쿼리 | "users 테이블에서 최근 가입자 조회" |
98
+ | `bq_ga4_events` | GA4 Export 이벤트 조회 | "purchase 이벤트 분석해줘" |
99
+ | `bq_raw_sql` | SQL 직접 실행 | "SELECT문 실행해줘" |
100
+ | `bq_metadata` | 데이터셋/테이블 정보 | "BigQuery 테이블 목록 보여줘" |
101
+ | `bq_event_params` | 이벤트 파라미터 추출 | "page_view 파라미터 분석해줘" |
102
+ | `bq_user_journey` | 사용자 여정 분석 | "사용자 행동 시퀀스 보여줘" |
103
+ | `bq_funnel` | 퍼널 분석 | "회원가입 퍼널 이탈률 분석해줘" |
104
+ | `bq_status` | 연결 상태 확인 | "BigQuery 연결 확인" |
99
105
 
100
- ### BigQuery 고급 도구 (v2.1.0)
106
+ ### Search Console (3개)
101
107
 
102
- | Tool | 설명 | 언제 쓰나요? |
103
- |------|------|------------|
104
- | `bq_raw_sql` | SQL 직접 실행 | 복잡한 JOIN, 윈도우 함수 |
105
- | `bq_event_params` | 이벤트 파라미터 추출 | page_location, page_title 쉽게 추출 |
106
- | `bq_user_journey` | 사용자 여정 분석 | 특정 사용자가 어떤 행동을 했는지 |
107
- | `bq_funnel` | 퍼널 분석 | 단계별 전환율 자동 계산 |
108
+ | Tool | 설명 | 사용 예시 |
109
+ |------|------|----------|
110
+ | `gsc_query` | 검색 분석 데이터 조회 | "검색어별 클릭수 상위 20개" |
111
+ | `gsc_sites` | 등록된 사이트 목록 | "접근 가능한 사이트 보여줘" |
112
+ | `gsc_status` | 연결 상태 확인 | "GSC 연결 상태" |
108
113
 
109
- ### Google Search Console 도구 (v2.2.0 신규)
114
+ ### 통합 분석 (1개) - NEW in v3.0!
110
115
 
111
- | Tool | 설명 | 언제 쓰나요? |
112
- |------|------|------------|
113
- | `gsc_query` | 검색 분석 데이터 조회 | 검색어/페이지별 클릭, 노출, CTR, 순위 |
114
- | `gsc_status` | 연결 상태 확인 | 연결 문제 진단 |
115
- | `gsc_sites` | 등록된 사이트 목록 | 접근 가능한 사이트 확인 |
116
+ | Tool | 설명 | 사용 예시 |
117
+ |------|------|----------|
118
+ | `unified_analysis` | GA4+BQ+GSC 통합 분석 | "이번 마케팅 성과 종합 분석해줘" |
116
119
 
117
120
  ---
118
121
 
119
122
  ## 사용 예시
120
123
 
121
- Claude Code에서 자연어로 질문하세요:
122
-
123
- ### 기본 질의
124
-
124
+ ### 트래픽 분석
125
125
  ```
126
- "지난 7일 세션수 보여줘"
127
- "채널별 전환수 알려줘"
128
- "어제 대비 오늘 트래픽 어때?"
129
- "랜딩 페이지별 이탈률 분석해줘"
126
+ "지난 7일 채널별 세션수와 전환율 비교해줘"
127
+ "이번 vs 지난 주 트래픽 변화 분석해줘"
128
+ "모바일 vs 데스크톱 사용자 비교해줘"
130
129
  ```
131
130
 
132
- ### 고급 질의 (v2.1.0)
133
-
131
+ ### SEO 분석
134
132
  ```
135
- "page_view 이벤트에서 page_location 파라미터 추출해줘"
136
- "사용자 ID 12345678의 행동 여정 보여줘"
137
- "page_view post_detail_view → post_create_start 퍼널 분석해줘"
138
- "디바이스별 전환율 비교해줘"
133
+ "검색어별 클릭수 상위 20개 보여줘"
134
+ "페이지별 평균 순위와 CTR 분석해줘"
135
+ "순위가 떨어진 페이지 찾아줘"
139
136
  ```
140
137
 
141
- ### Search Console 질의 (v2.2.0)
138
+ ### 전환 분석
139
+ ```
140
+ "회원가입 퍼널 단계별 이탈률 분석해줘"
141
+ "purchase 이벤트 상세 분석해줘"
142
+ "전환율이 가장 높은 채널 찾아줘"
143
+ ```
142
144
 
145
+ ### 통합 분석 (v3.0)
143
146
  ```
144
- "최근 28일 검색어별 클릭수 보여줘"
145
- "클릭률이 낮은 페이지 찾아줘"
146
- "모바일 vs 데스크톱 검색 성과 비교해줘"
147
- "순위가 높은데 CTR이 낮은 키워드 분석해줘"
147
+ "이번 마케팅 성과 종합 분석해줘"
148
+ "트래픽 하락 원인을 데이터 기반으로 분석해줘"
149
+ "SEO와 유입 트래픽 상관관계 분석해줘"
148
150
  ```
149
151
 
150
152
  ### 실제 결과 예시 (퍼널 분석)
@@ -154,9 +156,10 @@ Claude Code에서 자연어로 질문하세요:
154
156
  page_view → post_create_start 전환율: 2.3% | 1,215 → 28명
155
157
 
156
158
  ## 인사이트
157
- 1. 전체 전환율: 2.3% (1,215명 중 28명 완료)
158
- 2. 최대 이탈 구간: page_view → post_detail_view (89.8% 이탈)
159
- 3. post_detail_view post_create_start: 22.8% 전환 (개선 필요)
159
+ 🔴 [HYPOTHESIS] "post_detail_view" 단계 병목 현상
160
+ page_view에서 post_detail_view로 진행 89.8%가 이탈합니다.
161
+ 📊 근거: page_view: 1,215명, post_detail_view: 123명, 이탈률: 89.8%
162
+ 💡 권장: 해당 단계의 폼 필드, 오류 메시지, 로딩 상태를 점검하세요.
160
163
 
161
164
  ## 퍼널 시각화
162
165
  1. page_view ██████████████████████████████ 1,215명 (100%)
@@ -166,48 +169,103 @@ page_view → post_create_start 전환율: 2.3% | 1,215 → 28명
166
169
 
167
170
  ---
168
171
 
169
- ## v2.2.0 주요 업데이트 (최신)
172
+ ## v3.0.0 주요 업데이트
170
173
 
171
- ### Google Search Console 통합
174
+ ### Enhanced Insight Engine
172
175
 
173
- - **3개 도구 추가**: `gsc_query`, `gsc_status`, `gsc_sites`
174
- - 검색어/페이지별 클릭수, 노출수, CTR, 평균 순위 분석
175
- - 국가별, 디바이스별 필터링 지원
176
- - 16개월 이전 데이터까지 조회 가능
176
+ - **자동 이상치 탐지**: Z-Score 기반 통계적 이상치 탐지
177
+ - **가설 자동 생성**: 데이터 패턴 기반 가설 제안
178
+ - **신뢰도 표시**: High/Medium/Low로 인사이트 신뢰도 표시
179
+ - **권장 조치**: 인사이트에 대한 구체적인 다음 액션 제안
177
180
 
178
- ### 환경변수
181
+ ### Unified Analysis 도구
179
182
 
180
- | 변수 | 설명 |
181
- |------|------|
182
- | `GSC_SITE_URL` | 기본 사이트 URL (예: `https://example.com/` 또는 `sc-domain:example.com`) |
183
+ - **통합 분석**: GA4 + BigQuery + GSC 데이터를 한 번에 조회
184
+ - **교차 소스 인사이트**: 여러 데이터 소스 간 상관관계 분석
185
+ - **분석 유형**: performance, seo, conversion, traffic, comprehensive
183
186
 
184
- ### GSC 권한 설정
187
+ ### Setup UI 개선
185
188
 
186
- 1. Search Console > 설정 > 사용자 및 권한
187
- 2. Service Account 이메일 추가 (전체 권한 또는 제한된 권한)
189
+ - **ASCII 아트 배너**: 세련된 CLI 경험
190
+ - **상태 표시 개선**: 색상 코딩된 연결 상태
191
+ - **진행률 표시**: 단계별 설정 진행 상황
188
192
 
189
193
  ---
190
194
 
191
- ## v2.1.0 주요 업데이트
195
+ ## 사전 준비
196
+
197
+ ### 1. Google Cloud Service Account
198
+ - [Google Cloud Console](https://console.cloud.google.com/)에서 Service Account 생성
199
+ - JSON 키 파일 다운로드
192
200
 
193
- ### 버그 수정
201
+ ### 2. API 활성화
202
+ - [GA4 Data API](https://console.cloud.google.com/apis/library/analyticsdata.googleapis.com) 활성화
203
+ - [BigQuery API](https://console.cloud.google.com/apis/library/bigquery.googleapis.com) 활성화
204
+ - [Search Console API](https://console.cloud.google.com/apis/library/searchconsole.googleapis.com) 활성화
194
205
 
195
- - `bq_ga4_events` GROUP BY 오류 해결
196
- - 이제 metrics 있을 때/없을 때 모두 정상 동작
206
+ ### 3. 권한 설정
197
207
 
198
- ### 새 기능
208
+ **GA4:**
209
+ - GA4 속성 > 관리 > 속성 액세스 관리 > Service Account 이메일 추가 (뷰어)
199
210
 
200
- - **복합 필터 지원**: `filterLogic: "AND" | "OR"` 옵션 추가
201
- - **Raw SQL 실행**: 복잡한 쿼리도 직접 작성 가능 (SELECT만 허용)
211
+ **BigQuery:**
212
+ - IAM에서 Service Account에 `BigQuery Data Viewer` 역할 부여
202
213
 
203
- ### 새 도구 4개 추가
214
+ **Search Console:**
215
+ - [Search Console](https://search.google.com/search-console) > 설정 > 사용자 및 권한 > Service Account 이메일 추가 (전체)
204
216
 
205
- | 도구 | 하는 일 |
206
- |------|--------|
207
- | `bq_raw_sql` | SQL 직접 실행 (UNNEST, JOIN 등) |
208
- | `bq_event_params` | event_params 쉽게 추출 |
209
- | `bq_user_journey` | 사용자별 이벤트 시퀀스 분석 |
210
- | `bq_funnel` | 전환 퍼널 자동 계산 |
217
+ ### 4. Claude Code
218
+ - [Claude Code](https://claude.ai/claude-code) CLI 설치 필요
219
+
220
+ ---
221
+
222
+ ## 수동 설정
223
+
224
+ ### Claude CLI로 추가
225
+
226
+ ```bash
227
+ claude mcp add careerly-data \
228
+ -s user \
229
+ -e GA4_PROPERTY_ID=123456789 \
230
+ -e BQ_PROJECT_ID=your-project-id \
231
+ -e GSC_SITE_URL=https://example.com/ \
232
+ -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json \
233
+ -- npx -y careerly-data-mcp serve
234
+ ```
235
+
236
+ ### 설정 파일 직접 수정
237
+
238
+ `~/.claude/settings.json`:
239
+
240
+ ```json
241
+ {
242
+ "mcpServers": {
243
+ "careerly-data": {
244
+ "command": "npx",
245
+ "args": ["-y", "careerly-data-mcp", "serve"],
246
+ "env": {
247
+ "GA4_PROPERTY_ID": "123456789",
248
+ "BQ_PROJECT_ID": "your-project-id",
249
+ "BQ_LOCATION": "US",
250
+ "GSC_SITE_URL": "https://example.com/",
251
+ "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/key.json"
252
+ }
253
+ }
254
+ }
255
+ }
256
+ ```
257
+
258
+ ---
259
+
260
+ ## 환경 변수
261
+
262
+ | 변수 | 필수 | 설명 |
263
+ |------|------|------|
264
+ | `GA4_PROPERTY_ID` | GA4 사용시 | GA4 속성 ID (숫자) |
265
+ | `BQ_PROJECT_ID` | BigQuery 사용시 | GCP 프로젝트 ID |
266
+ | `BQ_LOCATION` | 선택 | BigQuery 위치 (기본: US) |
267
+ | `GSC_SITE_URL` | GSC 사용시 | 사이트 URL |
268
+ | `GOOGLE_APPLICATION_CREDENTIALS` | 필수 | Service Account 키 파일 경로 |
211
269
 
212
270
  ---
213
271
 
@@ -236,75 +294,63 @@ npx careerly-data-mcp serve
236
294
 
237
295
  ## 문제 해결
238
296
 
239
- ### MCP 서버가 `/mcp`에 안 보여요
297
+ ### "GA4 연결 실패"
298
+ - GA4 Property ID가 숫자인지 확인 (analytics.google.com에서 확인)
299
+ - Service Account에 GA4 접근 권한이 있는지 확인
300
+ - GA4 Data API가 활성화되어 있는지 확인
240
301
 
241
- 1. Claude Code 완전 종료 후 재시작
242
- 2. `claude mcp list`로 등록 확인
243
- 3. `npx careerly-data-mcp setup` 재실행
302
+ ### "BigQuery 권한 오류"
303
+ - Service Account에 `BigQuery Data Viewer` 역할 필요
304
+ - BigQuery API가 활성화되어 있는지 확인
244
305
 
245
- ### PERMISSION_DENIED 에러
306
+ ### "GSC 사이트 없음"
307
+ - Service Account 이메일이 Search Console에 추가되어 있는지 확인
308
+ - 사이트 URL 형식 확인 (https:// 또는 sc-domain:)
246
309
 
247
- **GA4 권한 문제:**
248
- - GA4 Admin > 속성 액세스 관리 > Service Account 이메일 추가
310
+ ### "claude mcp add 실패"
311
+ - Claude Code CLI가 설치되어 있는지 확인
312
+ - `~/.claude/settings.json`에 수동 추가
249
313
 
250
- **BigQuery 권한 문제:**
251
- - IAM & Admin > Service Account에 "BigQuery 데이터 뷰어" 역할 추가
252
-
253
- ### MCP 제거
314
+ ### MCP 서버가 `/mcp`에 안 보여요
315
+ 1. Claude Code 완전 종료 재시작
316
+ 2. `claude mcp list`로 등록 확인
317
+ 3. `npx careerly-data-mcp setup` 재실행
254
318
 
319
+ ### 일반적인 문제
255
320
  ```bash
256
- # CLI로 삭제
257
- claude mcp remove careerly-ga4 -s user
258
-
259
- # 또는 메뉴에서
260
- npx careerly-data-mcp
261
- # → Disable 선택
321
+ # 연결 테스트
322
+ npx careerly-data-mcp setup
323
+ # "Test connections" 선택
262
324
  ```
263
325
 
264
326
  ---
265
327
 
266
- ## 수동 설정 (선택)
328
+ ## 보안
267
329
 
268
- ### Claude CLI로 추가
269
-
270
- ```bash
271
- claude mcp add careerly-ga4 \
272
- -s user \
273
- -e GA4_PROPERTY_ID=123456789 \
274
- -e BQ_PROJECT_ID=your-project-id \
275
- -e GSC_SITE_URL=https://example.com/ \
276
- -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json \
277
- -- npx -y careerly-data-mcp serve
278
- ```
330
+ - **읽기 전용**: 모든 API 호출은 읽기 전용
331
+ - **Service Account**: 개인 계정 대신 Service Account 사용
332
+ - **SQL 안전성**: INSERT/UPDATE/DELETE 등 위험 쿼리 자동 차단
333
+ - **환경 변수**: 민감 정보는 환경 변수로 관리
279
334
 
280
- ### 설정 파일 직접 수정
335
+ ---
281
336
 
282
- `~/.claude/settings.local.json`:
337
+ ## 버전 히스토리
283
338
 
284
- ```json
285
- {
286
- "mcpServers": {
287
- "careerly-ga4": {
288
- "command": "npx",
289
- "args": ["-y", "careerly-data-mcp", "serve"],
290
- "env": {
291
- "GA4_PROPERTY_ID": "123456789",
292
- "BQ_PROJECT_ID": "your-project-id",
293
- "GSC_SITE_URL": "https://example.com/",
294
- "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/key.json"
295
- }
296
- }
297
- }
298
- }
299
- ```
339
+ ### v3.0.0 (Current)
340
+ - Enhanced Insight Engine 추가
341
+ - Unified Analysis 도구 추가
342
+ - 셋업 UI 개선 (ASCII 아트 배너)
343
+ - 자동 이상치 탐지 / 가설 생성
300
344
 
301
- ---
345
+ ### v2.3.0
346
+ - Search Console "Login Required" 버그 수정
347
+ - google-auth-library 버전 고정
302
348
 
303
- ## 보안 원칙
349
+ ### v2.2.0
350
+ - Google Search Console 통합 (gsc_query, gsc_sites, gsc_status)
304
351
 
305
- - `bq_raw_sql`은 **SELECT/WITH 문만 허용** (INSERT, DELETE 등 차단)
306
- - Service Account 파일은 **개인 로컬에서만 관리**
307
- - 민감 데이터 접근 시 권한 최소화 원칙 적용
352
+ ### v2.1.0
353
+ - BigQuery 고급 도구 추가 (bq_raw_sql, bq_event_params, bq_user_journey, bq_funnel)
308
354
 
309
355
  ---
310
356
 
@@ -315,10 +361,11 @@ npm install # 의존성 설치
315
361
  npm run build # 빌드
316
362
  npm run dev # 개발 모드 (watch)
317
363
  npm run typecheck # 타입 체크
364
+ npm run test # 테스트 실행
318
365
  ```
319
366
 
320
367
  ---
321
368
 
322
369
  ## 라이선스
323
370
 
324
- MIT
371
+ MIT License - 자유롭게 사용하세요.
@@ -1 +1 @@
1
- {"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,CA4ID;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4JxD"}
1
+ {"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgSH;;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,CAsK9C;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,CA4ID;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4JxD"}