apick-mcp 2.5.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 -56
  2. package/README.md +404 -383
  3. package/TOOLS.md +2015 -1841
  4. package/package.json +89 -89
  5. package/src/index.js +92 -92
package/README.md CHANGED
@@ -1,383 +1,404 @@
1
- <div align="center">
2
-
3
- <img src="https://raw.githubusercontent.com/lead788/apick-mcp/main/assets/logo-400.png" alt="APICK" width="88" height="88">
4
-
5
- # APICK MCP — 89 Korean Data, AI & Image Tools
6
-
7
- **Korean business registry, ID verification, OCR, parcel tracking, file conversion, web intelligence and LLM — as MCP tools for any AI agent.**
8
-
9
- **대한민국 사업자조회 · 신분증 진위확인 · OCR · 택배 배송조회 · 파일변환 · 웹조회 · LLM을 MCP Tool로.**
10
-
11
- [![npm](https://img.shields.io/npm/v/apick-mcp?color=%230a7cff&label=npm%20apick-mcp)](https://www.npmjs.com/package/apick-mcp)
12
- [![npm downloads](https://img.shields.io/npm/dm/apick-mcp?color=%230a7cff)](https://www.npmjs.com/package/apick-mcp)
13
- [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-app.apick-black)](https://registry.modelcontextprotocol.io/v0/servers?search=app.apick)
14
- [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
15
-
16
- ### **[apick.app](https://apick.app)** — Official site 공식 사이트
17
- **[Integration guide 연동 가이드](https://apick.app/dev_guide/mcp)** · **[Full tool catalog 전체 Tool 목록](TOOLS.md)** · **[API list API 목록](https://apick.app/api_list)**
18
-
19
- </div>
20
-
21
- ---
22
-
23
- ## What is this? / 이게 뭔가요?
24
-
25
- **EN** — APICK is a Korean data and AI API platform. This MCP server exposes **89 tools** for Korean business data, identity verification, OCR, parcel tracking, image generation and editing, file conversion, web intelligence, and LLM calls.
26
-
27
- **KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 89개**로 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 이미지 생성·편집, 파일 변환, 웹 검색과 LLM 호출을 **인증키 하나로** 제공합니다.
28
-
29
- **The server is hosted by APICK. Nothing to install, build, or keep running.**
30
- **서버는 에이픽이 운영합니다. 설치할 것도, 띄워둘 것도 없습니다.**
31
-
32
- ```
33
- https://apick.app/mcp/all
34
- ```
35
-
36
- ---
37
-
38
- ## Quick start / 빠른 시작
39
-
40
- ### 1. Get an API key / 인증키 발급
41
-
42
- Sign up at **[apick.app](https://apick.app)** and copy your license key from the dashboard. New accounts get **1,000 free points**.
43
- **[apick.app](https://apick.app)** 에서 가입하고 대시보드에서 인증키를 복사하세요. 신규 가입 시 **1,000포인트 무료**.
44
-
45
- > `tools/list` works **without** a key — a client can connect and discover all 89 tools before you sign up. Only `tools/call` validates the key and allowed IP.
46
- > `tools/list`는 **인증 없이** 동작합니다. 가입 전에도 클라이언트가 연결해 89개 Tool을 확인할 수 있고, 키와 허용 IP는 `tools/call`부터 검증합니다.
47
-
48
- Leave the allowed-IP list blank for unrestricted access. To restrict access, register the public IPv4 address seen by APICK as an exact address or CIDR such as `/32`. Changes apply immediately with no separate synchronization.
49
- 마이페이지의 허용 IP가 공란이면 제한 없이 사용할 수 있습니다. 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(`/32` 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화는 필요하지 않습니다.
50
-
51
- ### 2. Connect / 연결
52
-
53
- <table>
54
- <tr><th>Client</th><th>How / 방법</th></tr>
55
- <tr><td><b>Claude Code</b></td><td>
56
-
57
- ```bash
58
- claude mcp add --transport http apick https://apick.app/mcp/all --header "Authorization: Bearer YOUR_KEY"
59
- ```
60
- Restart Claude Code so the tools load. 툴이 로드되도록 재시작하세요.
61
- </td></tr>
62
- <tr><td><b>Claude Desktop</b><br><code>claude_desktop_config.json</code></td><td>
63
-
64
- ```json
65
- {
66
- "mcpServers": {
67
- "apick": {
68
- "type": "http",
69
- "url": "https://apick.app/mcp/all",
70
- "headers": { "Authorization": "Bearer YOUR_KEY" }
71
- }
72
- }
73
- }
74
- ```
75
- </td></tr>
76
- <tr><td><b>Cursor</b><br><code>~/.cursor/mcp.json</code></td><td>
77
-
78
- ```json
79
- {
80
- "mcpServers": {
81
- "apick": {
82
- "url": "https://apick.app/mcp/all",
83
- "headers": { "Authorization": "Bearer YOUR_KEY" }
84
- }
85
- }
86
- }
87
- ```
88
- </td></tr>
89
- <tr><td><b>Windsurf</b><br><code>~/.codeium/windsurf/mcp_config.json</code></td><td>
90
-
91
- ```json
92
- {
93
- "mcpServers": {
94
- "apick": {
95
- "serverUrl": "https://apick.app/mcp/all",
96
- "headers": { "Authorization": "Bearer YOUR_KEY" }
97
- }
98
- }
99
- }
100
- ```
101
- </td></tr>
102
- <tr><td><b>VS Code</b><br><code>.vscode/mcp.json</code></td><td>
103
-
104
- ```json
105
- {
106
- "servers": {
107
- "apick": {
108
- "type": "http",
109
- "url": "https://apick.app/mcp/all",
110
- "headers": { "Authorization": "Bearer YOUR_KEY" }
111
- }
112
- }
113
- }
114
- ```
115
- </td></tr>
116
- <tr><td><b>Cline</b> / any client without<br>remote MCP support<br>원격 MCP 미지원 클라이언트</td><td>
117
-
118
- ```json
119
- {
120
- "mcpServers": {
121
- "apick": {
122
- "command": "npx",
123
- "args": ["-y", "apick-mcp", "--server", "all"],
124
- "env": { "APICK_API_KEY": "YOUR_KEY" }
125
- }
126
- }
127
- }
128
- ```
129
- Zero-dependency stdio bridge, Node 18+. 의존성 0개 stdio 브릿지.
130
- </td></tr>
131
- </table>
132
-
133
- ### 3. Ask / 물어보기
134
-
135
- ```
136
- 사업자번호 439-87-00761 정상 사업자인지 확인하고 회사 정보 정리해줘
137
- Check whether Korean business number 439-87-00761 is active and summarize the company
138
- ```
139
-
140
- The agent picks `biz_detail`, calls it, and reads back the result.
141
- AI가 알맞은 Tool(`biz_detail`)을 골라 호출하고 결과를 정리해 줍니다.
142
-
143
- ---
144
-
145
- ## Servers / 서버 목록
146
-
147
- Connect to `all` for everything, or to one server to keep the tool list short and the agent's choices focused.
148
- 전부 쓰려면 `all`, 특정 분야만 쓰려면 해당 서버에 연결하면 Tool 목록이 짧아져 AI가 더 정확히 고릅니다.
149
-
150
- | Server 서버 | Endpoint | Tools | Coverage 범위 |
151
- | --- | --- | --- | --- |
152
- | **All 통합** | `https://apick.app/mcp/all` | **89** | 아래 전부 |
153
- | [Business 사업자·커머스](TOOLS.md#business) | `https://apick.app/mcp/business` | 16 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사 |
154
- | [Identity 신분증](TOOLS.md#identity) | `https://apick.app/mcp/identity` | 16 | 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹 |
155
- | [Convert 파일변환](TOOLS.md#convert) | `https://apick.app/mcp/convert` | 19 | PDF·DOCX·엑셀 변환, STT, 비동기 TTS, 워터마크 |
156
- | [Web 웹·검색](TOOLS.md#web) | `https://apick.app/mcp/web` | 13 | 도메인·IP·WHOIS, 웹페이지 수집, 구글 검색, 유튜브 |
157
- | [Vision 이미지·영상](TOOLS.md#vision) | `https://apick.app/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출 |
158
- | [OCR 문자인식](TOOLS.md#ocr) | `https://apick.app/mcp/ocr` | 6 | 이미지 텍스트 추출, 신분증 항목 추출 |
159
- | [AI · LLM](TOOLS.md#ai) | `https://apick.app/mcp/ai` | 10 | LLM 챗, 텍스트 요약·교정, 이미지 생성·편집·대량 작업 |
160
- | [Finance 금융](TOOLS.md#finance) | `https://apick.app/mcp/finance` | 3 | 계좌 예금주 조회, 1원 인증 |
161
-
162
- ### Every tool / 전체 Tool
163
-
164
- **[→ TOOLS.md](TOOLS.md)** — all 89 tools with parameters, types, and copy-paste JSON-RPC examples.
165
- **[→ TOOLS.md](TOOLS.md)** — 89개 전체를 파라미터·타입·호출 예시까지 정리했습니다.
166
-
167
- <details>
168
- <summary><b>Tool names at a glance / Tool 이름 한눈에 보기</b></summary>
169
-
170
- **Business** `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`
171
-
172
- **Identity** `identi_card1`–`identi_card5` `identi_card_image1`–`identi_card_image5` `name_rrn_auth` `hide_rrn` `identity_document_id_card` `identity_document_driver_license` `identity_document_passport` `identity_document_residence_card`
173
-
174
- **OCR** `ocr` `ocr_identi1` `ocr_identi2` `ocr_identi3` `ocr_identi4` `ocr_identi5`
175
-
176
- **Finance** `transfer_1won` `account_realname` `bank_code`
177
-
178
- **Web** `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`
179
-
180
- **Convert** `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`
181
-
182
- **Vision** `nsfw_detection` `image_similarity` `video_to_mp3` `extract_video_thumbnail` `word_cloud` `face_detection`
183
-
184
- **AI** `llm_models` `llm_chat` `text_summary` `text_polish` `image_generate` `image_edit` `image_batch_create` `image_batch_status` `image_batch_cancel` `image_batch_result`
185
-
186
- </details>
187
-
188
- ---
189
-
190
- ## Use cases / 주요 활용 사례
191
-
192
- ### 1. B2B onboarding & KYB — 거래처 실사 자동화
193
-
194
- > "거래처 사업자번호 목록 검증하고, 폐업이나 휴업 있으면 표로 정리해줘"
195
- > "Validate this list of Korean business numbers and flag any that are closed or suspended"
196
-
197
- `biz_detail` → `venture_biz_info` → `check_email_valid` · `check_phone_valid`
198
-
199
- Pull registry status, representative, industry code and address for each business number, cross-check the contact email and phone, and get one table back. Replaces manual 국세청/공정위 lookups.
200
- 사업자번호마다 국세청 상태·대표자·업종·주소를 끌어오고 담당자 이메일·전화 유효성까지 교차검증해 표 하나로 받습니다.
201
-
202
- ### 2. Identity verification pipeline — 비대면 신원확인
203
-
204
- > "이 신분증 이미지 진위확인하고 주민번호 뒷자리 마스킹한 사본 만들어줘"
205
- > "Verify this ID document image and produce a copy with the registration number masked"
206
-
207
- `identi_card_image1` → `ocr_identi1` → `identity_document_id_card`
208
-
209
- Checks the document against the government registry, extracts the fields, then returns a masked image safe to store. Covers 주민등록증 · 운전면허증 · 여권 · 외국인등록증 · 주민등록등본.
210
- 정부 registry 대조로 진위를 확인하고, 항목을 추출한 뒤, 보관 가능한 마스킹 사본까지 한 번에 만듭니다.
211
-
212
- `identity_document_residence_card`는 외국인등록증·영주증·외국국적동포 국내거소신고증의 개인정보 마스킹을 지원합니다. 영주증과 외국국적동포 국내거소신고증은 마스킹만 지원하며 외국인등록증 진위확인 Tool의 범위에는 포함되지 않습니다.
213
- `identity_document_residence_card` masks residence cards, permanent resident cards, and overseas Korean resident cards. The latter two are masking-only and are not accepted by the alien registration card authenticity-check tools.
214
-
215
- ### 3. Logistics & CS automation — 배송 문의 자동응답
216
-
217
- > "운송장 123456789012 지금 어디야? 지연되면 고객 안내문도 써줘"
218
- > "Where is tracking number 123456789012? Draft a customer notice if it's delayed"
219
-
220
- `parcel_tracking_auto` → `text_polish`
221
-
222
- Auto-detects the carrier from the number alone across **33 Korean carriers** (CJ대한통운, 한진, 롯데, 우체국, 로젠, 쿠팡로지스틱스 …), then drafts the customer message.
223
- 운송장 번호만으로 **33개 택배사**를 자동 판별해 조회하고, 고객 안내문 초안까지 씁니다.
224
-
225
- ### 4. Document processing — 문서 파이프라인
226
-
227
- > "이 PDF들 하나로 합치고 워터마크 넣은 다음 DOCX로도 뽑아줘"
228
- > "Merge these PDFs, add a watermark, and also give me a DOCX"
229
-
230
- `pdf_merge` → `draw_watermark_pdf` → `pdf_to_docx`
231
-
232
- Also: `html_to_pdf` for invoices and reports, `json_to_excel` for data exports, and `stt` for speech recognition.
233
- 견적서·리포트는 `html_to_pdf`, 데이터 내보내기는 `json_to_excel`, 음성 인식은 `stt`를 사용합니다.
234
-
235
- ### 5. Domain & fraud investigation — 도메인·사기 조사
236
-
237
- > "이 사이트 IP, 위치, WHOIS 조사하고 우리 사이트랑 얼마나 비슷한지 봐줘"
238
- > "Investigate this site's IP, location and WHOIS, and compare it to ours"
239
-
240
- `nslookup` → `location` → `whois` → `ip_history` → `url_similarity` → `url_screenshot`
241
-
242
- Built for phishing and copycat-site investigation: resolve the host, trace its IP history, score how closely it clones your page, and capture a screenshot as evidence.
243
- 피싱·모방 사이트 조사용입니다. 호스트를 확인하고 IP 이력을 추적한 뒤, 우리 페이지와의 유사도를 점수화하고 증거용 스크린샷까지 남깁니다.
244
-
245
- ### 6. Content safety & media — 콘텐츠 검수
246
-
247
- > "업로드된 이미지 중 유해한 거 걸러내고 사람 얼굴은 블러 처리해줘"
248
- > "Filter unsafe uploads and blur any faces"
249
-
250
- `nsfw_detection` → `face_detection` → `face_blur`
251
-
252
- ### 7. Payout & account verification — 정산 계좌 검증
253
-
254
- > "정산 대상 계좌 예금주가 등록된 이름과 같은지 확인해줘"
255
- > "Check that the payout account holder matches the registered name"
256
-
257
- `bank_code` → `account_realname` → `transfer_1won`
258
-
259
- `account_realname` reads the holder name; `transfer_1won` proves ownership by depositing 1 KRW with a code in the memo.
260
- `account_realname`은 예금주명을 읽고, `transfer_1won`은 적요에 인증코드를 담아 1원을 입금해 실소유를 증명합니다.
261
-
262
- ---
263
-
264
- ## How it works / 동작 방식
265
-
266
- | | EN | KO |
267
- | --- | --- | --- |
268
- | **Transport** | Streamable HTTP — one endpoint per server, JSON-RPC 2.0 over HTTPS POST, stateless | 서버당 단일 엔드포인트, HTTPS POST로 JSON-RPC 2.0, 세션 없이 요청 단위 |
269
- | **Protocol** | MCP `2026-07-28`, auto-compatible with earlier client versions | MCP `2026-07-28` 기본, 이전 규격 클라이언트 자동 호환 |
270
- | **Discovery** | `tools/list` returns every tool with JSON Schema, description and live price — no key needed | `tools/list`가 스키마·설명·실시간 단가를 반환, 인증 불필요 |
271
- | **Annotations** | Every tool declares `title`, `readOnlyHint`, `openWorldHint`. 11 of 89 are not read-only | 전 Tool이 `title`·`readOnlyHint`·`openWorldHint` 선언. 89개 중 상태 변경 Tool은 11개 |
272
- | **Results** | Text (JSON) + `structuredContent`. Images as image content; files up to 8MB as base64 | 텍스트(JSON)와 `structuredContent` 동시 반환. 이미지는 이미지 콘텐츠, 8MB 이하 파일은 base64 |
273
- | **File input** | File-taking tools accept a public `https` URL (`image_url`, `pdf_url`, …) — APICK downloads and processes it | 파일 Tool은 공개 `https` URL을 받습니다. 에이픽 서버가 내려받아 처리합니다 |
274
- | **Errors** | Delivered via `isError`; identity masking also preserves `structuredContent.error_code` | `isError`로 전달되며 신분증 마스킹은 `structuredContent.error_code`도 보존합니다 |
275
- | **Auth** | `Authorization: Bearer <key>`; `X-API-Key` also accepted | `Authorization: Bearer 인증키`, `X-API-Key`도 지원 |
276
-
277
- ### Tools with side effects / 부작용이 있는 Tool
278
-
279
- 78 of 89 tools are read-only. The other 11 change state, charge points, cancel work, or consume a result and carry `readOnlyHint: false` so your client can require approval:
280
- 89개 중 78개는 조회입니다. 나머지 11개는 과금·취소·결과 생성 등 상태를 바꾸므로 `readOnlyHint: false`가 붙습니다.
281
-
282
- | Tool | What it does / 하는 일 |
283
- | --- | --- |
284
- | `transfer_1won` | Deposits 1 KRW into a bank account · 실제로 1원을 입금합니다 |
285
- | `req_pccc` | Sends a verification SMS to the person · 본인 휴대폰으로 인증 SMS를 발송합니다 |
286
- | `get_pccc` | Consumes a one-time verification code · 1회용 인증 응답을 소모합니다 |
287
- | `tts_jobs_create` | Accepts and charges a TTS job once · TTS 작업을 접수하고 1회 과금합니다 |
288
- | `tts_jobs_cancel` | Cancels a waiting or processing job without a refund · 대기·생성 중 작업을 환불 없이 취소합니다 |
289
- | `tts_jobs_result` | Permanently consumes the one-time result · 1회용 결과 원본을 영구 소모합니다 |
290
- | `tts_jobs_subtitles` | Permanently consumes the one-time ASS subtitles · 1회용 ASS 자막 원본을 영구 소모합니다 |
291
-
292
- TTS 보이스 표시 이름: `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` 영수.
293
-
294
- TTS 작업 입력은 최대 800자입니다. 완성된 MP3와 ASS 자막은 서로 독립된 1회용 원본이므로, 결과를 저장할 준비가 된 뒤 `tts_jobs_result`와 `tts_jobs_subtitles`를 각각 한 번만 호출하세요.
295
-
296
- ### Try it with curl / curl로 바로 확인
297
-
298
- ```bash
299
- # Tool list — no key needed / 인증 불필요
300
- curl -X POST "https://apick.app/mcp/business" \
301
- -H "Content-Type: application/json" \
302
- -H "Accept: application/json, text/event-stream" \
303
- -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
304
-
305
- # Business lookup / 사업자 조회
306
- curl -X POST "https://apick.app/mcp/business" \
307
- -H "Content-Type: application/json" \
308
- -H "Accept: application/json, text/event-stream" \
309
- -H "Authorization: Bearer YOUR_KEY" \
310
- -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"biz_detail","arguments":{"biz_no":"4398700761"}}}'
311
- ```
312
-
313
- More in [`examples/`](examples). 더 많은 예시는 [`examples/`](examples).
314
-
315
- ### stdio bridge options / 브릿지 옵션
316
-
317
- ```bash
318
- npx -y apick-mcp --server business # one server / 특정 서버만
319
- npx -y apick-mcp --help
320
- ```
321
-
322
- | Variable 환경변수 | Default | Meaning 설명 |
323
- | --- | --- | --- |
324
- | `APICK_API_KEY` | — | License key. Optional for discovery, required for calls · 인증키. 탐색은 없어도 되고 호출에 필요 |
325
- | `APICK_MCP_SERVER` | `all` | Same as `--server` · `--server`와 동일 |
326
- | `APICK_MCP_URL` | `https://apick.app/mcp` | Base URL override · 기본 URL 변경 |
327
-
328
- ---
329
-
330
- ## Pricing / 요금
331
-
332
- Prepaid points, charged per call, at the same rate as the APICK REST API. 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 the agent sees the cost before it decides to call. Free tools include `bank_code`, `info` and `llm_models`.
333
-
334
- 포인트 선불, 호출당 차감이며 단가는 에이픽 REST API와 동일합니다. 구독료도 좌석당 요금도 없습니다. **실패한 호출은 과금되지 않습니다.** 각 Tool의 현재 단가는 `tools/list` 설명에 자동으로 붙어 AI가 호출 전에 비용을 보고 판단합니다. `bank_code`·`info`·`llm_models`는 무료입니다.
335
-
336
- **Current rates 단가표 → <https://apick.app/dev_guide/mcp>**
337
-
338
- ---
339
-
340
- ## Links / 링크
341
-
342
- | | |
343
- | --- | --- |
344
- | **Official site 공식 사이트** | <https://apick.app> |
345
- | Integration guide 연동 가이드 | <https://apick.app/dev_guide/mcp> |
346
- | REST API list API 목록 | <https://apick.app/api_list> |
347
- | Full tool catalog 전체 Tool | [TOOLS.md](TOOLS.md) |
348
- | Install guide for agents | [llms-install.md](llms-install.md) |
349
- | MCP Registry | [`app.apick/*`](https://registry.modelcontextprotocol.io/v0/servers?search=app.apick) |
350
- | npm | [`apick-mcp`](https://www.npmjs.com/package/apick-mcp) |
351
- | Issues 문의·버그 | <https://github.com/lead788/apick-mcp/issues> |
352
-
353
- ---
354
-
355
- ## Keywords / 검색 키워드
356
-
357
- Korean business registry API · 사업자등록번호 조회 API · business registration number lookup · 휴폐업 조회 · 법인등록번호 · 벤처기업 조회 · Korean ID verification · 신분증 진위확인 API · 주민등록증 진위확인 · 운전면허증 진위확인 · 여권 진위확인 · 외국인등록증 · 실명확인 · 주민번호 마스킹 · 개인정보 비식별화 · Korean OCR API · 신분증 OCR · 문자인식 · parcel tracking API Korea · 택배 배송조회 API · 운송장 조회 · CJ대한통운 한진 롯데택배 우체국 로젠 · 계좌 실명조회 · 예금주 조회 · 1원 인증 API · 개인통관고유부호 · PCCC · 부동산 실거래가 API · 침수차 조회 · 폐차 조회 · 도로명주소 검색 API · 공휴일 API · WHOIS API · DNS lookup · IP 위치조회 · 웹페이지 스크린샷 API · 구글 검색 API · 구글 이미지 검색 · 구글 렌즈 · 유튜브 크롤링 · PDF 변환 API · PDF to DOCX · HTML to PDF · 엑셀 변환 · 워터마크 API · STT 음성인식 API · 얼굴 인식 API · 얼굴 블러 · 유해이미지 판별 · NSFW detection · 이미지 유사도 · 워드클라우드 · LLM API
358
-
359
- ## Hashtags
360
-
361
- `#MCP` `#ModelContextProtocol` `#MCPServer` `#MCPTools` `#AIAgent` `#ClaudeMCP` `#ClaudeCode` `#ClaudeDesktop` `#Cursor` `#Cline` `#Windsurf` `#VSCode` `#APICK` `#에이픽` `#OpenAPI` `#RESTAPI` `#KoreaAPI` `#한국API` `#사업자조회` `#사업자등록번호조회` `#휴폐업조회` `#신분증진위확인` `#실명확인` `#본인인증` `#개인정보마스킹` `#OCR` `#문자인식` `#택배조회` `#배송조회` `#운송장조회` `#계좌실명조회` `#1원인증` `#통관고유부호` `#부동산실거래가` `#도로명주소` `#공휴일API` `#WHOIS` `#DNS` `#IP조회` `#웹크롤링` `#구글검색API` `#스크린샷API` `#PDF변환` `#DOCX변환` `#엑셀변환` `#워터마크` `#STT` `#음성인식` `#얼굴인식` `#얼굴블러` `#유해이미지` `#NSFW` `#이미지유사도` `#LLM` `#KYC` `#KYB` `#핀테크` `#이커머스` `#물류자동화` `#업무자동화`
362
-
363
- ---
364
-
365
- ## Privacy Policy / 개인정보처리방침
366
-
367
- **<https://apick.app/personal_policy>** · Terms 이용약관: **<https://apick.app/terms>**
368
-
369
- **EN** — This repository ships documentation and a stdio bridge. The bridge stores nothing and transmits nothing beyond the JSON-RPC messages your MCP client sends, forwarded to `https://apick.app/mcp/{server}` over HTTPS with your license key in the `Authorization` header. It writes no logs and never prints your key.
370
-
371
- What APICK collects when you call a tool — the request parameters needed to fulfil it, the account the key belongs to, and a billing record (which tool, cost, timestamp) — plus retention periods, third-party sharing and contact details, is covered in the policy above. Tools that take a file fetch it from the `https` URL you supply; the file is processed and not retained. Do not send personal data you are not authorized to process.
372
-
373
- **KO** — 이 저장소는 문서와 stdio 브릿지로 구성됩니다. 브릿지는 아무것도 저장하지 않으며, MCP 클라이언트가 보낸 JSON-RPC 메시지를 HTTPS로 `https://apick.app/mcp/{server}` 에 전달하는 것 외의 통신을 하지 않습니다. 로그를 남기지 않고 인증키를 출력하지 않습니다.
374
-
375
- Tool 호출 시 에이픽이 수집하는 항목(처리에 필요한 요청 파라미터, 인증키에 연결된 계정, 과금 기록)과 보관기간·제3자 제공·문의처는 위 방침에 정리되어 있습니다. 파일을 받는 Tool은 사용자가 준 `https` URL에서 파일을 내려받아 처리하며 보관하지 않습니다. 처리 권한이 없는 개인정보는 전송하지 마세요.
376
-
377
- ---
378
-
379
- ## License / 라이선스
380
-
381
- MIT — see [LICENSE](LICENSE). Covers this repository (documentation and the stdio bridge). Use of the APICK service is governed by the [APICK terms](https://apick.app).
382
-
383
- MIT — [LICENSE](LICENSE) 참고. 이 저장소(문서와 stdio 브릿지)에 적용됩니다. 에이픽 서비스 이용은 [에이픽 이용약관](https://apick.app)을 따릅니다.
1
+ <div align="center">
2
+
3
+ <img src="https://raw.githubusercontent.com/lead788/apick-mcp/main/assets/logo-400.png" alt="APICK" width="88" height="88">
4
+
5
+ # APICK MCP — 97 Korean Data, AI, Image & Video Tools
6
+
7
+ **Korean business registry, ID verification, OCR, parcel tracking, file conversion, web intelligence and LLM — as MCP tools for any AI agent.**
8
+
9
+ **대한민국 사업자조회 · 신분증 진위확인 · OCR · 택배 배송조회 · 파일변환 · 웹조회 · LLM을 MCP Tool로.**
10
+
11
+ [![npm](https://img.shields.io/npm/v/apick-mcp?color=%230a7cff&label=npm%20apick-mcp)](https://www.npmjs.com/package/apick-mcp)
12
+ [![npm downloads](https://img.shields.io/npm/dm/apick-mcp?color=%230a7cff)](https://www.npmjs.com/package/apick-mcp)
13
+ [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-app.apick-black)](https://registry.modelcontextprotocol.io/v0/servers?search=app.apick)
14
+ [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
15
+
16
+ ### **[apick.app](https://apick.app)** — Official site 공식 사이트
17
+ **[Integration guide 연동 가이드](https://apick.app/dev_guide/mcp)** · **[Full tool catalog 전체 Tool 목록](TOOLS.md)** · **[API list API 목록](https://apick.app/api_list)**
18
+
19
+ </div>
20
+
21
+ ---
22
+
23
+ ## What is this? / 이게 뭔가요?
24
+
25
+ **EN** — APICK is a Korean data and AI API platform. This MCP server exposes **97 tools** for Korean business data, identity verification, OCR, parcel tracking, image and video generation, file conversion, web intelligence, and LLM calls.
26
+
27
+ **KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 97개**로 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 이미지·영상 생성, 파일 변환, 웹 검색과 LLM 호출을 **인증키 하나로** 제공합니다.
28
+
29
+ **The server is hosted by APICK. Nothing to install, build, or keep running.**
30
+ **서버는 에이픽이 운영합니다. 설치할 것도, 띄워둘 것도 없습니다.**
31
+
32
+ ```
33
+ https://apick.app/mcp/all
34
+ ```
35
+
36
+ ---
37
+
38
+ ## Quick start / 빠른 시작
39
+
40
+ ### 1. Get an API key / 인증키 발급
41
+
42
+ Sign up at **[apick.app](https://apick.app)** and copy your license key from the dashboard. New accounts get **1,000 free points**.
43
+ **[apick.app](https://apick.app)** 에서 가입하고 대시보드에서 인증키를 복사하세요. 신규 가입 시 **1,000포인트 무료**.
44
+
45
+ > `tools/list` works **without** a key — a client can connect and discover all 97 tools before you sign up. Only `tools/call` validates the key and allowed IP.
46
+ > `tools/list`는 **인증 없이** 동작합니다. 가입 전에도 클라이언트가 연결해 97개 Tool을 확인할 수 있고, 키와 허용 IP는 `tools/call`부터 검증합니다.
47
+
48
+ Leave the allowed-IP list blank for unrestricted access. To restrict access, register the public IPv4 address seen by APICK as an exact address or CIDR such as `/32`. Changes apply immediately with no separate synchronization.
49
+ 마이페이지의 허용 IP가 공란이면 제한 없이 사용할 수 있습니다. 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(`/32` 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화는 필요하지 않습니다.
50
+
51
+ ### 2. Connect / 연결
52
+
53
+ <table>
54
+ <tr><th>Client</th><th>How / 방법</th></tr>
55
+ <tr><td><b>Claude Code</b></td><td>
56
+
57
+ ```bash
58
+ claude mcp add --transport http apick https://apick.app/mcp/all --header "Authorization: Bearer YOUR_KEY"
59
+ ```
60
+ Restart Claude Code so the tools load. 툴이 로드되도록 재시작하세요.
61
+ </td></tr>
62
+ <tr><td><b>Claude Desktop</b><br><code>claude_desktop_config.json</code></td><td>
63
+
64
+ ```json
65
+ {
66
+ "mcpServers": {
67
+ "apick": {
68
+ "type": "http",
69
+ "url": "https://apick.app/mcp/all",
70
+ "headers": { "Authorization": "Bearer YOUR_KEY" }
71
+ }
72
+ }
73
+ }
74
+ ```
75
+ </td></tr>
76
+ <tr><td><b>Cursor</b><br><code>~/.cursor/mcp.json</code></td><td>
77
+
78
+ ```json
79
+ {
80
+ "mcpServers": {
81
+ "apick": {
82
+ "url": "https://apick.app/mcp/all",
83
+ "headers": { "Authorization": "Bearer YOUR_KEY" }
84
+ }
85
+ }
86
+ }
87
+ ```
88
+ </td></tr>
89
+ <tr><td><b>Windsurf</b><br><code>~/.codeium/windsurf/mcp_config.json</code></td><td>
90
+
91
+ ```json
92
+ {
93
+ "mcpServers": {
94
+ "apick": {
95
+ "serverUrl": "https://apick.app/mcp/all",
96
+ "headers": { "Authorization": "Bearer YOUR_KEY" }
97
+ }
98
+ }
99
+ }
100
+ ```
101
+ </td></tr>
102
+ <tr><td><b>VS Code</b><br><code>.vscode/mcp.json</code></td><td>
103
+
104
+ ```json
105
+ {
106
+ "servers": {
107
+ "apick": {
108
+ "type": "http",
109
+ "url": "https://apick.app/mcp/all",
110
+ "headers": { "Authorization": "Bearer YOUR_KEY" }
111
+ }
112
+ }
113
+ }
114
+ ```
115
+ </td></tr>
116
+ <tr><td><b>Cline</b> / any client without<br>remote MCP support<br>원격 MCP 미지원 클라이언트</td><td>
117
+
118
+ ```json
119
+ {
120
+ "mcpServers": {
121
+ "apick": {
122
+ "command": "npx",
123
+ "args": ["-y", "apick-mcp", "--server", "all"],
124
+ "env": { "APICK_API_KEY": "YOUR_KEY" }
125
+ }
126
+ }
127
+ }
128
+ ```
129
+ Zero-dependency stdio bridge, Node 18+. 의존성 0개 stdio 브릿지.
130
+ </td></tr>
131
+ </table>
132
+
133
+ ### 3. Ask / 물어보기
134
+
135
+ ```
136
+ 사업자번호 439-87-00761 정상 사업자인지 확인하고 회사 정보 정리해줘
137
+ Check whether Korean business number 439-87-00761 is active and summarize the company
138
+ ```
139
+
140
+ The agent picks `biz_detail`, calls it, and reads back the result.
141
+ AI가 알맞은 Tool(`biz_detail`)을 골라 호출하고 결과를 정리해 줍니다.
142
+
143
+ ---
144
+
145
+ ## Servers / 서버 목록
146
+
147
+ Connect to `all` for everything, or to one server to keep the tool list short and the agent's choices focused.
148
+ 전부 쓰려면 `all`, 특정 분야만 쓰려면 해당 서버에 연결하면 Tool 목록이 짧아져 AI가 더 정확히 고릅니다.
149
+
150
+ | Server 서버 | Endpoint | Tools | Coverage 범위 |
151
+ | --- | --- | --- | --- |
152
+ | **All 통합** | `https://apick.app/mcp/all` | **97** | 아래 전부 |
153
+ | [Business 사업자·커머스](TOOLS.md#business) | `https://apick.app/mcp/business` | 16 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사 |
154
+ | [Identity 신분증](TOOLS.md#identity) | `https://apick.app/mcp/identity` | 16 | 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹 |
155
+ | [Convert 파일변환](TOOLS.md#convert) | `https://apick.app/mcp/convert` | 22 | PDF·DOCX·엑셀 변환, STT, 비동기 TTS, 워터마크 |
156
+ | [Web 웹·검색](TOOLS.md#web) | `https://apick.app/mcp/web` | 13 | 도메인·IP·WHOIS, 웹페이지 수집, 구글 검색, 유튜브 |
157
+ | [Vision 이미지·영상](TOOLS.md#vision) | `https://apick.app/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출 |
158
+ | [OCR 문자인식](TOOLS.md#ocr) | `https://apick.app/mcp/ocr` | 6 | 이미지 텍스트 추출, 신분증 항목 추출 |
159
+ | [AI · LLM](TOOLS.md#ai) | `https://apick.app/mcp/ai` | 15 | LLM 챗, 텍스트 요약·교정, 이미지 생성·편집·대량 작업, 비동기 영상 생성 |
160
+ | [Finance 금융](TOOLS.md#finance) | `https://apick.app/mcp/finance` | 3 | 계좌 예금주 조회, 1원 인증 |
161
+
162
+ ### Every tool / 전체 Tool
163
+
164
+ **[→ TOOLS.md](TOOLS.md)** — all 97 tools with parameters, types, and copy-paste JSON-RPC examples.
165
+ **[→ TOOLS.md](TOOLS.md)** — 97개 전체를 파라미터·타입·호출 예시까지 정리했습니다.
166
+
167
+ <details>
168
+ <summary><b>Tool names at a glance / Tool 이름 한눈에 보기</b></summary>
169
+
170
+ **Business** `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`
171
+
172
+ **Identity** `identi_card1`–`identi_card5` `identi_card_image1`–`identi_card_image5` `name_rrn_auth` `hide_rrn` `identity_document_id_card` `identity_document_driver_license` `identity_document_passport` `identity_document_residence_card`
173
+
174
+ **OCR** `ocr` `ocr_identi1` `ocr_identi2` `ocr_identi3` `ocr_identi4` `ocr_identi5`
175
+
176
+ **Finance** `transfer_1won` `account_realname` `bank_code`
177
+
178
+ **Web** `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`
179
+
180
+ **Convert** `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`
181
+
182
+ **Vision** `nsfw_detection` `image_similarity` `video_to_mp3` `extract_video_thumbnail` `word_cloud` `face_detection`
183
+
184
+ **AI** `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`
185
+
186
+ </details>
187
+
188
+ ---
189
+
190
+ ## Use cases / 주요 활용 사례
191
+
192
+ ### 1. B2B onboarding & KYB — 거래처 실사 자동화
193
+
194
+ > "거래처 사업자번호 목록 검증하고, 폐업이나 휴업 있으면 표로 정리해줘"
195
+ > "Validate this list of Korean business numbers and flag any that are closed or suspended"
196
+
197
+ `biz_detail` → `venture_biz_info` → `check_email_valid` · `check_phone_valid`
198
+
199
+ Pull registry status, representative, industry code and address for each business number, cross-check the contact email and phone, and get one table back. Replaces manual 국세청/공정위 lookups.
200
+ 사업자번호마다 국세청 상태·대표자·업종·주소를 끌어오고 담당자 이메일·전화 유효성까지 교차검증해 표 하나로 받습니다.
201
+
202
+ ### 2. Identity verification pipeline — 비대면 신원확인
203
+
204
+ > "이 신분증 이미지 진위확인하고 주민번호 뒷자리 마스킹한 사본 만들어줘"
205
+ > "Verify this ID document image and produce a copy with the registration number masked"
206
+
207
+ `identi_card_image1` → `ocr_identi1` → `identity_document_id_card`
208
+
209
+ Checks the document against the government registry, extracts the fields, then returns a masked image safe to store. Covers 주민등록증 · 운전면허증 · 여권 · 외국인등록증 · 주민등록등본.
210
+ 정부 registry 대조로 진위를 확인하고, 항목을 추출한 뒤, 보관 가능한 마스킹 사본까지 한 번에 만듭니다.
211
+
212
+ `identity_document_residence_card`는 외국인등록증·영주증·외국국적동포 국내거소신고증의 개인정보 마스킹을 지원합니다. 영주증과 외국국적동포 국내거소신고증은 마스킹만 지원하며 외국인등록증 진위확인 Tool의 범위에는 포함되지 않습니다.
213
+ `identity_document_residence_card` masks residence cards, permanent resident cards, and overseas Korean resident cards. The latter two are masking-only and are not accepted by the alien registration card authenticity-check tools.
214
+
215
+ ### 3. Logistics & CS automation — 배송 문의 자동응답
216
+
217
+ > "운송장 123456789012 지금 어디야? 지연되면 고객 안내문도 써줘"
218
+ > "Where is tracking number 123456789012? Draft a customer notice if it's delayed"
219
+
220
+ `parcel_tracking_auto` → `text_polish`
221
+
222
+ Auto-detects the carrier from the number alone across **33 Korean carriers** (CJ대한통운, 한진, 롯데, 우체국, 로젠, 쿠팡로지스틱스 …), then drafts the customer message.
223
+ 운송장 번호만으로 **33개 택배사**를 자동 판별해 조회하고, 고객 안내문 초안까지 씁니다.
224
+
225
+ ### 4. Document processing — 문서 파이프라인
226
+
227
+ > "이 PDF들 하나로 합치고 워터마크 넣은 다음 DOCX로도 뽑아줘"
228
+ > "Merge these PDFs, add a watermark, and also give me a DOCX"
229
+
230
+ `pdf_merge` → `draw_watermark_pdf` → `pdf_to_docx`
231
+
232
+ Also: `html_to_pdf` for invoices and reports, `json_to_excel` for data exports, and `stt` for speech recognition.
233
+ 견적서·리포트는 `html_to_pdf`, 데이터 내보내기는 `json_to_excel`, 음성 인식은 `stt`를 사용합니다.
234
+
235
+ ### 5. Domain & fraud investigation — 도메인·사기 조사
236
+
237
+ > "이 사이트 IP, 위치, WHOIS 조사하고 우리 사이트랑 얼마나 비슷한지 봐줘"
238
+ > "Investigate this site's IP, location and WHOIS, and compare it to ours"
239
+
240
+ `nslookup` → `location` → `whois` → `ip_history` → `url_similarity` → `url_screenshot`
241
+
242
+ Built for phishing and copycat-site investigation: resolve the host, trace its IP history, score how closely it clones your page, and capture a screenshot as evidence.
243
+ 피싱·모방 사이트 조사용입니다. 호스트를 확인하고 IP 이력을 추적한 뒤, 우리 페이지와의 유사도를 점수화하고 증거용 스크린샷까지 남깁니다.
244
+
245
+ ### 6. Content safety & media — 콘텐츠 검수
246
+
247
+ > "업로드된 이미지 중 유해한 거 걸러내고 사람 얼굴은 블러 처리해줘"
248
+ > "Filter unsafe uploads and blur any faces"
249
+
250
+ `nsfw_detection` → `face_detection` → `face_blur`
251
+
252
+ ### 7. Payout & account verification — 정산 계좌 검증
253
+
254
+ > "정산 대상 계좌 예금주가 등록된 이름과 같은지 확인해줘"
255
+ > "Check that the payout account holder matches the registered name"
256
+
257
+ `bank_code` → `account_realname` → `transfer_1won`
258
+
259
+ `account_realname` reads the holder name; `transfer_1won` proves ownership by depositing 1 KRW with a code in the memo.
260
+ `account_realname`은 예금주명을 읽고, `transfer_1won`은 적요에 인증코드를 담아 1원을 입금해 실소유를 증명합니다.
261
+
262
+ ### 8. AI video generation — AI 영상 생성
263
+
264
+ > "제품 사진으로 4초짜리 짧은 홍보 영상 만들어줘"
265
+ > "Turn this product photo into a short 4-second promo video"
266
+
267
+ `veo_jobs_create` → `veo_jobs_status`
268
+
269
+ Video generation (`seedance_jobs_create`, `veo_jobs_create`, `kling_jobs_create`) is asynchronous — submit a job, poll status, then download once it's `completed` via the status result's `result_url`. Billed per second (`duration × per-second points`), refunded in full on failure or timeout.
270
+ 영상 생성(`seedance_jobs_create`, `veo_jobs_create`, `kling_jobs_create`)은 비동기입니다 — 접수 후 상태를 조회하다가 `completed`가 되면 상태 결과의 `result_url`로 다운로드합니다. 초당 포인트 × 길이(초)로 과금되며 실패·시간 초과 시 전액 환불됩니다.
271
+
272
+ ---
273
+
274
+ ## How it works / 동작 방식
275
+
276
+ | | EN | KO |
277
+ | --- | --- | --- |
278
+ | **Transport** | Streamable HTTP — one endpoint per server, JSON-RPC 2.0 over HTTPS POST, stateless | 서버당 단일 엔드포인트, HTTPS POST로 JSON-RPC 2.0, 세션 없이 요청 단위 |
279
+ | **Protocol** | MCP `2026-07-28`, auto-compatible with earlier client versions | MCP `2026-07-28` 기본, 이전 규격 클라이언트 자동 호환 |
280
+ | **Discovery** | `tools/list` returns every tool with JSON Schema, description and live price — no key needed | `tools/list`가 스키마·설명·실시간 단가를 반환, 인증 불필요 |
281
+ | **Annotations** | Every tool declares `title`, `readOnlyHint`, `openWorldHint`. 14 of 97 are not read-only | 전 Tool이 `title`·`readOnlyHint`·`openWorldHint` 선언. 97개 중 상태 변경 Tool은 14개 |
282
+ | **Results** | Text (JSON) + `structuredContent`. Images as image content; files up to 8MB as base64 | 텍스트(JSON)와 `structuredContent` 동시 반환. 이미지는 이미지 콘텐츠, 8MB 이하 파일은 base64 |
283
+ | **File input** | File-taking tools accept a public `https` URL (`image_url`, `pdf_url`, …) — APICK downloads and processes it | 파일 Tool은 공개 `https` URL을 받습니다. 에이픽 서버가 내려받아 처리합니다 |
284
+ | **Errors** | Delivered via `isError`; identity masking also preserves `structuredContent.error_code` | `isError`로 전달되며 신분증 마스킹은 `structuredContent.error_code`도 보존합니다 |
285
+ | **Auth** | `Authorization: Bearer <key>`; `X-API-Key` also accepted | `Authorization: Bearer 인증키`, `X-API-Key`도 지원 |
286
+
287
+ ### Tools with side effects / 부작용이 있는 Tool
288
+
289
+ 83 of 97 tools are read-only. The other 14 change state, charge points, cancel work, or consume a result and carry `readOnlyHint: false` so your client can require approval:
290
+ 97개 중 83개는 조회입니다. 나머지 14개는 과금·취소·결과 생성 등 상태를 바꾸므로 `readOnlyHint: false`가 붙습니다.
291
+
292
+ | Tool | What it does / 하는 일 |
293
+ | --- | --- |
294
+ | `transfer_1won` | Deposits 1 KRW into a bank account · 실제로 1원을 입금합니다 |
295
+ | `req_pccc` | Sends a verification SMS to the person · 본인 휴대폰으로 인증 SMS를 발송합니다 |
296
+ | `get_pccc` | Consumes a one-time verification code · 1회용 인증 응답을 소모합니다 |
297
+ | `tts_jobs_create` | Accepts and charges a TTS job once · TTS 작업을 접수하고 1회 과금합니다 |
298
+ | `tts_jobs_cancel` | Cancels a waiting or processing job without a refund · 대기·생성 중 작업을 환불 없이 취소합니다 |
299
+ | `tts_jobs_result` | Permanently consumes the one-time result · 1회용 결과 원본을 영구 소모합니다 |
300
+ | `tts_jobs_subtitles` | Permanently consumes the one-time ASS subtitles · 1회용 ASS 자막 원본을 영구 소모합니다 |
301
+ | `seedance_jobs_create` | Submits and charges an async Seedance video job · Seedance 영상 작업을 접수하고 과금합니다 |
302
+ | `veo_jobs_create` | Submits and charges an async Veo video job · Veo 영상 작업을 접수하고 과금합니다 |
303
+ | `kling_jobs_create` | Submits and charges an async Kling video job · Kling 영상 작업을 접수하고 과금합니다 |
304
+
305
+ TTS 보이스 표시 이름: `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` 영수.
306
+
307
+ TTS 작업 입력은 최대 800자입니다. 완성된 MP3와 ASS 자막은 서로 독립된 1회용 원본이므로, 결과를 저장할 준비가 된 뒤 `tts_jobs_result`와 `tts_jobs_subtitles`를 각각 한 번만 호출하세요.
308
+
309
+ ### Try it with curl / curl로 바로 확인
310
+
311
+ ```bash
312
+ # Tool list — no key needed / 인증 불필요
313
+ curl -X POST "https://apick.app/mcp/business" \
314
+ -H "Content-Type: application/json" \
315
+ -H "Accept: application/json, text/event-stream" \
316
+ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
317
+
318
+ # Business lookup / 사업자 조회
319
+ curl -X POST "https://apick.app/mcp/business" \
320
+ -H "Content-Type: application/json" \
321
+ -H "Accept: application/json, text/event-stream" \
322
+ -H "Authorization: Bearer YOUR_KEY" \
323
+ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"biz_detail","arguments":{"biz_no":"4398700761"}}}'
324
+ ```
325
+
326
+ More in [`examples/`](examples). 더 많은 예시는 [`examples/`](examples).
327
+
328
+ ### stdio bridge options / 브릿지 옵션
329
+
330
+ ```bash
331
+ npx -y apick-mcp --server business # one server / 특정 서버만
332
+ npx -y apick-mcp --help
333
+ ```
334
+
335
+ | Variable 환경변수 | Default | Meaning 설명 |
336
+ | --- | --- | --- |
337
+ | `APICK_API_KEY` | — | License key. Optional for discovery, required for calls · 인증키. 탐색은 없어도 되고 호출에 필요 |
338
+ | `APICK_MCP_SERVER` | `all` | Same as `--server` · `--server`와 동일 |
339
+ | `APICK_MCP_URL` | `https://apick.app/mcp` | Base URL override · 기본 URL 변경 |
340
+
341
+ ---
342
+
343
+ ## Pricing / 요금
344
+
345
+ Prepaid points, charged per call, at the same rate as the APICK REST API. 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 the agent sees the cost before it decides to call. Free tools include `bank_code`, `info` and `llm_models`.
346
+
347
+ 포인트 선불, 호출당 차감이며 단가는 에이픽 REST API와 동일합니다. 구독료도 좌석당 요금도 없습니다. **실패한 호출은 과금되지 않습니다.** 각 Tool의 현재 단가는 `tools/list` 설명에 자동으로 붙어 AI가 호출 전에 비용을 보고 판단합니다. `bank_code`·`info`·`llm_models`는 무료입니다.
348
+
349
+ **Current rates 단가표 → <https://apick.app/dev_guide/mcp>**
350
+
351
+ ---
352
+
353
+ ## Links / 링크
354
+
355
+ | | |
356
+ | --- | --- |
357
+ | **Official site 공식 사이트** | <https://apick.app> |
358
+ | Integration guide 연동 가이드 | <https://apick.app/dev_guide/mcp> |
359
+ | REST API list API 목록 | <https://apick.app/api_list> |
360
+ | Full tool catalog 전체 Tool | [TOOLS.md](TOOLS.md) |
361
+ | Install guide for agents | [llms-install.md](llms-install.md) |
362
+ | MCP Registry | [`app.apick/*`](https://registry.modelcontextprotocol.io/v0/servers?search=app.apick) |
363
+ | npm | [`apick-mcp`](https://www.npmjs.com/package/apick-mcp) |
364
+ | Issues 문의·버그 | <https://github.com/lead788/apick-mcp/issues> |
365
+
366
+ ---
367
+
368
+ ## Keywords / 검색 키워드
369
+
370
+ Korean business registry API · 사업자등록번호 조회 API · business registration number lookup · 휴폐업 조회 · 법인등록번호 · 벤처기업 조회 · Korean ID verification · 신분증 진위확인 API · 주민등록증 진위확인 · 운전면허증 진위확인 · 여권 진위확인 · 외국인등록증 · 실명확인 · 주민번호 마스킹 · 개인정보 비식별화 · Korean OCR API · 신분증 OCR · 문자인식 · parcel tracking API Korea · 택배 배송조회 API · 운송장 조회 · CJ대한통운 한진 롯데택배 우체국 로젠 · 계좌 실명조회 · 예금주 조회 · 1원 인증 API · 개인통관고유부호 · PCCC · 부동산 실거래가 API · 침수차 조회 · 폐차 조회 · 도로명주소 검색 API · 공휴일 API · WHOIS API · DNS lookup · IP 위치조회 · 웹페이지 스크린샷 API · 구글 검색 API · 구글 이미지 검색 · 구글 렌즈 · 유튜브 크롤링 · PDF 변환 API · PDF to DOCX · HTML to PDF · 엑셀 변환 · 워터마크 API · STT 음성인식 API · 얼굴 인식 API · 얼굴 블러 · 유해이미지 판별 · NSFW detection · 이미지 유사도 · 워드클라우드 · LLM API
371
+
372
+ ## Hashtags
373
+
374
+ `#MCP` `#ModelContextProtocol` `#MCPServer` `#MCPTools` `#AIAgent` `#ClaudeMCP` `#ClaudeCode` `#ClaudeDesktop` `#Cursor` `#Cline` `#Windsurf` `#VSCode` `#APICK` `#에이픽` `#OpenAPI` `#RESTAPI` `#KoreaAPI` `#한국API` `#사업자조회` `#사업자등록번호조회` `#휴폐업조회` `#신분증진위확인` `#실명확인` `#본인인증` `#개인정보마스킹` `#OCR` `#문자인식` `#택배조회` `#배송조회` `#운송장조회` `#계좌실명조회` `#1원인증` `#통관고유부호` `#부동산실거래가` `#도로명주소` `#공휴일API` `#WHOIS` `#DNS` `#IP조회` `#웹크롤링` `#구글검색API` `#스크린샷API` `#PDF변환` `#DOCX변환` `#엑셀변환` `#워터마크` `#STT` `#음성인식` `#얼굴인식` `#얼굴블러` `#유해이미지` `#NSFW` `#이미지유사도` `#LLM` `#KYC` `#KYB` `#핀테크` `#이커머스` `#물류자동화` `#업무자동화`
375
+
376
+ ---
377
+
378
+ ## Privacy Policy / 개인정보처리방침
379
+
380
+ **<https://apick.app/personal_policy>** · Terms 이용약관: **<https://apick.app/terms>**
381
+
382
+ **EN** — This repository ships documentation and a stdio bridge. The bridge stores nothing and transmits nothing beyond the JSON-RPC messages your MCP client sends, forwarded to `https://apick.app/mcp/{server}` over HTTPS with your license key in the `Authorization` header. It writes no logs and never prints your key.
383
+
384
+ What APICK collects when you call a tool — the request parameters needed to fulfil it, the account the key belongs to, and a billing record (which tool, cost, timestamp) — plus retention periods, third-party sharing and contact details, is covered in the policy above. Tools that take a file fetch it from the `https` URL you supply; the file is processed and not retained. Do not send personal data you are not authorized to process.
385
+
386
+ **KO** — 이 저장소는 문서와 stdio 브릿지로 구성됩니다. 브릿지는 아무것도 저장하지 않으며, MCP 클라이언트가 보낸 JSON-RPC 메시지를 HTTPS로 `https://apick.app/mcp/{server}` 에 전달하는 것 외의 통신을 하지 않습니다. 로그를 남기지 않고 인증키를 출력하지 않습니다.
387
+
388
+ Tool 호출 시 에이픽이 수집하는 항목(처리에 필요한 요청 파라미터, 인증키에 연결된 계정, 과금 기록)과 보관기간·제3자 제공·문의처는 위 방침에 정리되어 있습니다. 파일을 받는 Tool은 사용자가 준 `https` URL에서 파일을 내려받아 처리하며 보관하지 않습니다. 처리 권한이 없는 개인정보는 전송하지 마세요.
389
+
390
+ ---
391
+
392
+ ## License / 라이선스
393
+
394
+ MIT — see [LICENSE](LICENSE). Covers this repository (documentation and the stdio bridge). Use of the APICK service is governed by the [APICK terms](https://apick.app).
395
+
396
+ MIT — [LICENSE](LICENSE) 참고. 이 저장소(문서와 stdio 브릿지)에 적용됩니다. 에이픽 서비스 이용은 [에이픽 이용약관](https://apick.app)을 따릅니다.
397
+
398
+ ## TTS quality and recovery / TTS 검수와 재개
399
+
400
+ `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.
401
+
402
+ `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`).
403
+
404
+ `tts_jobs_quality`는 작업 ID로 발화 검수와 후보 이력을 조회합니다. `tts_jobs_candidate_audio`는 작업 ID·후보 ID로 WAV를 조회하며 최종 다운로드를 소비하지 않습니다. 후보는 종료 후 72시간 보존됩니다. `tts_jobs_retry`는 발화 ID 목록과 멱등 키로 같은 작업을 추가 과금 없이 재개합니다. 응답 단절 시 동일한 키와 목록을 재사용하세요.