nworks 0.3.0 → 0.3.1

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 (2) hide show
  1. package/README.md +41 -3
  2. package/package.json +3 -2
package/README.md CHANGED
@@ -25,8 +25,8 @@ nworks login \
25
25
  --private-key <PATH_TO_KEY> \
26
26
  --bot-id <BOT_ID>
27
27
 
28
- # User OAuth 로그인 (캘린더 등 사용자 API용)
29
- nworks login --user --scope calendar.read
28
+ # User OAuth 로그인 (캘린더, 드라이브 등 사용자 API용)
29
+ nworks login --user --scope calendar.read,file
30
30
 
31
31
  # 인증 확인
32
32
  nworks whoami
@@ -39,6 +39,12 @@ nworks directory members
39
39
 
40
40
  # 오늘 일정 조회
41
41
  nworks calendar list
42
+
43
+ # 드라이브 파일 목록
44
+ nworks drive list
45
+
46
+ # 파일 업로드
47
+ nworks drive upload --file ./report.pdf
42
48
  ```
43
49
 
44
50
  ## CLI Commands
@@ -95,6 +101,36 @@ nworks calendar list --user <userId>
95
101
 
96
102
  > **Note**: 캘린더 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope calendar.read`를 실행하세요.
97
103
 
104
+ ### 드라이브 (User OAuth 필요)
105
+
106
+ ```bash
107
+ # 루트 파일/폴더 목록
108
+ nworks drive list
109
+
110
+ # 특정 폴더 내 파일 목록
111
+ nworks drive list --folder <folderId>
112
+
113
+ # 페이지네이션
114
+ nworks drive list --count 50 --cursor <nextCursor>
115
+
116
+ # 파일 업로드 (루트)
117
+ nworks drive upload --file ./report.pdf
118
+
119
+ # 특정 폴더에 업로드
120
+ nworks drive upload --file ./report.pdf --folder <folderId>
121
+
122
+ # 동일 파일명 덮어쓰기
123
+ nworks drive upload --file ./report.pdf --overwrite
124
+
125
+ # 파일 다운로드
126
+ nworks drive download --file-id <fileId>
127
+
128
+ # 다운로드 경로/파일명 지정
129
+ nworks drive download --file-id <fileId> --out ./downloads --name report.pdf
130
+ ```
131
+
132
+ > **Note**: 드라이브 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope file`을 실행하세요. 읽기만 필요하면 `file.read` scope로 충분합니다.
133
+
98
134
  ### MCP 서버
99
135
 
100
136
  ```bash
@@ -134,6 +170,8 @@ nworks mcp --list-tools # 등록된 tool 목록
134
170
  | `bot.read` | Bot 채널/구성원 조회 | Service Account | `message members` |
135
171
  | `user.read` | 조직 구성원 조회 | Service Account | `directory members` |
136
172
  | `calendar.read` | 캘린더 일정 조회 | User OAuth | `calendar list` |
173
+ | `file` | 드라이브 읽기/쓰기 | User OAuth | `drive list/upload/download` |
174
+ | `file.read` | 드라이브 읽기 전용 | User OAuth | `drive list/download` |
137
175
 
138
176
  > **Tip**: scope를 변경한 후에는 토큰을 재발급해야 합니다.
139
177
  > ```bash
@@ -186,7 +224,7 @@ NWORKS_VERBOSE=1 # optional, 디버그 로깅
186
224
 
187
225
  - ~~**v0.1** — 메시지, 조직 구성원, MCP 서버~~
188
226
  - ~~**v0.2** — 캘린더 일정 조회 + User OAuth~~
189
- - **v0.3** — 드라이브 파일 조회/업로드 (`nworks drive`)
227
+ - ~~**v0.3** — 드라이브 파일 조회/업로드/다운로드 (`nworks drive`)~~
190
228
  - **v0.4** — 게시판, 메일 (`nworks board`, `nworks mail`)
191
229
 
192
230
  ## License
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nworks",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "NAVER WORKS CLI — built for humans and AI agents",
5
5
  "type": "module",
6
6
  "bin": {
@@ -38,9 +38,10 @@
38
38
  "node": ">=18.0.0"
39
39
  },
40
40
  "dependencies": {
41
+ "@modelcontextprotocol/sdk": "^1.12.1",
41
42
  "commander": "^12.1.0",
42
43
  "jsonwebtoken": "^9.0.2",
43
- "@modelcontextprotocol/sdk": "^1.12.1"
44
+ "nworks": "^0.3.0"
44
45
  },
45
46
  "devDependencies": {
46
47
  "@types/jsonwebtoken": "^9.0.7",