apick-mcp 3.0.0 → 3.2.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.
Files changed (5) hide show
  1. package/CHANGELOG.md +68 -62
  2. package/README.md +404 -383
  3. package/TOOLS.md +2015 -1840
  4. package/package.json +89 -89
  5. package/src/index.js +92 -92
package/TOOLS.md CHANGED
@@ -1,1840 +1,2015 @@
1
- # APICK MCP — Full Tool Catalog / 전체 Tool 목록
2
-
3
- **88 tools** across **8 domain servers**, plus the combined `all` server.
4
- **Tool 88개**, 분야별 서버 8개와 통합 서버 `all`.
5
-
6
- Official site 공식 사이트: **<https://apick.app>** · Docs 연동 가이드: **<https://apick.app/dev_guide/mcp>**
7
-
8
- Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for everything, or to one server to keep the tool list short.
9
- 엔드포인트: `https://apick.app/mcp/{server}` — 전부 쓰려면 `all`, 특정 분야만 쓰려면 해당 서버에 연결하면 Tool 목록이 짧아집니다.
10
-
11
- ## Index / 목차
12
-
13
- | Server 서버 | Endpoint | Tools | Coverage 범위 |
14
- | --- | --- | --- | --- |
15
- | [Business & Commerce · 사업자 · 커머스](#business) | `/mcp/business` | 16 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사. |
16
- | [Identity Verification · 신분증 진위확인 · 마스킹](#identity) | `/mcp/identity` | 16 | 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹. |
17
- | [OCR · OCR 문자인식](#ocr) | `/mcp/ocr` | 6 | 이미지 텍스트 추출과 신분증 항목 추출. |
18
- | [Finance · 금융 · 계좌확인](#finance) | `/mcp/finance` | 3 | 계좌 예금주 실명조회와 1원 인증. |
19
- | [Web & Search · 웹 · 검색](#web) | `/mcp/web` | 13 | 도메인·IP 조회, WHOIS, 웹페이지 수집, 구글 검색, 유튜브. |
20
- | [File Conversion · 파일 변환 · 워터마크](#convert) | `/mcp/convert` | 19 | PDF·DOCX·엑셀 변환, 음성인식(STT), 비동기 TTS, 워터마크. |
21
- | [Vision · 이미지 · 영상 분석](#vision) | `/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출. |
22
- | [AI & LLM · AI · LLM](#ai) | `/mcp/ai` | 10 | LLM 챗, 텍스트 도구, 이미지 생성·편집·대량 작업. |
23
- | **All 통합** | `/mcp/all` | **88** | 아래 전부 |
24
-
25
- <details><summary><b>All 88 tool names / 전체 Tool 이름</b></summary>
26
-
27
- `biz_detail` · `venture_biz_info` · `land_rt_price` · `req_pccc` · `get_pccc` · `check_pccc` · `get_car_flooding` · `get_car_scrap` · `parcel_tracking` · `parcel_tracking_auto` · `check_email_valid` · `check_phone_valid` · `check_spam_number` · `holiday_info` · `search_juso` · `info`
28
-
29
- `identi_card1` · `identi_card2` · `identi_card3` · `identi_card4` · `identi_card5` · `identi_card_image1` · `identi_card_image2` · `identi_card_image3` · `identi_card_image4` · `identi_card_image5` · `name_rrn_auth` · `hide_rrn` · `identity_document_residence_card` · `identity_document_passport` · `identity_document_id_card` · `identity_document_driver_license`
30
-
31
- `ocr` · `ocr_identi1` · `ocr_identi2` · `ocr_identi3` · `ocr_identi4` · `ocr_identi5`
32
-
33
- `transfer_1won` · `account_realname` · `bank_code`
34
-
35
- `nslookup` · `reverse_ip` · `location` · `ip_history` · `whois` · `url_html` · `url_screenshot` · `url_similarity` · `google_search` · `google_image_search` · `google_lens_search` · `crawl_youtube` · `download_youtube_video`
36
-
37
- `stt` · `tts_jobs_create` · `tts_jobs_status` · `tts_jobs_cancel` · `tts_jobs_result` · `tts_jobs_subtitles` · `voice_change` · `face_blur` · `pdf_to_docx` · `pdf_to_image` · `pdf_merge` · `html_to_pdf` · `docx_to_pdf` · `json_to_excel` · `base64_to_image` · `set_watermark` · `get_watermark` · `draw_watermark_pdf` · `draw_watermark_image`
38
-
39
- `nsfw_detection` · `image_similarity` · `video_to_mp3` · `extract_video_thumbnail` · `word_cloud` · `face_detection`
40
-
41
- `llm_models` · `llm_chat` · `text_summary` · `text_polish` · `image_generate` · `image_edit` · `image_batch_create` · `image_batch_status` · `image_batch_result`
42
-
43
- </details>
44
-
45
- ---
46
-
47
- <a id="business"></a>
48
-
49
- ## Business & Commerce · 사업자 · 커머스
50
-
51
- `https://apick.app/mcp/business` — 16 tools
52
-
53
- Korean business registry, corporate credit, parcel tracking, real-estate prices, vehicle history, and input validation.
54
-
55
- 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사.
56
-
57
- | Tool | 기능 | Required 필수 |
58
- | --- | --- | --- |
59
- | [`biz_detail`](#biz-detail) | 사업자 정보 조회 | `biz_no` |
60
- | [`venture_biz_info`](#venture-biz-info) | 벤처기업 정보조회 | `biz_no` |
61
- | [`land_rt_price`](#land-rt-price) | 부동산 실거래가 조회 | `addr1`, `addr2`, `type`, `year` |
62
- | [`req_pccc`](#req-pccc) | 개인통관고유부호 인증 요청 | `name`, `rrn1`, `rrn2`, `phone` |
63
- | [`get_pccc`](#get-pccc) | 개인통관고유부호 조회 | `auth_key`, `answer` |
64
- | [`check_pccc`](#check-pccc) | 개인통관부호 검증 | `name`, `pccc`, `zip`, `phone` |
65
- | [`get_car_flooding`](#get-car-flooding) | 차량 침수차 여부 조회 | `type`, `value` |
66
- | [`get_car_scrap`](#get-car-scrap) | 차량 폐차사고처리 여부 조회 | `type`, `value` |
67
- | [`parcel_tracking`](#parcel-tracking) | 택배 배송조회 | `carrier`, `trackingNumber` |
68
- | [`parcel_tracking_auto`](#parcel-tracking-auto) | 택배 배송조회(자동) | `trackingNumber` |
69
- | [`check_email_valid`](#check-email-valid) | 이메일 유효성 검사 | `email` |
70
- | [`check_phone_valid`](#check-phone-valid) | 전화번호 유효성 검사 | `number` |
71
- | [`check_spam_number`](#check-spam-number) | 스팸/광고/범죄 전화번호 조회 | `number` |
72
- | [`holiday_info`](#holiday-info) | 공휴일 조회 | `year`, `month` |
73
- | [`search_juso`](#search-juso) | 도로명주소 조회 | `juso` |
74
- | [`info`](#info) | 계정 정보 조회 | — |
75
-
76
- <a id="biz-detail"></a>
77
-
78
- ### `biz_detail` — 사업자 정보 조회
79
-
80
- Look up general status information of a Korean business by its 10-digit business registration number.
81
-
82
- 사업자등록번호로 해당 사업자의 일반 현황 정보(대표자, 주소, 직원수, 설립일, 업종, 업태, 종목, 연락처, 사업자상태, 과세유형 등)를 조회합니다.
83
-
84
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
85
-
86
- | Parameter | Type | Required | Description 설명 |
87
- | --- | --- | --- | --- |
88
- | `biz_no` | `string` | **필수 / required** | 사업자등록번호 (숫자 10자리, 하이픈 제외, 예: 4398700761) |
89
-
90
- ```json
91
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"biz_detail","arguments":{"biz_no":"<biz_no>"}}}
92
- ```
93
-
94
- <a id="venture-biz-info"></a>
95
-
96
- ### `venture_biz_info` — 벤처기업 정보조회
97
-
98
- Look up venture company information of a Korean business, including financial statements and investment data.
99
-
100
- 벤처기업을 대상으로 사업자 정보, 대차대조표, 손익계산서, 투자정보, 벤처기업확인정보를 조회합니다.
101
-
102
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
103
-
104
- | Parameter | Type | Required | Description 설명 |
105
- | --- | --- | --- | --- |
106
- | `biz_no` | `string` | **필수 / required** | 사업자등록번호 (숫자 10자리, 하이픈 제외) |
107
-
108
- ```json
109
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"venture_biz_info","arguments":{"biz_no":"<biz_no>"}}}
110
- ```
111
-
112
- <a id="land-rt-price"></a>
113
-
114
- ### `land_rt_price` — 부동산 실거래가 조회
115
-
116
- Look up real estate transaction price records in Korea by region, property type, and year.
117
-
118
- 시/도·시/군/구, 부동산 유형, 년도를 지정해 부동산 실거래 이력을 조회합니다. addr1 값이 잘못되면 응답의 options 필드로 선택 가능한 지역 목록을 안내합니다.
119
-
120
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
121
-
122
- | Parameter | Type | Required | Description 설명 |
123
- | --- | --- | --- | --- |
124
- | `addr1` | `string` | **필수 / required** | 도/광역시/특별시 정식 명칭 (예: 서울특별시, 경기도, 부산광역시) |
125
- | `addr2` | `string` | **필수 / required** | 시/군/구 (예: 금천구) |
126
- | `type` | `string` | **필수 / required** | 유형 코드 A~H 중 하나. A:아파트, B:연립/다세대, C:단독/다가구, D:오피스텔, E:분양/입주권, F:상업/업무용, G:토지, H:공장/창고등 |
127
- | `year` | `string` | **필수 / required** | 조회 년도 (1950 ~ 현재 년도, 예: 2025) |
128
-
129
- ```json
130
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"land_rt_price","arguments":{"addr1":"<addr1>","addr2":"<addr2>","type":"<type>","year":"<year>"}}}
131
- ```
132
-
133
- <a id="req-pccc"></a>
134
-
135
- ### `req_pccc` — 개인통관고유부호 인증 요청
136
-
137
- Request SMS verification to retrieve a Korean Personal Customs Clearance Code (PCCC).
138
-
139
- 개인통관고유부호 조회를 위한 본인 인증을 요청합니다. 인증번호 6자리가 문자(SMS)로 발송되며, 응답의 auth_key와 수신한 인증번호를 get_pccc Tool에 입력해 부호를 조회합니다.
140
-
141
- > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `business`
142
-
143
- | Parameter | Type | Required | Description 설명 |
144
- | --- | --- | --- | --- |
145
- | `name` | `string` | **필수 / required** | 이름 |
146
- | `rrn1` | `string` | **필수 / required** | 주민등록번호 앞 6자리 |
147
- | `rrn2` | `string` | **필수 / required** | 주민등록번호 뒤 7자리 |
148
- | `phone` | `string` | **필수 / required** | 휴대전화 번호 (본인 명의, 숫자만) |
149
-
150
- ```json
151
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"req_pccc","arguments":{"name":"<name>","rrn1":"<rrn1>","rrn2":"<rrn2>","phone":"<phone>"}}}
152
- ```
153
-
154
- <a id="get-pccc"></a>
155
-
156
- ### `get_pccc` — 개인통관고유부호 조회
157
-
158
- Retrieve a Korean Personal Customs Clearance Code (PCCC) using the auth key and SMS verification code.
159
-
160
- req_pccc Tool 호출로 받은 auth_key와 문자(SMS)로 수신한 인증번호 6자리를 입력해 개인통관고유부호를 조회합니다.
161
-
162
- > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `business`
163
-
164
- | Parameter | Type | Required | Description 설명 |
165
- | --- | --- | --- | --- |
166
- | `auth_key` | `string` | **필수 / required** | req_pccc(개인통관고유부호 인증 요청) 응답의 인증 키 |
167
- | `answer` | `string` | **필수 / required** | 문자(SMS)로 발송된 인증번호 6자리 |
168
-
169
- ```json
170
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_pccc","arguments":{"auth_key":"<auth_key>","answer":"<answer>"}}}
171
- ```
172
-
173
- <a id="check-pccc"></a>
174
-
175
- ### `check_pccc` — 개인통관부호 검증
176
-
177
- Verify that a Korean Personal Customs Clearance Code (PCCC) matches the given name, zip code, and phone number.
178
-
179
- 이름, 개인통관고유부호, 우편번호, 전화번호를 입력하여 개인통관부호 일치 여부를 검증합니다. 해외직구 주문 정보 검증 등에 사용합니다.
180
-
181
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
182
-
183
- | Parameter | Type | Required | Description 설명 |
184
- | --- | --- | --- | --- |
185
- | `name` | `string` | **필수 / required** | 이름 |
186
- | `pccc` | `string` | **필수 / required** | 개인통관고유부호 (P + 숫자 12자리, 예: P123456789012) |
187
- | `zip` | `string` | **필수 / required** | 우편번호 (5자리, 예: 12345) |
188
- | `phone` | `string` | **필수 / required** | 전화번호 (숫자만, 예: 01012341234) |
189
-
190
- ```json
191
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_pccc","arguments":{"name":"<name>","pccc":"<pccc>","zip":"<zip>","phone":"<phone>"}}}
192
- ```
193
-
194
- <a id="get-car-flooding"></a>
195
-
196
- ### `get_car_flooding` — 차량 침수차 여부 조회
197
-
198
- Check whether a Korean vehicle has a flood damage record, by VIN or license plate number.
199
-
200
- 차대번호(VIN) 또는 차량번호로 자동차의 침수 이력 여부를 조회합니다. 중고차 구매 전 확인 등에 사용합니다.
201
-
202
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
203
-
204
- | Parameter | Type | Required | Description 설명 |
205
- | --- | --- | --- | --- |
206
- | `type` | `string` | **필수 / required** | 조회 종류. 1: 차대번호(VIN), 2: 차량번호 |
207
- | `value` | `string` | **필수 / required** | 차대번호(type=1, 17자리) 또는 차량번호(type=2) |
208
-
209
- ```json
210
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_car_flooding","arguments":{"type":"<type>","value":"<value>"}}}
211
- ```
212
-
213
- <a id="get-car-scrap"></a>
214
-
215
- ### `get_car_scrap` — 차량 폐차사고처리 여부 조회
216
-
217
- Check whether a Korean vehicle has a scrap/total-loss accident record, by VIN or license plate number.
218
-
219
- 차대번호(VIN) 또는 차량번호로 폐차사고처리 여부를 조회합니다. 중고차 구매 전 확인 등에 사용합니다.
220
-
221
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
222
-
223
- | Parameter | Type | Required | Description 설명 |
224
- | --- | --- | --- | --- |
225
- | `type` | `string` | **필수 / required** | 조회 종류. 1: 차대번호(VIN), 2: 차량번호 |
226
- | `value` | `string` | **필수 / required** | 차대번호(type=1, 17자리) 또는 차량번호(type=2) |
227
-
228
- ```json
229
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_car_scrap","arguments":{"type":"<type>","value":"<value>"}}}
230
- ```
231
-
232
- <a id="parcel-tracking"></a>
233
-
234
- ### `parcel_tracking` — 택배 배송조회
235
-
236
- Track a Korean parcel in real time by carrier code and tracking number.
237
-
238
- 택배사 코드와 운송장번호를 지정해 실시간 배송현황을 조회합니다. 결과는 저장하지 않고 매 호출마다 즉시 조회합니다. carrier 코드 예: cj(CJ대한통운), hanjin(한진택배), lotte(롯데택배), logen(로젠택배), epost-domestic(우체국택배) 등 — 전체 목록은 /rest/parcel_tracking_carriers(무료)에서 확인할 수 있고, 택배사를 모르면 parcel_tracking_auto Tool로 자동판별 조회하세요.
239
-
240
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
241
-
242
- | Parameter | Type | Required | Description 설명 |
243
- | --- | --- | --- | --- |
244
- | `carrier` | `string` | **필수 / required** | 택배사 코드 (예: cj, hanjin, lotte, logen, epost-domestic) |
245
- | `trackingNumber` | `string` | **필수 / required** | 운송장번호 |
246
-
247
- ```json
248
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"parcel_tracking","arguments":{"carrier":"<carrier>","trackingNumber":"<trackingNumber>"}}}
249
- ```
250
-
251
- <a id="parcel-tracking-auto"></a>
252
-
253
- ### `parcel_tracking_auto` — 택배 배송조회(자동)
254
-
255
- Track a Korean parcel in real time with automatic carrier detection from the tracking number alone.
256
-
257
- 택배사 지정 없이 운송장번호만으로 택배사를 자동 판별해 실시간 배송현황을 조회합니다. 택배사를 이미 아는 경우에는 parcel_tracking Tool이 더 정확합니다.
258
-
259
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
260
-
261
- | Parameter | Type | Required | Description 설명 |
262
- | --- | --- | --- | --- |
263
- | `trackingNumber` | `string` | **필수 / required** | 운송장번호 (택배사 지정 없이 형식만으로 자동 판별) |
264
-
265
- ```json
266
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"parcel_tracking_auto","arguments":{"trackingNumber":"<trackingNumber>"}}}
267
- ```
268
-
269
- <a id="check-email-valid"></a>
270
-
271
- ### `check_email_valid` — 이메일 유효성 검사
272
-
273
- Validate whether an email address is real and deliverable.
274
-
275
- 이메일 주소의 유효성 여부를 검사합니다. 회원가입 입력값 검증, 발송 전 리스트 정제 등에 사용합니다.
276
-
277
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
278
-
279
- | Parameter | Type | Required | Description 설명 |
280
- | --- | --- | --- | --- |
281
- | `email` | `string` | **필수 / required** | 이메일 주소 (예: hong@example.com) |
282
-
283
- ```json
284
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_email_valid","arguments":{"email":"<email>"}}}
285
- ```
286
-
287
- <a id="check-phone-valid"></a>
288
-
289
- ### `check_phone_valid` — 전화번호 유효성 검사
290
-
291
- Validate whether a phone number is in service.
292
-
293
- 전화번호의 유효성 여부를 검사합니다. 국내 번호는 0으로 시작하는 형식(예: 01012341234) 그대로 입력하면 되고, 해외 번호는 + 국가코드 형식으로 입력합니다.
294
-
295
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
296
-
297
- | Parameter | Type | Required | Description 설명 |
298
- | --- | --- | --- | --- |
299
- | `number` | `string` | **필수 / required** | 전화번호 (예: 01012341234, 해외는 +국가코드 형식) |
300
-
301
- ```json
302
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_phone_valid","arguments":{"number":"<number>"}}}
303
- ```
304
-
305
- <a id="check-spam-number"></a>
306
-
307
- ### `check_spam_number` — 스팸/광고/범죄 전화번호 조회
308
-
309
- Check whether a phone number has been reported for spam, advertising, or criminal use in Korea.
310
-
311
- 스팸/광고/범죄에 사용된 전화번호인지 조회합니다. 수신 전화 필터링, 이상 거래 탐지 등에 사용합니다.
312
-
313
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
314
-
315
- | Parameter | Type | Required | Description 설명 |
316
- | --- | --- | --- | --- |
317
- | `number` | `string` | **필수 / required** | 전화번호 (예: 01012341234) |
318
-
319
- ```json
320
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_spam_number","arguments":{"number":"<number>"}}}
321
- ```
322
-
323
- <a id="holiday-info"></a>
324
-
325
- ### `holiday_info` — 공휴일 조회
326
-
327
- Look up Korean public holidays for a given year and month.
328
-
329
- 해당 년월의 대한민국 공휴일 정보를 조회합니다. 영업일 계산, 일정 관리 등에 사용합니다.
330
-
331
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
332
-
333
- | Parameter | Type | Required | Description 설명 |
334
- | --- | --- | --- | --- |
335
- | `year` | `string` | **필수 / required** | 조회 년도 (1900 ~ 2200, 예: 2024) |
336
- | `month` | `string` | **필수 / required** | 조회 월 (1 ~ 12, 예: 02) |
337
-
338
- ```json
339
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"holiday_info","arguments":{"year":"<year>","month":"<month>"}}}
340
- ```
341
-
342
- <a id="search-juso"></a>
343
-
344
- ### `search_juso` — 도로명주소 조회
345
-
346
- Search Korean road-name addresses by keyword.
347
-
348
- 지번 또는 도로명 키워드로 도로명 주소를 검색합니다. 페이지당 10건씩 반환되며 total_count 필드로 전체 검색결과 개수를 확인할 수 있습니다.
349
-
350
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
351
-
352
- | Parameter | Type | Required | Description 설명 |
353
- | --- | --- | --- | --- |
354
- | `juso` | `string` | **필수 / required** | 검색할 주소 키워드 (지번, 도로명. 예: 디지털로) |
355
- | `page` | `string` | 선택 / optional | 검색 결과 조회 페이지 (기본값 1, 페이지당 10건) |
356
-
357
- ```json
358
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_juso","arguments":{"juso":"<juso>"}}}
359
- ```
360
-
361
- <a id="info"></a>
362
-
363
- ### `info` — 계정 정보 조회
364
-
365
- Check your APICK account balance and status.
366
-
367
- 현재 인증 키에 연결된 APICK 계정의 잔여 포인트와 계정 상태 정보를 조회합니다. 무료입니다.
368
-
369
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
370
-
371
- _No parameters. 파라미터 없음._
372
-
373
- ```json
374
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"info","arguments":{}}}
375
- ```
376
-
377
- ---
378
-
379
- <a id="identity"></a>
380
-
381
- ## Identity Verification · 신분증 진위확인 · 마스킹
382
-
383
- `https://apick.app/mcp/identity` — 16 tools
384
-
385
- Authenticity checks for Korean ID documents against government registries, real-name verification, and PII masking.
386
-
387
- 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹.
388
-
389
- 마스킹 5종의 실패 결과는 기존 텍스트 오류와 함께 `structuredContent.error_code` 및 `structuredContent.error`를 제공합니다. 오류 코드는 `IDENTITY_TEXT_UNREADABLE`, `IDENTITY_DOCUMENT_MISMATCH`, `IDENTITY_PROCESSING_FAILED`입니다. 과금 없이 실패하며 브리지는 서버 결과를 그대로 전달합니다.
390
-
391
- The five masking tools preserve the text error and also return `structuredContent.error_code` and `structuredContent.error`. The service codes are `IDENTITY_TEXT_UNREADABLE`, `IDENTITY_DOCUMENT_MISMATCH`, and `IDENTITY_PROCESSING_FAILED`; failed calls are not charged and the bridge forwards the server result unchanged.
392
-
393
- | Tool | 기능 | Required 필수 |
394
- | --- | --- | --- |
395
- | [`identi_card1`](#identi-card1) | [Text] 주민등록증 진위 확인 | `name`, `rrn1`, `rrn2`, `date` |
396
- | [`identi_card2`](#identi-card2) | [Text] 운전면허증 진위 확인 | `birth_y`, `birth_m`, `birth_d`, `name`, `licen_no0`, `licen_no1`, `licen_no2`, `licen_no3` |
397
- | [`identi_card3`](#identi-card3) | [Text] 여권 진위 확인 | `name`, `pass_num`, `made_date`, `exp_date`, `birth_date` |
398
- | [`identi_card4`](#identi-card4) | [Text] 주민등록등본 진위 확인 | `doc_num1`, `doc_num2`, `doc_num3`, `doc_num4`, `type` |
399
- | [`identi_card5`](#identi-card5) | [Text] 외국인등록증 진위 확인 | `rrn`, `made_date` |
400
- | [`identi_card_image1`](#identi-card-image1) | [Image/PDF] 주민등록증 진위 확인 | `image_url` |
401
- | [`identi_card_image2`](#identi-card-image2) | [Image/PDF] 운전면허증 진위 확인 | `image_url` |
402
- | [`identi_card_image3`](#identi-card-image3) | [Image/PDF] 여권 진위 확인 | `image_url` |
403
- | [`identi_card_image4`](#identi-card-image4) | [Image/PDF] 주민등록등본 진위 확인 | `image_url` |
404
- | [`identi_card_image5`](#identi-card-image5) | [Image/PDF] 외국인등록증 진위 확인 | `image_url` |
405
- | [`name_rrn_auth`](#name-rrn-auth) | 성명/주민등록번호 실명확인 | `name`, `rrn1`, `rrn2` |
406
- | [`hide_rrn`](#hide-rrn) | 개인정보 마스킹(주민등록번호) | `type`, `image_url` |
407
- | [`identity_document_residence_card`](#identity-document-residence-card) | 외국인등록증 개인정보 마스킹 | `image_url` |
408
- | [`identity_document_passport`](#identity-document-passport) | 여권 개인정보 마스킹 | `image_url` |
409
- | [`identity_document_id_card`](#identity-document-id-card) | 주민등록증 개인정보 마스킹 | `image_url` |
410
- | [`identity_document_driver_license`](#identity-document-driver-license) | 운전면허증 개인정보 마스킹 | `image_url` |
411
-
412
- <a id="identi-card1"></a>
413
-
414
- ### `identi_card1` — [Text] 주민등록증 진위 확인
415
-
416
- Verify the authenticity of a Korean resident registration card (jumin-deungnokjeung) using text input.
417
-
418
- 주민등록증의 기재 정보를 입력해 진위 여부를 확인합니다. name, rrn1, rrn2, date 네 항목을 모두 입력해야 하며, date는 숫자만 허용됩니다(예: 20230101). 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
419
-
420
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
421
-
422
- | Parameter | Type | Required | Description 설명 |
423
- | --- | --- | --- | --- |
424
- | `name` | `string` | **필수 / required** | 성명 |
425
- | `rrn1` | `string` | **필수 / required** | 주민등록번호 앞 6자리 |
426
- | `rrn2` | `string` | **필수 / required** | 주민등록번호 뒤 7자리 |
427
- | `date` | `string` | **필수 / required** | 발급일자 (숫자만, 예: 20230101) |
428
-
429
- ```json
430
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card1","arguments":{"name":"<name>","rrn1":"<rrn1>","rrn2":"<rrn2>","date":"<date>"}}}
431
- ```
432
-
433
- <a id="identi-card2"></a>
434
-
435
- ### `identi_card2` — [Text] 운전면허증 진위 확인
436
-
437
- Verify the authenticity of a Korean driver license using text input.
438
-
439
- 운전면허증의 기재 정보를 입력해 진위 여부를 확인합니다. birth_y, birth_m, birth_d, name과 면허번호 4구획(licen_no0~licen_no3)은 모두 필수이며, ghost_num(식별번호)과 rrn1, rrn2는 선택 입력입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
440
-
441
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
442
-
443
- | Parameter | Type | Required | Description 설명 |
444
- | --- | --- | --- | --- |
445
- | `birth_y` | `string` | **필수 / required** | 생년월일 - 년 (예: 2000) |
446
- | `birth_m` | `string` | **필수 / required** | 생년월일 - 월 (예: 01) |
447
- | `birth_d` | `string` | **필수 / required** | 생년월일 - 일 (예: 01) |
448
- | `name` | `string` | **필수 / required** | 성명 |
449
- | `licen_no0` | `string` | **필수 / required** | 면허번호 1구획 (예: 21) |
450
- | `licen_no1` | `string` | **필수 / required** | 면허번호 2구획 (예: 19) |
451
- | `licen_no2` | `string` | **필수 / required** | 면허번호 3구획 (예: 174133) |
452
- | `licen_no3` | `string` | **필수 / required** | 면허번호 4구획 (예: 01) |
453
- | `ghost_num` | `string` | 선택 / optional | 식별번호 (면허증 우측 표기, 예: 8H1X3Y) |
454
- | `rrn1` | `string` | 선택 / optional | 주민등록번호 앞 6자리 (선택) |
455
- | `rrn2` | `string` | 선택 / optional | 주민등록번호 뒤 7자리 (선택) |
456
-
457
- ```json
458
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card2","arguments":{"birth_y":"<birth_y>","birth_m":"<birth_m>","birth_d":"<birth_d>","name":"<name>","licen_no0":"<licen_no0>","licen_no1":"<licen_no1>","licen_no2":"<licen_no2>","licen_no3":"<licen_no3>"}}}
459
- ```
460
-
461
- <a id="identi-card3"></a>
462
-
463
- ### `identi_card3` — [Text] 여권 진위 확인
464
-
465
- Verify the authenticity of a Korean passport using text input.
466
-
467
- 여권의 기재 정보를 입력해 진위 여부를 확인합니다. name, pass_num, made_date, exp_date, birth_date 다섯 항목을 모두 입력해야 하며, 일자 세 항목은 숫자만 허용됩니다(예: 20230101). 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
468
-
469
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
470
-
471
- | Parameter | Type | Required | Description 설명 |
472
- | --- | --- | --- | --- |
473
- | `name` | `string` | **필수 / required** | 성명 |
474
- | `pass_num` | `string` | **필수 / required** | 여권번호 (예: M00000000) |
475
- | `made_date` | `string` | **필수 / required** | 발급일자 (숫자만, 예: 20230101) |
476
- | `exp_date` | `string` | **필수 / required** | 만료일자 (숫자만, 예: 20330101) |
477
- | `birth_date` | `string` | **필수 / required** | 생년월일 (숫자만, 예: 20000101) |
478
-
479
- ```json
480
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card3","arguments":{"name":"<name>","pass_num":"<pass_num>","made_date":"<made_date>","exp_date":"<exp_date>","birth_date":"<birth_date>"}}}
481
- ```
482
-
483
- <a id="identi-card4"></a>
484
-
485
- ### `identi_card4` — [Text] 주민등록등본 진위 확인
486
-
487
- Verify the authenticity of a Korean resident registration certificate (jumin-deungnok-deungbon) using text input.
488
-
489
- 주민등록등본의 문서확인번호로 진위 여부를 확인합니다. 문서확인번호 16자리를 4자리씩 나눈 doc_num1~doc_num4와 발급 종류 type(1: 정부24 발급, 2: 기타 발급)은 필수이며, name(성명)은 선택 입력입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
490
-
491
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
492
-
493
- | Parameter | Type | Required | Description 설명 |
494
- | --- | --- | --- | --- |
495
- | `doc_num1` | `string` | **필수 / required** | 문서확인번호 1구획 (4자리) |
496
- | `doc_num2` | `string` | **필수 / required** | 문서확인번호 2구획 (4자리) |
497
- | `doc_num3` | `string` | **필수 / required** | 문서확인번호 3구획 (4자리) |
498
- | `doc_num4` | `string` | **필수 / required** | 문서확인번호 4구획 (4자리) |
499
- | `name` | `string` | 선택 / optional | 성명 |
500
- | `type` | `string` | **필수 / required** | 발급 종류 (1: 정부24 발급, 2: 기타 발급) |
501
-
502
- ```json
503
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card4","arguments":{"doc_num1":"<doc_num1>","doc_num2":"<doc_num2>","doc_num3":"<doc_num3>","doc_num4":"<doc_num4>","type":"<type>"}}}
504
- ```
505
-
506
- <a id="identi-card5"></a>
507
-
508
- ### `identi_card5` — [Text] 외국인등록증 진위 확인
509
-
510
- Verify the authenticity of a Korean alien registration card (residence card) using text input.
511
-
512
- 외국인등록증의 기재 정보를 입력해 진위 여부를 확인합니다. rrn(외국인등록번호 13자리)과 made_date(발급일자 10자리, 예: 2020-01-01)는 필수이며, card_sn(뒷면 일련번호)은 입력 시 11자리여야 하고 2011-01-01 이후 발급된 등록증은 필수입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
513
-
514
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
515
-
516
- | Parameter | Type | Required | Description 설명 |
517
- | --- | --- | --- | --- |
518
- | `rrn` | `string` | **필수 / required** | 외국인등록번호 (숫자 13자리) |
519
- | `made_date` | `string` | **필수 / required** | 발급일자 (10자리, 예: 2020-01-01) |
520
- | `card_sn` | `string` | 선택 / optional | 뒷면 일련번호 (11자리). 2011-01-01 이후 발급분은 필수 |
521
-
522
- ```json
523
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card5","arguments":{"rrn":"<rrn>","made_date":"<made_date>"}}}
524
- ```
525
-
526
- <a id="identi-card-image1"></a>
527
-
528
- ### `identi_card_image1` — [Image/PDF] 주민등록증 진위 확인
529
-
530
- Verify the authenticity of a Korean resident registration card from an image or PDF file.
531
-
532
- 주민등록증 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
533
-
534
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
535
-
536
- | Parameter | Type | Required | Description 설명 |
537
- | --- | --- | --- | --- |
538
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, application/pdf, 최대 25MB |
539
-
540
- ```json
541
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card_image1","arguments":{"image_url":"https://example.com/file"}}}
542
- ```
543
-
544
- <a id="identi-card-image2"></a>
545
-
546
- ### `identi_card_image2` — [Image/PDF] 운전면허증 진위 확인
547
-
548
- Verify the authenticity of a Korean driver license from an image or PDF file.
549
-
550
- 운전면허증 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
551
-
552
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
553
-
554
- | Parameter | Type | Required | Description 설명 |
555
- | --- | --- | --- | --- |
556
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, application/pdf, 최대 25MB |
557
-
558
- ```json
559
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card_image2","arguments":{"image_url":"https://example.com/file"}}}
560
- ```
561
-
562
- <a id="identi-card-image3"></a>
563
-
564
- ### `identi_card_image3` — [Image/PDF] 여권 진위 확인
565
-
566
- Verify the authenticity of a Korean passport from an image or PDF file.
567
-
568
- 여권 인적사항면 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
569
-
570
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
571
-
572
- | Parameter | Type | Required | Description 설명 |
573
- | --- | --- | --- | --- |
574
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, application/pdf, 최대 25MB |
575
-
576
- ```json
577
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card_image3","arguments":{"image_url":"https://example.com/file"}}}
578
- ```
579
-
580
- <a id="identi-card-image4"></a>
581
-
582
- ### `identi_card_image4` — [Image/PDF] 주민등록등본 진위 확인
583
-
584
- Verify the authenticity of a Korean resident registration certificate from an image or PDF file.
585
-
586
- 주민등록등본 이미지 또는 PDF 파일을 업로드하면 문서확인번호 등 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
587
-
588
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
589
-
590
- | Parameter | Type | Required | Description 설명 |
591
- | --- | --- | --- | --- |
592
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, application/pdf, 최대 25MB |
593
-
594
- ```json
595
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card_image4","arguments":{"image_url":"https://example.com/file"}}}
596
- ```
597
-
598
- <a id="identi-card-image5"></a>
599
-
600
- ### `identi_card_image5` — [Image/PDF] 외국인등록증 진위 확인
601
-
602
- Verify the authenticity of a Korean alien registration card (residence card) from an image or PDF file.
603
-
604
- 외국인등록증 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. card_sn(뒷면 일련번호 11자리)은 선택 입력이며, 2011-01-01 이후 발급된 등록증은 필수입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
605
-
606
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
607
-
608
- | Parameter | Type | Required | Description 설명 |
609
- | --- | --- | --- | --- |
610
- | `card_sn` | `string` | 선택 / optional | 뒷면 일련번호 (11자리). 2011-01-01 이후 발급분은 필수 |
611
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, application/pdf, 최대 25MB |
612
-
613
- ```json
614
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card_image5","arguments":{"image_url":"https://example.com/file"}}}
615
- ```
616
-
617
- <a id="name-rrn-auth"></a>
618
-
619
- ### `name_rrn_auth` — 성명/주민등록번호 실명확인
620
-
621
- Verify that a Korean name and resident registration number (RRN) match a real registered person.
622
-
623
- 성명과 주민등록번호의 일치 여부(실명 존재 여부)를 확인합니다. name, rrn1(앞 6자리), rrn2(뒤 7자리)를 모두 입력해야 합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
624
-
625
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
626
-
627
- | Parameter | Type | Required | Description 설명 |
628
- | --- | --- | --- | --- |
629
- | `name` | `string` | **필수 / required** | 한글 성명 |
630
- | `rrn1` | `string` | **필수 / required** | 주민등록번호 앞 6자리 숫자 |
631
- | `rrn2` | `string` | **필수 / required** | 주민등록번호 뒤 7자리 숫자 |
632
-
633
- ```json
634
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"name_rrn_auth","arguments":{"name":"<name>","rrn1":"<rrn1>","rrn2":"<rrn2>"}}}
635
- ```
636
-
637
- <a id="hide-rrn"></a>
638
-
639
- ### `hide_rrn` — 개인정보 마스킹(주민등록번호)
640
-
641
- Mask resident registration numbers found in an image and return the masked image.
642
-
643
- 이미지에서 주민등록번호를 인식해 지정한 방식으로 가린 이미지를 반환합니다. 이미지 파일과 type(1: 주민등록번호 전체 가림, 2: 뒷자리 전체 가림, 3: 뒷자리 첫 숫자 제외 가림, 4: 주민등록번호와 주소 가림)을 모두 입력해야 합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
644
-
645
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
646
-
647
- | Parameter | Type | Required | Description 설명 |
648
- | --- | --- | --- | --- |
649
- | `type` | `string` | **필수 / required** | 가림 처리 타입 (1: 주민등록번호 전체, 2: 뒷자리 전체, 3: 뒷자리 첫 숫자 제외, 4: 주민등록번호+주소) |
650
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, 최대 25MB |
651
-
652
- ```json
653
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hide_rrn","arguments":{"type":"<type>","image_url":"https://example.com/file"}}}
654
- ```
655
-
656
- <a id="identity-document-residence-card"></a>
657
-
658
- ### `identity_document_residence_card` — 외국인등록증 개인정보 마스킹
659
-
660
- Extract key fields from a Korean residence card, permanent resident card, or overseas Korean resident card image and mask the last 6 digits of the registration or domestic residence report number.
661
-
662
- 외국인등록증·영주증·외국국적동포 국내거소신고증 이미지에서 지정 정보를 추출하고 등록번호 또는 거소신고번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. 한 번에 신분증 한 장이 포함된 PNG 또는 JPEG 이미지만 전달해야 하며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 영주증과 외국국적동포 국내거소신고증은 마스킹만 지원하며 진위확인 Tool의 범위에는 포함되지 않습니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
663
-
664
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
665
-
666
- | Parameter | Type | Required | Description 설명 |
667
- | --- | --- | --- | --- |
668
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, 최대 20MB |
669
-
670
- ```json
671
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identity_document_residence_card","arguments":{"image_url":"https://example.com/file"}}}
672
- ```
673
-
674
- <a id="identity-document-passport"></a>
675
-
676
- ### `identity_document_passport` — 여권 개인정보 마스킹
677
-
678
- Extract key fields from a passport image and mask the passport number and MRZ area.
679
-
680
- 여권 인적사항면 이미지에서 지정 정보를 추출하고 여권번호 및 MRZ 영역을 마스킹한 이미지를 함께 반환합니다. MRZ 2줄이 포함되도록 촬영한 PNG 또는 JPEG 이미지 파일 하나만 전달하면 되며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
681
-
682
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
683
-
684
- | Parameter | Type | Required | Description 설명 |
685
- | --- | --- | --- | --- |
686
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, 최대 20MB |
687
-
688
- ```json
689
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identity_document_passport","arguments":{"image_url":"https://example.com/file"}}}
690
- ```
691
-
692
- <a id="identity-document-id-card"></a>
693
-
694
- ### `identity_document_id_card` — 주민등록증 개인정보 마스킹
695
-
696
- Extract key fields from a Korean resident registration card image and mask the last 6 digits of the RRN.
697
-
698
- 주민등록증 이미지에서 지정 정보를 추출하고 주민등록번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. PNG 또는 JPEG 이미지 파일 하나만 전달하면 되며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
699
-
700
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
701
-
702
- | Parameter | Type | Required | Description 설명 |
703
- | --- | --- | --- | --- |
704
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, 최대 20MB |
705
-
706
- ```json
707
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identity_document_id_card","arguments":{"image_url":"https://example.com/file"}}}
708
- ```
709
-
710
- <a id="identity-document-driver-license"></a>
711
-
712
- ### `identity_document_driver_license` — 운전면허증 개인정보 마스킹
713
-
714
- Extract key fields from a Korean driver license image and mask the last 6 digits of the RRN.
715
-
716
- 운전면허증(주민등록번호 표기형) 이미지에서 지정 정보를 추출하고 주민등록번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. PNG 또는 JPEG 이미지 파일 하나만 전달하면 되며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
717
-
718
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
719
-
720
- | Parameter | Type | Required | Description 설명 |
721
- | --- | --- | --- | --- |
722
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, 최대 20MB |
723
-
724
- ```json
725
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identity_document_driver_license","arguments":{"image_url":"https://example.com/file"}}}
726
- ```
727
-
728
- ---
729
-
730
- <a id="ocr"></a>
731
-
732
- ## OCR · OCR 문자인식
733
-
734
- `https://apick.app/mcp/ocr` — 6 tools
735
-
736
- Text extraction from images and structured field extraction from Korean ID documents.
737
-
738
- 이미지 텍스트 추출과 신분증 항목 추출.
739
-
740
- | Tool | 기능 | Required 필수 |
741
- | --- | --- | --- |
742
- | [`ocr`](#ocr) | 이미지 텍스트 추출(OCR) | `image_url` |
743
- | [`ocr_identi1`](#ocr-identi1) | 주민등록증 텍스트 추출(OCR) | `image_url` |
744
- | [`ocr_identi2`](#ocr-identi2) | 운전면허증 텍스트 추출(OCR) | `image_url` |
745
- | [`ocr_identi3`](#ocr-identi3) | 여권 텍스트 추출(OCR) | `image_url` |
746
- | [`ocr_identi4`](#ocr-identi4) | 주민등록등본 텍스트 추출(OCR) | `image_url` |
747
- | [`ocr_identi5`](#ocr-identi5) | 외국인등록증 텍스트 추출(OCR) | `image_url` |
748
-
749
- <a id="ocr"></a>
750
-
751
- ### `ocr` — 이미지 텍스트 추출(OCR)
752
-
753
- Extract text from an image file (OCR).
754
-
755
- 이미지 파일에서 텍스트를 추출해 전체 텍스트(full_text)를 반환합니다. 문서 사진, 스캔 이미지, 캡처 화면 등 범용 이미지에 사용합니다.
756
-
757
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
758
-
759
- | Parameter | Type | Required | Description 설명 |
760
- | --- | --- | --- | --- |
761
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
762
-
763
- ```json
764
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr","arguments":{"image_url":"https://example.com/file"}}}
765
- ```
766
-
767
- <a id="ocr-identi1"></a>
768
-
769
- ### `ocr_identi1` — 주민등록증 텍스트 추출(OCR)
770
-
771
- Extract key fields from a Korean resident registration card (jumin card) image via OCR.
772
-
773
- 주민등록증 사진에서 이름, 주민등록번호, 주소, 발급일자 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
774
-
775
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
776
-
777
- | Parameter | Type | Required | Description 설명 |
778
- | --- | --- | --- | --- |
779
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
780
-
781
- ```json
782
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr_identi1","arguments":{"image_url":"https://example.com/file"}}}
783
- ```
784
-
785
- <a id="ocr-identi2"></a>
786
-
787
- ### `ocr_identi2` — 운전면허증 텍스트 추출(OCR)
788
-
789
- Extract key fields from a Korean driver license image via OCR.
790
-
791
- 운전면허증 사진에서 이름, 면허번호, 생년월일 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
792
-
793
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
794
-
795
- | Parameter | Type | Required | Description 설명 |
796
- | --- | --- | --- | --- |
797
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
798
-
799
- ```json
800
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr_identi2","arguments":{"image_url":"https://example.com/file"}}}
801
- ```
802
-
803
- <a id="ocr-identi3"></a>
804
-
805
- ### `ocr_identi3` — 여권 텍스트 추출(OCR)
806
-
807
- Extract key fields from a passport image via OCR.
808
-
809
- 여권 사진에서 이름, 여권번호, 발급일자, 만료일자, 생년월일 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
810
-
811
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
812
-
813
- | Parameter | Type | Required | Description 설명 |
814
- | --- | --- | --- | --- |
815
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
816
-
817
- ```json
818
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr_identi3","arguments":{"image_url":"https://example.com/file"}}}
819
- ```
820
-
821
- <a id="ocr-identi4"></a>
822
-
823
- ### `ocr_identi4` — 주민등록등본 텍스트 추출(OCR)
824
-
825
- Extract key fields from a Korean certified copy of resident registration (deungbon) image via OCR.
826
-
827
- 주민등록등본 사진에서 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
828
-
829
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
830
-
831
- | Parameter | Type | Required | Description 설명 |
832
- | --- | --- | --- | --- |
833
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
834
-
835
- ```json
836
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr_identi4","arguments":{"image_url":"https://example.com/file"}}}
837
- ```
838
-
839
- <a id="ocr-identi5"></a>
840
-
841
- ### `ocr_identi5` — 외국인등록증 텍스트 추출(OCR)
842
-
843
- Extract key fields from a Korean alien registration card (residence card) image via OCR.
844
-
845
- 외국인등록증 사진에서 이름, 외국인등록번호, 발급일자 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
846
-
847
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
848
-
849
- | Parameter | Type | Required | Description 설명 |
850
- | --- | --- | --- | --- |
851
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
852
-
853
- ```json
854
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr_identi5","arguments":{"image_url":"https://example.com/file"}}}
855
- ```
856
-
857
- ---
858
-
859
- <a id="finance"></a>
860
-
861
- ## Finance · 금융 · 계좌확인
862
-
863
- `https://apick.app/mcp/finance` — 3 tools
864
-
865
- Korean bank account holder lookup and 1 KRW deposit verification.
866
-
867
- 계좌 예금주 실명조회와 1원 인증.
868
-
869
- | Tool | 기능 | Required 필수 |
870
- | --- | --- | --- |
871
- | [`transfer_1won`](#transfer-1won) | 1원 인증 | `account_num` |
872
- | [`account_realname`](#account-realname) | 계좌 예금주 실명 조회 | `account_num` |
873
- | [`bank_code`](#bank-code) | 은행코드 조회 | — |
874
-
875
- <a id="transfer-1won"></a>
876
-
877
- ### `transfer_1won` — 1원 인증
878
-
879
- Send a 1 KRW verification deposit to a Korean bank account and return the 4-character verification code printed on the transaction.
880
-
881
- 대한민국 은행 계좌로 1원을 입금해 적요에 표시되는 인증코드를 반환합니다. 계좌 실소유 확인(1원 인증) 절차에 사용합니다. bank_code 또는 bank_name 중 하나는 입력해야 합니다.
882
-
883
- > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `finance`
884
-
885
- | Parameter | Type | Required | Description 설명 |
886
- | --- | --- | --- | --- |
887
- | `account_num` | `string` | **필수 / required** | 계좌번호 (숫자만, 하이픈 제외) |
888
- | `bank_code` | `string` | 선택 / optional | 은행 코드 (bank_code Tool로 조회 가능, 예: 004) |
889
- | `bank_name` | `string` | 선택 / optional | 은행명 (예: 국민). bank_code 대신 입력 가능 |
890
-
891
- ```json
892
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"transfer_1won","arguments":{"account_num":"<account_num>"}}}
893
- ```
894
-
895
- <a id="account-realname"></a>
896
-
897
- ### `account_realname` — 계좌 예금주 실명 조회
898
-
899
- Look up the account holder name of a Korean bank account.
900
-
901
- 대한민국 은행 계좌의 예금주명을 조회합니다. 송금 전 예금주 확인 등에 사용합니다. bank_code 또는 bank_name 중 하나는 입력해야 합니다.
902
-
903
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `finance`
904
-
905
- | Parameter | Type | Required | Description 설명 |
906
- | --- | --- | --- | --- |
907
- | `account_num` | `string` | **필수 / required** | 계좌번호 (숫자만, 하이픈 제외) |
908
- | `bank_code` | `string` | 선택 / optional | 은행 코드 (bank_code Tool로 조회 가능, 예: 004) |
909
- | `bank_name` | `string` | 선택 / optional | 은행명 (예: 국민). bank_code 대신 입력 가능 |
910
-
911
- ```json
912
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"account_realname","arguments":{"account_num":"<account_num>"}}}
913
- ```
914
-
915
- <a id="bank-code"></a>
916
-
917
- ### `bank_code` — 은행코드 조회
918
-
919
- List Korean bank codes and names.
920
-
921
- 대한민국 은행 코드·은행명 전체 목록을 반환합니다. transfer_1won, account_realname Tool의 bank_code 입력값을 찾을 때 사용합니다. 무료입니다.
922
-
923
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `finance`
924
-
925
- _No parameters. 파라미터 없음._
926
-
927
- ```json
928
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bank_code","arguments":{}}}
929
- ```
930
-
931
- ---
932
-
933
- <a id="web"></a>
934
-
935
- ## Web & Search · 웹 · 검색
936
-
937
- `https://apick.app/mcp/web` — 13 tools
938
-
939
- Domain and IP intelligence, WHOIS, page capture, Google search, and YouTube.
940
-
941
- 도메인·IP 조회, WHOIS, 웹페이지 수집, 구글 검색, 유튜브.
942
-
943
- | Tool | 기능 | Required 필수 |
944
- | --- | --- | --- |
945
- | [`nslookup`](#nslookup) | 도메인으로 IP 조회 | `domain` |
946
- | [`reverse_ip`](#reverse-ip) | IP로 도메인 조회 | `ip` |
947
- | [`location`](#location) | 도메인/IP 위치 조회 | `address` |
948
- | [`ip_history`](#ip-history) | IP 변경 이력 조회 | `domain` |
949
- | [`whois`](#whois) | WHOIS 조회 | `address` |
950
- | [`url_html`](#url-html) | URL HTML 추출 | `url` |
951
- | [`url_screenshot`](#url-screenshot) | URL 화면캡처 | `url` |
952
- | [`url_similarity`](#url-similarity) | URL 유사도 비교 | `url1`, `url2` |
953
- | [`google_search`](#google-search) | 구글 키워드 검색 | `keyword` |
954
- | [`google_image_search`](#google-image-search) | 구글 이미지 검색(키워드로 검색) | `keyword` |
955
- | [`google_lens_search`](#google-lens-search) | 구글 렌즈 검색(이미지로 검색) | `image_url` |
956
- | [`crawl_youtube`](#crawl-youtube) | 유튜브 계정 정보 수집 | `user_id` |
957
- | [`download_youtube_video`](#download-youtube-video) | 유튜브 동영상 다운로드 | `url` |
958
-
959
- <a id="nslookup"></a>
960
-
961
- ### `nslookup` — 도메인으로 IP 조회
962
-
963
- Resolve a domain name to its currently registered IP addresses (DNS lookup).
964
-
965
- 도메인에 현재 등록된 IP 주소 목록을 조회합니다. 도메인 형식이 아닌 값은 오류로 응답합니다.
966
-
967
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
968
-
969
- | Parameter | Type | Required | Description 설명 |
970
- | --- | --- | --- | --- |
971
- | `domain` | `string` | **필수 / required** | 검색할 도메인 (예: apick.app) |
972
-
973
- ```json
974
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nslookup","arguments":{"domain":"<domain>"}}}
975
- ```
976
-
977
- <a id="reverse-ip"></a>
978
-
979
- ### `reverse_ip` — IP로 도메인 조회
980
-
981
- Reverse IP lookup: list domains that have been hosted on a given IP address.
982
-
983
- 특정 IP에 등록된 도메인 이력 정보를 조회합니다. IP 주소 형식만 허용됩니다.
984
-
985
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
986
-
987
- | Parameter | Type | Required | Description 설명 |
988
- | --- | --- | --- | --- |
989
- | `ip` | `string` | **필수 / required** | 검색할 IP 주소 (예: 121.140.146.38) |
990
-
991
- ```json
992
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reverse_ip","arguments":{"ip":"<ip>"}}}
993
- ```
994
-
995
- <a id="location"></a>
996
-
997
- ### `location` — 도메인/IP 위치 조회
998
-
999
- Look up the geographic location of a domain or IP address.
1000
-
1001
- 도메인 또는 IP의 위치(지리 정보)를 조회합니다. 도메인을 입력하면 해당 도메인의 IP를 찾아 위치를 반환합니다.
1002
-
1003
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1004
-
1005
- | Parameter | Type | Required | Description 설명 |
1006
- | --- | --- | --- | --- |
1007
- | `address` | `string` | **필수 / required** | 검색할 도메인 또는 IP (예: apick.app) |
1008
-
1009
- ```json
1010
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"location","arguments":{"address":"<address>"}}}
1011
- ```
1012
-
1013
- <a id="ip-history"></a>
1014
-
1015
- ### `ip_history` — IP 변경 이력 조회
1016
-
1017
- Look up the historical IP address changes of a domain.
1018
-
1019
- 도메인에 대한 IP 주소 변경 이력 정보를 조회합니다. 최상위 도메인 기준으로 조회되며 하위 도메인은 추적되지 않습니다.
1020
-
1021
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1022
-
1023
- | Parameter | Type | Required | Description 설명 |
1024
- | --- | --- | --- | --- |
1025
- | `domain` | `string` | **필수 / required** | 검색할 도메인 (예: apick.app) |
1026
-
1027
- ```json
1028
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ip_history","arguments":{"domain":"<domain>"}}}
1029
- ```
1030
-
1031
- <a id="whois"></a>
1032
-
1033
- ### `whois` — WHOIS 조회
1034
-
1035
- WHOIS lookup for a domain or IP address, returning registration and ownership information.
1036
-
1037
- 특정 도메인 또는 IP의 WHOIS(등록·소유) 정보를 조회합니다. .kr/.한국 도메인, 국내 IP, AS번호(예: AS9318)는 KISA/KRNIC 원본 정보로 조회됩니다.
1038
-
1039
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1040
-
1041
- | Parameter | Type | Required | Description 설명 |
1042
- | --- | --- | --- | --- |
1043
- | `address` | `string` | **필수 / required** | 검색할 도메인 또는 IP (예: apick.app) |
1044
-
1045
- ```json
1046
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whois","arguments":{"address":"<address>"}}}
1047
- ```
1048
-
1049
- <a id="url-html"></a>
1050
-
1051
- ### `url_html` — URL HTML 추출
1052
-
1053
- Fetch a web page and return its rendered HTML source.
1054
-
1055
- 입력한 URL의 페이지를 열어 HTML을 추출해 반환합니다. 자바스크립트 렌더링이 필요한 페이지도 처리됩니다.
1056
-
1057
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1058
-
1059
- | Parameter | Type | Required | Description 설명 |
1060
- | --- | --- | --- | --- |
1061
- | `url` | `string` | **필수 / required** | 페이지 URL (예: https://apick.app) |
1062
-
1063
- ```json
1064
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"url_html","arguments":{"url":"<url>"}}}
1065
- ```
1066
-
1067
- <a id="url-screenshot"></a>
1068
-
1069
- ### `url_screenshot` — URL 화면캡처
1070
-
1071
- Capture a screenshot of a web page and return it as a JPEG image.
1072
-
1073
- 입력한 URL의 화면을 캡처해 JPEG 이미지로 반환합니다.
1074
-
1075
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1076
-
1077
- | Parameter | Type | Required | Description 설명 |
1078
- | --- | --- | --- | --- |
1079
- | `url` | `string` | **필수 / required** | 페이지 URL (예: https://www.naver.com/) |
1080
-
1081
- ```json
1082
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"url_screenshot","arguments":{"url":"<url>"}}}
1083
- ```
1084
-
1085
- <a id="url-similarity"></a>
1086
-
1087
- ### `url_similarity` — URL 유사도 비교
1088
-
1089
- Compare two web pages and judge how similar they are.
1090
-
1091
- 입력한 두 사이트 페이지의 유사 여부를 분석해 유사도 결과를 반환합니다. 피싱·복제 사이트 판별 등에 활용할 수 있습니다.
1092
-
1093
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1094
-
1095
- | Parameter | Type | Required | Description 설명 |
1096
- | --- | --- | --- | --- |
1097
- | `url1` | `string` | **필수 / required** | 비교할 첫 번째 페이지 URL |
1098
- | `url2` | `string` | **필수 / required** | 비교할 두 번째 페이지 URL |
1099
-
1100
- ```json
1101
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"url_similarity","arguments":{"url1":"<url1>","url2":"<url2>"}}}
1102
- ```
1103
-
1104
- <a id="google-search"></a>
1105
-
1106
- ### `google_search` — 구글 키워드 검색
1107
-
1108
- Google keyword search: return web search results (link, title, snippet) for a keyword.
1109
-
1110
- 특정 키워드의 구글 검색 결과(링크·제목·요약)를 조회합니다. page 로 결과 페이지를 넘겨 가며 조회할 수 있습니다.
1111
-
1112
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1113
-
1114
- | Parameter | Type | Required | Description 설명 |
1115
- | --- | --- | --- | --- |
1116
- | `keyword` | `string` | **필수 / required** | 검색할 키워드 |
1117
- | `page` | `string` | 선택 / optional | 검색 결과 조회 페이지 (기본값 1) |
1118
-
1119
- ```json
1120
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"google_search","arguments":{"keyword":"<keyword>"}}}
1121
- ```
1122
-
1123
- <a id="google-image-search"></a>
1124
-
1125
- ### `google_image_search` — 구글 이미지 검색(키워드로 검색)
1126
-
1127
- Google image search by keyword: return image results (image URL, source link, title).
1128
-
1129
- 특정 키워드의 구글 이미지 검색 결과(이미지 URL·출처 링크·제목)를 조회합니다. page 로 결과 페이지를 넘겨 가며 조회할 수 있습니다.
1130
-
1131
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1132
-
1133
- | Parameter | Type | Required | Description 설명 |
1134
- | --- | --- | --- | --- |
1135
- | `keyword` | `string` | **필수 / required** | 검색할 키워드 |
1136
- | `page` | `string` | 선택 / optional | 검색 결과 조회 페이지 (기본값 1) |
1137
-
1138
- ```json
1139
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"google_image_search","arguments":{"keyword":"<keyword>"}}}
1140
- ```
1141
-
1142
- <a id="google-lens-search"></a>
1143
-
1144
- ### `google_lens_search` — 구글 렌즈 검색(이미지로 검색)
1145
-
1146
- Reverse image search: upload an image and get visually matching web pages and labels.
1147
-
1148
- 이미지 파일을 업로드해 해당 이미지와 관련된 웹 페이지(링크·이미지·텍스트)와 라벨을 조회합니다. 이미지 형식 파일만 허용됩니다.
1149
-
1150
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1151
-
1152
- | Parameter | Type | Required | Description 설명 |
1153
- | --- | --- | --- | --- |
1154
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, image/webp, image/gif, image/bmp, 최대 25MB |
1155
-
1156
- ```json
1157
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"google_lens_search","arguments":{"image_url":"https://example.com/file"}}}
1158
- ```
1159
-
1160
- <a id="crawl-youtube"></a>
1161
-
1162
- ### `crawl_youtube` — 유튜브 계정 정보 수집
1163
-
1164
- Collect a YouTube channel profile and its latest uploaded videos.
1165
-
1166
- 유튜브 계정(채널) 정보와 최근 게시한 동영상 정보를 수집해 반환합니다.
1167
-
1168
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1169
-
1170
- | Parameter | Type | Required | Description 설명 |
1171
- | --- | --- | --- | --- |
1172
- | `user_id` | `string` | **필수 / required** | 수집할 유튜브 사용자(채널) 아이디 (예: CNN) |
1173
-
1174
- ```json
1175
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"crawl_youtube","arguments":{"user_id":"<user_id>"}}}
1176
- ```
1177
-
1178
- <a id="download-youtube-video"></a>
1179
-
1180
- ### `download_youtube_video` — 유튜브 동영상 다운로드
1181
-
1182
- Download a publicly available YouTube video and return it as an MP4 file.
1183
-
1184
- 유튜브에 공개된 동영상을 MP4 파일로 다운로드해 반환합니다. 비공개·차단된 게시글은 실패로 응답합니다.
1185
-
1186
- > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1187
-
1188
- | Parameter | Type | Required | Description 설명 |
1189
- | --- | --- | --- | --- |
1190
- | `url` | `string` | **필수 / required** | 유튜브 게시글 URL (예: https://www.youtube.com/watch?v=...) |
1191
-
1192
- ```json
1193
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"download_youtube_video","arguments":{"url":"<url>"}}}
1194
- ```
1195
-
1196
- ---
1197
-
1198
- <a id="convert"></a>
1199
-
1200
- ## File Conversion · 파일 변환 · 워터마크
1201
-
1202
- `https://apick.app/mcp/convert` — 19 tools
1203
-
1204
- PDF, DOCX, Excel, speech-to-text, asynchronous TTS jobs, and watermarking.
1205
-
1206
- PDF·DOCX·엑셀 변환, 음성인식(STT), 비동기 TTS, 워터마크.
1207
-
1208
- | Tool | 기능 | Required 필수 |
1209
- | --- | --- | --- |
1210
- | [`stt`](#stt) | 오디오 텍스트 변환(STT) | `audio_url` |
1211
- | [`tts_jobs_create`](#tts-jobs-create) | TTS 작업 접수 | `voice_id`, `text` |
1212
- | [`tts_jobs_status`](#tts-jobs-status) | TTS 작업 상태 조회 | `job_id` |
1213
- | [`tts_jobs_cancel`](#tts-jobs-cancel) | TTS 대기·생성 중 작업 취소 | `job_id` |
1214
- | [`tts_jobs_result`](#tts-jobs-result) | TTS 결과 1회 다운로드 | `job_id` |
1215
- | [`tts_jobs_subtitles`](#tts-jobs-subtitles) | TTS ASS 자막 1회 다운로드 | `job_id` |
1216
- | [`voice_change`](#voice-change) | 음성 변조 | `type`, `media_url` |
1217
- | [`face_blur`](#face-blur) | 얼굴 모자이크 처리 | `image_url` |
1218
- | [`pdf_to_docx`](#pdf-to-docx) | PDF 파일 DOCX 변환 | `pdf_url` |
1219
- | [`pdf_to_image`](#pdf-to-image) | PDF 파일 이미지 변환 | `pdf_url` |
1220
- | [`pdf_merge`](#pdf-merge) | PDF 파일 합치기 | `pdf_url_1`, `pdf_url_2` |
1221
- | [`html_to_pdf`](#html-to-pdf) | HTML PDF 변환 | `html` |
1222
- | [`docx_to_pdf`](#docx-to-pdf) | DOCX 파일을 PDF 파일로 변환 | `docx_url` |
1223
- | [`json_to_excel`](#json-to-excel) | JSON 데이터 EXCEL 파일 변환 | `data_list` |
1224
- | [`base64_to_image`](#base64-to-image) | base64 이미지 변환 | `base64` |
1225
- | [`set_watermark`](#set-watermark) | 비가시성 워터마크 삽입 | `code`, `image_url` |
1226
- | [`get_watermark`](#get-watermark) | 비가시성 워터마크 조회 | `image_url` |
1227
- | [`draw_watermark_pdf`](#draw-watermark-pdf) | PDF 워터마크 삽입 | `wm`, `pdf_url` |
1228
- | [`draw_watermark_image`](#draw-watermark-image) | Image 워터마크 삽입 | `wm`, `image_url` |
1229
-
1230
- <a id="stt"></a>
1231
-
1232
- ### `stt` — 오디오 텍스트 변환(STT)
1233
-
1234
- Convert a speech audio file to text (STT).
1235
-
1236
- 음성 파일을 텍스트로 변환합니다. MP3, WAV, M4A, AAC, OGG, FLAC, WEBM 등 일반적인 오디오 포맷을 지원하며, 변환된 텍스트를 JSON으로 반환합니다.
1237
-
1238
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1239
-
1240
- | Parameter | Type | Required | Description 설명 |
1241
- | --- | --- | --- | --- |
1242
- | `language` | `string` | 선택 / optional | 추출 언어 코드 (예: ko, en, ja). 기본값 ko |
1243
- | `audio_url` | `string` (file) | **필수 / required** | https URL, audio/mpeg, audio/mp3, audio/wav, audio/x-wav, audio/mp4, audio/aac, audio/ogg, audio/flac, audio/webm, 최대 200MB |
1244
-
1245
- ```json
1246
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"stt","arguments":{"audio_url":"https://example.com/file"}}}
1247
- ```
1248
-
1249
- <a id="tts-jobs-create"></a>
1250
-
1251
- ### `tts_jobs_create` — TTS 작업 접수
1252
-
1253
- 17개 중립 내레이션 목소리 중 하나로 유료 비동기 TTS 작업을 접수합니다. 접수 성공 시 즉시 과금되며 취소해도 환불되지 않습니다. `text`는 최대 800자입니다.
1254
-
1255
- 표시 이름: `narrator_m_01` 태준, `narrator_m_02` 민석, `narrator_m_03` 도현, `narrator_m_04` 강우, `narrator_m_05` 성훈, `narrator_f_10s_01` 서아, `narrator_f_10s_02` 하린, `narrator_f_10s_03` 예린, `narrator_m_20s_01` 도윤, `narrator_f_20s_01` 지안, `narrator_f_20s_02` 서윤, `narrator_f_20s_03` 소연, `narrator_f_20s_04` 유나, `narrator_m_30s_01` 현우, `narrator_m_30s_02` 준혁, `narrator_m_40s_01` 정우, `narrator_m_80s_01` 영수.
1256
-
1257
- > **부작용 있음 / has side effects** · 접수 시 과금 / charged on acceptance · server `convert`
1258
-
1259
- | Parameter | Type | Required | Description 설명 |
1260
- | --- | --- | --- | --- |
1261
- | `voice_id` | `string` | **필수 / required** | 지원 `voice_id`. `narrator_m_01`–`05`, `narrator_f_10s_01`–`03`, `narrator_m_20s_01`, `narrator_f_20s_01`–`04`, `narrator_m_30s_01`–`02`, `narrator_m_40s_01`, `narrator_m_80s_01` |
1262
- | `text` | `string` | **필수 / required** | 합성할 한국어 텍스트, 최대 800자 |
1263
-
1264
- ```json
1265
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"tts_jobs_create","arguments":{"voice_id":"narrator_m_03","text":"오늘의 이야기를 시작합니다."}}}
1266
- ```
1267
-
1268
- <a id="tts-jobs-status"></a>
1269
-
1270
- ### `tts_jobs_status` — TTS 작업 상태 조회
1271
-
1272
- 작업의 `waiting`, `processing`, `completed`, `cancelled`, `failed` 공개 상태와 결과 준비 여부를 조회합니다. 추가 과금은 없습니다.
1273
-
1274
- > 읽기 전용 / read-only · server `convert`
1275
-
1276
- | Parameter | Type | Required | Description 설명 |
1277
- | --- | --- | --- | --- |
1278
- | `job_id` | `string` | **필수 / required** | 작업 접수에서 받은 32자리 ID |
1279
-
1280
- ```json
1281
- {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"tts_jobs_status","arguments":{"job_id":"<job_id>"}}}
1282
- ```
1283
-
1284
- <a id="tts-jobs-cancel"></a>
1285
-
1286
- ### `tts_jobs_cancel` — TTS 대기·생성 중 작업 취소
1287
-
1288
- `waiting` 또는 `processing` 상태에서 취소할 수 있으며 접수 시 과금된 금액은 환불되지 않습니다.
1289
-
1290
- > **부작용 있음 / has side effects** · 환불 없음 / no refund · server `convert`
1291
-
1292
- | Parameter | Type | Required | Description 설명 |
1293
- | --- | --- | --- | --- |
1294
- | `job_id` | `string` | **필수 / required** | 취소할 32자리 ID |
1295
-
1296
- ```json
1297
- {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"tts_jobs_cancel","arguments":{"job_id":"<job_id>"}}}
1298
- ```
1299
-
1300
- <a id="tts-jobs-result"></a>
1301
-
1302
- ### `tts_jobs_result` — TTS 결과 1회 다운로드
1303
-
1304
- 완료된 MP3(`audio/mpeg`) 결과를 base64로 반환합니다. Tool 호출로 다운로드가 시작되는 즉시 서버 원본이 폐기되므로, 호출 실패나 전송 중단을 포함해 재다운로드할 수 없습니다. 결과를 받을 준비가 된 클라이언트에서 한 번만 호출하세요.
1305
-
1306
- > **파괴적 부작용 / destructive side effect** · 재실행 불가 / not idempotent · server `convert`
1307
-
1308
- | Parameter | Type | Required | Description 설명 |
1309
- | --- | --- | --- | --- |
1310
- | `job_id` | `string` | **필수 / required** | `completed` 상태인 32자리 ID |
1311
-
1312
- ```json
1313
- {"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"tts_jobs_result","arguments":{"job_id":"<job_id>"}}}
1314
- ```
1315
-
1316
- <a id="tts-jobs-subtitles"></a>
1317
-
1318
- ### `tts_jobs_subtitles` — TTS ASS 자막 1회 다운로드
1319
-
1320
- 완료된 ASS 타이밍 자막(`text/x-ass`)을 base64로 반환합니다. MP3와 별도의 1회용 원본이므로 MP3를 먼저 다운로드해도 자막을 한 번 받을 수 있습니다. Tool 호출로 자막 다운로드가 시작되는 즉시 자막 원본이 폐기되므로, 호출 실패나 전송 중단을 포함해 재다운로드할 수 없습니다.
1321
-
1322
- > **파괴적 부작용 / destructive side effect** · 재실행 불가 / not idempotent · server `convert`
1323
-
1324
- | Parameter | Type | Required | Description 설명 |
1325
- | --- | --- | --- | --- |
1326
- | `job_id` | `string` | **필수 / required** | `completed` 상태인 32자리 ID |
1327
-
1328
- ```json
1329
- {"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"tts_jobs_subtitles","arguments":{"job_id":"<job_id>"}}}
1330
- ```
1331
-
1332
- <a id="voice-change"></a>
1333
-
1334
- ### `voice_change` — 음성 변조
1335
-
1336
- Modulate the voice in a video or audio file to a lower or higher pitch.
1337
-
1338
- 동영상 또는 오디오 파일의 음성을 저음 또는 고음으로 변조합니다. MP3, WAV 등 오디오와 MP4, MOV 등 동영상 포맷을 지원하며, 변조된 파일을 반환합니다.
1339
-
1340
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1341
-
1342
- | Parameter | Type | Required | Description 설명 |
1343
- | --- | --- | --- | --- |
1344
- | `type` | `string` | **필수 / required** | 변조음 타입 (1: 저음, 2: 고음) |
1345
- | `media_url` | `string` (file) | **필수 / required** | https URL, audio/mpeg, audio/mp3, audio/wav, audio/x-wav, audio/mp4, audio/aac, audio/ogg, video/mp4, video/quicktime, video/x-msvideo, video/x-matroska, video/webm, 최대 200MB |
1346
-
1347
- ```json
1348
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"voice_change","arguments":{"type":"<type>","media_url":"https://example.com/file"}}}
1349
- ```
1350
-
1351
- <a id="face-blur"></a>
1352
-
1353
- ### `face_blur` — 얼굴 모자이크 처리
1354
-
1355
- Detect faces in an image and blur (mosaic) them.
1356
-
1357
- 이미지 파일에서 얼굴을 인식해 해당 영역을 모자이크 처리한 이미지(JPEG)를 반환합니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다.
1358
-
1359
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1360
-
1361
- | Parameter | Type | Required | Description 설명 |
1362
- | --- | --- | --- | --- |
1363
- | `threshold` | `number` | 선택 / optional | 얼굴 추출 민감도 (0 ~ 0.9, 기본값 0.5, 작을수록 민감하게 추출) |
1364
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, image/webp, image/bmp, 최대 25MB |
1365
-
1366
- ```json
1367
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"face_blur","arguments":{"image_url":"https://example.com/file"}}}
1368
- ```
1369
-
1370
- <a id="pdf-to-docx"></a>
1371
-
1372
- ### `pdf_to_docx` — PDF 파일 DOCX 변환
1373
-
1374
- Convert a PDF file to a DOCX (Word) file.
1375
-
1376
- PDF 파일을 DOCX 파일로 변환해 반환합니다. PDF 형식의 파일만 허용됩니다.
1377
-
1378
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1379
-
1380
- | Parameter | Type | Required | Description 설명 |
1381
- | --- | --- | --- | --- |
1382
- | `pdf_url` | `string` (file) | **필수 / required** | https URL, application/pdf, 최대 25MB |
1383
-
1384
- ```json
1385
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pdf_to_docx","arguments":{"pdf_url":"https://example.com/file"}}}
1386
- ```
1387
-
1388
- <a id="pdf-to-image"></a>
1389
-
1390
- ### `pdf_to_image` — PDF 파일 이미지 변환
1391
-
1392
- Convert each page of a PDF file to PNG images, returned as a ZIP archive.
1393
-
1394
- PDF 파일의 각 페이지를 PNG 이미지로 변환하고 ZIP 파일로 묶어 반환합니다. PDF 형식의 파일만 허용됩니다.
1395
-
1396
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1397
-
1398
- | Parameter | Type | Required | Description 설명 |
1399
- | --- | --- | --- | --- |
1400
- | `pdf_url` | `string` (file) | **필수 / required** | https URL, application/pdf, 최대 25MB |
1401
-
1402
- ```json
1403
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pdf_to_image","arguments":{"pdf_url":"https://example.com/file"}}}
1404
- ```
1405
-
1406
- <a id="pdf-merge"></a>
1407
-
1408
- ### `pdf_merge` — PDF 파일 합치기
1409
-
1410
- Merge two PDF files into one.
1411
-
1412
- 두 개의 PDF 파일을 순서대로 하나의 PDF 파일로 합쳐 반환합니다. PDF 형식의 파일만 허용됩니다.
1413
-
1414
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1415
-
1416
- | Parameter | Type | Required | Description 설명 |
1417
- | --- | --- | --- | --- |
1418
- | `pdf_url_1` | `string` (file) | **필수 / required** | https URL, application/pdf, 최대 25MB |
1419
- | `pdf_url_2` | `string` (file) | **필수 / required** | https URL, application/pdf, 최대 25MB |
1420
-
1421
- ```json
1422
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pdf_merge","arguments":{"pdf_url_1":"https://example.com/file","pdf_url_2":"https://example.com/file"}}}
1423
- ```
1424
-
1425
- <a id="html-to-pdf"></a>
1426
-
1427
- ### `html_to_pdf` — HTML PDF 변환
1428
-
1429
- Render HTML code into a PDF file.
1430
-
1431
- HTML 코드를 렌더링해 PDF 파일로 변환합니다. HTML 문자열을 입력하면 변환된 PDF 파일을 반환합니다.
1432
-
1433
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1434
-
1435
- | Parameter | Type | Required | Description 설명 |
1436
- | --- | --- | --- | --- |
1437
- | `html` | `string` | **필수 / required** | 변환할 HTML 코드 |
1438
- | `pagination` | `integer` | 선택 / optional | 페이지 번호 표시 여부 (0: 없음(기본값), 1: 표시) |
1439
-
1440
- ```json
1441
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"html_to_pdf","arguments":{"html":"<html>"}}}
1442
- ```
1443
-
1444
- <a id="docx-to-pdf"></a>
1445
-
1446
- ### `docx_to_pdf` — DOCX 파일을 PDF 파일로 변환
1447
-
1448
- Convert a DOCX (Word) file to a PDF file.
1449
-
1450
- DOCX 파일을 PDF 파일로 변환해 반환합니다. DOCX 형식의 파일만 허용됩니다.
1451
-
1452
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1453
-
1454
- | Parameter | Type | Required | Description 설명 |
1455
- | --- | --- | --- | --- |
1456
- | `docx_url` | `string` (file) | **필수 / required** | https URL, application/vnd.openxmlformats-officedocument.wordprocessingml.document, 최대 25MB |
1457
-
1458
- ```json
1459
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"docx_to_pdf","arguments":{"docx_url":"https://example.com/file"}}}
1460
- ```
1461
-
1462
- <a id="json-to-excel"></a>
1463
-
1464
- ### `json_to_excel` — JSON 데이터 EXCEL 파일 변환
1465
-
1466
- Convert JSON data into an Excel (XLSX) file.
1467
-
1468
- JSON 데이터를 EXCEL(XLSX) 파일로 변환해 반환합니다. data_list 는 객체 배열([{"컬럼":"값", ...}, ...]) 또는 2차원 배열([[...], ...]) 형식을 지원합니다.
1469
-
1470
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1471
-
1472
- | Parameter | Type | Required | Description 설명 |
1473
- | --- | --- | --- | --- |
1474
- | `data_list` | `array` | **필수 / required** | 변환할 데이터 목록. 객체 배열 또는 2차원 배열 (2차원 배열은 모든 행의 열 개수가 같아야 함) |
1475
- | `sheet_name` | `string` | 선택 / optional | 엑셀 시트 이름 |
1476
-
1477
- ```json
1478
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"json_to_excel","arguments":{"data_list":"<data_list>"}}}
1479
- ```
1480
-
1481
- <a id="base64-to-image"></a>
1482
-
1483
- ### `base64_to_image` — base64 이미지 변환
1484
-
1485
- Decode a base64-encoded image string back into an image file.
1486
-
1487
- base64 로 인코딩된 이미지 문자열을 원본 이미지 파일로 디코딩해 반환합니다. "data:image/타입;base64," 접두어가 붙은 문자열도 허용됩니다.
1488
-
1489
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1490
-
1491
- | Parameter | Type | Required | Description 설명 |
1492
- | --- | --- | --- | --- |
1493
- | `base64` | `string` | **필수 / required** | 이미지 base64 문자열 (data:image/타입;base64, 접두어 허용) |
1494
-
1495
- ```json
1496
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"base64_to_image","arguments":{"base64":"<base64>"}}}
1497
- ```
1498
-
1499
- <a id="set-watermark"></a>
1500
-
1501
- ### `set_watermark` — 비가시성 워터마크 삽입
1502
-
1503
- Embed an invisible watermark code into an image.
1504
-
1505
- 원본 이미지에 보이지 않는 워터마크 코드를 삽입한 PNG 이미지를 반환합니다. 이미지가 일부 변형되어도 높은 확률로 워터마크를 확인할 수 있습니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다.
1506
-
1507
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1508
-
1509
- | Parameter | Type | Required | Description 설명 |
1510
- | --- | --- | --- | --- |
1511
- | `code` | `integer` | **필수 / required** | 삽입할 워터마크 코드 (1 ~ 21,767,823,359 사이의 숫자) |
1512
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, image/webp, image/bmp, 최대 25MB |
1513
-
1514
- ```json
1515
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_watermark","arguments":{"code":1,"image_url":"https://example.com/file"}}}
1516
- ```
1517
-
1518
- <a id="get-watermark"></a>
1519
-
1520
- ### `get_watermark` — 비가시성 워터마크 조회
1521
-
1522
- Read the invisible watermark code embedded in an image.
1523
-
1524
- 이미지에 삽입된 비가시성 워터마크 코드를 조회해 JSON 으로 반환합니다. 이미지가 일부 변형되어도 높은 확률로 워터마크를 확인할 수 있습니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다.
1525
-
1526
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1527
-
1528
- | Parameter | Type | Required | Description 설명 |
1529
- | --- | --- | --- | --- |
1530
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, image/webp, image/bmp, 최대 25MB |
1531
-
1532
- ```json
1533
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_watermark","arguments":{"image_url":"https://example.com/file"}}}
1534
- ```
1535
-
1536
- <a id="draw-watermark-pdf"></a>
1537
-
1538
- ### `draw_watermark_pdf` — PDF 워터마크 삽입
1539
-
1540
- Draw a visible text watermark across every page of a PDF file.
1541
-
1542
- PDF 파일 전체 페이지에 텍스트 워터마크를 삽입한 PDF 를 반환합니다. 글자 크기·색상·투명도·각도·밀집도·적용 영역을 조절할 수 있으며, PDF 형식의 파일만 허용됩니다.
1543
-
1544
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1545
-
1546
- | Parameter | Type | Required | Description 설명 |
1547
- | --- | --- | --- | --- |
1548
- | `wm` | `string` | **필수 / required** | 워터마크 문자열 (최대 30자) |
1549
- | `font_size` | `integer` | 선택 / optional | 워터마크 글자 크기 (8 ~ 30, 기본값 10) |
1550
- | `color` | `string` | 선택 / optional | 워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE) |
1551
- | `opacity` | `number` | 선택 / optional | 워터마크 투명도 (0 ~ 1, 기본값 0.05) |
1552
- | `angle` | `integer` | 선택 / optional | 워터마크 각도 (0 ~ 360, 기본값 35) |
1553
- | `density` | `integer` | 선택 / optional | 워터마크 글자 밀집도 (100 ~ 200, 기본값 150) |
1554
- | `width` | `integer` | 선택 / optional | 워터마크 적용 너비 (0 ~ 2000, 기본값 550, A4 기준) |
1555
- | `height` | `integer` | 선택 / optional | 워터마크 적용 높이 (0 ~ 2000, 기본값 800, A4 기준) |
1556
- | `pdf_url` | `string` (file) | **필수 / required** | https URL, application/pdf, 최대 25MB |
1557
-
1558
- ```json
1559
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"draw_watermark_pdf","arguments":{"wm":"<wm>","pdf_url":"https://example.com/file"}}}
1560
- ```
1561
-
1562
- <a id="draw-watermark-image"></a>
1563
-
1564
- ### `draw_watermark_image` — Image 워터마크 삽입
1565
-
1566
- Draw a visible text watermark across an image.
1567
-
1568
- 이미지 파일에 텍스트 워터마크를 삽입한 PNG 이미지를 반환합니다. 글자 크기·색상·투명도·밀집도를 조절할 수 있으며, PNG, JPEG 등 일반 이미지 포맷을 지원합니다.
1569
-
1570
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1571
-
1572
- | Parameter | Type | Required | Description 설명 |
1573
- | --- | --- | --- | --- |
1574
- | `wm` | `string` | **필수 / required** | 워터마크 문자열 (최대 30자) |
1575
- | `font_size` | `integer` | 선택 / optional | 워터마크 글자 크기 (10 ~ 100, 기본값 10) |
1576
- | `color` | `string` | 선택 / optional | 워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE) |
1577
- | `opacity` | `number` | 선택 / optional | 워터마크 투명도 (0 ~ 1, 기본값 0.5) |
1578
- | `density` | `integer` | 선택 / optional | 워터마크 글자 밀집도 (5 ~ 15, 기본값 10) |
1579
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, image/webp, image/bmp, 최대 25MB |
1580
-
1581
- ```json
1582
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"draw_watermark_image","arguments":{"wm":"<wm>","image_url":"https://example.com/file"}}}
1583
- ```
1584
-
1585
- ---
1586
-
1587
- <a id="vision"></a>
1588
-
1589
- ## Vision · 이미지 · 영상 분석
1590
-
1591
- `https://apick.app/mcp/vision` — 6 tools
1592
-
1593
- Face detection, image similarity, NSFW detection, and video extraction.
1594
-
1595
- 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출.
1596
-
1597
- | Tool | 기능 | Required 필수 |
1598
- | --- | --- | --- |
1599
- | [`nsfw_detection`](#nsfw-detection) | 선정적인 컨텐츠(NSFW) 탐지 | `image_url` |
1600
- | [`image_similarity`](#image-similarity) | 이미지 유사도 비교 | `image_url`, `compare_image_url` |
1601
- | [`video_to_mp3`](#video-to-mp3) | 동영상 MP3 추출 | `video_url` |
1602
- | [`extract_video_thumbnail`](#extract-video-thumbnail) | 동영상 미리보기 이미지 추출 | `video_url` |
1603
- | [`word_cloud`](#word-cloud) | 워드클라우드 생성 | `text` |
1604
- | [`face_detection`](#face-detection) | 이미지 얼굴 인식 | `image_url` |
1605
-
1606
- <a id="nsfw-detection"></a>
1607
-
1608
- ### `nsfw_detection` — 선정적인 컨텐츠(NSFW) 탐지
1609
-
1610
- Detect whether an image contains NSFW (violent or sexually explicit) content and return an nsfw_score.
1611
-
1612
- 이미지가 NSFW(폭력적·선정적) 콘텐츠인지 탐지해 nsfw_score 를 반환합니다. detail=1 입력 시 세부 판정 결과를 함께 반환합니다.
1613
-
1614
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1615
-
1616
- | Parameter | Type | Required | Description 설명 |
1617
- | --- | --- | --- | --- |
1618
- | `detail` | `string` | 선택 / optional | 세부 판정 결과 포함 여부 (포함: 1, 미포함: 0, 기본값 0) |
1619
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, image/webp, image/bmp, 최대 25MB |
1620
-
1621
- ```json
1622
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nsfw_detection","arguments":{"image_url":"https://example.com/file"}}}
1623
- ```
1624
-
1625
- <a id="image-similarity"></a>
1626
-
1627
- ### `image_similarity` — 이미지 유사도 비교
1628
-
1629
- Compare a base image with another image and return a similarity score.
1630
-
1631
- 기준 이미지와 비교 대상 이미지의 유사도를 분석해 점수를 반환합니다. 원본 검증, 중복 이미지 탐지 등에 사용합니다.
1632
-
1633
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1634
-
1635
- | Parameter | Type | Required | Description 설명 |
1636
- | --- | --- | --- | --- |
1637
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, image/webp, image/bmp, 최대 25MB |
1638
- | `compare_image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, image/webp, image/bmp, 최대 25MB |
1639
-
1640
- ```json
1641
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"image_similarity","arguments":{"image_url":"https://example.com/file","compare_image_url":"https://example.com/file"}}}
1642
- ```
1643
-
1644
- <a id="video-to-mp3"></a>
1645
-
1646
- ### `video_to_mp3` — 동영상 MP3 추출
1647
-
1648
- Extract the audio track of a video file as an MP3 file.
1649
-
1650
- 동영상 파일에서 오디오를 추출해 MP3 파일로 반환합니다.
1651
-
1652
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1653
-
1654
- | Parameter | Type | Required | Description 설명 |
1655
- | --- | --- | --- | --- |
1656
- | `video_url` | `string` (file) | **필수 / required** | https URL, video/mp4, video/quicktime, video/x-msvideo, video/webm, video/x-matroska, 최대 200MB |
1657
-
1658
- ```json
1659
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"video_to_mp3","arguments":{"video_url":"https://example.com/file"}}}
1660
- ```
1661
-
1662
- <a id="extract-video-thumbnail"></a>
1663
-
1664
- ### `extract_video_thumbnail` — 동영상 미리보기 이미지 추출
1665
-
1666
- Extract preview thumbnail images from a video at regular intervals and return them as a ZIP file.
1667
-
1668
- 동영상에서 일정 구간마다 미리보기 이미지를 추출해 ZIP 파일로 반환합니다.
1669
-
1670
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1671
-
1672
- | Parameter | Type | Required | Description 설명 |
1673
- | --- | --- | --- | --- |
1674
- | `width` | `string` | 선택 / optional | 이미지 가로 길이 (범위: 100 ~ 2000, 기본값 480). 세로 길이는 가로 비율에 따라 자동 계산 |
1675
- | `count` | `string` | 선택 / optional | 추출할 이미지 개수 (범위: 0 ~ 200, 기본값 100) |
1676
- | `video_url` | `string` (file) | **필수 / required** | https URL, video/mp4, video/quicktime, video/x-msvideo, video/webm, video/x-matroska, 최대 200MB |
1677
-
1678
- ```json
1679
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"extract_video_thumbnail","arguments":{"video_url":"https://example.com/file"}}}
1680
- ```
1681
-
1682
- <a id="word-cloud"></a>
1683
-
1684
- ### `word_cloud` — 워드클라우드 생성
1685
-
1686
- Generate a word cloud image (JPEG) from input text, sizing each word by frequency.
1687
-
1688
- 입력 텍스트를 구성하는 단어의 중요도(빈도수)에 따라 서로 다른 크기의 단어로 이루어진 워드클라우드 이미지(JPEG)를 생성해 반환합니다.
1689
-
1690
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1691
-
1692
- | Parameter | Type | Required | Description 설명 |
1693
- | --- | --- | --- | --- |
1694
- | `text` | `string` | **필수 / required** | 워드클라우드를 생성할 텍스트 |
1695
-
1696
- ```json
1697
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"word_cloud","arguments":{"text":"<text>"}}}
1698
- ```
1699
-
1700
- <a id="face-detection"></a>
1701
-
1702
- ### `face_detection` — 이미지 얼굴 인식
1703
-
1704
- Detect faces in an image and return their coordinates.
1705
-
1706
- 이미지 파일에서 얼굴을 인식해 해당 좌표를 반환합니다. use_feature=1 입력 시 얼굴 특징 정보를 함께 반환합니다.
1707
-
1708
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1709
-
1710
- | Parameter | Type | Required | Description 설명 |
1711
- | --- | --- | --- | --- |
1712
- | `threshold` | `string` | 선택 / optional | 얼굴 추출 민감도 (범위: 0 ~ 0.9, 기본값 0.5, 높을수록 정확한 얼굴만 추출) |
1713
- | `use_feature` | `string` | 선택 / optional | 얼굴 특징 정보 포함 여부 (포함: 1, 미포함: 0, 기본값 0) |
1714
- | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, image/webp, image/bmp, 최대 25MB |
1715
-
1716
- ```json
1717
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"face_detection","arguments":{"image_url":"https://example.com/file"}}}
1718
- ```
1719
-
1720
- ---
1721
-
1722
- <a id="ai"></a>
1723
-
1724
- ## AI & LLM · AI · LLM
1725
-
1726
- `https://apick.app/mcp/ai` — 9 tools
1727
-
1728
- LLM chat across multiple models, text summarization, and polishing.
1729
-
1730
- LLM 챗(다중 모델), 텍스트 요약·교정.
1731
-
1732
- | Tool | 기능 | Required 필수 |
1733
- | --- | --- | --- |
1734
- | [`llm_models`](#llm-models) | LLM 모델 카탈로그 | — |
1735
- | [`llm_chat`](#llm-chat) | LLM 채팅 | `model` |
1736
- | [`text_summary`](#text-summary) | 텍스트 요약 AI | `text` |
1737
- | [`text_polish`](#text-polish) | 텍스트 다듬기 AI | `text` |
1738
- | `image_generate` | 텍스트 또는 참고 이미지와 텍스트로 이미지 한 장 생성 | `prompt`, `reference_image_url?`, `size?`, `output_format?`, `background?`, `idempotency_key?` |
1739
- | `image_edit` | 이미지 한 장 편집 | `image_url`, `prompt` 및 출력 옵션 |
1740
- | `image_batch_create` | 이미지 대량 작업 생성 | `mode`, `prompt`, `image_count`, 참고·편집 파일 및 출력 옵션 |
1741
- | `image_batch_status` | 대량 작업 상태 조회 | `job_id` |
1742
- | `image_batch_result` | 대량 작업 개별 결과 | `job_id`, `index` |
1743
-
1744
- 이미지 생성·편집은 한 장당 25포인트입니다. 작업 접수 시 요청 장수 전체 금액을 먼저 차감하고, 생성에 실패한 이미지가 있으면 해당 장수의 포인트를 즉시 환급합니다. 접수된 작업은 취소할 수 없습니다. `image_generate`에 `reference_image_url`을 더하면 참고 이미지의 구도·색감·제품 형태와 프롬프트를 함께 반영할 수 있습니다. 편집은 원본 이미지 한 장과 프롬프트만 받으며 마스크 파일은 지원하지 않습니다. 동기 Tool은 응답 크기를 위해 한 장만 반환하며, 대량 작업은 `image_count`에 1~50을 지정한 뒤 `image_batch_result`로 한 장씩 가져옵니다. 크기는 `1024x1024`, `1536x1024`, `1024x1536`, `1152x864`, `864x1152` 중에서 고릅니다. PNG·JPEG·WebP와 PNG/WebP 투명 배경 미리보기를 지원합니다. 프롬프트는 최대 28,000자이고 완료 결과는 24시간 동안 반복 조회할 수 있습니다. `idempotency_key`는 같은 요청의 중복 생성·과금을 막는 8~128자 안전번호이며, 동일 요청을 재전송할 때만 같은 값을 사용합니다.
1745
-
1746
- 예: `흰색 대리석 테이블 위의 무광 검정 텀블러, 부드러운 아침 자연광, 제품 전체가 프레임 안에 보이게, 이미지 안 글자 없음`처럼 피사체·배경·조명·구도·금지 요소를 구체적으로 적습니다. 글자를 넣을 때는 `상단 중앙에 '가을 산책'을 또렷한 짙은 남색 한글로, 다른 글자 없음`처럼 실제 문구와 위치를 함께 지정합니다.
1747
-
1748
- <a id="llm-models"></a>
1749
-
1750
- ### `llm_models` — LLM 모델 카탈로그
1751
-
1752
- List available text-generation LLM models with per-token pricing and max context.
1753
-
1754
- 텍스트 생성 모델 카탈로그를 반환합니다. 각 모델의 1M 토큰당 input/output 단가(포인트), 계열·크기·멀티모달 여부·태그·추천 용도(use_cases)·max_context 를 한 응답에 포함합니다. llm_chat Tool의 model 입력값을 찾을 때 사용합니다. 무료입니다.
1755
-
1756
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1757
-
1758
- | Parameter | Type | Required | Description 설명 |
1759
- | --- | --- | --- | --- |
1760
- | `family` | `string` | 선택 / optional | 모델 계열 필터 (deepseek, qwen, glm, google, nvidia, llama, mistral, gpt-oss, moonshot, seed, mimo, phi) |
1761
- | `tag` | `string` | 선택 / optional | 특수 태그 필터 — 'reasoning'(추론 특화) \| 'coder'(코딩 특화) |
1762
- | `use_case` | `string` | 선택 / optional | 추천 용도 필터 — 'general' \| 'reasoning' \| 'coding' \| 'multimodal' \| 'economy' |
1763
- | `multimodal` | `boolean` | 선택 / optional | 멀티모달(이미지 이해) 지원 여부 필터 (true/false) |
1764
-
1765
- ```json
1766
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"llm_models","arguments":{}}}
1767
- ```
1768
-
1769
- <a id="llm-chat"></a>
1770
-
1771
- ### `llm_chat` — LLM 채팅
1772
-
1773
- Send a chat request to a selected LLM model and receive the assistant reply.
1774
-
1775
- 선택한 LLM 모델에 대화를 보내고 assistant 응답을 받습니다. 서버는 대화 히스토리를 보관하지 않는 stateless 방식 — 매 호출마다 전체 히스토리를 messages 로 전송하고, 응답의 compacted_messages 를 다음 턴의 messages 로 그대로 재사용합니다. 사용 가능한 모델은 llm_models Tool로 조회합니다. 토큰 사용량에 비례해 포인트가 차감됩니다.
1776
-
1777
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1778
-
1779
- | Parameter | Type | Required | Description 설명 |
1780
- | --- | --- | --- | --- |
1781
- | `model` | `string` | **필수 / required** | 모델 id (`llm_models` Tool로 조회) |
1782
- | `messages` | `array` | 선택 / optional | 채팅 메시지 [{role, content}] 배열. role 은 'system'\|'user'\|'assistant'. content 와 둘 중 하나는 필수, 동시 지정 시 messages 우선. 멀티턴 대화는 응답의 compacted_messages 를 다음 턴에 그대로 전송 |
1783
- | `content` | `string` | 선택 / optional | 단발 입력 — 사용자 메시지 한 건만 보내는 간편 형태. messages 와 둘 중 하나는 필수 |
1784
- | `system` | `string` | 선택 / optional | system 프롬프트 (역할·페르소나·정책·배경지식). 미지정 시 기본 한국어 어시스턴트 프롬프트가 적용됩니다 |
1785
- | `compact` | `object` | 선택 / optional | 히스토리 압축 옵션 { strategy: 'none'(기본) \| 'sliding_window', window_pairs: 유지할 user/assistant 페어 수 (기본 10, 최소 1) }. 긴 대화의 input 토큰 누적 방지 |
1786
- | `temperature` | `number` | 선택 / optional | 출력 다양성 0.0~2.0. 낮을수록 재현성, 높을수록 창의성 (미지정 시 모델 기본값) |
1787
- | `max_tokens` | `integer` | 선택 / optional | 응답 최대 토큰. 미지정 시 모델 컨텍스트 기반 안전 상한으로 자동 설정, 상한 초과 지정 시 자동 조정 |
1788
- | `speed` | `string` | 선택 / optional | 응답 속도/추론 깊이 — 'fast'(얕게, 빠름) \| 'medium' \| 'slow'(깊게, 느림). 한글 '빠름'\|'중간'\|'느림' 허용. 추론 특화 모델에서 효과가 큽니다 |
1789
-
1790
- ```json
1791
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"llm_chat","arguments":{"model":"<model>"}}}
1792
- ```
1793
-
1794
- <a id="text-summary"></a>
1795
-
1796
- ### `text_summary` — 텍스트 요약 AI
1797
-
1798
- Summarize a long text (up to 100,000 characters) into a concise Korean summary.
1799
-
1800
- 입력 텍스트(최대 10만 자)의 핵심 내용을 간결하고 정확하게 요약합니다. 모델·파라미터는 서버가 고정하며 빠른 응답에 최적화되어 있습니다. 토큰 수와 무관하게 요청당 고정 포인트가 차감됩니다.
1801
-
1802
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1803
-
1804
- | Parameter | Type | Required | Description 설명 |
1805
- | --- | --- | --- | --- |
1806
- | `text` | `string` | **필수 / required** | 요약할 원문 텍스트 (최대 100,000자) |
1807
-
1808
- ```json
1809
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"text_summary","arguments":{"text":"<text>"}}}
1810
- ```
1811
-
1812
- <a id="text-polish"></a>
1813
-
1814
- ### `text_polish` — 텍스트 다듬기 AI
1815
-
1816
- Polish a text (up to 100,000 characters) by fixing grammar, spelling, and awkward phrasing.
1817
-
1818
- 입력 텍스트(최대 10만 자)의 문법 오류, 맞춤법·오타, 어색한 표현, 문장 순서를 의미를 유지한 채 자연스럽게 다듬습니다. 모델·파라미터는 서버가 고정하며 빠른 응답에 최적화되어 있습니다. 토큰 수와 무관하게 요청당 고정 포인트가 차감됩니다.
1819
-
1820
- > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1821
-
1822
- | Parameter | Type | Required | Description 설명 |
1823
- | --- | --- | --- | --- |
1824
- | `text` | `string` | **필수 / required** | 다듬을 원문 텍스트 (최대 100,000자) |
1825
-
1826
- ```json
1827
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"text_polish","arguments":{"text":"<text>"}}}
1828
- ```
1829
-
1830
- ---
1831
-
1832
- ## Pricing / 요금
1833
-
1834
- Prepaid points, charged per call, identical to the APICK REST API rate. No subscription, no per-seat fee. **Failed calls are not charged.** Each tool's live price is appended to its description in `tools/list`, so an agent sees the current cost before it calls.
1835
-
1836
- 포인트 선불, 호출당 차감이며 단가는 에이픽 REST API와 동일합니다. 구독료·좌석당 요금 없음. **실패한 호출은 과금되지 않습니다.** 각 Tool의 현재 단가는 `tools/list` 응답의 설명에 자동으로 붙으므로 AI가 호출 전에 비용을 보고 판단합니다.
1837
-
1838
- Current rates 단가표: <https://apick.app/dev_guide/mcp> · Sign up for 1,000 free points 가입 시 1,000포인트 무료: <https://apick.app>
1839
-
1840
- `tools/list`는 API Key와 허용 IP를 검사하지 않으며 실제 검증은 `tools/call`에서 수행됩니다. 마이페이지의 허용 IP 목록이 공란이면 IP 제한이 없고, 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(`/32` 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화나 대기시간은 없습니다.
1
+ # APICK MCP — Full Tool Catalog / 전체 Tool 목록
2
+
3
+ **97 tools** across **8 domain servers**, plus the combined `all` server.
4
+ **Tool 97개**, 분야별 서버 8개와 통합 서버 `all`.
5
+
6
+ Official site 공식 사이트: **<https://apick.app>** · Docs 연동 가이드: **<https://apick.app/dev_guide/mcp>**
7
+
8
+ Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for everything, or to one server to keep the tool list short.
9
+ 엔드포인트: `https://apick.app/mcp/{server}` — 전부 쓰려면 `all`, 특정 분야만 쓰려면 해당 서버에 연결하면 Tool 목록이 짧아집니다.
10
+
11
+ ## Index / 목차
12
+
13
+ | Server 서버 | Endpoint | Tools | Coverage 범위 |
14
+ | --- | --- | --- | --- |
15
+ | [Business & Commerce · 사업자 · 커머스](#business) | `/mcp/business` | 16 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사. |
16
+ | [Identity Verification · 신분증 진위확인 · 마스킹](#identity) | `/mcp/identity` | 16 | 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹. |
17
+ | [OCR · OCR 문자인식](#ocr) | `/mcp/ocr` | 6 | 이미지 텍스트 추출과 신분증 항목 추출. |
18
+ | [Finance · 금융 · 계좌확인](#finance) | `/mcp/finance` | 3 | 계좌 예금주 실명조회와 1원 인증. |
19
+ | [Web & Search · 웹 · 검색](#web) | `/mcp/web` | 13 | 도메인·IP 조회, WHOIS, 웹페이지 수집, 구글 검색, 유튜브. |
20
+ | [File Conversion · 파일 변환 · 워터마크](#convert) | `/mcp/convert` | 22 | PDF·DOCX·엑셀 변환, 음성인식(STT), 비동기 TTS, 워터마크. |
21
+ | [Vision · 이미지 · 영상 분석](#vision) | `/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출. |
22
+ | [AI & LLM · AI · LLM](#ai) | `/mcp/ai` | 15 | LLM 챗, 텍스트 도구, 이미지 생성·편집·대량 작업, 비동기 영상 생성. |
23
+ | **All 통합** | `/mcp/all` | **97** | 아래 전부 |
24
+
25
+ <details><summary><b>All 97 tool names / 전체 Tool 이름</b></summary>
26
+
27
+ `biz_detail` · `venture_biz_info` · `land_rt_price` · `req_pccc` · `get_pccc` · `check_pccc` · `get_car_flooding` · `get_car_scrap` · `parcel_tracking` · `parcel_tracking_auto` · `check_email_valid` · `check_phone_valid` · `check_spam_number` · `holiday_info` · `search_juso` · `info`
28
+
29
+ `identi_card1` · `identi_card2` · `identi_card3` · `identi_card4` · `identi_card5` · `identi_card_image1` · `identi_card_image2` · `identi_card_image3` · `identi_card_image4` · `identi_card_image5` · `name_rrn_auth` · `hide_rrn` · `identity_document_residence_card` · `identity_document_passport` · `identity_document_id_card` · `identity_document_driver_license`
30
+
31
+ `ocr` · `ocr_identi1` · `ocr_identi2` · `ocr_identi3` · `ocr_identi4` · `ocr_identi5`
32
+
33
+ `transfer_1won` · `account_realname` · `bank_code`
34
+
35
+ `nslookup` · `reverse_ip` · `location` · `ip_history` · `whois` · `url_html` · `url_screenshot` · `url_similarity` · `google_search` · `google_image_search` · `google_lens_search` · `crawl_youtube` · `download_youtube_video`
36
+
37
+ `stt` · `tts_jobs_create` · `tts_jobs_status` · `tts_jobs_cancel` · `tts_jobs_result` · `tts_jobs_subtitles` · `tts_jobs_quality` · `tts_jobs_retry` · `tts_jobs_candidate_audio` · `voice_change` · `face_blur` · `pdf_to_docx` · `pdf_to_image` · `pdf_merge` · `html_to_pdf` · `docx_to_pdf` · `json_to_excel` · `base64_to_image` · `set_watermark` · `get_watermark` · `draw_watermark_pdf` · `draw_watermark_image`
38
+
39
+ `nsfw_detection` · `image_similarity` · `video_to_mp3` · `extract_video_thumbnail` · `word_cloud` · `face_detection`
40
+
41
+ `llm_models` · `llm_chat` · `text_summary` · `text_polish` · `image_generate` · `image_edit` · `image_batch_create` · `image_batch_status` · `image_batch_result` · `seedance_jobs_create` · `seedance_jobs_status` · `veo_jobs_create` · `veo_jobs_status` · `kling_jobs_create` · `kling_jobs_status`
42
+
43
+ </details>
44
+
45
+ ---
46
+
47
+ <a id="business"></a>
48
+
49
+ ## Business & Commerce · 사업자 · 커머스
50
+
51
+ `https://apick.app/mcp/business` — 16 tools
52
+
53
+ Korean business registry, corporate credit, parcel tracking, real-estate prices, vehicle history, and input validation.
54
+
55
+ 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사.
56
+
57
+ | Tool | 기능 | Required 필수 |
58
+ | --- | --- | --- |
59
+ | [`biz_detail`](#biz-detail) | 사업자 정보 조회 | `biz_no` |
60
+ | [`venture_biz_info`](#venture-biz-info) | 벤처기업 정보조회 | `biz_no` |
61
+ | [`land_rt_price`](#land-rt-price) | 부동산 실거래가 조회 | `addr1`, `addr2`, `type`, `year` |
62
+ | [`req_pccc`](#req-pccc) | 개인통관고유부호 인증 요청 | `name`, `rrn1`, `rrn2`, `phone` |
63
+ | [`get_pccc`](#get-pccc) | 개인통관고유부호 조회 | `auth_key`, `answer` |
64
+ | [`check_pccc`](#check-pccc) | 개인통관부호 검증 | `name`, `pccc`, `zip`, `phone` |
65
+ | [`get_car_flooding`](#get-car-flooding) | 차량 침수차 여부 조회 | `type`, `value` |
66
+ | [`get_car_scrap`](#get-car-scrap) | 차량 폐차사고처리 여부 조회 | `type`, `value` |
67
+ | [`parcel_tracking`](#parcel-tracking) | 택배 배송조회 | `carrier`, `trackingNumber` |
68
+ | [`parcel_tracking_auto`](#parcel-tracking-auto) | 택배 배송조회(자동) | `trackingNumber` |
69
+ | [`check_email_valid`](#check-email-valid) | 이메일 유효성 검사 | `email` |
70
+ | [`check_phone_valid`](#check-phone-valid) | 전화번호 유효성 검사 | `number` |
71
+ | [`check_spam_number`](#check-spam-number) | 스팸/광고/범죄 전화번호 조회 | `number` |
72
+ | [`holiday_info`](#holiday-info) | 공휴일 조회 | `year`, `month` |
73
+ | [`search_juso`](#search-juso) | 도로명주소 조회 | `juso` |
74
+ | [`info`](#info) | 계정 정보 조회 | — |
75
+
76
+ <a id="biz-detail"></a>
77
+
78
+ ### `biz_detail` — 사업자 정보 조회
79
+
80
+ Look up general status information of a Korean business by its 10-digit business registration number.
81
+
82
+ 사업자등록번호로 해당 사업자의 일반 현황 정보(대표자, 주소, 직원수, 설립일, 업종, 업태, 종목, 연락처, 사업자상태, 과세유형 등)를 조회합니다.
83
+
84
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
85
+
86
+ | Parameter | Type | Required | Description 설명 |
87
+ | --- | --- | --- | --- |
88
+ | `biz_no` | `string` | **필수 / required** | 사업자등록번호 (숫자 10자리, 하이픈 제외, 예: 4398700761) |
89
+
90
+ ```json
91
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"biz_detail","arguments":{"biz_no":"<biz_no>"}}}
92
+ ```
93
+
94
+ <a id="venture-biz-info"></a>
95
+
96
+ ### `venture_biz_info` — 벤처기업 정보조회
97
+
98
+ Look up venture company information of a Korean business, including financial statements and investment data.
99
+
100
+ 벤처기업을 대상으로 사업자 정보, 대차대조표, 손익계산서, 투자정보, 벤처기업확인정보를 조회합니다.
101
+
102
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
103
+
104
+ | Parameter | Type | Required | Description 설명 |
105
+ | --- | --- | --- | --- |
106
+ | `biz_no` | `string` | **필수 / required** | 사업자등록번호 (숫자 10자리, 하이픈 제외) |
107
+
108
+ ```json
109
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"venture_biz_info","arguments":{"biz_no":"<biz_no>"}}}
110
+ ```
111
+
112
+ <a id="land-rt-price"></a>
113
+
114
+ ### `land_rt_price` — 부동산 실거래가 조회
115
+
116
+ Look up real estate transaction price records in Korea by region, property type, and year.
117
+
118
+ 시/도·시/군/구, 부동산 유형, 년도를 지정해 부동산 실거래 이력을 조회합니다. addr1 값이 잘못되면 응답의 options 필드로 선택 가능한 지역 목록을 안내합니다.
119
+
120
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
121
+
122
+ | Parameter | Type | Required | Description 설명 |
123
+ | --- | --- | --- | --- |
124
+ | `addr1` | `string` | **필수 / required** | 도/광역시/특별시 정식 명칭 (예: 서울특별시, 경기도, 부산광역시) |
125
+ | `addr2` | `string` | **필수 / required** | 시/군/구 (예: 금천구) |
126
+ | `type` | `string` | **필수 / required** | 유형 코드 A~H 중 하나. A:아파트, B:연립/다세대, C:단독/다가구, D:오피스텔, E:분양/입주권, F:상업/업무용, G:토지, H:공장/창고등 |
127
+ | `year` | `string` | **필수 / required** | 조회 년도 (1950 ~ 현재 년도, 예: 2025) |
128
+
129
+ ```json
130
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"land_rt_price","arguments":{"addr1":"<addr1>","addr2":"<addr2>","type":"<type>","year":"<year>"}}}
131
+ ```
132
+
133
+ <a id="req-pccc"></a>
134
+
135
+ ### `req_pccc` — 개인통관고유부호 인증 요청
136
+
137
+ Request SMS verification to retrieve a Korean Personal Customs Clearance Code (PCCC).
138
+
139
+ 개인통관고유부호 조회를 위한 본인 인증을 요청합니다. 인증번호 6자리가 문자(SMS)로 발송되며, 응답의 auth_key와 수신한 인증번호를 get_pccc Tool에 입력해 부호를 조회합니다.
140
+
141
+ > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `business`
142
+
143
+ | Parameter | Type | Required | Description 설명 |
144
+ | --- | --- | --- | --- |
145
+ | `name` | `string` | **필수 / required** | 이름 |
146
+ | `rrn1` | `string` | **필수 / required** | 주민등록번호 앞 6자리 |
147
+ | `rrn2` | `string` | **필수 / required** | 주민등록번호 뒤 7자리 |
148
+ | `phone` | `string` | **필수 / required** | 휴대전화 번호 (본인 명의, 숫자만) |
149
+
150
+ ```json
151
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"req_pccc","arguments":{"name":"<name>","rrn1":"<rrn1>","rrn2":"<rrn2>","phone":"<phone>"}}}
152
+ ```
153
+
154
+ <a id="get-pccc"></a>
155
+
156
+ ### `get_pccc` — 개인통관고유부호 조회
157
+
158
+ Retrieve a Korean Personal Customs Clearance Code (PCCC) using the auth key and SMS verification code.
159
+
160
+ req_pccc Tool 호출로 받은 auth_key와 문자(SMS)로 수신한 인증번호 6자리를 입력해 개인통관고유부호를 조회합니다.
161
+
162
+ > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `business`
163
+
164
+ | Parameter | Type | Required | Description 설명 |
165
+ | --- | --- | --- | --- |
166
+ | `auth_key` | `string` | **필수 / required** | req_pccc(개인통관고유부호 인증 요청) 응답의 인증 키 |
167
+ | `answer` | `string` | **필수 / required** | 문자(SMS)로 발송된 인증번호 6자리 |
168
+
169
+ ```json
170
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_pccc","arguments":{"auth_key":"<auth_key>","answer":"<answer>"}}}
171
+ ```
172
+
173
+ <a id="check-pccc"></a>
174
+
175
+ ### `check_pccc` — 개인통관부호 검증
176
+
177
+ Verify that a Korean Personal Customs Clearance Code (PCCC) matches the given name, zip code, and phone number.
178
+
179
+ 이름, 개인통관고유부호, 우편번호, 전화번호를 입력하여 개인통관부호 일치 여부를 검증합니다. 해외직구 주문 정보 검증 등에 사용합니다.
180
+
181
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
182
+
183
+ | Parameter | Type | Required | Description 설명 |
184
+ | --- | --- | --- | --- |
185
+ | `name` | `string` | **필수 / required** | 이름 |
186
+ | `pccc` | `string` | **필수 / required** | 개인통관고유부호 (P + 숫자 12자리, 예: P123456789012) |
187
+ | `zip` | `string` | **필수 / required** | 우편번호 (5자리, 예: 12345) |
188
+ | `phone` | `string` | **필수 / required** | 전화번호 (숫자만, 예: 01012341234) |
189
+
190
+ ```json
191
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_pccc","arguments":{"name":"<name>","pccc":"<pccc>","zip":"<zip>","phone":"<phone>"}}}
192
+ ```
193
+
194
+ <a id="get-car-flooding"></a>
195
+
196
+ ### `get_car_flooding` — 차량 침수차 여부 조회
197
+
198
+ Check whether a Korean vehicle has a flood damage record, by VIN or license plate number.
199
+
200
+ 차대번호(VIN) 또는 차량번호로 자동차의 침수 이력 여부를 조회합니다. 중고차 구매 전 확인 등에 사용합니다.
201
+
202
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
203
+
204
+ | Parameter | Type | Required | Description 설명 |
205
+ | --- | --- | --- | --- |
206
+ | `type` | `string` | **필수 / required** | 조회 종류. 1: 차대번호(VIN), 2: 차량번호 |
207
+ | `value` | `string` | **필수 / required** | 차대번호(type=1, 17자리) 또는 차량번호(type=2) |
208
+
209
+ ```json
210
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_car_flooding","arguments":{"type":"<type>","value":"<value>"}}}
211
+ ```
212
+
213
+ <a id="get-car-scrap"></a>
214
+
215
+ ### `get_car_scrap` — 차량 폐차사고처리 여부 조회
216
+
217
+ Check whether a Korean vehicle has a scrap/total-loss accident record, by VIN or license plate number.
218
+
219
+ 차대번호(VIN) 또는 차량번호로 폐차사고처리 여부를 조회합니다. 중고차 구매 전 확인 등에 사용합니다.
220
+
221
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
222
+
223
+ | Parameter | Type | Required | Description 설명 |
224
+ | --- | --- | --- | --- |
225
+ | `type` | `string` | **필수 / required** | 조회 종류. 1: 차대번호(VIN), 2: 차량번호 |
226
+ | `value` | `string` | **필수 / required** | 차대번호(type=1, 17자리) 또는 차량번호(type=2) |
227
+
228
+ ```json
229
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_car_scrap","arguments":{"type":"<type>","value":"<value>"}}}
230
+ ```
231
+
232
+ <a id="parcel-tracking"></a>
233
+
234
+ ### `parcel_tracking` — 택배 배송조회
235
+
236
+ Track a Korean parcel in real time by carrier code and tracking number.
237
+
238
+ 택배사 코드와 운송장번호를 지정해 실시간 배송현황을 조회합니다. 결과는 저장하지 않고 매 호출마다 즉시 조회합니다. carrier 코드 예: cj(CJ대한통운), hanjin(한진택배), lotte(롯데택배), logen(로젠택배), epost-domestic(우체국택배) 등 — 전체 목록은 /rest/parcel_tracking_carriers(무료)에서 확인할 수 있고, 택배사를 모르면 parcel_tracking_auto Tool로 자동판별 조회하세요.
239
+
240
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
241
+
242
+ | Parameter | Type | Required | Description 설명 |
243
+ | --- | --- | --- | --- |
244
+ | `carrier` | `string` | **필수 / required** | 택배사 코드 (예: cj, hanjin, lotte, logen, epost-domestic) |
245
+ | `trackingNumber` | `string` | **필수 / required** | 운송장번호 |
246
+
247
+ ```json
248
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"parcel_tracking","arguments":{"carrier":"<carrier>","trackingNumber":"<trackingNumber>"}}}
249
+ ```
250
+
251
+ <a id="parcel-tracking-auto"></a>
252
+
253
+ ### `parcel_tracking_auto` — 택배 배송조회(자동)
254
+
255
+ Track a Korean parcel in real time with automatic carrier detection from the tracking number alone.
256
+
257
+ 택배사 지정 없이 운송장번호만으로 택배사를 자동 판별해 실시간 배송현황을 조회합니다. 택배사를 이미 아는 경우에는 parcel_tracking Tool이 더 정확합니다.
258
+
259
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
260
+
261
+ | Parameter | Type | Required | Description 설명 |
262
+ | --- | --- | --- | --- |
263
+ | `trackingNumber` | `string` | **필수 / required** | 운송장번호 (택배사 지정 없이 형식만으로 자동 판별) |
264
+
265
+ ```json
266
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"parcel_tracking_auto","arguments":{"trackingNumber":"<trackingNumber>"}}}
267
+ ```
268
+
269
+ <a id="check-email-valid"></a>
270
+
271
+ ### `check_email_valid` — 이메일 유효성 검사
272
+
273
+ Validate whether an email address is real and deliverable.
274
+
275
+ 이메일 주소의 유효성 여부를 검사합니다. 회원가입 입력값 검증, 발송 전 리스트 정제 등에 사용합니다.
276
+
277
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
278
+
279
+ | Parameter | Type | Required | Description 설명 |
280
+ | --- | --- | --- | --- |
281
+ | `email` | `string` | **필수 / required** | 이메일 주소 (예: hong@example.com) |
282
+
283
+ ```json
284
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_email_valid","arguments":{"email":"<email>"}}}
285
+ ```
286
+
287
+ <a id="check-phone-valid"></a>
288
+
289
+ ### `check_phone_valid` — 전화번호 유효성 검사
290
+
291
+ Validate whether a phone number is in service.
292
+
293
+ 전화번호의 유효성 여부를 검사합니다. 국내 번호는 0으로 시작하는 형식(예: 01012341234) 그대로 입력하면 되고, 해외 번호는 + 국가코드 형식으로 입력합니다.
294
+
295
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
296
+
297
+ | Parameter | Type | Required | Description 설명 |
298
+ | --- | --- | --- | --- |
299
+ | `number` | `string` | **필수 / required** | 전화번호 (예: 01012341234, 해외는 +국가코드 형식) |
300
+
301
+ ```json
302
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_phone_valid","arguments":{"number":"<number>"}}}
303
+ ```
304
+
305
+ <a id="check-spam-number"></a>
306
+
307
+ ### `check_spam_number` — 스팸/광고/범죄 전화번호 조회
308
+
309
+ Check whether a phone number has been reported for spam, advertising, or criminal use in Korea.
310
+
311
+ 스팸/광고/범죄에 사용된 전화번호인지 조회합니다. 수신 전화 필터링, 이상 거래 탐지 등에 사용합니다.
312
+
313
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
314
+
315
+ | Parameter | Type | Required | Description 설명 |
316
+ | --- | --- | --- | --- |
317
+ | `number` | `string` | **필수 / required** | 전화번호 (예: 01012341234) |
318
+
319
+ ```json
320
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_spam_number","arguments":{"number":"<number>"}}}
321
+ ```
322
+
323
+ <a id="holiday-info"></a>
324
+
325
+ ### `holiday_info` — 공휴일 조회
326
+
327
+ Look up Korean public holidays for a given year and month.
328
+
329
+ 해당 년월의 대한민국 공휴일 정보를 조회합니다. 영업일 계산, 일정 관리 등에 사용합니다.
330
+
331
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
332
+
333
+ | Parameter | Type | Required | Description 설명 |
334
+ | --- | --- | --- | --- |
335
+ | `year` | `string` | **필수 / required** | 조회 년도 (1900 ~ 2200, 예: 2024) |
336
+ | `month` | `string` | **필수 / required** | 조회 월 (1 ~ 12, 예: 02) |
337
+
338
+ ```json
339
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"holiday_info","arguments":{"year":"<year>","month":"<month>"}}}
340
+ ```
341
+
342
+ <a id="search-juso"></a>
343
+
344
+ ### `search_juso` — 도로명주소 조회
345
+
346
+ Search Korean road-name addresses by keyword.
347
+
348
+ 지번 또는 도로명 키워드로 도로명 주소를 검색합니다. 페이지당 10건씩 반환되며 total_count 필드로 전체 검색결과 개수를 확인할 수 있습니다.
349
+
350
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
351
+
352
+ | Parameter | Type | Required | Description 설명 |
353
+ | --- | --- | --- | --- |
354
+ | `juso` | `string` | **필수 / required** | 검색할 주소 키워드 (지번, 도로명. 예: 디지털로) |
355
+ | `page` | `string` | 선택 / optional | 검색 결과 조회 페이지 (기본값 1, 페이지당 10건) |
356
+
357
+ ```json
358
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_juso","arguments":{"juso":"<juso>"}}}
359
+ ```
360
+
361
+ <a id="info"></a>
362
+
363
+ ### `info` — 계정 정보 조회
364
+
365
+ Check your APICK account balance and status.
366
+
367
+ 현재 인증 키에 연결된 APICK 계정의 잔여 포인트와 계정 상태 정보를 조회합니다. 무료입니다.
368
+
369
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `business`
370
+
371
+ _No parameters. 파라미터 없음._
372
+
373
+ ```json
374
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"info","arguments":{}}}
375
+ ```
376
+
377
+ ---
378
+
379
+ <a id="identity"></a>
380
+
381
+ ## Identity Verification · 신분증 진위확인 · 마스킹
382
+
383
+ `https://apick.app/mcp/identity` — 16 tools
384
+
385
+ Authenticity checks for Korean ID documents against government registries, real-name verification, and PII masking.
386
+
387
+ 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹.
388
+
389
+ 마스킹 5종의 실패 결과는 기존 텍스트 오류와 함께 `structuredContent.error_code` 및 `structuredContent.error`를 제공합니다. 오류 코드는 `IDENTITY_TEXT_UNREADABLE`, `IDENTITY_DOCUMENT_MISMATCH`, `IDENTITY_PROCESSING_FAILED`입니다. 과금 없이 실패하며 브리지는 서버 결과를 그대로 전달합니다.
390
+
391
+ The five masking tools preserve the text error and also return `structuredContent.error_code` and `structuredContent.error`. The service codes are `IDENTITY_TEXT_UNREADABLE`, `IDENTITY_DOCUMENT_MISMATCH`, and `IDENTITY_PROCESSING_FAILED`; failed calls are not charged and the bridge forwards the server result unchanged.
392
+
393
+ | Tool | 기능 | Required 필수 |
394
+ | --- | --- | --- |
395
+ | [`identi_card1`](#identi-card1) | [Text] 주민등록증 진위 확인 | `name`, `rrn1`, `rrn2`, `date` |
396
+ | [`identi_card2`](#identi-card2) | [Text] 운전면허증 진위 확인 | `birth_y`, `birth_m`, `birth_d`, `name`, `licen_no0`, `licen_no1`, `licen_no2`, `licen_no3` |
397
+ | [`identi_card3`](#identi-card3) | [Text] 여권 진위 확인 | `name`, `pass_num`, `made_date`, `exp_date`, `birth_date` |
398
+ | [`identi_card4`](#identi-card4) | [Text] 주민등록등본 진위 확인 | `doc_num1`, `doc_num2`, `doc_num3`, `doc_num4`, `type` |
399
+ | [`identi_card5`](#identi-card5) | [Text] 외국인등록증 진위 확인 | `rrn`, `made_date` |
400
+ | [`identi_card_image1`](#identi-card-image1) | [Image/PDF] 주민등록증 진위 확인 | `image_url` |
401
+ | [`identi_card_image2`](#identi-card-image2) | [Image/PDF] 운전면허증 진위 확인 | `image_url` |
402
+ | [`identi_card_image3`](#identi-card-image3) | [Image/PDF] 여권 진위 확인 | `image_url` |
403
+ | [`identi_card_image4`](#identi-card-image4) | [Image/PDF] 주민등록등본 진위 확인 | `image_url` |
404
+ | [`identi_card_image5`](#identi-card-image5) | [Image/PDF] 외국인등록증 진위 확인 | `image_url` |
405
+ | [`name_rrn_auth`](#name-rrn-auth) | 성명/주민등록번호 실명확인 | `name`, `rrn1`, `rrn2` |
406
+ | [`hide_rrn`](#hide-rrn) | 개인정보 마스킹(주민등록번호) | `type`, `image_url` |
407
+ | [`identity_document_residence_card`](#identity-document-residence-card) | 외국인등록증 개인정보 마스킹 | `image_url` |
408
+ | [`identity_document_passport`](#identity-document-passport) | 여권 개인정보 마스킹 | `image_url` |
409
+ | [`identity_document_id_card`](#identity-document-id-card) | 주민등록증 개인정보 마스킹 | `image_url` |
410
+ | [`identity_document_driver_license`](#identity-document-driver-license) | 운전면허증 개인정보 마스킹 | `image_url` |
411
+
412
+ <a id="identi-card1"></a>
413
+
414
+ ### `identi_card1` — [Text] 주민등록증 진위 확인
415
+
416
+ Verify the authenticity of a Korean resident registration card (jumin-deungnokjeung) using text input.
417
+
418
+ 주민등록증의 기재 정보를 입력해 진위 여부를 확인합니다. name, rrn1, rrn2, date 네 항목을 모두 입력해야 하며, date는 숫자만 허용됩니다(예: 20230101). 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
419
+
420
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
421
+
422
+ | Parameter | Type | Required | Description 설명 |
423
+ | --- | --- | --- | --- |
424
+ | `name` | `string` | **필수 / required** | 성명 |
425
+ | `rrn1` | `string` | **필수 / required** | 주민등록번호 앞 6자리 |
426
+ | `rrn2` | `string` | **필수 / required** | 주민등록번호 뒤 7자리 |
427
+ | `date` | `string` | **필수 / required** | 발급일자 (숫자만, 예: 20230101) |
428
+
429
+ ```json
430
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card1","arguments":{"name":"<name>","rrn1":"<rrn1>","rrn2":"<rrn2>","date":"<date>"}}}
431
+ ```
432
+
433
+ <a id="identi-card2"></a>
434
+
435
+ ### `identi_card2` — [Text] 운전면허증 진위 확인
436
+
437
+ Verify the authenticity of a Korean driver license using text input.
438
+
439
+ 운전면허증의 기재 정보를 입력해 진위 여부를 확인합니다. birth_y, birth_m, birth_d, name과 면허번호 4구획(licen_no0~licen_no3)은 모두 필수이며, ghost_num(식별번호)과 rrn1, rrn2는 선택 입력입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
440
+
441
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
442
+
443
+ | Parameter | Type | Required | Description 설명 |
444
+ | --- | --- | --- | --- |
445
+ | `birth_y` | `string` | **필수 / required** | 생년월일 - 년 (예: 2000) |
446
+ | `birth_m` | `string` | **필수 / required** | 생년월일 - 월 (예: 01) |
447
+ | `birth_d` | `string` | **필수 / required** | 생년월일 - 일 (예: 01) |
448
+ | `name` | `string` | **필수 / required** | 성명 |
449
+ | `licen_no0` | `string` | **필수 / required** | 면허번호 1구획 (예: 21) |
450
+ | `licen_no1` | `string` | **필수 / required** | 면허번호 2구획 (예: 19) |
451
+ | `licen_no2` | `string` | **필수 / required** | 면허번호 3구획 (예: 174133) |
452
+ | `licen_no3` | `string` | **필수 / required** | 면허번호 4구획 (예: 01) |
453
+ | `ghost_num` | `string` | 선택 / optional | 식별번호 (면허증 우측 표기, 예: 8H1X3Y) |
454
+ | `rrn1` | `string` | 선택 / optional | 주민등록번호 앞 6자리 (선택) |
455
+ | `rrn2` | `string` | 선택 / optional | 주민등록번호 뒤 7자리 (선택) |
456
+
457
+ ```json
458
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card2","arguments":{"birth_y":"<birth_y>","birth_m":"<birth_m>","birth_d":"<birth_d>","name":"<name>","licen_no0":"<licen_no0>","licen_no1":"<licen_no1>","licen_no2":"<licen_no2>","licen_no3":"<licen_no3>"}}}
459
+ ```
460
+
461
+ <a id="identi-card3"></a>
462
+
463
+ ### `identi_card3` — [Text] 여권 진위 확인
464
+
465
+ Verify the authenticity of a Korean passport using text input.
466
+
467
+ 여권의 기재 정보를 입력해 진위 여부를 확인합니다. name, pass_num, made_date, exp_date, birth_date 다섯 항목을 모두 입력해야 하며, 일자 세 항목은 숫자만 허용됩니다(예: 20230101). 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
468
+
469
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
470
+
471
+ | Parameter | Type | Required | Description 설명 |
472
+ | --- | --- | --- | --- |
473
+ | `name` | `string` | **필수 / required** | 성명 |
474
+ | `pass_num` | `string` | **필수 / required** | 여권번호 (예: M00000000) |
475
+ | `made_date` | `string` | **필수 / required** | 발급일자 (숫자만, 예: 20230101) |
476
+ | `exp_date` | `string` | **필수 / required** | 만료일자 (숫자만, 예: 20330101) |
477
+ | `birth_date` | `string` | **필수 / required** | 생년월일 (숫자만, 예: 20000101) |
478
+
479
+ ```json
480
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card3","arguments":{"name":"<name>","pass_num":"<pass_num>","made_date":"<made_date>","exp_date":"<exp_date>","birth_date":"<birth_date>"}}}
481
+ ```
482
+
483
+ <a id="identi-card4"></a>
484
+
485
+ ### `identi_card4` — [Text] 주민등록등본 진위 확인
486
+
487
+ Verify the authenticity of a Korean resident registration certificate (jumin-deungnok-deungbon) using text input.
488
+
489
+ 주민등록등본의 문서확인번호로 진위 여부를 확인합니다. 문서확인번호 16자리를 4자리씩 나눈 doc_num1~doc_num4와 발급 종류 type(1: 정부24 발급, 2: 기타 발급)은 필수이며, name(성명)은 선택 입력입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
490
+
491
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
492
+
493
+ | Parameter | Type | Required | Description 설명 |
494
+ | --- | --- | --- | --- |
495
+ | `doc_num1` | `string` | **필수 / required** | 문서확인번호 1구획 (4자리) |
496
+ | `doc_num2` | `string` | **필수 / required** | 문서확인번호 2구획 (4자리) |
497
+ | `doc_num3` | `string` | **필수 / required** | 문서확인번호 3구획 (4자리) |
498
+ | `doc_num4` | `string` | **필수 / required** | 문서확인번호 4구획 (4자리) |
499
+ | `name` | `string` | 선택 / optional | 성명 |
500
+ | `type` | `string` | **필수 / required** | 발급 종류 (1: 정부24 발급, 2: 기타 발급) |
501
+
502
+ ```json
503
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card4","arguments":{"doc_num1":"<doc_num1>","doc_num2":"<doc_num2>","doc_num3":"<doc_num3>","doc_num4":"<doc_num4>","type":"<type>"}}}
504
+ ```
505
+
506
+ <a id="identi-card5"></a>
507
+
508
+ ### `identi_card5` — [Text] 외국인등록증 진위 확인
509
+
510
+ Verify the authenticity of a Korean alien registration card (residence card) using text input.
511
+
512
+ 외국인등록증의 기재 정보를 입력해 진위 여부를 확인합니다. rrn(외국인등록번호 13자리)과 made_date(발급일자 10자리, 예: 2020-01-01)는 필수이며, card_sn(뒷면 일련번호)은 입력 시 11자리여야 하고 2011-01-01 이후 발급된 등록증은 필수입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
513
+
514
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
515
+
516
+ | Parameter | Type | Required | Description 설명 |
517
+ | --- | --- | --- | --- |
518
+ | `rrn` | `string` | **필수 / required** | 외국인등록번호 (숫자 13자리) |
519
+ | `made_date` | `string` | **필수 / required** | 발급일자 (10자리, 예: 2020-01-01) |
520
+ | `card_sn` | `string` | 선택 / optional | 뒷면 일련번호 (11자리). 2011-01-01 이후 발급분은 필수 |
521
+
522
+ ```json
523
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card5","arguments":{"rrn":"<rrn>","made_date":"<made_date>"}}}
524
+ ```
525
+
526
+ <a id="identi-card-image1"></a>
527
+
528
+ ### `identi_card_image1` — [Image/PDF] 주민등록증 진위 확인
529
+
530
+ Verify the authenticity of a Korean resident registration card from an image or PDF file.
531
+
532
+ 주민등록증 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
533
+
534
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
535
+
536
+ | Parameter | Type | Required | Description 설명 |
537
+ | --- | --- | --- | --- |
538
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, application/pdf, 최대 25MB |
539
+
540
+ ```json
541
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card_image1","arguments":{"image_url":"https://example.com/file"}}}
542
+ ```
543
+
544
+ <a id="identi-card-image2"></a>
545
+
546
+ ### `identi_card_image2` — [Image/PDF] 운전면허증 진위 확인
547
+
548
+ Verify the authenticity of a Korean driver license from an image or PDF file.
549
+
550
+ 운전면허증 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
551
+
552
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
553
+
554
+ | Parameter | Type | Required | Description 설명 |
555
+ | --- | --- | --- | --- |
556
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, application/pdf, 최대 25MB |
557
+
558
+ ```json
559
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card_image2","arguments":{"image_url":"https://example.com/file"}}}
560
+ ```
561
+
562
+ <a id="identi-card-image3"></a>
563
+
564
+ ### `identi_card_image3` — [Image/PDF] 여권 진위 확인
565
+
566
+ Verify the authenticity of a Korean passport from an image or PDF file.
567
+
568
+ 여권 인적사항면 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
569
+
570
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
571
+
572
+ | Parameter | Type | Required | Description 설명 |
573
+ | --- | --- | --- | --- |
574
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, application/pdf, 최대 25MB |
575
+
576
+ ```json
577
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card_image3","arguments":{"image_url":"https://example.com/file"}}}
578
+ ```
579
+
580
+ <a id="identi-card-image4"></a>
581
+
582
+ ### `identi_card_image4` — [Image/PDF] 주민등록등본 진위 확인
583
+
584
+ Verify the authenticity of a Korean resident registration certificate from an image or PDF file.
585
+
586
+ 주민등록등본 이미지 또는 PDF 파일을 업로드하면 문서확인번호 등 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
587
+
588
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
589
+
590
+ | Parameter | Type | Required | Description 설명 |
591
+ | --- | --- | --- | --- |
592
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, application/pdf, 최대 25MB |
593
+
594
+ ```json
595
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card_image4","arguments":{"image_url":"https://example.com/file"}}}
596
+ ```
597
+
598
+ <a id="identi-card-image5"></a>
599
+
600
+ ### `identi_card_image5` — [Image/PDF] 외국인등록증 진위 확인
601
+
602
+ Verify the authenticity of a Korean alien registration card (residence card) from an image or PDF file.
603
+
604
+ 외국인등록증 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. card_sn(뒷면 일련번호 11자리)은 선택 입력이며, 2011-01-01 이후 발급된 등록증은 필수입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
605
+
606
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
607
+
608
+ | Parameter | Type | Required | Description 설명 |
609
+ | --- | --- | --- | --- |
610
+ | `card_sn` | `string` | 선택 / optional | 뒷면 일련번호 (11자리). 2011-01-01 이후 발급분은 필수 |
611
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, application/pdf, 최대 25MB |
612
+
613
+ ```json
614
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identi_card_image5","arguments":{"image_url":"https://example.com/file"}}}
615
+ ```
616
+
617
+ <a id="name-rrn-auth"></a>
618
+
619
+ ### `name_rrn_auth` — 성명/주민등록번호 실명확인
620
+
621
+ Verify that a Korean name and resident registration number (RRN) match a real registered person.
622
+
623
+ 성명과 주민등록번호의 일치 여부(실명 존재 여부)를 확인합니다. name, rrn1(앞 6자리), rrn2(뒤 7자리)를 모두 입력해야 합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
624
+
625
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
626
+
627
+ | Parameter | Type | Required | Description 설명 |
628
+ | --- | --- | --- | --- |
629
+ | `name` | `string` | **필수 / required** | 한글 성명 |
630
+ | `rrn1` | `string` | **필수 / required** | 주민등록번호 앞 6자리 숫자 |
631
+ | `rrn2` | `string` | **필수 / required** | 주민등록번호 뒤 7자리 숫자 |
632
+
633
+ ```json
634
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"name_rrn_auth","arguments":{"name":"<name>","rrn1":"<rrn1>","rrn2":"<rrn2>"}}}
635
+ ```
636
+
637
+ <a id="hide-rrn"></a>
638
+
639
+ ### `hide_rrn` — 개인정보 마스킹(주민등록번호)
640
+
641
+ Mask resident registration numbers found in an image and return the masked image.
642
+
643
+ 이미지에서 주민등록번호를 인식해 지정한 방식으로 가린 이미지를 반환합니다. 이미지 파일과 type(1: 주민등록번호 전체 가림, 2: 뒷자리 전체 가림, 3: 뒷자리 첫 숫자 제외 가림, 4: 주민등록번호와 주소 가림)을 모두 입력해야 합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
644
+
645
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
646
+
647
+ | Parameter | Type | Required | Description 설명 |
648
+ | --- | --- | --- | --- |
649
+ | `type` | `string` | **필수 / required** | 가림 처리 타입 (1: 주민등록번호 전체, 2: 뒷자리 전체, 3: 뒷자리 첫 숫자 제외, 4: 주민등록번호+주소) |
650
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, 최대 25MB |
651
+
652
+ ```json
653
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hide_rrn","arguments":{"type":"<type>","image_url":"https://example.com/file"}}}
654
+ ```
655
+
656
+ <a id="identity-document-residence-card"></a>
657
+
658
+ ### `identity_document_residence_card` — 외국인등록증 개인정보 마스킹
659
+
660
+ Extract key fields from a Korean residence card, permanent resident card, or overseas Korean resident card image and mask the last 6 digits of the registration or domestic residence report number.
661
+
662
+ 외국인등록증·영주증·외국국적동포 국내거소신고증 이미지에서 지정 정보를 추출하고 등록번호 또는 거소신고번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. 한 번에 신분증 한 장이 포함된 PNG 또는 JPEG 이미지만 전달해야 하며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 영주증과 외국국적동포 국내거소신고증은 마스킹만 지원하며 진위확인 Tool의 범위에는 포함되지 않습니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
663
+
664
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
665
+
666
+ | Parameter | Type | Required | Description 설명 |
667
+ | --- | --- | --- | --- |
668
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, 최대 20MB |
669
+
670
+ ```json
671
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identity_document_residence_card","arguments":{"image_url":"https://example.com/file"}}}
672
+ ```
673
+
674
+ <a id="identity-document-passport"></a>
675
+
676
+ ### `identity_document_passport` — 여권 개인정보 마스킹
677
+
678
+ Extract key fields from a passport image and mask the passport number and MRZ area.
679
+
680
+ 여권 인적사항면 이미지에서 지정 정보를 추출하고 여권번호 및 MRZ 영역을 마스킹한 이미지를 함께 반환합니다. MRZ 2줄이 포함되도록 촬영한 PNG 또는 JPEG 이미지 파일 하나만 전달하면 되며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
681
+
682
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
683
+
684
+ | Parameter | Type | Required | Description 설명 |
685
+ | --- | --- | --- | --- |
686
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, 최대 20MB |
687
+
688
+ ```json
689
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identity_document_passport","arguments":{"image_url":"https://example.com/file"}}}
690
+ ```
691
+
692
+ <a id="identity-document-id-card"></a>
693
+
694
+ ### `identity_document_id_card` — 주민등록증 개인정보 마스킹
695
+
696
+ Extract key fields from a Korean resident registration card image and mask the last 6 digits of the RRN.
697
+
698
+ 주민등록증 이미지에서 지정 정보를 추출하고 주민등록번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. PNG 또는 JPEG 이미지 파일 하나만 전달하면 되며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
699
+
700
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
701
+
702
+ | Parameter | Type | Required | Description 설명 |
703
+ | --- | --- | --- | --- |
704
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, 최대 20MB |
705
+
706
+ ```json
707
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identity_document_id_card","arguments":{"image_url":"https://example.com/file"}}}
708
+ ```
709
+
710
+ <a id="identity-document-driver-license"></a>
711
+
712
+ ### `identity_document_driver_license` — 운전면허증 개인정보 마스킹
713
+
714
+ Extract key fields from a Korean driver license image and mask the last 6 digits of the RRN.
715
+
716
+ 운전면허증(주민등록번호 표기형) 이미지에서 지정 정보를 추출하고 주민등록번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. PNG 또는 JPEG 이미지 파일 하나만 전달하면 되며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
717
+
718
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `identity`
719
+
720
+ | Parameter | Type | Required | Description 설명 |
721
+ | --- | --- | --- | --- |
722
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, 최대 20MB |
723
+
724
+ ```json
725
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identity_document_driver_license","arguments":{"image_url":"https://example.com/file"}}}
726
+ ```
727
+
728
+ ---
729
+
730
+ <a id="ocr"></a>
731
+
732
+ ## OCR · OCR 문자인식
733
+
734
+ `https://apick.app/mcp/ocr` — 6 tools
735
+
736
+ Text extraction from images and structured field extraction from Korean ID documents.
737
+
738
+ 이미지 텍스트 추출과 신분증 항목 추출.
739
+
740
+ | Tool | 기능 | Required 필수 |
741
+ | --- | --- | --- |
742
+ | [`ocr`](#ocr) | 이미지 텍스트 추출(OCR) | `image_url` |
743
+ | [`ocr_identi1`](#ocr-identi1) | 주민등록증 텍스트 추출(OCR) | `image_url` |
744
+ | [`ocr_identi2`](#ocr-identi2) | 운전면허증 텍스트 추출(OCR) | `image_url` |
745
+ | [`ocr_identi3`](#ocr-identi3) | 여권 텍스트 추출(OCR) | `image_url` |
746
+ | [`ocr_identi4`](#ocr-identi4) | 주민등록등본 텍스트 추출(OCR) | `image_url` |
747
+ | [`ocr_identi5`](#ocr-identi5) | 외국인등록증 텍스트 추출(OCR) | `image_url` |
748
+
749
+ <a id="ocr"></a>
750
+
751
+ ### `ocr` — 이미지 텍스트 추출(OCR)
752
+
753
+ Extract text from an image file (OCR).
754
+
755
+ 이미지 파일에서 텍스트를 추출해 전체 텍스트(full_text)를 반환합니다. 문서 사진, 스캔 이미지, 캡처 화면 등 범용 이미지에 사용합니다.
756
+
757
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
758
+
759
+ | Parameter | Type | Required | Description 설명 |
760
+ | --- | --- | --- | --- |
761
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
762
+
763
+ ```json
764
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr","arguments":{"image_url":"https://example.com/file"}}}
765
+ ```
766
+
767
+ <a id="ocr-identi1"></a>
768
+
769
+ ### `ocr_identi1` — 주민등록증 텍스트 추출(OCR)
770
+
771
+ Extract key fields from a Korean resident registration card (jumin card) image via OCR.
772
+
773
+ 주민등록증 사진에서 이름, 주민등록번호, 주소, 발급일자 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
774
+
775
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
776
+
777
+ | Parameter | Type | Required | Description 설명 |
778
+ | --- | --- | --- | --- |
779
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
780
+
781
+ ```json
782
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr_identi1","arguments":{"image_url":"https://example.com/file"}}}
783
+ ```
784
+
785
+ <a id="ocr-identi2"></a>
786
+
787
+ ### `ocr_identi2` — 운전면허증 텍스트 추출(OCR)
788
+
789
+ Extract key fields from a Korean driver license image via OCR.
790
+
791
+ 운전면허증 사진에서 이름, 면허번호, 생년월일 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
792
+
793
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
794
+
795
+ | Parameter | Type | Required | Description 설명 |
796
+ | --- | --- | --- | --- |
797
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
798
+
799
+ ```json
800
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr_identi2","arguments":{"image_url":"https://example.com/file"}}}
801
+ ```
802
+
803
+ <a id="ocr-identi3"></a>
804
+
805
+ ### `ocr_identi3` — 여권 텍스트 추출(OCR)
806
+
807
+ Extract key fields from a passport image via OCR.
808
+
809
+ 여권 사진에서 이름, 여권번호, 발급일자, 만료일자, 생년월일 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
810
+
811
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
812
+
813
+ | Parameter | Type | Required | Description 설명 |
814
+ | --- | --- | --- | --- |
815
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
816
+
817
+ ```json
818
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr_identi3","arguments":{"image_url":"https://example.com/file"}}}
819
+ ```
820
+
821
+ <a id="ocr-identi4"></a>
822
+
823
+ ### `ocr_identi4` — 주민등록등본 텍스트 추출(OCR)
824
+
825
+ Extract key fields from a Korean certified copy of resident registration (deungbon) image via OCR.
826
+
827
+ 주민등록등본 사진에서 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
828
+
829
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
830
+
831
+ | Parameter | Type | Required | Description 설명 |
832
+ | --- | --- | --- | --- |
833
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
834
+
835
+ ```json
836
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr_identi4","arguments":{"image_url":"https://example.com/file"}}}
837
+ ```
838
+
839
+ <a id="ocr-identi5"></a>
840
+
841
+ ### `ocr_identi5` — 외국인등록증 텍스트 추출(OCR)
842
+
843
+ Extract key fields from a Korean alien registration card (residence card) image via OCR.
844
+
845
+ 외국인등록증 사진에서 이름, 외국인등록번호, 발급일자 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
846
+
847
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ocr`
848
+
849
+ | Parameter | Type | Required | Description 설명 |
850
+ | --- | --- | --- | --- |
851
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, 최대 25MB |
852
+
853
+ ```json
854
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ocr_identi5","arguments":{"image_url":"https://example.com/file"}}}
855
+ ```
856
+
857
+ ---
858
+
859
+ <a id="finance"></a>
860
+
861
+ ## Finance · 금융 · 계좌확인
862
+
863
+ `https://apick.app/mcp/finance` — 3 tools
864
+
865
+ Korean bank account holder lookup and 1 KRW deposit verification.
866
+
867
+ 계좌 예금주 실명조회와 1원 인증.
868
+
869
+ | Tool | 기능 | Required 필수 |
870
+ | --- | --- | --- |
871
+ | [`transfer_1won`](#transfer-1won) | 1원 인증 | `account_num` |
872
+ | [`account_realname`](#account-realname) | 계좌 예금주 실명 조회 | `account_num` |
873
+ | [`bank_code`](#bank-code) | 은행코드 조회 | — |
874
+
875
+ <a id="transfer-1won"></a>
876
+
877
+ ### `transfer_1won` — 1원 인증
878
+
879
+ Send a 1 KRW verification deposit to a Korean bank account and return the 4-character verification code printed on the transaction.
880
+
881
+ 대한민국 은행 계좌로 1원을 입금해 적요에 표시되는 인증코드를 반환합니다. 계좌 실소유 확인(1원 인증) 절차에 사용합니다. bank_code 또는 bank_name 중 하나는 입력해야 합니다.
882
+
883
+ > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `finance`
884
+
885
+ | Parameter | Type | Required | Description 설명 |
886
+ | --- | --- | --- | --- |
887
+ | `account_num` | `string` | **필수 / required** | 계좌번호 (숫자만, 하이픈 제외) |
888
+ | `bank_code` | `string` | 선택 / optional | 은행 코드 (bank_code Tool로 조회 가능, 예: 004) |
889
+ | `bank_name` | `string` | 선택 / optional | 은행명 (예: 국민). bank_code 대신 입력 가능 |
890
+
891
+ ```json
892
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"transfer_1won","arguments":{"account_num":"<account_num>"}}}
893
+ ```
894
+
895
+ <a id="account-realname"></a>
896
+
897
+ ### `account_realname` — 계좌 예금주 실명 조회
898
+
899
+ Look up the account holder name of a Korean bank account.
900
+
901
+ 대한민국 은행 계좌의 예금주명을 조회합니다. 송금 전 예금주 확인 등에 사용합니다. bank_code 또는 bank_name 중 하나는 입력해야 합니다.
902
+
903
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `finance`
904
+
905
+ | Parameter | Type | Required | Description 설명 |
906
+ | --- | --- | --- | --- |
907
+ | `account_num` | `string` | **필수 / required** | 계좌번호 (숫자만, 하이픈 제외) |
908
+ | `bank_code` | `string` | 선택 / optional | 은행 코드 (bank_code Tool로 조회 가능, 예: 004) |
909
+ | `bank_name` | `string` | 선택 / optional | 은행명 (예: 국민). bank_code 대신 입력 가능 |
910
+
911
+ ```json
912
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"account_realname","arguments":{"account_num":"<account_num>"}}}
913
+ ```
914
+
915
+ <a id="bank-code"></a>
916
+
917
+ ### `bank_code` — 은행코드 조회
918
+
919
+ List Korean bank codes and names.
920
+
921
+ 대한민국 은행 코드·은행명 전체 목록을 반환합니다. transfer_1won, account_realname Tool의 bank_code 입력값을 찾을 때 사용합니다. 무료입니다.
922
+
923
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `finance`
924
+
925
+ _No parameters. 파라미터 없음._
926
+
927
+ ```json
928
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bank_code","arguments":{}}}
929
+ ```
930
+
931
+ ---
932
+
933
+ <a id="web"></a>
934
+
935
+ ## Web & Search · 웹 · 검색
936
+
937
+ `https://apick.app/mcp/web` — 13 tools
938
+
939
+ Domain and IP intelligence, WHOIS, page capture, Google search, and YouTube.
940
+
941
+ 도메인·IP 조회, WHOIS, 웹페이지 수집, 구글 검색, 유튜브.
942
+
943
+ | Tool | 기능 | Required 필수 |
944
+ | --- | --- | --- |
945
+ | [`nslookup`](#nslookup) | 도메인으로 IP 조회 | `domain` |
946
+ | [`reverse_ip`](#reverse-ip) | IP로 도메인 조회 | `ip` |
947
+ | [`location`](#location) | 도메인/IP 위치 조회 | `address` |
948
+ | [`ip_history`](#ip-history) | IP 변경 이력 조회 | `domain` |
949
+ | [`whois`](#whois) | WHOIS 조회 | `address` |
950
+ | [`url_html`](#url-html) | URL HTML 추출 | `url` |
951
+ | [`url_screenshot`](#url-screenshot) | URL 화면캡처 | `url` |
952
+ | [`url_similarity`](#url-similarity) | URL 유사도 비교 | `url1`, `url2` |
953
+ | [`google_search`](#google-search) | 구글 키워드 검색 | `keyword` |
954
+ | [`google_image_search`](#google-image-search) | 구글 이미지 검색(키워드로 검색) | `keyword` |
955
+ | [`google_lens_search`](#google-lens-search) | 구글 렌즈 검색(이미지로 검색) | `image_url` |
956
+ | [`crawl_youtube`](#crawl-youtube) | 유튜브 계정 정보 수집 | `user_id` |
957
+ | [`download_youtube_video`](#download-youtube-video) | 유튜브 동영상 다운로드 | `url` |
958
+
959
+ <a id="nslookup"></a>
960
+
961
+ ### `nslookup` — 도메인으로 IP 조회
962
+
963
+ Resolve a domain name to its currently registered IP addresses (DNS lookup).
964
+
965
+ 도메인에 현재 등록된 IP 주소 목록을 조회합니다. 도메인 형식이 아닌 값은 오류로 응답합니다.
966
+
967
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
968
+
969
+ | Parameter | Type | Required | Description 설명 |
970
+ | --- | --- | --- | --- |
971
+ | `domain` | `string` | **필수 / required** | 검색할 도메인 (예: apick.app) |
972
+
973
+ ```json
974
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nslookup","arguments":{"domain":"<domain>"}}}
975
+ ```
976
+
977
+ <a id="reverse-ip"></a>
978
+
979
+ ### `reverse_ip` — IP로 도메인 조회
980
+
981
+ Reverse IP lookup: list domains that have been hosted on a given IP address.
982
+
983
+ 특정 IP에 등록된 도메인 이력 정보를 조회합니다. IP 주소 형식만 허용됩니다.
984
+
985
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
986
+
987
+ | Parameter | Type | Required | Description 설명 |
988
+ | --- | --- | --- | --- |
989
+ | `ip` | `string` | **필수 / required** | 검색할 IP 주소 (예: 121.140.146.38) |
990
+
991
+ ```json
992
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reverse_ip","arguments":{"ip":"<ip>"}}}
993
+ ```
994
+
995
+ <a id="location"></a>
996
+
997
+ ### `location` — 도메인/IP 위치 조회
998
+
999
+ Look up the geographic location of a domain or IP address.
1000
+
1001
+ 도메인 또는 IP의 위치(지리 정보)를 조회합니다. 도메인을 입력하면 해당 도메인의 IP를 찾아 위치를 반환합니다.
1002
+
1003
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1004
+
1005
+ | Parameter | Type | Required | Description 설명 |
1006
+ | --- | --- | --- | --- |
1007
+ | `address` | `string` | **필수 / required** | 검색할 도메인 또는 IP (예: apick.app) |
1008
+
1009
+ ```json
1010
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"location","arguments":{"address":"<address>"}}}
1011
+ ```
1012
+
1013
+ <a id="ip-history"></a>
1014
+
1015
+ ### `ip_history` — IP 변경 이력 조회
1016
+
1017
+ Look up the historical IP address changes of a domain.
1018
+
1019
+ 도메인에 대한 IP 주소 변경 이력 정보를 조회합니다. 최상위 도메인 기준으로 조회되며 하위 도메인은 추적되지 않습니다.
1020
+
1021
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1022
+
1023
+ | Parameter | Type | Required | Description 설명 |
1024
+ | --- | --- | --- | --- |
1025
+ | `domain` | `string` | **필수 / required** | 검색할 도메인 (예: apick.app) |
1026
+
1027
+ ```json
1028
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ip_history","arguments":{"domain":"<domain>"}}}
1029
+ ```
1030
+
1031
+ <a id="whois"></a>
1032
+
1033
+ ### `whois` — WHOIS 조회
1034
+
1035
+ WHOIS lookup for a domain or IP address, returning registration and ownership information.
1036
+
1037
+ 특정 도메인 또는 IP의 WHOIS(등록·소유) 정보를 조회합니다. .kr/.한국 도메인, 국내 IP, AS번호(예: AS9318)는 KISA/KRNIC 원본 정보로 조회됩니다.
1038
+
1039
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1040
+
1041
+ | Parameter | Type | Required | Description 설명 |
1042
+ | --- | --- | --- | --- |
1043
+ | `address` | `string` | **필수 / required** | 검색할 도메인 또는 IP (예: apick.app) |
1044
+
1045
+ ```json
1046
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whois","arguments":{"address":"<address>"}}}
1047
+ ```
1048
+
1049
+ <a id="url-html"></a>
1050
+
1051
+ ### `url_html` — URL HTML 추출
1052
+
1053
+ Fetch a web page and return its rendered HTML source.
1054
+
1055
+ 입력한 URL의 페이지를 열어 HTML을 추출해 반환합니다. 자바스크립트 렌더링이 필요한 페이지도 처리됩니다.
1056
+
1057
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1058
+
1059
+ | Parameter | Type | Required | Description 설명 |
1060
+ | --- | --- | --- | --- |
1061
+ | `url` | `string` | **필수 / required** | 페이지 URL (예: https://apick.app) |
1062
+
1063
+ ```json
1064
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"url_html","arguments":{"url":"<url>"}}}
1065
+ ```
1066
+
1067
+ <a id="url-screenshot"></a>
1068
+
1069
+ ### `url_screenshot` — URL 화면캡처
1070
+
1071
+ Capture a screenshot of a web page and return it as a JPEG image.
1072
+
1073
+ 입력한 URL의 화면을 캡처해 JPEG 이미지로 반환합니다.
1074
+
1075
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1076
+
1077
+ | Parameter | Type | Required | Description 설명 |
1078
+ | --- | --- | --- | --- |
1079
+ | `url` | `string` | **필수 / required** | 페이지 URL (예: https://www.naver.com/) |
1080
+
1081
+ ```json
1082
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"url_screenshot","arguments":{"url":"<url>"}}}
1083
+ ```
1084
+
1085
+ <a id="url-similarity"></a>
1086
+
1087
+ ### `url_similarity` — URL 유사도 비교
1088
+
1089
+ Compare two web pages and judge how similar they are.
1090
+
1091
+ 입력한 두 사이트 페이지의 유사 여부를 분석해 유사도 결과를 반환합니다. 피싱·복제 사이트 판별 등에 활용할 수 있습니다.
1092
+
1093
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1094
+
1095
+ | Parameter | Type | Required | Description 설명 |
1096
+ | --- | --- | --- | --- |
1097
+ | `url1` | `string` | **필수 / required** | 비교할 첫 번째 페이지 URL |
1098
+ | `url2` | `string` | **필수 / required** | 비교할 두 번째 페이지 URL |
1099
+
1100
+ ```json
1101
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"url_similarity","arguments":{"url1":"<url1>","url2":"<url2>"}}}
1102
+ ```
1103
+
1104
+ <a id="google-search"></a>
1105
+
1106
+ ### `google_search` — 구글 키워드 검색
1107
+
1108
+ Google keyword search: return web search results (link, title, snippet) for a keyword.
1109
+
1110
+ 특정 키워드의 구글 검색 결과(링크·제목·요약)를 조회합니다. page 로 결과 페이지를 넘겨 가며 조회할 수 있습니다.
1111
+
1112
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1113
+
1114
+ | Parameter | Type | Required | Description 설명 |
1115
+ | --- | --- | --- | --- |
1116
+ | `keyword` | `string` | **필수 / required** | 검색할 키워드 |
1117
+ | `page` | `string` | 선택 / optional | 검색 결과 조회 페이지 (기본값 1) |
1118
+
1119
+ ```json
1120
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"google_search","arguments":{"keyword":"<keyword>"}}}
1121
+ ```
1122
+
1123
+ <a id="google-image-search"></a>
1124
+
1125
+ ### `google_image_search` — 구글 이미지 검색(키워드로 검색)
1126
+
1127
+ Google image search by keyword: return image results (image URL, source link, title).
1128
+
1129
+ 특정 키워드의 구글 이미지 검색 결과(이미지 URL·출처 링크·제목)를 조회합니다. page 로 결과 페이지를 넘겨 가며 조회할 수 있습니다.
1130
+
1131
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1132
+
1133
+ | Parameter | Type | Required | Description 설명 |
1134
+ | --- | --- | --- | --- |
1135
+ | `keyword` | `string` | **필수 / required** | 검색할 키워드 |
1136
+ | `page` | `string` | 선택 / optional | 검색 결과 조회 페이지 (기본값 1) |
1137
+
1138
+ ```json
1139
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"google_image_search","arguments":{"keyword":"<keyword>"}}}
1140
+ ```
1141
+
1142
+ <a id="google-lens-search"></a>
1143
+
1144
+ ### `google_lens_search` — 구글 렌즈 검색(이미지로 검색)
1145
+
1146
+ Reverse image search: upload an image and get visually matching web pages and labels.
1147
+
1148
+ 이미지 파일을 업로드해 해당 이미지와 관련된 웹 페이지(링크·이미지·텍스트)와 라벨을 조회합니다. 이미지 형식 파일만 허용됩니다.
1149
+
1150
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1151
+
1152
+ | Parameter | Type | Required | Description 설명 |
1153
+ | --- | --- | --- | --- |
1154
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, image/webp, image/gif, image/bmp, 최대 25MB |
1155
+
1156
+ ```json
1157
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"google_lens_search","arguments":{"image_url":"https://example.com/file"}}}
1158
+ ```
1159
+
1160
+ <a id="crawl-youtube"></a>
1161
+
1162
+ ### `crawl_youtube` — 유튜브 계정 정보 수집
1163
+
1164
+ Collect a YouTube channel profile and its latest uploaded videos.
1165
+
1166
+ 유튜브 계정(채널) 정보와 최근 게시한 동영상 정보를 수집해 반환합니다.
1167
+
1168
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1169
+
1170
+ | Parameter | Type | Required | Description 설명 |
1171
+ | --- | --- | --- | --- |
1172
+ | `user_id` | `string` | **필수 / required** | 수집할 유튜브 사용자(채널) 아이디 (예: CNN) |
1173
+
1174
+ ```json
1175
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"crawl_youtube","arguments":{"user_id":"<user_id>"}}}
1176
+ ```
1177
+
1178
+ <a id="download-youtube-video"></a>
1179
+
1180
+ ### `download_youtube_video` — 유튜브 동영상 다운로드
1181
+
1182
+ Download a publicly available YouTube video and return it as an MP4 file.
1183
+
1184
+ 유튜브에 공개된 동영상을 MP4 파일로 다운로드해 반환합니다. 비공개·차단된 게시글은 실패로 응답합니다.
1185
+
1186
+ > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `web`
1187
+
1188
+ | Parameter | Type | Required | Description 설명 |
1189
+ | --- | --- | --- | --- |
1190
+ | `url` | `string` | **필수 / required** | 유튜브 게시글 URL (예: https://www.youtube.com/watch?v=...) |
1191
+
1192
+ ```json
1193
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"download_youtube_video","arguments":{"url":"<url>"}}}
1194
+ ```
1195
+
1196
+ ---
1197
+
1198
+ <a id="convert"></a>
1199
+
1200
+ ## File Conversion · 파일 변환 · 워터마크
1201
+
1202
+ `https://apick.app/mcp/convert` — 22 tools
1203
+
1204
+ PDF, DOCX, Excel, speech-to-text, asynchronous TTS jobs, and watermarking.
1205
+
1206
+ PDF·DOCX·엑셀 변환, 음성인식(STT), 비동기 TTS, 워터마크.
1207
+
1208
+ | Tool | 기능 | Required 필수 |
1209
+ | --- | --- | --- |
1210
+ | [`stt`](#stt) | 오디오 텍스트 변환(STT) | `audio_url` |
1211
+ | [`tts_jobs_create`](#tts-jobs-create) | TTS 작업 접수 | `voice_id`, `text` |
1212
+ | [`tts_jobs_status`](#tts-jobs-status) | TTS 작업 상태 조회 | `job_id` |
1213
+ | [`tts_jobs_cancel`](#tts-jobs-cancel) | TTS 대기·생성 중 작업 취소 | `job_id` |
1214
+ | [`tts_jobs_result`](#tts-jobs-result) | TTS 결과 1회 다운로드 | `job_id` |
1215
+ | [`tts_jobs_subtitles`](#tts-jobs-subtitles) | TTS ASS 자막 1회 다운로드 | `job_id` |
1216
+ | [`voice_change`](#voice-change) | 음성 변조 | `type`, `media_url` |
1217
+ | [`face_blur`](#face-blur) | 얼굴 모자이크 처리 | `image_url` |
1218
+ | [`pdf_to_docx`](#pdf-to-docx) | PDF 파일 DOCX 변환 | `pdf_url` |
1219
+ | [`pdf_to_image`](#pdf-to-image) | PDF 파일 이미지 변환 | `pdf_url` |
1220
+ | [`pdf_merge`](#pdf-merge) | PDF 파일 합치기 | `pdf_url_1`, `pdf_url_2` |
1221
+ | [`html_to_pdf`](#html-to-pdf) | HTML PDF 변환 | `html` |
1222
+ | [`docx_to_pdf`](#docx-to-pdf) | DOCX 파일을 PDF 파일로 변환 | `docx_url` |
1223
+ | [`json_to_excel`](#json-to-excel) | JSON 데이터 EXCEL 파일 변환 | `data_list` |
1224
+ | [`base64_to_image`](#base64-to-image) | base64 이미지 변환 | `base64` |
1225
+ | [`set_watermark`](#set-watermark) | 비가시성 워터마크 삽입 | `code`, `image_url` |
1226
+ | [`get_watermark`](#get-watermark) | 비가시성 워터마크 조회 | `image_url` |
1227
+ | [`draw_watermark_pdf`](#draw-watermark-pdf) | PDF 워터마크 삽입 | `wm`, `pdf_url` |
1228
+ | [`draw_watermark_image`](#draw-watermark-image) | Image 워터마크 삽입 | `wm`, `image_url` |
1229
+
1230
+ <a id="stt"></a>
1231
+
1232
+ ### `stt` — 오디오 텍스트 변환(STT)
1233
+
1234
+ Convert a speech audio file to text (STT).
1235
+
1236
+ 음성 파일을 텍스트로 변환합니다. MP3, WAV, M4A, AAC, OGG, FLAC, WEBM 등 일반적인 오디오 포맷을 지원하며, 변환된 텍스트를 JSON으로 반환합니다.
1237
+
1238
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1239
+
1240
+ | Parameter | Type | Required | Description 설명 |
1241
+ | --- | --- | --- | --- |
1242
+ | `language` | `string` | 선택 / optional | 추출 언어 코드 (예: ko, en, ja). 기본값 ko |
1243
+ | `audio_url` | `string` (file) | **필수 / required** | https URL, audio/mpeg, audio/mp3, audio/wav, audio/x-wav, audio/mp4, audio/aac, audio/ogg, audio/flac, audio/webm, 최대 200MB |
1244
+
1245
+ ```json
1246
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"stt","arguments":{"audio_url":"https://example.com/file"}}}
1247
+ ```
1248
+
1249
+ <a id="tts-jobs-create"></a>
1250
+
1251
+ ### `tts_jobs_create` — TTS 작업 접수
1252
+
1253
+ 17개 중립 내레이션 목소리 중 하나로 유료 비동기 TTS 작업을 접수합니다. 접수 성공 시 즉시 과금되며 취소해도 환불되지 않습니다. `text`는 최대 800자입니다.
1254
+
1255
+ 표시 이름: `narrator_m_01` 태준, `narrator_m_02` 민석, `narrator_m_03` 도현, `narrator_m_04` 강우, `narrator_m_05` 성훈, `narrator_f_10s_01` 서아, `narrator_f_10s_02` 하린, `narrator_f_10s_03` 예린, `narrator_m_20s_01` 도윤, `narrator_f_20s_01` 지안, `narrator_f_20s_02` 서윤, `narrator_f_20s_03` 소연, `narrator_f_20s_04` 유나, `narrator_m_30s_01` 현우, `narrator_m_30s_02` 준혁, `narrator_m_40s_01` 정우, `narrator_m_80s_01` 영수.
1256
+
1257
+ > **부작용 있음 / has side effects** · 접수 시 과금 / charged on acceptance · server `convert`
1258
+
1259
+ | Parameter | Type | Required | Description 설명 |
1260
+ | --- | --- | --- | --- |
1261
+ | `voice_id` | `string` | **필수 / required** | 지원 `voice_id`. `narrator_m_01`–`05`, `narrator_f_10s_01`–`03`, `narrator_m_20s_01`, `narrator_f_20s_01`–`04`, `narrator_m_30s_01`–`02`, `narrator_m_40s_01`, `narrator_m_80s_01` |
1262
+ | `text` | `string` | **필수 / required** | 합성할 한국어 텍스트, 최대 800자 |
1263
+
1264
+ ```json
1265
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"tts_jobs_create","arguments":{"voice_id":"narrator_m_03","text":"오늘의 이야기를 시작합니다."}}}
1266
+ ```
1267
+
1268
+ <a id="tts-jobs-status"></a>
1269
+
1270
+ ### `tts_jobs_status` — TTS 작업 상태 조회
1271
+
1272
+ 작업의 `waiting`, `processing`, `completed`, `cancelled`, `failed` 공개 상태와 결과 준비 여부를 조회합니다. 추가 과금은 없습니다.
1273
+
1274
+ > 읽기 전용 / read-only · server `convert`
1275
+
1276
+ | Parameter | Type | Required | Description 설명 |
1277
+ | --- | --- | --- | --- |
1278
+ | `job_id` | `string` | **필수 / required** | 작업 접수에서 받은 32자리 ID |
1279
+
1280
+ ```json
1281
+ {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"tts_jobs_status","arguments":{"job_id":"<job_id>"}}}
1282
+ ```
1283
+
1284
+ <a id="tts-jobs-cancel"></a>
1285
+
1286
+ ### `tts_jobs_cancel` — TTS 대기·생성 중 작업 취소
1287
+
1288
+ `waiting` 또는 `processing` 상태에서 취소할 수 있으며 접수 시 과금된 금액은 환불되지 않습니다.
1289
+
1290
+ > **부작용 있음 / has side effects** · 환불 없음 / no refund · server `convert`
1291
+
1292
+ | Parameter | Type | Required | Description 설명 |
1293
+ | --- | --- | --- | --- |
1294
+ | `job_id` | `string` | **필수 / required** | 취소할 32자리 ID |
1295
+
1296
+ ```json
1297
+ {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"tts_jobs_cancel","arguments":{"job_id":"<job_id>"}}}
1298
+ ```
1299
+
1300
+ <a id="tts-jobs-result"></a>
1301
+
1302
+ ### `tts_jobs_result` — TTS 결과 1회 다운로드
1303
+
1304
+ 완료된 MP3(`audio/mpeg`) 결과를 base64로 반환합니다. Tool 호출로 다운로드가 시작되는 즉시 서버 원본이 폐기되므로, 호출 실패나 전송 중단을 포함해 재다운로드할 수 없습니다. 결과를 받을 준비가 된 클라이언트에서 한 번만 호출하세요.
1305
+
1306
+ > **파괴적 부작용 / destructive side effect** · 재실행 불가 / not idempotent · server `convert`
1307
+
1308
+ | Parameter | Type | Required | Description 설명 |
1309
+ | --- | --- | --- | --- |
1310
+ | `job_id` | `string` | **필수 / required** | `completed` 상태인 32자리 ID |
1311
+
1312
+ ```json
1313
+ {"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"tts_jobs_result","arguments":{"job_id":"<job_id>"}}}
1314
+ ```
1315
+
1316
+ <a id="tts-jobs-subtitles"></a>
1317
+
1318
+ ### `tts_jobs_subtitles` — TTS ASS 자막 1회 다운로드
1319
+
1320
+ 완료된 ASS 타이밍 자막(`text/x-ass`)을 base64로 반환합니다. MP3와 별도의 1회용 원본이므로 MP3를 먼저 다운로드해도 자막을 한 번 받을 수 있습니다. Tool 호출로 자막 다운로드가 시작되는 즉시 자막 원본이 폐기되므로, 호출 실패나 전송 중단을 포함해 재다운로드할 수 없습니다.
1321
+
1322
+ > **파괴적 부작용 / destructive side effect** · 재실행 불가 / not idempotent · server `convert`
1323
+
1324
+ | Parameter | Type | Required | Description 설명 |
1325
+ | --- | --- | --- | --- |
1326
+ | `job_id` | `string` | **필수 / required** | `completed` 상태인 32자리 ID |
1327
+
1328
+ ```json
1329
+ {"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"tts_jobs_subtitles","arguments":{"job_id":"<job_id>"}}}
1330
+ ```
1331
+
1332
+ <a id="voice-change"></a>
1333
+
1334
+ ### `voice_change` — 음성 변조
1335
+
1336
+ Modulate the voice in a video or audio file to a lower or higher pitch.
1337
+
1338
+ 동영상 또는 오디오 파일의 음성을 저음 또는 고음으로 변조합니다. MP3, WAV 등 오디오와 MP4, MOV 등 동영상 포맷을 지원하며, 변조된 파일을 반환합니다.
1339
+
1340
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1341
+
1342
+ | Parameter | Type | Required | Description 설명 |
1343
+ | --- | --- | --- | --- |
1344
+ | `type` | `string` | **필수 / required** | 변조음 타입 (1: 저음, 2: 고음) |
1345
+ | `media_url` | `string` (file) | **필수 / required** | https URL, audio/mpeg, audio/mp3, audio/wav, audio/x-wav, audio/mp4, audio/aac, audio/ogg, video/mp4, video/quicktime, video/x-msvideo, video/x-matroska, video/webm, 최대 200MB |
1346
+
1347
+ ```json
1348
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"voice_change","arguments":{"type":"<type>","media_url":"https://example.com/file"}}}
1349
+ ```
1350
+
1351
+ <a id="face-blur"></a>
1352
+
1353
+ ### `face_blur` — 얼굴 모자이크 처리
1354
+
1355
+ Detect faces in an image and blur (mosaic) them.
1356
+
1357
+ 이미지 파일에서 얼굴을 인식해 해당 영역을 모자이크 처리한 이미지(JPEG)를 반환합니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다.
1358
+
1359
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1360
+
1361
+ | Parameter | Type | Required | Description 설명 |
1362
+ | --- | --- | --- | --- |
1363
+ | `threshold` | `number` | 선택 / optional | 얼굴 추출 민감도 (0 ~ 0.9, 기본값 0.5, 작을수록 민감하게 추출) |
1364
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, image/webp, image/bmp, 최대 25MB |
1365
+
1366
+ ```json
1367
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"face_blur","arguments":{"image_url":"https://example.com/file"}}}
1368
+ ```
1369
+
1370
+ <a id="pdf-to-docx"></a>
1371
+
1372
+ ### `pdf_to_docx` — PDF 파일 DOCX 변환
1373
+
1374
+ Convert a PDF file to a DOCX (Word) file.
1375
+
1376
+ PDF 파일을 DOCX 파일로 변환해 반환합니다. PDF 형식의 파일만 허용됩니다.
1377
+
1378
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1379
+
1380
+ | Parameter | Type | Required | Description 설명 |
1381
+ | --- | --- | --- | --- |
1382
+ | `pdf_url` | `string` (file) | **필수 / required** | https URL, application/pdf, 최대 25MB |
1383
+
1384
+ ```json
1385
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pdf_to_docx","arguments":{"pdf_url":"https://example.com/file"}}}
1386
+ ```
1387
+
1388
+ <a id="pdf-to-image"></a>
1389
+
1390
+ ### `pdf_to_image` — PDF 파일 이미지 변환
1391
+
1392
+ Convert each page of a PDF file to PNG images, returned as a ZIP archive.
1393
+
1394
+ PDF 파일의 각 페이지를 PNG 이미지로 변환하고 ZIP 파일로 묶어 반환합니다. PDF 형식의 파일만 허용됩니다.
1395
+
1396
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1397
+
1398
+ | Parameter | Type | Required | Description 설명 |
1399
+ | --- | --- | --- | --- |
1400
+ | `pdf_url` | `string` (file) | **필수 / required** | https URL, application/pdf, 최대 25MB |
1401
+
1402
+ ```json
1403
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pdf_to_image","arguments":{"pdf_url":"https://example.com/file"}}}
1404
+ ```
1405
+
1406
+ <a id="pdf-merge"></a>
1407
+
1408
+ ### `pdf_merge` — PDF 파일 합치기
1409
+
1410
+ Merge two PDF files into one.
1411
+
1412
+ 두 개의 PDF 파일을 순서대로 하나의 PDF 파일로 합쳐 반환합니다. PDF 형식의 파일만 허용됩니다.
1413
+
1414
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1415
+
1416
+ | Parameter | Type | Required | Description 설명 |
1417
+ | --- | --- | --- | --- |
1418
+ | `pdf_url_1` | `string` (file) | **필수 / required** | https URL, application/pdf, 최대 25MB |
1419
+ | `pdf_url_2` | `string` (file) | **필수 / required** | https URL, application/pdf, 최대 25MB |
1420
+
1421
+ ```json
1422
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pdf_merge","arguments":{"pdf_url_1":"https://example.com/file","pdf_url_2":"https://example.com/file"}}}
1423
+ ```
1424
+
1425
+ <a id="html-to-pdf"></a>
1426
+
1427
+ ### `html_to_pdf` — HTML PDF 변환
1428
+
1429
+ Render HTML code into a PDF file.
1430
+
1431
+ HTML 코드를 렌더링해 PDF 파일로 변환합니다. HTML 문자열을 입력하면 변환된 PDF 파일을 반환합니다.
1432
+
1433
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1434
+
1435
+ | Parameter | Type | Required | Description 설명 |
1436
+ | --- | --- | --- | --- |
1437
+ | `html` | `string` | **필수 / required** | 변환할 HTML 코드 |
1438
+ | `pagination` | `integer` | 선택 / optional | 페이지 번호 표시 여부 (0: 없음(기본값), 1: 표시) |
1439
+
1440
+ ```json
1441
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"html_to_pdf","arguments":{"html":"<html>"}}}
1442
+ ```
1443
+
1444
+ <a id="docx-to-pdf"></a>
1445
+
1446
+ ### `docx_to_pdf` — DOCX 파일을 PDF 파일로 변환
1447
+
1448
+ Convert a DOCX (Word) file to a PDF file.
1449
+
1450
+ DOCX 파일을 PDF 파일로 변환해 반환합니다. DOCX 형식의 파일만 허용됩니다.
1451
+
1452
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1453
+
1454
+ | Parameter | Type | Required | Description 설명 |
1455
+ | --- | --- | --- | --- |
1456
+ | `docx_url` | `string` (file) | **필수 / required** | https URL, application/vnd.openxmlformats-officedocument.wordprocessingml.document, 최대 25MB |
1457
+
1458
+ ```json
1459
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"docx_to_pdf","arguments":{"docx_url":"https://example.com/file"}}}
1460
+ ```
1461
+
1462
+ <a id="json-to-excel"></a>
1463
+
1464
+ ### `json_to_excel` — JSON 데이터 EXCEL 파일 변환
1465
+
1466
+ Convert JSON data into an Excel (XLSX) file.
1467
+
1468
+ JSON 데이터를 EXCEL(XLSX) 파일로 변환해 반환합니다. data_list 는 객체 배열([{"컬럼":"값", ...}, ...]) 또는 2차원 배열([[...], ...]) 형식을 지원합니다.
1469
+
1470
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1471
+
1472
+ | Parameter | Type | Required | Description 설명 |
1473
+ | --- | --- | --- | --- |
1474
+ | `data_list` | `array` | **필수 / required** | 변환할 데이터 목록. 객체 배열 또는 2차원 배열 (2차원 배열은 모든 행의 열 개수가 같아야 함) |
1475
+ | `sheet_name` | `string` | 선택 / optional | 엑셀 시트 이름 |
1476
+
1477
+ ```json
1478
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"json_to_excel","arguments":{"data_list":"<data_list>"}}}
1479
+ ```
1480
+
1481
+ <a id="base64-to-image"></a>
1482
+
1483
+ ### `base64_to_image` — base64 이미지 변환
1484
+
1485
+ Decode a base64-encoded image string back into an image file.
1486
+
1487
+ base64 로 인코딩된 이미지 문자열을 원본 이미지 파일로 디코딩해 반환합니다. "data:image/타입;base64," 접두어가 붙은 문자열도 허용됩니다.
1488
+
1489
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1490
+
1491
+ | Parameter | Type | Required | Description 설명 |
1492
+ | --- | --- | --- | --- |
1493
+ | `base64` | `string` | **필수 / required** | 이미지 base64 문자열 (data:image/타입;base64, 접두어 허용) |
1494
+
1495
+ ```json
1496
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"base64_to_image","arguments":{"base64":"<base64>"}}}
1497
+ ```
1498
+
1499
+ <a id="set-watermark"></a>
1500
+
1501
+ ### `set_watermark` — 비가시성 워터마크 삽입
1502
+
1503
+ Embed an invisible watermark code into an image.
1504
+
1505
+ 원본 이미지에 보이지 않는 워터마크 코드를 삽입한 PNG 이미지를 반환합니다. 이미지가 일부 변형되어도 높은 확률로 워터마크를 확인할 수 있습니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다.
1506
+
1507
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1508
+
1509
+ | Parameter | Type | Required | Description 설명 |
1510
+ | --- | --- | --- | --- |
1511
+ | `code` | `integer` | **필수 / required** | 삽입할 워터마크 코드 (1 ~ 21,767,823,359 사이의 숫자) |
1512
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, image/webp, image/bmp, 최대 25MB |
1513
+
1514
+ ```json
1515
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"set_watermark","arguments":{"code":1,"image_url":"https://example.com/file"}}}
1516
+ ```
1517
+
1518
+ <a id="get-watermark"></a>
1519
+
1520
+ ### `get_watermark` — 비가시성 워터마크 조회
1521
+
1522
+ Read the invisible watermark code embedded in an image.
1523
+
1524
+ 이미지에 삽입된 비가시성 워터마크 코드를 조회해 JSON 으로 반환합니다. 이미지가 일부 변형되어도 높은 확률로 워터마크를 확인할 수 있습니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다.
1525
+
1526
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1527
+
1528
+ | Parameter | Type | Required | Description 설명 |
1529
+ | --- | --- | --- | --- |
1530
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, image/webp, image/bmp, 최대 25MB |
1531
+
1532
+ ```json
1533
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_watermark","arguments":{"image_url":"https://example.com/file"}}}
1534
+ ```
1535
+
1536
+ <a id="draw-watermark-pdf"></a>
1537
+
1538
+ ### `draw_watermark_pdf` — PDF 워터마크 삽입
1539
+
1540
+ Draw a visible text watermark across every page of a PDF file.
1541
+
1542
+ PDF 파일 전체 페이지에 텍스트 워터마크를 삽입한 PDF 를 반환합니다. 글자 크기·색상·투명도·각도·밀집도·적용 영역을 조절할 수 있으며, PDF 형식의 파일만 허용됩니다.
1543
+
1544
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1545
+
1546
+ | Parameter | Type | Required | Description 설명 |
1547
+ | --- | --- | --- | --- |
1548
+ | `wm` | `string` | **필수 / required** | 워터마크 문자열 (최대 30자) |
1549
+ | `font_size` | `integer` | 선택 / optional | 워터마크 글자 크기 (8 ~ 30, 기본값 10) |
1550
+ | `color` | `string` | 선택 / optional | 워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE) |
1551
+ | `opacity` | `number` | 선택 / optional | 워터마크 투명도 (0 ~ 1, 기본값 0.05) |
1552
+ | `angle` | `integer` | 선택 / optional | 워터마크 각도 (0 ~ 360, 기본값 35) |
1553
+ | `density` | `integer` | 선택 / optional | 워터마크 글자 밀집도 (100 ~ 200, 기본값 150) |
1554
+ | `width` | `integer` | 선택 / optional | 워터마크 적용 너비 (0 ~ 2000, 기본값 550, A4 기준) |
1555
+ | `height` | `integer` | 선택 / optional | 워터마크 적용 높이 (0 ~ 2000, 기본값 800, A4 기준) |
1556
+ | `pdf_url` | `string` (file) | **필수 / required** | https URL, application/pdf, 최대 25MB |
1557
+
1558
+ ```json
1559
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"draw_watermark_pdf","arguments":{"wm":"<wm>","pdf_url":"https://example.com/file"}}}
1560
+ ```
1561
+
1562
+ <a id="draw-watermark-image"></a>
1563
+
1564
+ ### `draw_watermark_image` — Image 워터마크 삽입
1565
+
1566
+ Draw a visible text watermark across an image.
1567
+
1568
+ 이미지 파일에 텍스트 워터마크를 삽입한 PNG 이미지를 반환합니다. 글자 크기·색상·투명도·밀집도를 조절할 수 있으며, PNG, JPEG 등 일반 이미지 포맷을 지원합니다.
1569
+
1570
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
1571
+
1572
+ | Parameter | Type | Required | Description 설명 |
1573
+ | --- | --- | --- | --- |
1574
+ | `wm` | `string` | **필수 / required** | 워터마크 문자열 (최대 30자) |
1575
+ | `font_size` | `integer` | 선택 / optional | 워터마크 글자 크기 (10 ~ 100, 기본값 10) |
1576
+ | `color` | `string` | 선택 / optional | 워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE) |
1577
+ | `opacity` | `number` | 선택 / optional | 워터마크 투명도 (0 ~ 1, 기본값 0.5) |
1578
+ | `density` | `integer` | 선택 / optional | 워터마크 글자 밀집도 (5 ~ 15, 기본값 10) |
1579
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/png, image/jpeg, image/webp, image/bmp, 최대 25MB |
1580
+
1581
+ ```json
1582
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"draw_watermark_image","arguments":{"wm":"<wm>","image_url":"https://example.com/file"}}}
1583
+ ```
1584
+
1585
+ ---
1586
+
1587
+ <a id="vision"></a>
1588
+
1589
+ ## Vision · 이미지 · 영상 분석
1590
+
1591
+ `https://apick.app/mcp/vision` — 6 tools
1592
+
1593
+ Face detection, image similarity, NSFW detection, and video extraction.
1594
+
1595
+ 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출.
1596
+
1597
+ | Tool | 기능 | Required 필수 |
1598
+ | --- | --- | --- |
1599
+ | [`nsfw_detection`](#nsfw-detection) | 선정적인 컨텐츠(NSFW) 탐지 | `image_url` |
1600
+ | [`image_similarity`](#image-similarity) | 이미지 유사도 비교 | `image_url`, `compare_image_url` |
1601
+ | [`video_to_mp3`](#video-to-mp3) | 동영상 MP3 추출 | `video_url` |
1602
+ | [`extract_video_thumbnail`](#extract-video-thumbnail) | 동영상 미리보기 이미지 추출 | `video_url` |
1603
+ | [`word_cloud`](#word-cloud) | 워드클라우드 생성 | `text` |
1604
+ | [`face_detection`](#face-detection) | 이미지 얼굴 인식 | `image_url` |
1605
+
1606
+ <a id="nsfw-detection"></a>
1607
+
1608
+ ### `nsfw_detection` — 선정적인 컨텐츠(NSFW) 탐지
1609
+
1610
+ Detect whether an image contains NSFW (violent or sexually explicit) content and return an nsfw_score.
1611
+
1612
+ 이미지가 NSFW(폭력적·선정적) 콘텐츠인지 탐지해 nsfw_score 를 반환합니다. detail=1 입력 시 세부 판정 결과를 함께 반환합니다.
1613
+
1614
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1615
+
1616
+ | Parameter | Type | Required | Description 설명 |
1617
+ | --- | --- | --- | --- |
1618
+ | `detail` | `string` | 선택 / optional | 세부 판정 결과 포함 여부 (포함: 1, 미포함: 0, 기본값 0) |
1619
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, image/webp, image/bmp, 최대 25MB |
1620
+
1621
+ ```json
1622
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nsfw_detection","arguments":{"image_url":"https://example.com/file"}}}
1623
+ ```
1624
+
1625
+ <a id="image-similarity"></a>
1626
+
1627
+ ### `image_similarity` — 이미지 유사도 비교
1628
+
1629
+ Compare a base image with another image and return a similarity score.
1630
+
1631
+ 기준 이미지와 비교 대상 이미지의 유사도를 분석해 점수를 반환합니다. 원본 검증, 중복 이미지 탐지 등에 사용합니다.
1632
+
1633
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1634
+
1635
+ | Parameter | Type | Required | Description 설명 |
1636
+ | --- | --- | --- | --- |
1637
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, image/webp, image/bmp, 최대 25MB |
1638
+ | `compare_image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, image/webp, image/bmp, 최대 25MB |
1639
+
1640
+ ```json
1641
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"image_similarity","arguments":{"image_url":"https://example.com/file","compare_image_url":"https://example.com/file"}}}
1642
+ ```
1643
+
1644
+ <a id="video-to-mp3"></a>
1645
+
1646
+ ### `video_to_mp3` — 동영상 MP3 추출
1647
+
1648
+ Extract the audio track of a video file as an MP3 file.
1649
+
1650
+ 동영상 파일에서 오디오를 추출해 MP3 파일로 반환합니다.
1651
+
1652
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1653
+
1654
+ | Parameter | Type | Required | Description 설명 |
1655
+ | --- | --- | --- | --- |
1656
+ | `video_url` | `string` (file) | **필수 / required** | https URL, video/mp4, video/quicktime, video/x-msvideo, video/webm, video/x-matroska, 최대 200MB |
1657
+
1658
+ ```json
1659
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"video_to_mp3","arguments":{"video_url":"https://example.com/file"}}}
1660
+ ```
1661
+
1662
+ <a id="extract-video-thumbnail"></a>
1663
+
1664
+ ### `extract_video_thumbnail` — 동영상 미리보기 이미지 추출
1665
+
1666
+ Extract preview thumbnail images from a video at regular intervals and return them as a ZIP file.
1667
+
1668
+ 동영상에서 일정 구간마다 미리보기 이미지를 추출해 ZIP 파일로 반환합니다.
1669
+
1670
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1671
+
1672
+ | Parameter | Type | Required | Description 설명 |
1673
+ | --- | --- | --- | --- |
1674
+ | `width` | `string` | 선택 / optional | 이미지 가로 길이 (범위: 100 ~ 2000, 기본값 480). 세로 길이는 가로 비율에 따라 자동 계산 |
1675
+ | `count` | `string` | 선택 / optional | 추출할 이미지 개수 (범위: 0 ~ 200, 기본값 100) |
1676
+ | `video_url` | `string` (file) | **필수 / required** | https URL, video/mp4, video/quicktime, video/x-msvideo, video/webm, video/x-matroska, 최대 200MB |
1677
+
1678
+ ```json
1679
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"extract_video_thumbnail","arguments":{"video_url":"https://example.com/file"}}}
1680
+ ```
1681
+
1682
+ <a id="word-cloud"></a>
1683
+
1684
+ ### `word_cloud` — 워드클라우드 생성
1685
+
1686
+ Generate a word cloud image (JPEG) from input text, sizing each word by frequency.
1687
+
1688
+ 입력 텍스트를 구성하는 단어의 중요도(빈도수)에 따라 서로 다른 크기의 단어로 이루어진 워드클라우드 이미지(JPEG)를 생성해 반환합니다.
1689
+
1690
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1691
+
1692
+ | Parameter | Type | Required | Description 설명 |
1693
+ | --- | --- | --- | --- |
1694
+ | `text` | `string` | **필수 / required** | 워드클라우드를 생성할 텍스트 |
1695
+
1696
+ ```json
1697
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"word_cloud","arguments":{"text":"<text>"}}}
1698
+ ```
1699
+
1700
+ <a id="face-detection"></a>
1701
+
1702
+ ### `face_detection` — 이미지 얼굴 인식
1703
+
1704
+ Detect faces in an image and return their coordinates.
1705
+
1706
+ 이미지 파일에서 얼굴을 인식해 해당 좌표를 반환합니다. use_feature=1 입력 시 얼굴 특징 정보를 함께 반환합니다.
1707
+
1708
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `vision`
1709
+
1710
+ | Parameter | Type | Required | Description 설명 |
1711
+ | --- | --- | --- | --- |
1712
+ | `threshold` | `string` | 선택 / optional | 얼굴 추출 민감도 (범위: 0 ~ 0.9, 기본값 0.5, 높을수록 정확한 얼굴만 추출) |
1713
+ | `use_feature` | `string` | 선택 / optional | 얼굴 특징 정보 포함 여부 (포함: 1, 미포함: 0, 기본값 0) |
1714
+ | `image_url` | `string` (file) | **필수 / required** | https URL, image/jpeg, image/png, image/webp, image/bmp, 최대 25MB |
1715
+
1716
+ ```json
1717
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"face_detection","arguments":{"image_url":"https://example.com/file"}}}
1718
+ ```
1719
+
1720
+ ---
1721
+
1722
+ <a id="ai"></a>
1723
+
1724
+ ## AI & LLM · AI · LLM
1725
+
1726
+ `https://apick.app/mcp/ai` — 15 tools
1727
+
1728
+ LLM chat across multiple models, text summarization and polishing, and asynchronous AI video generation.
1729
+
1730
+ LLM 챗(다중 모델), 텍스트 요약·교정, 비동기 AI 영상 생성.
1731
+
1732
+ | Tool | 기능 | Required 필수 |
1733
+ | --- | --- | --- |
1734
+ | [`llm_models`](#llm-models) | LLM 모델 카탈로그 | — |
1735
+ | [`llm_chat`](#llm-chat) | LLM 채팅 | `model` |
1736
+ | [`text_summary`](#text-summary) | 텍스트 요약 AI | `text` |
1737
+ | [`text_polish`](#text-polish) | 텍스트 다듬기 AI | `text` |
1738
+ | `image_generate` | 텍스트 또는 참고 이미지와 텍스트로 이미지 한 장 생성 | `prompt`, `reference_image_url?`, `size?`, `output_format?`, `background?`, `idempotency_key?` |
1739
+ | `image_edit` | 이미지 한 장 편집 | `image_url`, `prompt` 및 출력 옵션 |
1740
+ | `image_batch_create` | 이미지 대량 작업 생성 | `mode`, `prompt`, `image_count`, 참고·편집 파일 및 출력 옵션 |
1741
+ | `image_batch_status` | 대량 작업 상태 조회 | `job_id` |
1742
+ | `image_batch_result` | 대량 작업 개별 결과 | `job_id`, `index` |
1743
+ | [`seedance_jobs_create`](#seedance-jobs-create) | Seedance 영상 작업 접수 | `prompt` |
1744
+ | [`seedance_jobs_status`](#seedance-jobs-status) | Seedance 영상 작업 상태 | `job_id` |
1745
+ | [`veo_jobs_create`](#veo-jobs-create) | Veo 영상 작업 접수 | `prompt` |
1746
+ | [`veo_jobs_status`](#veo-jobs-status) | Veo 영상 작업 상태 | `job_id` |
1747
+ | [`kling_jobs_create`](#kling-jobs-create) | Kling 영상 작업 접수 | `prompt` |
1748
+ | [`kling_jobs_status`](#kling-jobs-status) | Kling 영상 작업 상태 | `job_id` |
1749
+
1750
+ 이미지 생성·편집은 한 장당 25포인트입니다. 작업 접수 시 요청 장수 전체 금액을 먼저 차감하고, 생성에 실패한 이미지가 있으면 해당 장수의 포인트를 즉시 환급합니다. 접수된 작업은 취소할 수 없습니다. `image_generate`에 `reference_image_url`을 더하면 참고 이미지의 구도·색감·제품 형태와 프롬프트를 함께 반영할 수 있습니다. 편집은 원본 이미지 한 장과 프롬프트만 받으며 마스크 파일은 지원하지 않습니다. 동기 Tool은 응답 크기를 위해 한 장만 반환하며, 대량 작업은 `image_count`에 1~50을 지정한 뒤 `image_batch_result`로 한 장씩 가져옵니다. 크기는 `1024x1024`, `1536x1024`, `1024x1536`, `1152x864`, `864x1152` 중에서 고릅니다. PNG·JPEG·WebP와 PNG/WebP 투명 배경 미리보기를 지원합니다. 프롬프트는 최대 28,000자이고 완료 결과는 24시간 동안 반복 조회할 수 있습니다. `idempotency_key`는 같은 요청의 중복 생성·과금을 막는 8~128자 안전번호이며, 동일 요청을 재전송할 때만 같은 값을 사용합니다.
1751
+
1752
+ 예: `흰색 대리석 테이블 위의 무광 검정 텀블러, 부드러운 아침 자연광, 제품 전체가 프레임 안에 보이게, 이미지 안 글자 없음`처럼 피사체·배경·조명·구도·금지 요소를 구체적으로 적습니다. 글자를 넣을 때는 `상단 중앙에 '가을 산책'을 또렷한 짙은 남색 한글로, 다른 글자 없음`처럼 실제 문구와 위치를 함께 지정합니다.
1753
+
1754
+ <a id="llm-models"></a>
1755
+
1756
+ ### `llm_models` — LLM 모델 카탈로그
1757
+
1758
+ List available text-generation LLM models with per-token pricing and max context.
1759
+
1760
+ 텍스트 생성 모델 카탈로그를 반환합니다. 각 모델의 1M 토큰당 input/output 단가(포인트), 계열·크기·멀티모달 여부·태그·추천 용도(use_cases)·max_context 를 한 응답에 포함합니다. llm_chat Tool의 model 입력값을 찾을 때 사용합니다. 무료입니다.
1761
+
1762
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1763
+
1764
+ | Parameter | Type | Required | Description 설명 |
1765
+ | --- | --- | --- | --- |
1766
+ | `family` | `string` | 선택 / optional | 모델 계열 필터 (deepseek, qwen, glm, google, nvidia, llama, mistral, gpt-oss, moonshot, seed, mimo, phi) |
1767
+ | `tag` | `string` | 선택 / optional | 특수 태그 필터 — 'reasoning'(추론 특화) \| 'coder'(코딩 특화) |
1768
+ | `use_case` | `string` | 선택 / optional | 추천 용도 필터 — 'general' \| 'reasoning' \| 'coding' \| 'multimodal' \| 'economy' |
1769
+ | `multimodal` | `boolean` | 선택 / optional | 멀티모달(이미지 이해) 지원 여부 필터 (true/false) |
1770
+
1771
+ ```json
1772
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"llm_models","arguments":{}}}
1773
+ ```
1774
+
1775
+ <a id="llm-chat"></a>
1776
+
1777
+ ### `llm_chat` — LLM 채팅
1778
+
1779
+ Send a chat request to a selected LLM model and receive the assistant reply.
1780
+
1781
+ 선택한 LLM 모델에 대화를 보내고 assistant 응답을 받습니다. 서버는 대화 히스토리를 보관하지 않는 stateless 방식 — 매 호출마다 전체 히스토리를 messages 로 전송하고, 응답의 compacted_messages 를 다음 턴의 messages 로 그대로 재사용합니다. 사용 가능한 모델은 llm_models Tool로 조회합니다. 토큰 사용량에 비례해 포인트가 차감됩니다.
1782
+
1783
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1784
+
1785
+ | Parameter | Type | Required | Description 설명 |
1786
+ | --- | --- | --- | --- |
1787
+ | `model` | `string` | **필수 / required** | 모델 id (`llm_models` Tool로 조회) |
1788
+ | `messages` | `array` | 선택 / optional | 채팅 메시지 [{role, content}] 배열. role 은 'system'\|'user'\|'assistant'. content 와 둘 중 하나는 필수, 동시 지정 시 messages 우선. 멀티턴 대화는 응답의 compacted_messages 를 다음 턴에 그대로 전송 |
1789
+ | `content` | `string` | 선택 / optional | 단발 입력 — 사용자 메시지 한 건만 보내는 간편 형태. messages 와 둘 중 하나는 필수 |
1790
+ | `system` | `string` | 선택 / optional | system 프롬프트 (역할·페르소나·정책·배경지식). 미지정 시 기본 한국어 어시스턴트 프롬프트가 적용됩니다 |
1791
+ | `compact` | `object` | 선택 / optional | 히스토리 압축 옵션 { strategy: 'none'(기본) \| 'sliding_window', window_pairs: 유지할 user/assistant 페어 수 (기본 10, 최소 1) }. 긴 대화의 input 토큰 누적 방지 |
1792
+ | `temperature` | `number` | 선택 / optional | 출력 다양성 0.0~2.0. 낮을수록 재현성, 높을수록 창의성 (미지정 시 모델 기본값) |
1793
+ | `max_tokens` | `integer` | 선택 / optional | 응답 최대 토큰. 미지정 시 모델 컨텍스트 기반 안전 상한으로 자동 설정, 상한 초과 지정 시 자동 조정 |
1794
+ | `speed` | `string` | 선택 / optional | 응답 속도/추론 깊이 — 'fast'(얕게, 빠름) \| 'medium' \| 'slow'(깊게, 느림). 한글 '빠름'\|'중간'\|'느림' 허용. 추론 특화 모델에서 효과가 큽니다 |
1795
+
1796
+ ```json
1797
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"llm_chat","arguments":{"model":"<model>"}}}
1798
+ ```
1799
+
1800
+ <a id="text-summary"></a>
1801
+
1802
+ ### `text_summary` — 텍스트 요약 AI
1803
+
1804
+ Summarize a long text (up to 100,000 characters) into a concise Korean summary.
1805
+
1806
+ 입력 텍스트(최대 10만 자)의 핵심 내용을 간결하고 정확하게 요약합니다. 모델·파라미터는 서버가 고정하며 빠른 응답에 최적화되어 있습니다. 토큰 수와 무관하게 요청당 고정 포인트가 차감됩니다.
1807
+
1808
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1809
+
1810
+ | Parameter | Type | Required | Description 설명 |
1811
+ | --- | --- | --- | --- |
1812
+ | `text` | `string` | **필수 / required** | 요약할 원문 텍스트 (최대 100,000자) |
1813
+
1814
+ ```json
1815
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"text_summary","arguments":{"text":"<text>"}}}
1816
+ ```
1817
+
1818
+ <a id="text-polish"></a>
1819
+
1820
+ ### `text_polish` — 텍스트 다듬기 AI
1821
+
1822
+ Polish a text (up to 100,000 characters) by fixing grammar, spelling, and awkward phrasing.
1823
+
1824
+ 입력 텍스트(최대 10만 자)의 문법 오류, 맞춤법·오타, 어색한 표현, 문장 순서를 의미를 유지한 채 자연스럽게 다듬습니다. 모델·파라미터는 서버가 고정하며 빠른 응답에 최적화되어 있습니다. 토큰 수와 무관하게 요청당 고정 포인트가 차감됩니다.
1825
+
1826
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1827
+
1828
+ | Parameter | Type | Required | Description 설명 |
1829
+ | --- | --- | --- | --- |
1830
+ | `text` | `string` | **필수 / required** | 다듬을 원문 텍스트 (최대 100,000자) |
1831
+
1832
+ ```json
1833
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"text_polish","arguments":{"text":"<text>"}}}
1834
+ ```
1835
+
1836
+ 영상 생성 3종(`seedance_jobs_create`, `veo_jobs_create`, `kling_jobs_create`)은 모두 **비동기**입니다 — 접수하면 `job_id`와 함께 `waiting` 상태를 받고, 각 `*_jobs_status` Tool로 폴링하다가 `completed`가 되면 응답의 `result_url`(REST 다운로드 주소, 완료 후 7일 이내 유효)로 내려받습니다. 영상 파일 자체는 Tool 응답 크기 제한 때문에 MCP로 직접 전달하지 않습니다. 과금은 `duration × 초당 포인트`가 접수 시 예약 차감되고 완료 시 그대로 확정되며, 실패하거나 처리 시간이 초과되면 전액 환불됩니다. Seedance는 기본적으로 오디오를 함께 생성하는데(`audio: true`), 생성된 오디오가 저작권 등 정책 검수에서 거부되면 작업이 실패로 끝나고 예약 포인트가 전액 환불됩니다 — 이 거부를 피하려면 `audio: false`로 접수하세요.
1837
+
1838
+ <a id="seedance-jobs-create"></a>
1839
+
1840
+ ### `seedance_jobs_create` — Seedance 영상 작업 접수
1841
+
1842
+ Submit an asynchronous Seedance video generation job combining text, image, or reference inputs into up to a 30-second video.
1843
+
1844
+ Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `seedance_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 610포인트`가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
1845
+
1846
+ > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `ai`
1847
+
1848
+ | Parameter | Type | Required | Description 설명 |
1849
+ | --- | --- | --- | --- |
1850
+ | `prompt` | `string` | **필수 / required** | 영상 생성 프롬프트, 최대 2,000자 |
1851
+ | `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text |
1852
+ | `duration` | `integer` | 선택 / optional | 영상 길이(초), 4~30, 기본 5 |
1853
+ | `aspect_ratio` | `string` | 선택 / optional | 가로세로 비율 — `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` 중 하나, 기본 16:9 |
1854
+ | `resolution` | `string` | 선택 / optional | 해상도 — `480p`, `720p` 중 하나, 기본 720p |
1855
+ | `audio` | `boolean` | 선택 / optional | 오디오 생성 여부, 기본 true. 생성된 오디오가 정책(저작권 등) 검수에서 거부되면 작업이 실패하고 전액 환불됩니다 |
1856
+ | `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
1857
+ | `image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1858
+ | `last_image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1859
+ | `reference_image_url` | `string` (file) | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1860
+ | `reference_image_url_2` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(2번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1861
+ | `reference_image_url_3` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(3번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1862
+ | `reference_video_url` | `string` (file) | 선택 / optional | reference 모드에서 동작을 참조할 영상 URL — https URL, video/mp4, video/quicktime, video/webm, 최대 50MB |
1863
+
1864
+ ```json
1865
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"seedance_jobs_create","arguments":{"prompt":"<prompt>"}}}
1866
+ ```
1867
+
1868
+ <a id="seedance-jobs-status"></a>
1869
+
1870
+ ### `seedance_jobs_status` — Seedance 영상 작업 상태
1871
+
1872
+ Check the status of a Seedance video generation job submitted via `seedance_jobs_create`.
1873
+
1874
+ Seedance 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 `result_url`(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다.
1875
+
1876
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1877
+
1878
+ | Parameter | Type | Required | Description 설명 |
1879
+ | --- | --- | --- | --- |
1880
+ | `job_id` | `string` | **필수 / required** | 작업 ID |
1881
+
1882
+ ```json
1883
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"seedance_jobs_status","arguments":{"job_id":"<job_id>"}}}
1884
+ ```
1885
+
1886
+ <a id="veo-jobs-create"></a>
1887
+
1888
+ ### `veo_jobs_create` — Veo 영상 작업 접수
1889
+
1890
+ Submit an asynchronous Veo video generation job combining text, image, or reference images into a 4/6/8-second high-quality video.
1891
+
1892
+ Veo 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `veo_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 포인트`(등급별 단가는 요금 절 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
1893
+
1894
+ > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `ai`
1895
+
1896
+ | Parameter | Type | Required | Description 설명 |
1897
+ | --- | --- | --- | --- |
1898
+ | `prompt` | `string` | **필수 / required** | 영상 생성 프롬프트, 최대 2,000자 |
1899
+ | `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지로 주체 지정). 기본 text |
1900
+ | `duration` | `integer` | 선택 / optional | 영상 길이(초). 4, 6, 8 중 하나만 허용, 기본 8 |
1901
+ | `aspect_ratio` | `string` | 선택 / optional | 가로세로 비율 — `16:9`, `9:16` 중 하나, 기본 16:9 |
1902
+ | `resolution` | `string` | 선택 / optional | 해상도 — `720p`, `1080p`, `4k` 중 하나, 기본 720p |
1903
+ | `audio` | `boolean` | 선택 / optional | 오디오 생성 여부, 기본 true |
1904
+ | `tier` | `string` | 선택 / optional | 품질/속도 등급 — `standard`, `fast` 중 하나, 기본 standard |
1905
+ | `negative_prompt` | `string` | 선택 / optional | 제외할 요소를 설명하는 텍스트 |
1906
+ | `seed` | `integer` | 선택 / optional | 재현성을 위한 시드 값 |
1907
+ | `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
1908
+ | `image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1909
+ | `last_image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1910
+ | `reference_image_url` | `string` (file) | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1911
+ | `reference_image_url_2` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(2번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1912
+ | `reference_image_url_3` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(3번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1913
+
1914
+ ```json
1915
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"veo_jobs_create","arguments":{"prompt":"<prompt>"}}}
1916
+ ```
1917
+
1918
+ <a id="veo-jobs-status"></a>
1919
+
1920
+ ### `veo_jobs_status` — Veo 영상 작업 상태
1921
+
1922
+ Check the status of a Veo video generation job submitted via `veo_jobs_create`.
1923
+
1924
+ Veo 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 `result_url`(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다.
1925
+
1926
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1927
+
1928
+ | Parameter | Type | Required | Description 설명 |
1929
+ | --- | --- | --- | --- |
1930
+ | `job_id` | `string` | **필수 / required** | 작업 ID |
1931
+
1932
+ ```json
1933
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"veo_jobs_status","arguments":{"job_id":"<job_id>"}}}
1934
+ ```
1935
+
1936
+ <a id="kling-jobs-create"></a>
1937
+
1938
+ ### `kling_jobs_create` — Kling 영상 작업 접수
1939
+
1940
+ Submit an asynchronous Kling video generation job combining text, image, or reference subjects into a 3-15 second video.
1941
+
1942
+ Kling 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `kling_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 포인트`(등급별 단가는 요금 절 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
1943
+
1944
+ > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `ai`
1945
+
1946
+ | Parameter | Type | Required | Description 설명 |
1947
+ | --- | --- | --- | --- |
1948
+ | `prompt` | `string` | **필수 / required** | 영상 생성 프롬프트, 최대 2,000자 |
1949
+ | `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text |
1950
+ | `duration` | `integer` | 선택 / optional | 영상 길이(초), 3~15, 기본 5 |
1951
+ | `aspect_ratio` | `string` | 선택 / optional | 가로세로 비율 — `16:9`, `9:16`, `1:1` 중 하나, 기본 16:9 |
1952
+ | `resolution` | `string` | 선택 / optional | image 모드 전용 해상도(다른 모드에서는 지원하지 않음) — `720P`, `1080P-SR`, `1440P-SR`, `1080P` 중 tier별 허용 목록에서 선택, 기본은 std=720P·pro=1080P |
1953
+ | `audio` | `boolean` | 선택 / optional | 오디오 생성 여부, 기본 true |
1954
+ | `tier` | `string` | 선택 / optional | 품질/속도 등급 — `std`, `pro` 중 하나, 기본 std |
1955
+ | `negative_prompt` | `string` | 선택 / optional | 제외할 요소를 설명하는 텍스트 |
1956
+ | `cfg_scale` | `number` | 선택 / optional | 프롬프트 반영 강도(0~1), 기본 0.5 |
1957
+ | `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
1958
+ | `image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
1959
+ | `last_image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
1960
+ | `reference_image_url` | `string` (file) | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
1961
+ | `reference_image_url_2` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(2번째) — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
1962
+ | `reference_image_url_3` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(3번째) — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
1963
+
1964
+ ```json
1965
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kling_jobs_create","arguments":{"prompt":"<prompt>"}}}
1966
+ ```
1967
+
1968
+ <a id="kling-jobs-status"></a>
1969
+
1970
+ ### `kling_jobs_status` — Kling 영상 작업 상태
1971
+
1972
+ Check the status of a Kling video generation job submitted via `kling_jobs_create`.
1973
+
1974
+ Kling 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 `result_url`(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다.
1975
+
1976
+ > 읽기 전용 / read-only · 입력 변환 / transforms your input · server `ai`
1977
+
1978
+ | Parameter | Type | Required | Description 설명 |
1979
+ | --- | --- | --- | --- |
1980
+ | `job_id` | `string` | **필수 / required** | 작업 ID |
1981
+
1982
+ ```json
1983
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kling_jobs_status","arguments":{"job_id":"<job_id>"}}}
1984
+ ```
1985
+
1986
+ ---
1987
+
1988
+ ## Pricing / 요금
1989
+
1990
+ Prepaid points, charged per call, identical to the APICK REST API rate. No subscription, no per-seat fee. **Failed calls are not charged.** Each tool's live price is appended to its description in `tools/list`, so an agent sees the current cost before it calls.
1991
+
1992
+ 포인트 선불, 호출당 차감이며 단가는 에이픽 REST API와 동일합니다. 구독료·좌석당 요금 없음. **실패한 호출은 과금되지 않습니다.** 각 Tool의 현재 단가는 `tools/list` 응답의 설명에 자동으로 붙으므로 AI가 호출 전에 비용을 보고 판단합니다.
1993
+
1994
+ Current rates 단가표: <https://apick.app/dev_guide/mcp> · Sign up for 1,000 free points 가입 시 1,000포인트 무료: <https://apick.app>
1995
+
1996
+ `tools/list`는 API Key와 허용 IP를 검사하지 않으며 실제 검증은 `tools/call`에서 수행됩니다. 마이페이지의 허용 IP 목록이 공란이면 IP 제한이 없고, 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(`/32` 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화나 대기시간은 없습니다.
1997
+
1998
+ Video generation is billed per second of output (`duration × per-second points`), not per call — the rate above is per second, not per video.
1999
+ 영상 생성은 호출당이 아니라 초당 과금입니다(`duration × 초당 포인트`) — 아래 단가는 1초당 포인트입니다.
2000
+
2001
+ | Model 모델 | Tier 등급 | Points/sec 초당 포인트 |
2002
+ | --- | --- | --- |
2003
+ | Seedance | standard | 610P |
2004
+ | Veo | standard | 900P |
2005
+ | Veo | fast | 360P |
2006
+ | Kling | std | 320P |
2007
+ | Kling | pro | 430P |
2008
+
2009
+ ## TTS quality and recovery / TTS 검수와 재개
2010
+
2011
+ `tts_jobs_quality` takes `job_id` and returns utterance quality and candidate history. `tts_jobs_candidate_audio` takes `job_id` and `candidate_id` and returns candidate WAV audio without consuming the final downloads. Candidates remain available for 72 hours after termination.
2012
+
2013
+ `tts_jobs_retry` takes `job_id`, `utterance_ids` (such as `["u002"]`), and `idempotency_key`. Reuse the same key and IDs after a lost response. Technical recovery does not add a charge. This tool changes job state (`readOnlyHint: false`).
2014
+
2015
+ `tts_jobs_quality`는 작업 ID로 발화 검수와 후보 이력을 조회합니다. `tts_jobs_candidate_audio`는 작업 ID·후보 ID로 WAV를 조회하며 최종 다운로드를 소비하지 않습니다. 후보는 종료 후 72시간 보존됩니다. `tts_jobs_retry`는 발화 ID 목록과 멱등 키로 같은 작업을 추가 과금 없이 재개합니다. 응답 단절 시 동일한 키와 목록을 재사용하세요.