careerly-data-mcp 2.2.7 → 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 +227 -180
- package/dist/cli/setup.d.ts.map +1 -1
- package/dist/cli/setup.js +51 -71
- package/dist/cli/setup.js.map +1 -1
- package/dist/cli/ui.d.ts +113 -0
- package/dist/cli/ui.d.ts.map +1 -0
- package/dist/cli/ui.js +271 -0
- package/dist/cli/ui.js.map +1 -0
- package/dist/gsc/client.d.ts.map +1 -1
- package/dist/gsc/client.js +1 -6
- package/dist/gsc/client.js.map +1 -1
- package/dist/insight/anomaly.d.ts +29 -0
- package/dist/insight/anomaly.d.ts.map +1 -0
- package/dist/insight/anomaly.js +167 -0
- package/dist/insight/anomaly.js.map +1 -0
- package/dist/insight/hypothesis.d.ts +41 -0
- package/dist/insight/hypothesis.d.ts.map +1 -0
- package/dist/insight/hypothesis.js +198 -0
- package/dist/insight/hypothesis.js.map +1 -0
- package/dist/insight/index.d.ts +9 -0
- package/dist/insight/index.d.ts.map +1 -0
- package/dist/insight/index.js +13 -0
- package/dist/insight/index.js.map +1 -0
- package/dist/insight/renderer.d.ts +45 -1
- package/dist/insight/renderer.d.ts.map +1 -1
- package/dist/insight/renderer.js +243 -1
- package/dist/insight/renderer.js.map +1 -1
- package/dist/insight/types.d.ts +80 -0
- package/dist/insight/types.d.ts.map +1 -0
- package/dist/insight/types.js +5 -0
- package/dist/insight/types.js.map +1 -0
- package/dist/mcp/server.d.ts +1 -0
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +6 -1
- package/dist/mcp/server.js.map +1 -1
- package/dist/tools/unified-analysis.d.ts +10 -0
- package/dist/tools/unified-analysis.d.ts.map +1 -0
- package/dist/tools/unified-analysis.js +344 -0
- package/dist/tools/unified-analysis.js.map +1 -0
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -1,45 +1,39 @@
|
|
|
1
|
-
# Careerly Data MCP
|
|
1
|
+
# Careerly Data MCP
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> GA4, BigQuery, Search Console 데이터를 Claude Code에서 **자연어로** 분석
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
[](https://www.npmjs.com/package/careerly-data-mcp)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
7
|
+
[](https://nodejs.org/)
|
|
6
8
|
|
|
7
|
-
|
|
9
|
+
## 왜 이 도구인가?
|
|
8
10
|
|
|
9
|
-
|
|
10
|
-
GA4 데이터 보고 싶다 → GA4 API 문서 읽기 → 인증 설정 → 코드 작성 → 결과 해석
|
|
11
|
-
BigQuery 분석하고 싶다 → SQL 작성 → UNNEST 문법 검색 → 쿼리 수정 → 결과 해석
|
|
12
|
-
```
|
|
11
|
+
데이터 분석에 드는 시간을 획기적으로 줄여줍니다.
|
|
13
12
|
|
|
14
|
-
|
|
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
|
-
|
|
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.
|
|
37
|
-
cd /path/to/your/project
|
|
38
|
-
|
|
39
|
-
# 2. 설정 실행 (키 파일 자동 탐지 + Claude Code 자동 등록)
|
|
32
|
+
# 1. 셋업 시작 (5분)
|
|
40
33
|
npx careerly-data-mcp setup
|
|
41
34
|
|
|
42
|
-
#
|
|
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
|
-
|
|
75
|
-
|
|
76
|
-
|
|
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
|
-
##
|
|
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` |
|
|
96
|
-
| `
|
|
97
|
-
| `
|
|
98
|
-
| `
|
|
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
|
-
###
|
|
106
|
+
### Search Console (3개)
|
|
101
107
|
|
|
102
|
-
| Tool | 설명 |
|
|
103
|
-
|
|
104
|
-
| `
|
|
105
|
-
| `
|
|
106
|
-
| `
|
|
107
|
-
| `bq_funnel` | 퍼널 분석 | 단계별 전환율 자동 계산 |
|
|
108
|
+
| Tool | 설명 | 사용 예시 |
|
|
109
|
+
|------|------|----------|
|
|
110
|
+
| `gsc_query` | 검색 분석 데이터 조회 | "검색어별 클릭수 상위 20개" |
|
|
111
|
+
| `gsc_sites` | 등록된 사이트 목록 | "접근 가능한 사이트 보여줘" |
|
|
112
|
+
| `gsc_status` | 연결 상태 확인 | "GSC 연결 상태" |
|
|
108
113
|
|
|
109
|
-
###
|
|
114
|
+
### 통합 분석 (1개) - NEW in v3.0!
|
|
110
115
|
|
|
111
|
-
| Tool | 설명 |
|
|
112
|
-
|
|
113
|
-
| `
|
|
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
|
-
|
|
122
|
-
|
|
123
|
-
### 기본 질의
|
|
124
|
-
|
|
124
|
+
### 트래픽 분석
|
|
125
125
|
```
|
|
126
|
-
"지난 7일
|
|
127
|
-
"
|
|
128
|
-
"
|
|
129
|
-
"랜딩 페이지별 이탈률 분석해줘"
|
|
126
|
+
"지난 7일 채널별 세션수와 전환율 비교해줘"
|
|
127
|
+
"이번 주 vs 지난 주 트래픽 변화 분석해줘"
|
|
128
|
+
"모바일 vs 데스크톱 사용자 비교해줘"
|
|
130
129
|
```
|
|
131
130
|
|
|
132
|
-
###
|
|
133
|
-
|
|
131
|
+
### SEO 분석
|
|
134
132
|
```
|
|
135
|
-
"
|
|
136
|
-
"
|
|
137
|
-
"
|
|
138
|
-
"디바이스별 전환율 비교해줘"
|
|
133
|
+
"검색어별 클릭수 상위 20개 보여줘"
|
|
134
|
+
"페이지별 평균 순위와 CTR 분석해줘"
|
|
135
|
+
"순위가 떨어진 페이지 찾아줘"
|
|
139
136
|
```
|
|
140
137
|
|
|
141
|
-
###
|
|
138
|
+
### 전환 분석
|
|
139
|
+
```
|
|
140
|
+
"회원가입 퍼널 단계별 이탈률 분석해줘"
|
|
141
|
+
"purchase 이벤트 상세 분석해줘"
|
|
142
|
+
"전환율이 가장 높은 채널 찾아줘"
|
|
143
|
+
```
|
|
142
144
|
|
|
145
|
+
### 통합 분석 (v3.0)
|
|
143
146
|
```
|
|
144
|
-
"
|
|
145
|
-
"
|
|
146
|
-
"
|
|
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
|
-
|
|
158
|
-
|
|
159
|
-
|
|
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
|
-
##
|
|
172
|
+
## v3.0.0 주요 업데이트
|
|
170
173
|
|
|
171
|
-
###
|
|
174
|
+
### Enhanced Insight Engine
|
|
172
175
|
|
|
173
|
-
-
|
|
174
|
-
-
|
|
175
|
-
-
|
|
176
|
-
-
|
|
176
|
+
- **자동 이상치 탐지**: Z-Score 기반 통계적 이상치 탐지
|
|
177
|
+
- **가설 자동 생성**: 데이터 패턴 기반 가설 제안
|
|
178
|
+
- **신뢰도 표시**: High/Medium/Low로 인사이트 신뢰도 표시
|
|
179
|
+
- **권장 조치**: 각 인사이트에 대한 구체적인 다음 액션 제안
|
|
177
180
|
|
|
178
|
-
###
|
|
181
|
+
### Unified Analysis 도구
|
|
179
182
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
+
- **통합 분석**: GA4 + BigQuery + GSC 데이터를 한 번에 조회
|
|
184
|
+
- **교차 소스 인사이트**: 여러 데이터 소스 간 상관관계 분석
|
|
185
|
+
- **분석 유형**: performance, seo, conversion, traffic, comprehensive
|
|
183
186
|
|
|
184
|
-
###
|
|
187
|
+
### Setup UI 개선
|
|
185
188
|
|
|
186
|
-
|
|
187
|
-
|
|
189
|
+
- **ASCII 아트 배너**: 세련된 CLI 경험
|
|
190
|
+
- **상태 표시 개선**: 색상 코딩된 연결 상태
|
|
191
|
+
- **진행률 표시**: 단계별 설정 진행 상황
|
|
188
192
|
|
|
189
193
|
---
|
|
190
194
|
|
|
191
|
-
##
|
|
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
|
-
|
|
196
|
-
- 이제 metrics 있을 때/없을 때 모두 정상 동작
|
|
206
|
+
### 3. 권한 설정
|
|
197
207
|
|
|
198
|
-
|
|
208
|
+
**GA4:**
|
|
209
|
+
- GA4 속성 > 관리 > 속성 액세스 관리 > Service Account 이메일 추가 (뷰어)
|
|
199
210
|
|
|
200
|
-
|
|
201
|
-
-
|
|
211
|
+
**BigQuery:**
|
|
212
|
+
- IAM에서 Service Account에 `BigQuery Data Viewer` 역할 부여
|
|
202
213
|
|
|
203
|
-
|
|
214
|
+
**Search Console:**
|
|
215
|
+
- [Search Console](https://search.google.com/search-console) > 설정 > 사용자 및 권한 > Service Account 이메일 추가 (전체)
|
|
204
216
|
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
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
|
-
###
|
|
297
|
+
### "GA4 연결 실패"
|
|
298
|
+
- GA4 Property ID가 숫자인지 확인 (analytics.google.com에서 확인)
|
|
299
|
+
- Service Account에 GA4 접근 권한이 있는지 확인
|
|
300
|
+
- GA4 Data API가 활성화되어 있는지 확인
|
|
240
301
|
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
302
|
+
### "BigQuery 권한 오류"
|
|
303
|
+
- Service Account에 `BigQuery Data Viewer` 역할 필요
|
|
304
|
+
- BigQuery API가 활성화되어 있는지 확인
|
|
244
305
|
|
|
245
|
-
###
|
|
306
|
+
### "GSC 사이트 없음"
|
|
307
|
+
- Service Account 이메일이 Search Console에 추가되어 있는지 확인
|
|
308
|
+
- 사이트 URL 형식 확인 (https:// 또는 sc-domain:)
|
|
246
309
|
|
|
247
|
-
|
|
248
|
-
-
|
|
310
|
+
### "claude mcp add 실패"
|
|
311
|
+
- Claude Code CLI가 설치되어 있는지 확인
|
|
312
|
+
- `~/.claude/settings.json`에 수동 추가
|
|
249
313
|
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
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
|
-
#
|
|
257
|
-
|
|
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
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
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
|
-
|
|
337
|
+
## 버전 히스토리
|
|
283
338
|
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
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
|
-
|
|
306
|
-
-
|
|
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 - 자유롭게 사용하세요.
|
package/dist/cli/setup.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;
|
|
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"}
|