apick-mcp 3.2.2 → 3.4.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 (4) hide show
  1. package/CHANGELOG.md +23 -7
  2. package/README.md +34 -14
  3. package/TOOLS.md +151 -101
  4. package/package.json +89 -89
package/CHANGELOG.md CHANGED
@@ -1,10 +1,26 @@
1
- # 변경 기록
2
-
3
- ## 3.2.2 - 2026-09-14
4
-
5
- - 운전면허 `ghost_num`의 생략·빈값·임의 문자열 허용과 판정 미사용 계약을 한영 문서에 명시했습니다.
6
- - 운전면허 불일치와 무과금 처리 실패를 구분하고, 응답에 조회 페이지 HTML을 포함하지 않는 계약을 안내합니다.
7
- - Clarify optional driver-license serial input, match semantics, safe messages, and uncharged processing failures.
1
+ # 변경 기록
2
+
3
+ ## 3.4.0 — 2026-09-19
4
+
5
+ - 개인통관고유부호 조회가 문자(SMS) 인증번호 방식에서 간편인증 방식으로 바뀌었습니다. 기존 `rrn1`·`rrn2`·`auth_key`·`answer` 인자는 더 이상 쓰지 않습니다.
6
+ - `req_pccc` 는 `name`, `birthday`(생년월일 8자리), `phone`, `provider`(간편인증 방식)를 받아 tx_id 를 즉시 반환합니다.
7
+ - `get_pccc` 는 `tx_id` 만 받아 처리 상태와 결과를 확인합니다. 결과는 수집 시각(`checked_at`) 기준 24시간 동안 재조회할 수 있습니다.
8
+ - `check_pccc` Tool 이 제거되어 전체 Tool 이 97개에서 96개로 줄었습니다.
9
+ - Replace the SMS-verification PCCC flow with simple authentication; `check_pccc` is removed.
10
+
11
+ ## 3.3.0 — 2026-09-14
12
+
13
+ - Seedance 참조 소재의 이미지·영상·오디오 파일 인자를 문서화했습니다.
14
+ - Add video generation version selection documentation and compatibility tests.
15
+ - 영상 생성 버전 선택, 버전별 옵션·요금 안내와 호환 검증을 추가했습니다.
16
+ - Pass version and tier through the existing bridge; no transport change.
17
+ - Document and verify Seedance 2.0 Fast and Mini tier pass-through.
18
+
19
+ ## 3.2.2 - 2026-09-14
20
+
21
+ - 운전면허 `ghost_num`의 생략·빈값·임의 문자열 허용과 판정 미사용 계약을 한영 문서에 명시했습니다.
22
+ - 운전면허 불일치와 무과금 처리 실패를 구분하고, 응답에 조회 페이지 HTML을 포함하지 않는 계약을 안내합니다.
23
+ - Clarify optional driver-license serial input, match semantics, safe messages, and uncharged processing failures.
8
24
 
9
25
  ## 3.2.1 - 2026-09-14
10
26
 
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  <img src="https://raw.githubusercontent.com/lead788/apick-mcp/main/assets/logo-400.png" alt="APICK" width="88" height="88">
4
4
 
5
- # APICK MCP — 97 Korean Data, AI, Image & Video Tools
5
+ # APICK MCP — 96 Korean Data, AI, Image & Video Tools
6
6
 
7
7
  **Korean business registry, ID verification, OCR, parcel tracking, file conversion, web intelligence and LLM — as MCP tools for any AI agent.**
8
8
 
@@ -22,9 +22,9 @@
22
22
 
23
23
  ## What is this? / 이게 뭔가요?
24
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.
25
+ **EN** — APICK is a Korean data and AI API platform. This MCP server exposes **96 tools** for Korean business data, identity verification, OCR, parcel tracking, image and video generation, file conversion, web intelligence, and LLM calls.
26
26
 
27
- **KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 97개**로 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 이미지·영상 생성, 파일 변환, 웹 검색과 LLM 호출을 **인증키 하나로** 제공합니다.
27
+ **KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 96개**로 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 이미지·영상 생성, 파일 변환, 웹 검색과 LLM 호출을 **인증키 하나로** 제공합니다.
28
28
 
29
29
  **The server is hosted by APICK. Nothing to install, build, or keep running.**
30
30
  **서버는 에이픽이 운영합니다. 설치할 것도, 띄워둘 것도 없습니다.**
