apick-mcp 3.2.0 → 3.2.2

package/CHANGELOG.md

@@ -1,4 +1,15 @@
-# 변경 기록
+# 변경 기록
+
+## 3.2.2 - 2026-09-14
+
+- 운전면허 `ghost_num`의 생략·빈값·임의 문자열 허용과 판정 미사용 계약을 한영 문서에 명시했습니다.
+- 운전면허 불일치와 무과금 처리 실패를 구분하고, 응답에 조회 페이지 HTML을 포함하지 않는 계약을 안내합니다.
+- Clarify optional driver-license serial input, match semantics, safe messages, and uncharged processing failures.
+
+## 3.2.1 - 2026-09-14
+
+- Seedance 영상 생성 요금을 해상도별로 세분화(480p 560P·720p 1,250P·1080p 2,810P)하고 1080p 해상도를 지원합니다.
+- Kling 영상 생성 요금을 std 410P·pro 550P로 갱신했습니다.
 
 ## 3.2.0 - 2026-09-14
 

package/TOOLS.md

@@ -434,9 +434,13 @@ Verify the authenticity of a Korean resident registration card (jumin-deungnokje
 
 ### `identi_card2` — [Text] 운전면허증 진위 확인
 
-Verify the authenticity of a Korean driver license using text input.
+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.
 
-운전면허증의 기재 정보를 입력해 진위 여부를 확인합니다. birth_y, birth_m, birth_d, name과 면허번호 4구획(licen_no0~licen_no3)은 모두 필수이며, ghost_num(식별번호)과 rrn1, rrn2는 선택 입력입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
+운전면허번호와 인적사항의 일치 여부를 조회합니다. birth_y, birth_m, birth_d, name과 면허번호 4구획(licen_no0~licen_no3)은 필수입니다. ghost_num(식별번호)은 생략·빈값·임의 문자열 모두 허용하며 전달값은 판정에 사용하지 않습니다. rrn1, rrn2도 선택 입력입니다. 암호일련번호 자체나 실물 면허증의 위·변조 여부는 검증하지 않습니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
+
+`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.
+
+`result=0`은 불일치, `result=1`은 일치입니다. 판정 확인 실패는 HTTP 424(`result=2`), 시간 초과는 HTTP 408(`result=3`)이며 과금되지 않습니다. 응답에는 짧은 안내 문구만 포함되고 조회 페이지 HTML은 포함되지 않습니다.
 
 > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
 
@@ -450,7 +454,7 @@ Verify the authenticity of a Korean driver license using text input.
 | `licen_no1` | `string` | **필수 / required** | 면허번호 2구획 (예: 19) |
 | `licen_no2` | `string` | **필수 / required** | 면허번호 3구획 (예: 174133) |
 | `licen_no3` | `string` | **필수 / required** | 면허번호 4구획 (예: 01) |
-| `ghost_num` | `string` | 선택 / optional | 식별번호 (면허증 우측 표기, 예: 8H1X3Y) |
+| `ghost_num` | `string` | 선택 / optional | 생략·빈값 허용, 전달값은 판정에 사용하지 않음 / May be omitted or empty; not used in the match decision |
 | `rrn1` | `string` | 선택 / optional | 주민등록번호 앞 6자리 (선택) |
 | `rrn2` | `string` | 선택 / optional | 주민등록번호 뒤 7자리 (선택) |
 
@@ -1841,7 +1845,7 @@ Polish a text (up to 100,000 characters) by fixing grammar, spelling, and awkwar
 
 Submit an asynchronous Seedance video generation job combining text, image, or reference inputs into up to a 30-second video.
 
-Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `seedance_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 610포인트`가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
+Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `seedance_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 포인트`(해상도별 단가는 요금 절 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
 
 > **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `ai`
 
@@ -1851,7 +1855,7 @@ Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/refere
 | `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text |
 | `duration` | `integer` | 선택 / optional | 영상 길이(초), 4~30, 기본 5 |
 | `aspect_ratio` | `string` | 선택 / optional | 가로세로 비율 — `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` 중 하나, 기본 16:9 |
-| `resolution` | `string` | 선택 / optional | 해상도 — `480p`, `720p` 중 하나, 기본 720p |
+| `resolution` | `string` | 선택 / optional | 해상도 — `480p`, `720p`, `1080p` 중 하나, 기본 720p. 해상도별로 초당 포인트가 다릅니다(요금 절 참고, 높을수록 비용 증가) |
 | `audio` | `boolean` | 선택 / optional | 오디오 생성 여부, 기본 true. 생성된 오디오가 정책(저작권 등) 검수에서 거부되면 작업이 실패하고 전액 환불됩니다 |
 | `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
 | `image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
@@ -1998,13 +2002,15 @@ Current rates 단가표: <https://apick.app/dev_guide/mcp> · Sign up for 1,000
 Video generation is billed per second of output (`duration × per-second points`), not per call — the rate above is per second, not per video.
 영상 생성은 호출당이 아니라 초당 과금입니다(`duration × 초당 포인트`) — 아래 단가는 1초당 포인트입니다.
 
-| Model 모델 | Tier 등급 | Points/sec 초당 포인트 |
+| Model 모델 | Tier·Resolution 등급·해상도 | Points/sec 초당 포인트 |
 | --- | --- | --- |
-| Seedance | standard | 610P |
+| Seedance | standard · 480p | 560P |
+| Seedance | standard · 720p | 1,250P |
+| Seedance | standard · 1080p | 2,810P |
 | Veo | standard | 900P |
 | Veo | fast | 360P |
-| Kling | std | 320P |
-| Kling | pro | 430P |
+| Kling | std | 410P |
+| Kling | pro | 550P |
 
 ## TTS quality and recovery / TTS 검수와 재개
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apick-mcp",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "APICK MCP — 97 Korean data, AI, image & video tools for AI agents. 사업자조회·신분증·OCR·배송조회·이미지 생성·편집·영상 생성·파일변환·검색·LLM.",
   "type": "module",
   "license": "MIT",

package/src/index.js

@@ -1,92 +1,92 @@
-#!/usr/bin/env node
-// apick-mcp - run the APICK MCP server over stdio.
-//
-// Usage:
-//   apick-mcp [--server <name>]
-//
-// Environment:
-//   APICK_API_KEY     APICK license key. Optional: tools/list works without one,
-//                     tools/call needs it.
-//   APICK_MCP_SERVER  Which server to expose (default: all).
-//   APICK_MCP_URL     Base URL override (default: https://apick.app/mcp).
-
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { createBridge, DEFAULT_ENDPOINT, SERVERS } from './bridge.js';
-
-const HELP = `apick-mcp - APICK MCP server over stdio
-
-  apick-mcp [--server <name>]
-
-Options
-  --server, -s <name>  ${SERVERS.join(', ')}  (default: all)
-  --version, -v        print version
-  --help, -h           print this message
-
-Environment
-  APICK_API_KEY        APICK license key (get one at https://apick.app)
-  APICK_MCP_SERVER     same as --server
-  APICK_MCP_URL        base URL override (default: ${DEFAULT_ENDPOINT})
-
-Clients that support remote MCP can skip this bridge and connect straight to
-${DEFAULT_ENDPOINT}/all with an Authorization: Bearer header.
-Docs: https://apick.app/dev_guide/mcp
-`;
-
-function parseArgs(argv) {
-	const args = { server: process.env.APICK_MCP_SERVER || 'all' };
-	for (let i = 0; i < argv.length; i++) {
-		const arg = argv[i];
-		if (arg === '--help' || arg === '-h') args.help = true;
-		else if (arg === '--version' || arg === '-v') args.version = true;
-		else if (arg === '--server' || arg === '-s') args.server = argv[++i];
-		else if (arg.startsWith('--server=')) args.server = arg.slice('--server='.length);
-		else args.unknown = arg;
-	}
-	return args;
-}
-
-async function main() {
-	const args = parseArgs(process.argv.slice(2));
-
-	if (args.help) {
-		process.stdout.write(HELP);
-		return;
-	}
-	if (args.version) {
-		const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));
-		process.stdout.write(JSON.parse(readFileSync(pkgPath, 'utf8')).version + '\n');
-		return;
-	}
-	if (args.unknown) {
-		process.stderr.write('apick-mcp: unknown argument ' + args.unknown + '\n\n' + HELP);
-		process.exitCode = 2;
-		return;
-	}
-	if (!SERVERS.includes(args.server)) {
-		process.stderr.write(
-			'apick-mcp: unknown server "' + args.server + '". Available: ' + SERVERS.join(', ') + '\n'
-		);
-		process.exitCode = 2;
-		return;
-	}
-
-	const bridge = createBridge({
-		server: args.server,
-		apiKey: process.env.APICK_API_KEY,
-		endpoint: process.env.APICK_MCP_URL
-	});
-
-	if (!process.env.APICK_API_KEY) {
-		process.stderr.write(
-			'apick-mcp: no APICK_API_KEY set - tool discovery works, tool calls will ask you to sign in at https://apick.app\n'
-		);
-	}
-
-	await bridge.attach(process.stdin);
-}
-
-main().catch((err) => {
-	process.stderr.write('apick-mcp: ' + err.message + '\n');
-	process.exitCode = 1;
-});
+#!/usr/bin/env node
+// apick-mcp - run the APICK MCP server over stdio.
+//
+// Usage:
+//   apick-mcp [--server <name>]
+//
+// Environment:
+//   APICK_API_KEY     APICK license key. Optional: tools/list works without one,
+//                     tools/call needs it.
+//   APICK_MCP_SERVER  Which server to expose (default: all).
+//   APICK_MCP_URL     Base URL override (default: https://apick.app/mcp).
+
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { createBridge, DEFAULT_ENDPOINT, SERVERS } from './bridge.js';
+
+const HELP = `apick-mcp - APICK MCP server over stdio
+
+  apick-mcp [--server <name>]
+
+Options
+  --server, -s <name>  ${SERVERS.join(', ')}  (default: all)
+  --version, -v        print version
+  --help, -h           print this message
+
+Environment
+  APICK_API_KEY        APICK license key (get one at https://apick.app)
+  APICK_MCP_SERVER     same as --server
+  APICK_MCP_URL        base URL override (default: ${DEFAULT_ENDPOINT})
+
+Clients that support remote MCP can skip this bridge and connect straight to
+${DEFAULT_ENDPOINT}/all with an Authorization: Bearer header.
+Docs: https://apick.app/dev_guide/mcp
+`;
+
+function parseArgs(argv) {
+	const args = { server: process.env.APICK_MCP_SERVER || 'all' };
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg === '--help' || arg === '-h') args.help = true;
+		else if (arg === '--version' || arg === '-v') args.version = true;
+		else if (arg === '--server' || arg === '-s') args.server = argv[++i];
+		else if (arg.startsWith('--server=')) args.server = arg.slice('--server='.length);
+		else args.unknown = arg;
+	}
+	return args;
+}
+
+async function main() {
+	const args = parseArgs(process.argv.slice(2));
+
+	if (args.help) {
+		process.stdout.write(HELP);
+		return;
+	}
+	if (args.version) {
+		const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));
+		process.stdout.write(JSON.parse(readFileSync(pkgPath, 'utf8')).version + '\n');
+		return;
+	}
+	if (args.unknown) {
+		process.stderr.write('apick-mcp: unknown argument ' + args.unknown + '\n\n' + HELP);
+		process.exitCode = 2;
+		return;
+	}
+	if (!SERVERS.includes(args.server)) {
+		process.stderr.write(
+			'apick-mcp: unknown server "' + args.server + '". Available: ' + SERVERS.join(', ') + '\n'
+		);
+		process.exitCode = 2;
+		return;
+	}
+
+	const bridge = createBridge({
+		server: args.server,
+		apiKey: process.env.APICK_API_KEY,
+		endpoint: process.env.APICK_MCP_URL
+	});
+
+	if (!process.env.APICK_API_KEY) {
+		process.stderr.write(
+			'apick-mcp: no APICK_API_KEY set - tool discovery works, tool calls will ask you to sign in at https://apick.app\n'
+		);
+	}
+
+	await bridge.attach(process.stdin);
+}
+
+main().catch((err) => {
+	process.stderr.write('apick-mcp: ' + err.message + '\n');
+	process.exitCode = 1;
+});