@@ -42,8 +42,8 @@ https://apick.app/mcp/all
42
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
43
  **[apick.app](https://apick.app)** 에서 가입하고 대시보드에서 인증키를 복사하세요. 신규 가입 시 **1,000포인트 무료**.
44
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`부터 검증합니다.
45
+ > `tools/list` works **without** a key — a client can connect and discover all 96 tools before you sign up. Only `tools/call` validates the key and allowed IP.
46
+ > `tools/list`는 **인증 없이** 동작합니다. 가입 전에도 클라이언트가 연결해 96개 Tool을 확인할 수 있고, 키와 허용 IP는 `tools/call`부터 검증합니다.
47
47
 
48
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
49
  마이페이지의 허용 IP가 공란이면 제한 없이 사용할 수 있습니다. 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(`/32` 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화는 필요하지 않습니다.
@@ -149,7 +149,7 @@ Connect to `all` for everything, or to one server to keep the tool list short an
149
149
 
150
150
  | Server 서버 | Endpoint | Tools | Coverage 범위 |
151
151
  | --- | --- | --- | --- |
152
- | **All 통합** | `https://apick.app/mcp/all` | **97** | 아래 전부 |
152
+ | **All 통합** | `https://apick.app/mcp/all` | **96** | 아래 전부 |
153
153
  | [Business 사업자·커머스](TOOLS.md#business) | `https://apick.app/mcp/business` | 16 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사 |
154
154
  | [Identity 신분증](TOOLS.md#identity) | `https://apick.app/mcp/identity` | 16 | 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹 |
155
155
  | [Convert 파일변환](TOOLS.md#convert) | `https://apick.app/mcp/convert` | 22 | PDF·DOCX·엑셀 변환, STT, 비동기 TTS, 워터마크 |
@@ -161,13 +161,13 @@ Connect to `all` for everything, or to one server to keep the tool list short an
161
161
 
162
162
  ### Every tool / 전체 Tool
163
163
 
164
- **[→ TOOLS.md](TOOLS.md)** — all 97 tools with parameters, types, and copy-paste JSON-RPC examples.
165
- **[→ TOOLS.md](TOOLS.md)** — 97개 전체를 파라미터·타입·호출 예시까지 정리했습니다.
164
+ **[→ TOOLS.md](TOOLS.md)** — all 96 tools with parameters, types, and copy-paste JSON-RPC examples.
165
+ **[→ TOOLS.md](TOOLS.md)** — 96개 전체를 파라미터·타입·호출 예시까지 정리했습니다.
166
166
 
167
167
  <details>
168
168
  <summary><b>Tool names at a glance / Tool 이름 한눈에 보기</b></summary>
169
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`
170
+ **Business** `biz_detail` `venture_biz_info` `land_rt_price` `req_pccc` `get_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
171
 
172
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
173
 
@@ -269,6 +269,8 @@ Built for phishing and copycat-site investigation: resolve the host, trace its I
269
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
270
  영상 생성(`seedance_jobs_create`, `veo_jobs_create`, `kling_jobs_create`)은 비동기입니다 — 접수 후 상태를 조회하다가 `completed`가 되면 상태 결과의 `result_url`로 다운로드합니다. 초당 포인트 × 길이(초)로 과금되며 실패·시간 초과 시 전액 환불됩니다.
271
271
 
272
+ Seedance 참조 소재 모드는 지원 버전에서 참조 이미지·영상·오디오(MP3·WAV) URL을 함께 받을 수 있습니다.
273
+
272
274
  ---
273
275
 
274
276
  ## How it works / 동작 방식
@@ -278,7 +280,7 @@ Video generation (`seedance_jobs_create`, `veo_jobs_create`, `kling_jobs_create`
278
280
  | **Transport** | Streamable HTTP — one endpoint per server, JSON-RPC 2.0 over HTTPS POST, stateless | 서버당 단일 엔드포인트, HTTPS POST로 JSON-RPC 2.0, 세션 없이 요청 단위 |
279
281
  | **Protocol** | MCP `2026-07-28`, auto-compatible with earlier client versions | MCP `2026-07-28` 기본, 이전 규격 클라이언트 자동 호환 |
280
282
  | **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개 |
283
+ | **Annotations** | Every tool declares `title`, `readOnlyHint`, `openWorldHint`. 14 of 96 are not read-only | 전 Tool이 `title`·`readOnlyHint`·`openWorldHint` 선언. 96개 중 상태 변경 Tool은 14개 |
282
284
  | **Results** | Text (JSON) + `structuredContent`. Images as image content; files up to 8MB as base64 | 텍스트(JSON)와 `structuredContent` 동시 반환. 이미지는 이미지 콘텐츠, 8MB 이하 파일은 base64 |
283
285
  | **File input** | File-taking tools accept a public `https` URL (`image_url`, `pdf_url`, …) — APICK downloads and processes it | 파일 Tool은 공개 `https` URL을 받습니다. 에이픽 서버가 내려받아 처리합니다 |
284
286
  | **Errors** | Delivered via `isError`; identity masking also preserves `structuredContent.error_code` | `isError`로 전달되며 신분증 마스킹은 `structuredContent.error_code`도 보존합니다 |
@@ -286,14 +288,14 @@ Video generation (`seedance_jobs_create`, `veo_jobs_create`, `kling_jobs_create`
286
288
 
287
289
  ### Tools with side effects / 부작용이 있는 Tool
288
290
 
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
+ 82 of 96 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:
292
+ 96개 중 82개는 조회입니다. 나머지 14개는 과금·취소·결과 생성 등 상태를 바꾸므로 `readOnlyHint: false`가 붙습니다.
291
293
 
292
294
  | Tool | What it does / 하는 일 |
293
295
  | --- | --- |
294
296
  | `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
+ | `req_pccc` | Sends a simple-authentication request to the person's phone · 본인 휴대폰으로 간편인증 요청을 발송합니다 |
298
+ | `get_pccc` | Reads the approval result by tx_id and charges once per result · tx_id 로 승인 결과를 조회하고 결과 1건마다 과금합니다 |
297
299
  | `tts_jobs_create` | Accepts and charges a TTS job once · TTS 작업을 접수하고 1회 과금합니다 |
298
300
  | `tts_jobs_cancel` | Cancels a waiting or processing job without a refund · 대기·생성 중 작업을 환불 없이 취소합니다 |
299
301
  | `tts_jobs_result` | Permanently consumes the one-time result · 1회용 결과 원본을 영구 소모합니다 |
@@ -402,3 +404,21 @@ MIT — [LICENSE](LICENSE) 참고. 이 저장소(문서와 stdio 브릿지)에
402
404
  `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
405
 
404
406
  `tts_jobs_quality`는 작업 ID로 발화 검수와 후보 이력을 조회합니다. `tts_jobs_candidate_audio`는 작업 ID·후보 ID로 WAV를 조회하며 최종 다운로드를 소비하지 않습니다. 후보는 종료 후 72시간 보존됩니다. `tts_jobs_retry`는 발화 ID 목록과 멱등 키로 같은 작업을 추가 과금 없이 재개합니다. 응답 단절 시 동일한 키와 목록을 재사용하세요.
407
+
408
+ ## Video model versions
409
+
410
+ Omitting `version` preserves Seedance 2.5, Veo 3.1 and Kling 3.0. Set `version` and `tier` explicitly to select a generation; jobs are never silently switched to another version. Submission and status responses include `version`.
411
+
412
+ Available generations: Seedance 1.0/1.5/2.0/2.5, including Seedance 2.0 Standard/Fast/Mini; Veo 3.1 (Standard/Fast/Lite); Kling 1.6/2.0/2.1/2.5/2.6/3.0/O1/O3. Veo 3.0 is unavailable. Modes, tiers, resolutions, durations, audio, file limits and prices vary by combination. See the [Seedance](https://apick.app/dev_guide/seedancejobs), [Veo](https://apick.app/dev_guide/veojobs) and [Kling](https://apick.app/dev_guide/klingjobs) version tables. Unsupported combinations are rejected before submission.
413
+
414
+ ## 영상 모델 버전 선택
415
+
416
+ `version`을 생략하면 Seedance 2.5, Veo 3.1, Kling 3.0을 사용합니다. 버전과 등급을 명시하면 해당 조합으로 생성하며 다른 모델로 자동 대체하지 않습니다. 생성과 상태 응답의 `version`으로 확인할 수 있습니다.
417
+
418
+ | 제품 | 제공 버전 | 제약과 요금 |
419
+ |---|---|---|
420
+ | Seedance | 2.5, 2.0(Standard·Fast·Mini), 1.5, 1.0 | [버전별 지원표](https://apick.app/dev_guide/seedancejobs) |
421
+ | Veo | 3.1 (Standard, Fast, Lite) | [버전별 지원표](https://apick.app/dev_guide/veojobs) |
422
+ | Kling | 3.0, O3, O1, 2.6, 2.5, 2.1, 2.0, 1.6 | [버전별 지원표](https://apick.app/dev_guide/klingjobs) |
423
+
424
+ 등급·해상도·길이·오디오·파일 개수와 초당 포인트는 선택 조합별로 다릅니다. Seedance 2.0은 Standard·Fast·Mini를 제공하며 Mini는 480p·720p와 4~15초를 지원합니다. 무음 전용 모델은 `audio=false`, 오디오 필수 모델은 `audio=true`만 허용합니다. Veo 3.0은 현재 제공하지 않습니다. 지원하지 않는 조합은 접수 전에 거절됩니다.
package/TOOLS.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # APICK MCP — Full Tool Catalog / 전체 Tool 목록
2
2
 
3
- **97 tools** across **8 domain servers**, plus the combined `all` server.
4
- **Tool 97개**, 분야별 서버 8개와 통합 서버 `all`.
3
+ **96 tools** across **8 domain servers**, plus the combined `all` server.
4
+ **Tool 96개**, 분야별 서버 8개와 통합 서버 `all`.
5
5
 
6
6
  Official site 공식 사이트: **<https://apick.app>** · Docs 연동 가이드: **<https://apick.app/dev_guide/mcp>**
7
7
 
@@ -12,7 +12,7 @@ Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for ever
12
12
 
13
13
  | Server 서버 | Endpoint | Tools | Coverage 범위 |
14
14
  | --- | --- | --- | --- |
15
- | [Business & Commerce · 사업자 · 커머스](#business) | `/mcp/business` | 16 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사. |
15
+ | [Business & Commerce · 사업자 · 커머스](#business) | `/mcp/business` | 15 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사. |
16
16
  | [Identity Verification · 신분증 진위확인 · 마스킹](#identity) | `/mcp/identity` | 16 | 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹. |
17
17
  | [OCR · OCR 문자인식](#ocr) | `/mcp/ocr` | 6 | 이미지 텍스트 추출과 신분증 항목 추출. |
18
18
  | [Finance · 금융 · 계좌확인](#finance) | `/mcp/finance` | 3 | 계좌 예금주 실명조회와 1원 인증. |
@@ -20,11 +20,11 @@ Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for ever
20
20
  | [File Conversion · 파일 변환 · 워터마크](#convert) | `/mcp/convert` | 22 | PDF·DOCX·엑셀 변환, 음성인식(STT), 비동기 TTS, 워터마크. |
21
21
  | [Vision · 이미지 · 영상 분석](#vision) | `/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출. |
22
22
  | [AI & LLM · AI · LLM](#ai) | `/mcp/ai` | 15 | LLM 챗, 텍스트 도구, 이미지 생성·편집·대량 작업, 비동기 영상 생성. |
23
- | **All 통합** | `/mcp/all` | **97** | 아래 전부 |
23
+ | **All 통합** | `/mcp/all` | **96** | 아래 전부 |
24
24
 
25
- <details><summary><b>All 97 tool names / 전체 Tool 이름</b></summary>
25
+ <details><summary><b>All 96 tool names / 전체 Tool 이름</b></summary>
26
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`
27
+ `biz_detail` · `venture_biz_info` · `land_rt_price` · `req_pccc` · `get_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
28
 
29
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
30
 
@@ -48,7 +48,7 @@ Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for ever
48
48
 
49
49
  ## Business & Commerce · 사업자 · 커머스
50
50
 
51
- `https://apick.app/mcp/business` — 16 tools
51
+ `https://apick.app/mcp/business` — 15 tools
52
52
 
53
53
  Korean business registry, corporate credit, parcel tracking, real-estate prices, vehicle history, and input validation.
54
54
 
@@ -59,9 +59,8 @@ Korean business registry, corporate credit, parcel tracking, real-estate prices,
59
59
  | [`biz_detail`](#biz-detail) | 사업자 정보 조회 | `biz_no` |
60
60
  | [`venture_biz_info`](#venture-biz-info) | 벤처기업 정보조회 | `biz_no` |
61
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` |
62
+ | [`req_pccc`](#req-pccc) | 개인통관고유부호 인증 요청 | `name`, `birthday`, `phone`, `provider` |
63
+ | [`get_pccc`](#get-pccc) | 개인통관고유부호 조회 | `tx_id` |
65
64
  | [`get_car_flooding`](#get-car-flooding) | 차량 침수차 여부 조회 | `type`, `value` |
66
65
  | [`get_car_scrap`](#get-car-scrap) | 차량 폐차사고처리 여부 조회 | `type`, `value` |
67
66
  | [`parcel_tracking`](#parcel-tracking) | 택배 배송조회 | `carrier`, `trackingNumber` |
@@ -134,61 +133,41 @@ Look up real estate transaction price records in Korea by region, property type,
134
133
 
135
134
  ### `req_pccc` — 개인통관고유부호 인증 요청
136
135
 
137
- Request SMS verification to retrieve a Korean Personal Customs Clearance Code (PCCC).
136
+ Request simple authentication (KakaoTalk, Toss, PASS, etc.) to retrieve a Korean Personal Customs Clearance Code (PCCC).
138
137
 
139
- 개인통관고유부호 조회를 위한 본인 인증을 요청합니다. 인증번호 6자리가 문자(SMS)로 발송되며, 응답의 auth_key와 수신한 인증번호를 get_pccc Tool에 입력해 부호를 조회합니다.
138
+ 이름, 생년월일, 휴대전화번호, 간편인증 방식을 입력하면 해당 휴대폰으로 간편인증 요청을 보내고 결과 조회에 사용할 tx_id 를 즉시 반환합니다. 사용자가 휴대폰에서 직접 승인해야 하며, 승인 결과는 `get_pccc` 에 tx_id 를 넣어 확인합니다.
140
139
 
141
140
  > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `business`
142
141
 
143
142
  | Parameter | Type | Required | Description 설명 |
144
143
  | --- | --- | --- | --- |
145
144
  | `name` | `string` | **필수 / required** | 이름 |
146
- | `rrn1` | `string` | **필수 / required** | 주민등록번호 앞 6자리 |
147
- | `rrn2` | `string` | **필수 / required** | 주민등록번호 뒤 7자리 |
145
+ | `birthday` | `string` | **필수 / required** | 생년월일 8자리 (YYYYMMDD, 예: 19900101) |
148
146
  | `phone` | `string` | **필수 / required** | 휴대전화 번호 (본인 명의, 숫자만) |
147
+ | `provider` | `string` | **필수 / required** | 간편인증 방식: `kakao`, `naver`, `toss`, `pass`, `samsung`, `kb`, `shinhan`, `hana`, `woori`, `ibk`, `nh`, `kakaobank`, `banksalad` |
149
148
 
150
149
  ```json
151
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"req_pccc","arguments":{"name":"<name>","rrn1":"<rrn1>","rrn2":"<rrn2>","phone":"<phone>"}}}
150
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"req_pccc","arguments":{"name":"<name>","birthday":"19900101","phone":"<phone>","provider":"kakao"}}}
152
151
  ```
153
152
 
153
+ 인증 요청이 실제 발송된 접수 시점에 과금됩니다. 이미 대기 중인 요청을 다시 보내면 인증을 재발송하지 않고 기존 tx_id 를 반환하며 과금되지 않습니다. 인증 유효시간은 5분입니다.
154
+
154
155
  <a id="get-pccc"></a>
155
156
 
156
157
  ### `get_pccc` — 개인통관고유부호 조회
157
158
 
158
- Retrieve a Korean Personal Customs Clearance Code (PCCC) using the auth key and SMS verification code.
159
+ Retrieve a Korean Personal Customs Clearance Code (PCCC) by transaction ID.
159
160
 
160
- req_pccc Tool 호출로 받은 auth_key와 문자(SMS)로 수신한 인증번호 6자리를 입력해 개인통관고유부호를 조회합니다.
161
+ req_pccc Tool 호출로 받은 tx_id 를 입력해 처리 상태를 확인합니다. 아직 승인 전이면 status 는 `pending`, message 는 "인증 대기중입니다." 이며 과금되지 않습니다. 승인이 끝나면 서버가 최종 정보를 조회해 개인통관고유부호와 주소, 수집 시각 `checked_at` 을 반환하며 이때 과금됩니다. 발급된 부호가 없으면 message 는 "조회된 개인통관고유부호가 없습니다." 이고 과금되지 않습니다. 결과는 24시간 동안 재조회할 수 있고 재조회할 때마다 과금됩니다.
161
162
 
162
163
  > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `business`
163
164
 
164
165
  | Parameter | Type | Required | Description 설명 |
165
166
  | --- | --- | --- | --- |
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) |
167
+ | `tx_id` | `string` | **필수 / required** | req_pccc(개인통관고유부호 인증 요청) 응답의 트랜잭션 ID |
189
168
 
190
169
  ```json
191
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_pccc","arguments":{"name":"<name>","pccc":"<pccc>","zip":"<zip>","phone":"<phone>"}}}
170
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_pccc","arguments":{"tx_id":"<tx_id>"}}}
192
171
  ```
193
172
 
194
173
  <a id="get-car-flooding"></a>
@@ -434,13 +413,13 @@ Verify the authenticity of a Korean resident registration card (jumin-deungnokje
434
413
 
435
414
  ### `identi_card2` — [Text] 운전면허증 진위 확인
436
415
 
437
- Check Korean driver license number and personal details. `ghost_num` is optional: omit it, send an empty string, or send any string. Its content is not used in the match decision. This tool does not verify the serial number itself or the physical document's authenticity.
416
+ Check Korean driver license number and personal details. `ghost_num` is optional: omit it, send an empty string, or send any string. Its content is not used in the match decision. This tool does not verify the serial number itself or the physical document's authenticity.
438
417
 
439
- 운전면허번호와 인적사항의 일치 여부를 조회합니다. birth_y, birth_m, birth_d, name과 면허번호 4구획(licen_no0~licen_no3)은 필수입니다. ghost_num(식별번호)은 생략·빈값·임의 문자열 모두 허용하며 전달값은 판정에 사용하지 않습니다. rrn1, rrn2도 선택 입력입니다. 암호일련번호 자체나 실물 면허증의 위·변조 여부는 검증하지 않습니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
440
-
441
- `result=0` means a mismatch and `result=1` means a match. An unconfirmed result returns HTTP 424 (`result=2`); a timeout returns HTTP 408 (`result=3`). These processing failures are not charged. Responses contain short public messages, never source-page HTML.
442
-
443
- `result=0`은 불일치, `result=1`은 일치입니다. 판정 확인 실패는 HTTP 424(`result=2`), 시간 초과는 HTTP 408(`result=3`)이며 과금되지 않습니다. 응답에는 짧은 안내 문구만 포함되고 조회 페이지 HTML은 포함되지 않습니다.
418
+ 운전면허번호와 인적사항의 일치 여부를 조회합니다. birth_y, birth_m, birth_d, name과 면허번호 4구획(licen_no0~licen_no3)은 필수입니다. ghost_num(식별번호)은 생략·빈값·임의 문자열 모두 허용하며 전달값은 판정에 사용하지 않습니다. rrn1, rrn2도 선택 입력입니다. 암호일련번호 자체나 실물 면허증의 위·변조 여부는 검증하지 않습니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
419
+
420
+ `result=0` means a mismatch and `result=1` means a match. An unconfirmed result returns HTTP 424 (`result=2`); a timeout returns HTTP 408 (`result=3`). These processing failures are not charged. Responses contain short public messages, never source-page HTML.
421
+
422
+ `result=0`은 불일치, `result=1`은 일치입니다. 판정 확인 실패는 HTTP 424(`result=2`), 시간 초과는 HTTP 408(`result=3`)이며 과금되지 않습니다. 응답에는 짧은 안내 문구만 포함되고 조회 페이지 HTML은 포함되지 않습니다.
444
423
 
445
424
  > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
446
425
 
@@ -454,7 +433,7 @@ Check Korean driver license number and personal details. `ghost_num` is optional
454
433
  | `licen_no1` | `string` | **필수 / required** | 면허번호 2구획 (예: 19) |
455
434
  | `licen_no2` | `string` | **필수 / required** | 면허번호 3구획 (예: 174133) |
456
435
  | `licen_no3` | `string` | **필수 / required** | 면허번호 4구획 (예: 01) |
457
- | `ghost_num` | `string` | 선택 / optional | 생략·빈값 허용, 전달값은 판정에 사용하지 않음 / May be omitted or empty; not used in the match decision |
436
+ | `ghost_num` | `string` | 선택 / optional | 생략·빈값 허용, 전달값은 판정에 사용하지 않음 / May be omitted or empty; not used in the match decision |
458
437
  | `rrn1` | `string` | 선택 / optional | 주민등록번호 앞 6자리 (선택) |
459
438
  | `rrn2` | `string` | 선택 / optional | 주민등록번호 뒤 7자리 (선택) |
460
439
 
@@ -1843,30 +1822,77 @@ Polish a text (up to 100,000 characters) by fixing grammar, spelling, and awkwar
1843
1822
 
1844
1823
  ### `seedance_jobs_create` — Seedance 영상 작업 접수
1845
1824
 
1846
- Submit an asynchronous Seedance video generation job combining text, image, or reference inputs into up to a 30-second video.
1825
+ Submit an asynchronous Seedance video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, seedance_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 포인트(해상도별로 다름, resolution 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
1847
1826
 
1848
- Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `seedance_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 포인트`(해상도별 단가는 요금 절 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
1849
-
1850
- > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `ai`
1827
+ 기본 버전 기준: 초당 480p 560P·720p 1,250P·1080p 2,810P × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.
1851
1828
 
1852
1829
  | Parameter | Type | Required | Description 설명 |
1853
1830
  | --- | --- | --- | --- |
1854
- | `prompt` | `string` | **필수 / required** | 영상 생성 프롬프트, 최대 2,000자 |
1855
- | `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text |
1856
- | `duration` | `integer` | 선택 / optional | 영상 길이(초), 4~30, 기본 5 |
1857
- | `aspect_ratio` | `string` | 선택 / optional | 가로세로 비율 — `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` 중 하나, 기본 16:9 |
1858
- | `resolution` | `string` | 선택 / optional | 해상도 — `480p`, `720p`, `1080p` 중 하나, 기본 720p. 해상도별로 초당 포인트가 다릅니다(요금 절 참고, 높을수록 비용 증가) |
1859
- | `audio` | `boolean` | 선택 / optional | 오디오 생성 여부, 기본 true. 생성된 오디오가 정책(저작권 등) 검수에서 거부되면 작업이 실패하고 전액 환불됩니다 |
1831
+ | `version` | `string` | 선택 / optional | 영상 모델 버전. 생략 시 2.5. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. `2.5`, `2.0`, `1.5`, `1.0` |
1832
+ | `prompt` | `string` | 필수 / required | 영상 생성 프롬프트, 최대 2,000자 |
1833
+ | `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text `text`, `image`, `reference` |
1834
+ | `duration` | `integer` | 선택 / optional | 영상 길이(초), 전체 버전 범위 2~30. 허용 값과 기본값은 버전·등급별로 다릅니다. |
1835
+ | `aspect_ratio` | `string` | 선택 / optional | 출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요. `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` |
1836
+ | `resolution` | `string` | 선택 / optional | 출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. `480p`, `720p`, `1080p` |
1837
+ | `audio` | `boolean` | 선택 / optional | 오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. |
1838
+ | `tier` | `string` | 선택 / optional | 품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. `standard`, `fast`, `mini`, `pro` |
1839
+ | `seed` | `integer` | 선택 / optional | 재현성을 위한 시드 값 |
1860
1840
  | `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
1861
- | `image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1862
- | `last_image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1863
- | `reference_image_url` | `string` (file) | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1864
- | `reference_image_url_2` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(2번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1865
- | `reference_image_url_3` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(3번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1866
- | `reference_video_url` | `string` (file) | 선택 / optional | reference 모드에서 동작을 참조할 영상 URL — https URL, video/mp4, video/quicktime, video/webm, 최대 50MB |
1867
-
1868
- ```json
1869
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"seedance_jobs_create","arguments":{"prompt":"<prompt>"}}}
1841
+ | `image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL |
1842
+ | `last_image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) |
1843
+ | `reference_image_url` | `string (file)` | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL |
1844
+ | `reference_image_url_2` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(2번째) |
1845
+ | `reference_image_url_3` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(3번째) |
1846
+ | `reference_video_url` | `string (file)` | 선택 / optional | reference 모드에서 동작을 참조할 영상 URL |
1847
+ | `reference_image_url_4` | `string (file)` | 선택 / optional | 참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. |
1848
+ | `reference_image_url_5` | `string (file)` | 선택 / optional | 참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. |
1849
+ | `reference_image_url_6` | `string (file)` | 선택 / optional | 참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. |
1850
+ | `reference_image_url_7` | `string (file)` | 선택 / optional | 참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. |
1851
+ | `reference_image_url_8` | `string (file)` | 선택 / optional | 참조 이미지 URL(8번째). 버전별 최대 개수를 확인하세요. |
1852
+ | `reference_image_url_9` | `string (file)` | 선택 / optional | 참조 이미지 URL(9번째). 버전별 최대 개수를 확인하세요. |
1853
+ | `reference_image_url_10` | `string (file)` | 선택 / optional | 참조 이미지 URL(10번째). 버전별 최대 개수를 확인하세요. |
1854
+ | `reference_image_url_11` | `string (file)` | 선택 / optional | 참조 이미지 URL(11번째). 버전별 최대 개수를 확인하세요. |
1855
+ | `reference_image_url_12` | `string (file)` | 선택 / optional | 참조 이미지 URL(12번째). 버전별 최대 개수를 확인하세요. |
1856
+ | `reference_image_url_13` | `string (file)` | 선택 / optional | 참조 이미지 URL(13번째). 버전별 최대 개수를 확인하세요. |
1857
+ | `reference_image_url_14` | `string (file)` | 선택 / optional | 참조 이미지 URL(14번째). 버전별 최대 개수를 확인하세요. |
1858
+ | `reference_image_url_15` | `string (file)` | 선택 / optional | 참조 이미지 URL(15번째). 버전별 최대 개수를 확인하세요. |
1859
+ | `reference_image_url_16` | `string (file)` | 선택 / optional | 참조 이미지 URL(16번째). 버전별 최대 개수를 확인하세요. |
1860
+ | `reference_image_url_17` | `string (file)` | 선택 / optional | 참조 이미지 URL(17번째). 버전별 최대 개수를 확인하세요. |
1861
+ | `reference_image_url_18` | `string (file)` | 선택 / optional | 참조 이미지 URL(18번째). 버전별 최대 개수를 확인하세요. |
1862
+ | `reference_image_url_19` | `string (file)` | 선택 / optional | 참조 이미지 URL(19번째). 버전별 최대 개수를 확인하세요. |
1863
+ | `reference_image_url_20` | `string (file)` | 선택 / optional | 참조 이미지 URL(20번째). 버전별 최대 개수를 확인하세요. |
1864
+ | `reference_image_url_21` | `string (file)` | 선택 / optional | 참조 이미지 URL(21번째). 버전별 최대 개수를 확인하세요. |
1865
+ | `reference_image_url_22` | `string (file)` | 선택 / optional | 참조 이미지 URL(22번째). 버전별 최대 개수를 확인하세요. |
1866
+ | `reference_image_url_23` | `string (file)` | 선택 / optional | 참조 이미지 URL(23번째). 버전별 최대 개수를 확인하세요. |
1867
+ | `reference_image_url_24` | `string (file)` | 선택 / optional | 참조 이미지 URL(24번째). 버전별 최대 개수를 확인하세요. |
1868
+ | `reference_image_url_25` | `string (file)` | 선택 / optional | 참조 이미지 URL(25번째). 버전별 최대 개수를 확인하세요. |
1869
+ | `reference_image_url_26` | `string (file)` | 선택 / optional | 참조 이미지 URL(26번째). 버전별 최대 개수를 확인하세요. |
1870
+ | `reference_image_url_27` | `string (file)` | 선택 / optional | 참조 이미지 URL(27번째). 버전별 최대 개수를 확인하세요. |
1871
+ | `reference_image_url_28` | `string (file)` | 선택 / optional | 참조 이미지 URL(28번째). 버전별 최대 개수를 확인하세요. |
1872
+ | `reference_image_url_29` | `string (file)` | 선택 / optional | 참조 이미지 URL(29번째). 버전별 최대 개수를 확인하세요. |
1873
+ | `reference_image_url_30` | `string (file)` | 선택 / optional | 참조 이미지 URL(30번째). 버전별 최대 개수를 확인하세요. |
1874
+ | `reference_video_url_2` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1875
+ | `reference_video_url_3` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1876
+ | `reference_video_url_4` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1877
+ | `reference_video_url_5` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1878
+ | `reference_video_url_6` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1879
+ | `reference_video_url_7` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1880
+ | `reference_video_url_8` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1881
+ | `reference_video_url_9` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1882
+ | `reference_video_url_10` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1883
+ | `reference_audio_url` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1884
+ | `reference_audio_url_2` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1885
+ | `reference_audio_url_3` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1886
+ | `reference_audio_url_4` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1887
+ | `reference_audio_url_5` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1888
+ | `reference_audio_url_6` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1889
+ | `reference_audio_url_7` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1890
+ | `reference_audio_url_8` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1891
+ | `reference_audio_url_9` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1892
+ | `reference_audio_url_10` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1893
+
1894
+ ```json
1895
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"seedance_jobs_create","arguments":{"prompt":"A red sports car racing through a rainy city","version":"2.0","tier":"mini","duration":4,"resolution":"480p"}}}
1870
1896
  ```
1871
1897
 
1872
1898
  <a id="seedance-jobs-status"></a>
@@ -1891,32 +1917,31 @@ Seedance 영상 작업의 진행 상태를 조회합니다. 완료되면 응답
1891
1917
 
1892
1918
  ### `veo_jobs_create` — Veo 영상 작업 접수
1893
1919
 
1894
- Submit an asynchronous Veo video generation job combining text, image, or reference images into a 4/6/8-second high-quality video.
1920
+ Submit an asynchronous Veo video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Veo 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, veo_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 900포인트가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
1895
1921
 
1896
- Veo 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `veo_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 포인트`(등급별 단가는 요금 절 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
1897
-
1898
- > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `ai`
1922
+ 기본 버전 기준: 초당 900포인트 × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.
1899
1923
 
1900
1924
  | Parameter | Type | Required | Description 설명 |
1901
1925
  | --- | --- | --- | --- |
1902
- | `prompt` | `string` | **필수 / required** | 영상 생성 프롬프트, 최대 2,000자 |
1903
- | `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지로 주체 지정). 기본 text |
1904
- | `duration` | `integer` | 선택 / optional | 영상 길이(초). 4, 6, 8 중 하나만 허용, 기본 8 |
1905
- | `aspect_ratio` | `string` | 선택 / optional | 가로세로 비율 — `16:9`, `9:16` 중 하나, 기본 16:9 |
1906
- | `resolution` | `string` | 선택 / optional | 해상도 — `720p`, `1080p`, `4k` 중 하나, 기본 720p |
1907
- | `audio` | `boolean` | 선택 / optional | 오디오 생성 여부, 기본 true |
1908
- | `tier` | `string` | 선택 / optional | 품질/속도 등급 — `standard`, `fast` 중 하나, 기본 standard |
1926
+ | `version` | `string` | 선택 / optional | 영상 모델 버전. 생략 시 3.1. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. `3.1` |
1927
+ | `prompt` | `string` | 필수 / required | 영상 생성 프롬프트, 최대 2,000자 |
1928
+ | `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text `text`, `image`, `reference` |
1929
+ | `duration` | `integer` | 선택 / optional | 영상 길이(초), 전체 버전 범위 4~8. 허용 값과 기본값은 버전·등급별로 다릅니다. |
1930
+ | `aspect_ratio` | `string` | 선택 / optional | 출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요. `16:9`, `9:16` |
1931
+ | `resolution` | `string` | 선택 / optional | 출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. `720p`, `1080p`, `4k` |
1932
+ | `audio` | `boolean` | 선택 / optional | 오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. |
1933
+ | `tier` | `string` | 선택 / optional | 품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. `standard`, `fast`, `lite` |
1909
1934
  | `negative_prompt` | `string` | 선택 / optional | 제외할 요소를 설명하는 텍스트 |
1910
1935
  | `seed` | `integer` | 선택 / optional | 재현성을 위한 시드 값 |
1911
1936
  | `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
1912
- | `image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1913
- | `last_image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1914
- | `reference_image_url` | `string` (file) | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1915
- | `reference_image_url_2` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(2번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1916
- | `reference_image_url_3` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(3번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
1937
+ | `image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL |
1938
+ | `last_image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) |
1939
+ | `reference_image_url` | `string (file)` | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL |
1940
+ | `reference_image_url_2` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(2번째) |
1941
+ | `reference_image_url_3` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(3번째) |
1917
1942
 
1918
1943
  ```json
1919
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"veo_jobs_create","arguments":{"prompt":"<prompt>"}}}
1944
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"veo_jobs_create","arguments":{"prompt":"A boat crossing the sea","version":"3.1"}}}
1920
1945
  ```
1921
1946
 
1922
1947
  <a id="veo-jobs-status"></a>
@@ -1941,32 +1966,39 @@ Veo 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 `r
1941
1966
 
1942
1967
  ### `kling_jobs_create` — Kling 영상 작업 접수
1943
1968
 
1944
- Submit an asynchronous Kling video generation job combining text, image, or reference subjects into a 3-15 second video.
1945
-
1946
- Kling 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `kling_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 포인트`(등급별 단가는 요금 절 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
1969
+ Submit an asynchronous Kling video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Kling 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, kling_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 410포인트가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
1947
1970
 
1948
- > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `ai`
1971
+ 기본 버전 기준: 초당 410포인트 × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.
1949
1972
 
1950
1973
  | Parameter | Type | Required | Description 설명 |
1951
1974
  | --- | --- | --- | --- |
1952
- | `prompt` | `string` | **필수 / required** | 영상 생성 프롬프트, 최대 2,000자 |
1953
- | `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text |
1954
- | `duration` | `integer` | 선택 / optional | 영상 길이(초), 3~15, 기본 5 |
1955
- | `aspect_ratio` | `string` | 선택 / optional | 가로세로 비율 — `16:9`, `9:16`, `1:1` 중 하나, 기본 16:9 |
1956
- | `resolution` | `string` | 선택 / optional | image 모드 전용 해상도(다른 모드에서는 지원하지 않음) — `720P`, `1080P-SR`, `1440P-SR`, `1080P` 중 tier별 허용 목록에서 선택, 기본은 std=720P·pro=1080P |
1957
- | `audio` | `boolean` | 선택 / optional | 오디오 생성 여부, 기본 true |
1958
- | `tier` | `string` | 선택 / optional | 품질/속도 등급 — `std`, `pro` 중 하나, 기본 std |
1975
+ | `version` | `string` | 선택 / optional | 영상 모델 버전. 생략 시 3.0. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. `3.0`, `o3`, `o1`, `2.6`, `2.5`, `2.1`, `2.0`, `1.6` |
1976
+ | `prompt` | `string` | 필수 / required | 영상 생성 프롬프트, 최대 2,000자 |
1977
+ | `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text `text`, `image`, `reference` |
1978
+ | `duration` | `integer` | 선택 / optional | 영상 길이(초), 전체 버전 범위 3~15. 허용 값과 기본값은 버전·등급별로 다릅니다. |
1979
+ | `aspect_ratio` | `string` | 선택 / optional | 출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요. `16:9`, `9:16`, `1:1` |
1980
+ | `resolution` | `string` | 선택 / optional | 출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. `720p`, `1080p`, `720P`, `1080P-SR`, `1440P-SR`, `1080P` |
1981
+ | `audio` | `boolean` | 선택 / optional | 오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. |
1982
+ | `tier` | `string` | 선택 / optional | 품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. `std`, `pro`, `turbo`, `4k`, `standard`, `master` |
1959
1983
  | `negative_prompt` | `string` | 선택 / optional | 제외할 요소를 설명하는 텍스트 |
1960
1984
  | `cfg_scale` | `number` | 선택 / optional | 프롬프트 반영 강도(0~1), 기본 0.5 |
1961
1985
  | `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
1962
- | `image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
1963
- | `last_image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
1964
- | `reference_image_url` | `string` (file) | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
1965
- | `reference_image_url_2` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(2번째) — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
1966
- | `reference_image_url_3` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(3번째) — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
1986
+ | `image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL |
1987
+ | `last_image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) |
1988
+ | `reference_image_url` | `string (file)` | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL |
1989
+ | `reference_image_url_2` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(2번째) |
1990
+ | `reference_image_url_3` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(3번째) |
1991
+ | `reference_image_url_4` | `string (file)` | 선택 / optional | 참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. |
1992
+ | `reference_image_url_5` | `string (file)` | 선택 / optional | 참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. |
1993
+ | `reference_image_url_6` | `string (file)` | 선택 / optional | 참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. |
1994
+ | `reference_image_url_7` | `string (file)` | 선택 / optional | 참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. |
1995
+ | `reference_video_url` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1996
+ | `reference_video_url_2` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1997
+ | `reference_video_url_3` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1998
+ | `reference_video_url_4` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
1967
1999
 
1968
2000
  ```json
1969
- {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kling_jobs_create","arguments":{"prompt":"<prompt>"}}}
2001
+ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kling_jobs_create","arguments":{"prompt":"A boat crossing the sea","version":"3.0"}}}
1970
2002
  ```
1971
2003
 
1972
2004
  <a id="kling-jobs-status"></a>
@@ -2019,3 +2051,21 @@ Video generation is billed per second of output (`duration × per-second points`
2019
2051
  `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`).
2020
2052
 
2021
2053
  `tts_jobs_quality`는 작업 ID로 발화 검수와 후보 이력을 조회합니다. `tts_jobs_candidate_audio`는 작업 ID·후보 ID로 WAV를 조회하며 최종 다운로드를 소비하지 않습니다. 후보는 종료 후 72시간 보존됩니다. `tts_jobs_retry`는 발화 ID 목록과 멱등 키로 같은 작업을 추가 과금 없이 재개합니다. 응답 단절 시 동일한 키와 목록을 재사용하세요.
2054
+
2055
+ ## Video model versions
2056
+
2057
+ Omitting `version` preserves Seedance 2.5, Veo 3.1 and Kling 3.0. Set `version` and `tier` explicitly to select a generation; jobs are never silently switched to another version. Submission and status responses include `version`.
2058
+
2059
+ Available generations: Seedance 1.0/1.5/2.0/2.5, including Seedance 2.0 Standard/Fast/Mini; Veo 3.1 (Standard/Fast/Lite); Kling 1.6/2.0/2.1/2.5/2.6/3.0/O1/O3. Veo 3.0 is unavailable. Seedance 2.0 Mini supports 480p/720p and 4–15 seconds. Modes, tiers, resolutions, durations, audio, file limits and prices vary by combination. See the [Seedance](https://apick.app/dev_guide/seedancejobs), [Veo](https://apick.app/dev_guide/veojobs) and [Kling](https://apick.app/dev_guide/klingjobs) version tables. Unsupported combinations are rejected before submission.
2060
+
2061
+ ## 영상 모델 버전 선택
2062
+
2063
+ `version`을 생략하면 Seedance 2.5, Veo 3.1, Kling 3.0을 사용합니다. 버전과 등급을 명시하면 해당 조합으로 생성하며 다른 모델로 자동 대체하지 않습니다. 생성과 상태 응답의 `version`으로 확인할 수 있습니다.
2064
+
2065
+ | 제품 | 제공 버전 | 제약과 요금 |
2066
+ |---|---|---|
2067
+ | Seedance | 2.5, 2.0(Standard·Fast·Mini), 1.5, 1.0 | [버전별 지원표](https://apick.app/dev_guide/seedancejobs) |
2068
+ | Veo | 3.1 (Standard, Fast, Lite) | [버전별 지원표](https://apick.app/dev_guide/veojobs) |
2069
+ | Kling | 3.0, O3, O1, 2.6, 2.5, 2.1, 2.0, 1.6 | [버전별 지원표](https://apick.app/dev_guide/klingjobs) |
2070
+
2071
+ 등급·해상도·길이·오디오·파일 개수와 초당 포인트는 선택 조합별로 다릅니다. Seedance 2.0은 Standard·Fast·Mini를 제공하며 Mini는 480p·720p와 4~15초를 지원합니다. 무음 전용 모델은 `audio=false`, 오디오 필수 모델은 `audio=true`만 허용합니다. Veo 3.0은 현재 제공하지 않습니다. 지원하지 않는 조합은 접수 전에 거절됩니다.
package/package.json CHANGED
@@ -1,89 +1,89 @@
1
- {
2
- "name": "apick-mcp",
3
- "version": "3.2.2",
4
- "description": "APICK MCP — 97 Korean data, AI, image & video tools for AI agents. 사업자조회·신분증·OCR·배송조회·이미지 생성·편집·영상 생성·파일변환·검색·LLM.",
5
- "type": "module",
6
- "license": "MIT",
7
- "author": "APICK",
8
- "homepage": "https://apick.app/dev_guide/mcp",
9
- "repository": {
10
- "type": "git",
11
- "url": "git+https://github.com/lead788/apick-mcp.git"
12
- },
13
- "bugs": {
14
- "url": "https://github.com/lead788/apick-mcp/issues"
15
- },
16
- "mcpName": "app.apick/all",
17
- "bin": {
18
- "apick-mcp": "src/index.js"
19
- },
20
- "exports": {
21
- ".": "./src/bridge.js"
22
- },
23
- "files": [
24
- "src",
25
- "README.md",
26
- "TOOLS.md",
27
- "CHANGELOG.md",
28
- "LICENSE"
29
- ],
30
- "engines": {
31
- "node": ">=18"
32
- },
33
- "scripts": {
34
- "test": "node --test"
35
- },
36
- "keywords": [
37
- "mcp",
38
- "modelcontextprotocol",
39
- "model-context-protocol",
40
- "mcp-server",
41
- "mcp-tools",
42
- "claude",
43
- "claude-code",
44
- "claude-desktop",
45
- "cursor",
46
- "cline",
47
- "windsurf",
48
- "ai-agent",
49
- "llm",
50
- "apick",
51
- "korea",
52
- "korean",
53
- "korea-api",
54
- "business-registry",
55
- "business-registration-number",
56
- "identity-verification",
57
- "kyc",
58
- "kyb",
59
- "id-card-verification",
60
- "pii-masking",
61
- "ocr",
62
- "korean-ocr",
63
- "parcel-tracking",
64
- "delivery-tracking",
65
- "shipment-tracking",
66
- "bank-account-verification",
67
- "account-holder-lookup",
68
- "real-estate-price",
69
- "address-search",
70
- "holiday-api",
71
- "whois",
72
- "dns-lookup",
73
- "ip-geolocation",
74
- "web-scraping",
75
- "screenshot-api",
76
- "google-search",
77
- "pdf-conversion",
78
- "docx",
79
- "excel",
80
- "watermark",
81
- "speech-to-text",
82
- "face-detection",
83
- "face-blur",
84
- "nsfw-detection",
85
- "image-similarity",
86
- "image-generation",
87
- "image-editing"
88
- ]
89
- }
1
+ {
2
+ "name": "apick-mcp",
3
+ "version": "3.4.0",
4
+ "description": "APICK MCP — 96 Korean data, AI, image & video tools for AI agents. 사업자조회·신분증·OCR·배송조회·이미지 생성·편집·영상 생성·파일변환·검색·LLM.",
5
+ "type": "module",
6
+ "license": "MIT",
7
+ "author": "APICK",
8
+ "homepage": "https://apick.app/dev_guide/mcp",
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "git+https://github.com/lead788/apick-mcp.git"
12
+ },
13
+ "bugs": {
14
+ "url": "https://github.com/lead788/apick-mcp/issues"
15
+ },
16
+ "mcpName": "app.apick/all",
17
+ "bin": {
18
+ "apick-mcp": "src/index.js"
19
+ },
20
+ "exports": {
21
+ ".": "./src/bridge.js"
22
+ },
23
+ "files": [
24
+ "src",
25
+ "README.md",
26
+ "TOOLS.md",
27
+ "CHANGELOG.md",
28
+ "LICENSE"
29
+ ],
30
+ "engines": {
31
+ "node": ">=18"
32
+ },
33
+ "scripts": {
34
+ "test": "node --test"
35
+ },
36
+ "keywords": [
37
+ "mcp",
38
+ "modelcontextprotocol",
39
+ "model-context-protocol",
40
+ "mcp-server",
41
+ "mcp-tools",
42
+ "claude",
43
+ "claude-code",
44
+ "claude-desktop",
45
+ "cursor",
46
+ "cline",
47
+ "windsurf",
48
+ "ai-agent",
49
+ "llm",
50
+ "apick",
51
+ "korea",
52
+ "korean",
53
+ "korea-api",
54
+ "business-registry",
55
+ "business-registration-number",
56
+ "identity-verification",
57
+ "kyc",
58
+ "kyb",
59
+ "id-card-verification",
60
+ "pii-masking",
61
+ "ocr",
62
+ "korean-ocr",
63
+ "parcel-tracking",
64
+ "delivery-tracking",
65
+ "shipment-tracking",
66
+ "bank-account-verification",
67
+ "account-holder-lookup",
68
+ "real-estate-price",
69
+ "address-search",
70
+ "holiday-api",
71
+ "whois",
72
+ "dns-lookup",
73
+ "ip-geolocation",
74
+ "web-scraping",
75
+ "screenshot-api",
76
+ "google-search",
77
+ "pdf-conversion",
78
+ "docx",
79
+ "excel",
80
+ "watermark",
81
+ "speech-to-text",
82
+ "face-detection",
83
+ "face-blur",
84
+ "nsfw-detection",
85
+ "image-similarity",
86
+ "image-generation",
87
+ "image-editing"
88
+ ]
89
+ }