apick-api 4.11.0 → 4.13.0

package/docs/guide.en.md

@@ -116,7 +116,7 @@ await client.ocr(bytes, {
 Query `listGeminiTtsVoices()` and `listOpenAiTtsVoices()` for current voices; legacy `TTS_VOICE_IDS` are retired.
 
 
-Normalization is on by default and adds a skill charge. Set `normalize_text: false` (SDK `normalizeText: false`) to skip execution and billing. The skill price is its base fee (seller amount and base commission) plus actual AI cost × the pinned exchange rate × 1.4. Normalization failure stops synthesis; final server/provider failures refund normalization as well. ASS preserves the original spelling.
+Normalization is on by default and adds a skill charge. Set `normalize_text: false` (SDK `normalizeText: false`) to skip execution and billing. The skill price is its base fee (seller amount and base commission) plus the actual AI usage fee. Normalization failure stops synthesis; final server/provider failures refund normalization as well. ASS preserves the original spelling.
 
 ```js
 const screenshot = await client.screenshot('https://example.com');

package/docs/guide.ko.md

@@ -116,7 +116,7 @@ await client.ocr(bytes, {
 현재 목소리는 `listGeminiTtsVoices()`와 `listOpenAiTtsVoices()`로 조회합니다. 기존 `TTS_VOICE_IDS`는 폐기된 목소리입니다.
 
 
-정규화는 기본 켜짐이며 발음을 다듬는 스킬 요금이 추가됩니다. `normalize_text: false`(SDK `normalizeText: false`)로 실행과 요금을 끕니다. 스킬 최종가는 기본요금(판매자 금액·기본 수수료) + AI 원가 × 환율 × 1.4입니다. 정규화 실패는 제작을 중단하며, 서버·공급자의 최종 제작 실패는 정규화까지 전액 환불합니다. ASS에는 원문을 표시합니다.
+정규화는 기본 켜짐이며 발음을 다듬는 스킬 요금이 추가됩니다. `normalize_text: false`(SDK `normalizeText: false`)로 실행과 요금을 끕니다. 스킬 최종가는 기본요금(판매자 금액·기본 수수료) + 실제 AI 사용료입니다. 정규화 실패는 제작을 중단하며, 서버의 최종 제작 실패는 정규화까지 전액 환불합니다. ASS에는 원문을 표시합니다.
 
 ```js
 const screenshot = await client.screenshot('https://example.com');
@@ -233,7 +233,7 @@ console.log(result.data.result.fields);
 
 ## 간편인증 데이터 조회
 
-재직·소득·연금·면허·건강검진·현금영수증·국세 신고내역·주민등록표 발급·정부24 통합 조회는 본인 간편인증이 필요해 접수(`request*`)와 결과 조회(`get*`)가 나뉩니다.
+재직·소득·연금·면허·건강검진·현금영수증·국세 신고내역·주민등록표 발급·민원서류 통합 조회는 본인 간편인증이 필요해 접수(`request*`)와 결과 조회(`get*`)가 나뉩니다.
 
 아래 함수는 7종 모두에 공통으로 사용합니다. 같은 `transactionId`로 순차 조회하며 5→10→20→30초 간격으로 늘린 뒤 30초를 유지합니다. `resultAvailable === true`이면 즉시 결과를 반환합니다. `SUCCESS`는 전체 성공, `PARTIAL_SUCCESS`는 부분 성공이므로 `sources`에서 누락·실패 항목을 확인하세요. `AUTH_REJECTED`·`AUTH_EXPIRED`·`FAILED`는 실패 종료이며, `errorCode: 'RESULT_EXPIRED'`는 결과 보관 기간 만료입니다. 실패·만료 시 자동으로 재접수하지 않습니다.
 
@@ -309,7 +309,7 @@ try {
 
 `authProvider`는 `AUTH_PROVIDERS`(13종: kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad) 중 하나입니다. 접수는 정액 과금, 결과는 최초 반환에서만 과금되며 재조회는 무료입니다. `requestEmployment`는 `insuranceYears`(1~3), `requestPersonalIncome`은 `incomeYears`(1~5), `requestNpsJoinHistory`는 `from`/`to`(`YYYY-MM`) 선택 입력을 받습니다. `requestNpsDeductionCert`는 `years`(1~5), `requestNpsCareerHistory`는 `from`/`to`(`YYYY-MM`) 선택 입력을 받습니다. `requestCashReceiptDeduction`은 `incomeYears`(1~3), `requestTaxReturnHistory`는 `years`(1~10) 선택 입력을 받습니다. 나머지 상품은 `requestDrivingLicense`, `requestHealthCheckup`입니다.
 
-주민등록표등본·초본은 `requestResidentRegistration()`·`requestResidentRegistrationCho()`로 발급하며 주민등록 주소지 `sido`·`sigungu`가 필수입니다. 발급 1건은 80P이고 결과의 `발급문서`는 PDF 원본의 base64, `문서해시`는 그 SHA-256입니다. 정부24 통합 조회 `requestGov24Bundle()`은 `products`에 고른 상품만 한 번의 인증으로 조회하며, 과금은 고른 상품 단가의 합입니다. 선택 가능한 13개 키는 `GOV24_BUNDLE_PRODUCTS`로 제공하고 `sido`·`sigungu`는 등본·초본을 고를 때만 필요합니다.
+주민등록표등본·초본은 `requestResidentRegistration()`·`requestResidentRegistrationCho()`로 발급하며 주민등록 주소지 `sido`·`sigungu`가 필수입니다. 발급 1건은 80P이고 결과의 `발급문서`는 PDF 원본의 base64, `문서해시`는 그 SHA-256입니다. 민원서류 통합 조회 `requestGov24Bundle()`은 `products`에 고른 상품만 한 번의 인증으로 조회하며, 과금은 고른 상품 단가의 합입니다. 선택 가능한 13개 키는 `GOV24_BUNDLE_PRODUCTS`로 제공하고 `sido`·`sigungu`는 등본·초본을 고를 때만 필요합니다.
 
 ```js
 const bundle = await client.requestGov24Bundle({
@@ -320,7 +320,7 @@ const bundle = await client.requestGov24Bundle({
 const issued = await pollDataResult(id => client.getGov24Bundle(id), bundle);
 ```
 
-홈택스 민원증명은 `requestIncomeAmountCert`(소득금액증명), `requestPensionCreditCert`(연금보험료등 소득세액 공제확인서), `requestFactCert`(납부내역증명), `requestTaxClearanceCert`(납세증명서)로 발급하며 발급 1건은 60P입니다. 모두 본인명의 발급이고 `year`·`use_purpose`·`submit_to`·`delivery`가 필수이며 `format`(`pdf`·`json`·`both`, 기본 `both`)으로 응답을 고릅니다. `json`·`both` 이면 발급된 PDF를 파싱한 `PDF데이터.필드`가 함께 오고, 표 구조에 따라 일부 필드는 비어 있을 수 있습니다. 결과 본문의 `문서확인번호`·`귀속연도` 같은 값이 정본입니다.
+세무 민원증명은 `requestIncomeAmountCert`(소득금액증명), `requestPensionCreditCert`(연금보험료등 소득세액 공제확인서), `requestFactCert`(납부내역증명), `requestTaxClearanceCert`(납세증명서)로 발급하며 발급 1건은 60P입니다. 모두 본인명의 발급이고 `year`·`use_purpose`·`submit_to`·`delivery`가 필수이며 `format`(`pdf`·`json`·`both`, 기본 `both`)으로 응답을 고릅니다. `json`·`both` 이면 발급된 PDF를 파싱한 `PDF데이터.필드`가 함께 오고, 표 구조에 따라 일부 필드는 비어 있을 수 있습니다. 결과 본문의 `문서확인번호`·`귀속연도` 같은 값이 정본입니다.
 
 ```js
 const cert = await client.requestIncomeAmountCert({
@@ -427,7 +427,7 @@ if (status.data.status === "completed") {
 
 ## 상품별 조회 가이드
 
-상품별 간편인증 조회 가이드에는 조회 데이터, 출처 기관, 활용 사례와 자주 묻는 질문이 있습니다. 인증 요청은 해당 상품의 자료를 조회하기 위한 단계이며 결과 조회용 transactionId를 반환합니다. 요청·응답 계약과 인증 방식은 동일합니다. [공통 인증 흐름](https://apick.app/dev_guide/data)에서 절차와 오류 처리를 확인하세요.
+상품별 간편인증 조회 가이드에는 조회 데이터, 활용 사례와 자주 묻는 질문이 있습니다. 인증 요청은 해당 상품의 자료를 조회하기 위한 단계이며 결과 조회용 transactionId를 반환합니다. 요청·응답 계약과 인증 방식은 동일합니다. [공통 인증 흐름](https://apick.app/dev_guide/data)에서 절차와 오류 처리를 확인하세요.
 
 
 TTS: [Gemini·ChatGPT·정규화 / engines and normalization](tts.md). `createOpenAiTtsJob`, `listOpenAiTtsVoices`, `getTtsOptions`를 포함한 최신 계약입니다.

package/docs/skill-artifacts.md

@@ -19,6 +19,6 @@ const downloaded = await apick.getSkillArtifact(run.data.run_id, file.id);
 await downloaded.save('./result.png');
 ```
 
-파일의 `name`, `mime_type`, `bytes`, `sha256`을 확인하고 실제 형식에 맞는 확장자로 저장하세요. 인증키 소유자의 실행 파일만 내려받을 수 있고, 실행 결과가 만료되면 파일도 만료됩니다. 실패·취소·시간 초과는 예약액을 반환하며, 가변 요금 상품은 성공 시 실제 사용료를 정산합니다. 공급자 청구서와 대조한 확정 원가를 뜻하지 않습니다.
+파일의 `name`, `mime_type`, `bytes`, `sha256`을 확인하고 실제 형식에 맞는 확장자로 저장하세요. 인증키 소유자의 실행 파일만 내려받을 수 있고, 실행 결과가 만료되면 파일도 만료됩니다. 실패·취소·시간 초과는 예약액을 반환하며, 가변 요금 상품은 성공 시 실제 사용료를 정산합니다.
 
-Use `name`, `mime_type`, `bytes`, and `sha256` to identify and verify each file; choose a matching extension. Downloads require the run owner's API key and expire with the result. Failed, cancelled, and timed-out runs release the reservation. Variable-price Skills settle recorded tool usage on success; calculated vendor costs are not invoice-reconciled amounts.
+Use `name`, `mime_type`, `bytes`, and `sha256` to identify and verify each file; choose a matching extension. Downloads require the run owner's API key and expire with the result. Failed, cancelled, and timed-out runs release the reservation. Variable-price Skills settle recorded tool usage on success.

package/docs/subagent.md

@@ -1,8 +1,8 @@
 # 서브에이전트 / Subagent
 
-`apick-agent`는 설치형 상품이며 `quoteSkill`·`runSkill` 대신 전용 API를 사용합니다. 설치비·도입비·구독료는 없고, 성공 작업의 확인된 원가에 40%를 가산합니다(2026-11-06부터 분석 원가는 시간대와 관계없이 혼잡 시간대 단가 기준 20%, 자료 선별 원가는 40%)(소수점 올림, 2026-11-06부터 AI 사용 작업 기본 5P). 승인된 동일 결과 캐시는 1P입니다. 충전 잔액 외 상품 사용량 한도는 없습니다.
+`apick-agent`는 설치형 상품이며 `quoteSkill`·`runSkill` 대신 전용 API를 사용합니다. 설치비·도입비·구독료는 없고, 성공한 작업만 사용량대로 정산합니다(소수점 올림, 2026-11-06부터 AI 사용 작업 기본 5P). 승인된 동일 결과 캐시는 1P입니다. 충전 잔액 외 상품 사용량 한도는 없습니다.
 
-`apick-agent` is an installed-agent product. Use the dedicated API rather than `quoteSkill` or `runSkill`. There is no installation, setup or subscription fee. Successful work is billed at confirmed model cost plus 40% (from 2026-11-06, analysis cost is based on the peak-hour rate regardless of time with 20% added; source-selection cost stays at 40%) (fractions rounded up, 5-point base fee for AI jobs from 2026-11-06); approved identical-result cache reuse costs 1 point. There are no product usage quotas beyond prepaid balance.
+`apick-agent` is an installed-agent product. Use the dedicated API rather than `quoteSkill` or `runSkill`. There is no installation, setup or subscription fee. Successful work is billed by actual usage (fractions rounded up, 5-point base fee for AI jobs from 2026-11-06); approved identical-result cache reuse costs 1 point. There are no product usage quotas beyond prepaid balance.
 
 ```js
 import { ApickClient } from 'apick-api';

package/docs/tts.md

@@ -25,10 +25,10 @@ Style, emotion, tone, accent, pace, pitch and volume options can be set per requ
 
 Normalization is enabled by default and costs extra. Disable it with `normalize_text: false` (`normalizeText: false` for the string SDK helper). Input limits are 2,000 characters including utterance separators with normalization, or 8,000 without it. Query a quote, engine-specific voices and supported options before submitting.
 
-실제 AI 원가 × 고정된 환율 × 1.4에 정규화 요금을 더해 정산합니다. 소수점은 올림하며, 2026-11-06부터 합성 작업 1건의 기본요금 5P를 최소액으로 받습니다. Gemini 프로모션 입력/출력 단가는 2026-12-31까지 백만 토큰당 $0.50/$6.00이며 2027-01-01 00:00 UTC부터 $1.00/$12.00입니다. 약 $0.54/시간은 참고값이며 시간 단위 청구가 아닙니다. 엔진별 요금이 다릅니다.
+실제 사용량에 정규화 요금을 더해 정산합니다. 소수점은 올림하며, 2026-11-06부터 합성 작업 1건의 기본요금 5P를 최소액으로 받습니다. 엔진별 요금이 다르며, 예상 금액은 견적 API(`POST /rest/tts/quote`)로 미리 확인할 수 있습니다.
 
-AI usage is charged at verified cost × the pinned exchange rate × 1.4, plus normalization. Fractions are rounded up, and from 2026-11-06 each synthesis job has a 5-point base fee. Gemini promotional input/output rates are $0.50/$6.00 per million tokens through 2026-12-31, then $1.00/$12.00 from 2027-01-01 00:00 UTC. The approximate hourly figure is informational; billing uses actual usage and differs by engine.
+AI usage is charged by actual usage, plus normalization. Fractions are rounded up, and from 2026-11-06 each synthesis job has a 5-point base fee. Rates differ by engine; check the estimate with the quote API (`POST /rest/tts/quote`) first.
 
-두 엔진은 같은 작업 조회·취소·MP3·원문 ASS 계약을 사용합니다. `billing`의 예약·해제·확정·환불을 확인하세요. MP3는 24kHz 모노 48kbps, 결과는 완료 후 24시간 보관합니다. MP3와 ASS는 각각 완료된 다운로드 1회만 허용하며 전송 중단은 재시도할 수 있습니다. 접수 응답 유실 시 같은 입력과 멱등 키를 재사용하세요. 서버·공급자 최종 실패는 정규화까지 환불하며, 연결 종료는 작업 취소가 아닙니다. 취소 시 이미 수행된 작업분을 정산합니다.
+두 엔진은 같은 작업 조회·취소·MP3·원문 ASS 계약을 사용합니다. `billing`의 예약·해제·확정·환불을 확인하세요. MP3는 24kHz 모노 48kbps, 결과는 완료 후 24시간 보관합니다. MP3와 ASS는 각각 완료된 다운로드 1회만 허용하며 전송 중단은 재시도할 수 있습니다. 접수 응답 유실 시 같은 입력과 멱등 키를 재사용하세요. 서버 최종 실패는 정규화까지 환불하며, 연결 종료는 작업 취소가 아닙니다. 취소 시 이미 수행된 작업분을 정산합니다.
 
 Both engines share job status, cancellation, MP3 and original-text ASS downloads. Check reserved, released, captured and refunded amounts in `billing`. MP3 is 24 kHz mono at 48 kbps. Files are kept for 24 hours; each permits one completed download, and interrupted transfers can be retried. Reuse the same input and idempotency key after a lost response. Final server/provider failures refund synthesis and normalization; disconnecting does not cancel work. Explicit cancellation settles work already performed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apick-api",
-  "version": "4.11.0",
+  "version": "4.13.0",
   "description": "Official zero-dependency Node.js client for APICK data, AI, and image APIs. 에이픽 데이터·AI·이미지 API 공식 Node.js SDK.",
   "type": "module",
   "main": "./src/index.cjs",

package/src/index.cjs

@@ -16,7 +16,7 @@ const AUTH_PROVIDERS = Object.freeze([
 	'kakao', 'naver', 'toss', 'pass', 'samsung', 'kb', 'shinhan', 'hana', 'woori', 'ibk', 'nh', 'kakaobank', 'banksalad'
 ]);
 const AUTH_PROVIDER_SET = new Set(AUTH_PROVIDERS);
-// 정부24 통합 조회에서 고를 수 있는 상품 키. 서버 공개 목록과 같다.
+// 민원서류 통합 조회에서 고를 수 있는 상품 키. 서버 공개 목록과 같다.
 const GOV24_BUNDLE_PRODUCTS = Object.freeze([
 	'resident_registration', 'resident_registration_cho', 'driving_license', 'health_checkup',
 	'police_penalty', 'parking_fine_target', 'mortgage_loan', 'housing_refund_balance',
@@ -61,7 +61,36 @@ const SERVICE_DEFINITIONS = Object.freeze({
 	linkedinCompany: { endpoint: '/rest/linkedin_company', timeoutMs: 110_000, output: 'json' },
 	linkedinJob: { endpoint: '/rest/linkedin_job', timeoutMs: 110_000, output: 'json' },
 	courtAuction: { endpoint: '/rest/court_auction', timeoutMs: 45_000, output: 'json' },
+	bidNotice: { endpoint: '/rest/bid_notice', timeoutMs: 45_000, output: 'json' },
+	bidAward: { endpoint: '/rest/bid_award', timeoutMs: 45_000, output: 'json' },
+	rtmsTrade: { endpoint: '/rest/rtms_trade', timeoutMs: 45_000, output: 'json' },
+	rtmsRent: { endpoint: '/rest/rtms_rent', timeoutMs: 45_000, output: 'json' },
 	registryDocVerify: { endpoint: '/rest/registry_doc_verify', timeoutMs: 30_000, output: 'json' },
+	corpFinance: { endpoint: '/rest/corp_finance', timeoutMs: 35_000, output: 'json' },
+	buildingRegister: { endpoint: '/rest/bldrgst', timeoutMs: 35_000, output: 'json' },
+	appReviews: { endpoint: '/rest/app_reviews', timeoutMs: 35_000, output: 'json' },
+	vehicleEmission: { endpoint: '/rest/vehicle_emission', timeoutMs: 25_000, output: 'json' },
+	vehicleRecall: { endpoint: '/rest/vehicle_recall', timeoutMs: 45_000, output: 'json' },
+	hipassUnpaid: { endpoint: '/rest/hipass_unpaid', timeoutMs: 30_000, output: 'json' },
+	vehicleTaxCalc: { endpoint: '/rest/vehicle_tax_calc', timeoutMs: 15_000, output: 'json' },
+	// 공간정보는 배열·GeoJSON 객체를 그대로 보내도록 JSON 본문을 쓴다.
+	geoStandardize: { endpoint: '/rest/geo_standardize', timeoutMs: 30_000, output: 'json', json: true },
+	geoBatchGeocode: { endpoint: '/rest/geo_batch_geocode', timeoutMs: 35_000, output: 'json', json: true },
+	geoReverse: { endpoint: '/rest/geo_reverse', timeoutMs: 25_000, output: 'json', json: true },
+	geoAddressSearch: { endpoint: '/rest/geo_address_search', timeoutMs: 30_000, output: 'json', json: true },
+	geoPlaceSearch: { endpoint: '/rest/geo_place_search', timeoutMs: 30_000, output: 'json', json: true },
+	geoAdminCode: { endpoint: '/rest/geo_admin_code', timeoutMs: 25_000, output: 'json', json: true },
+	geoCompareAddress: { endpoint: '/rest/geo_compare_address', timeoutMs: 35_000, output: 'json', json: true },
+	geoMeasure: { endpoint: '/rest/geo_measure', timeoutMs: 25_000, output: 'json', json: true },
+	geoGeojsonAnalyze: { endpoint: '/rest/geo_geojson_analyze', timeoutMs: 25_000, output: 'json', json: true },
+	geoAddressQuality: { endpoint: '/rest/geo_address_quality', timeoutMs: 35_000, output: 'json', json: true },
+	geoAddressAutocomplete: { endpoint: '/rest/geo_address_autocomplete', timeoutMs: 25_000, output: 'json', json: true },
+	geoDistrictBoundary: { endpoint: '/rest/geo_district_boundary', timeoutMs: 35_000, output: 'json', json: true },
+	geoNeighborhood: { endpoint: '/rest/geo_neighborhood', timeoutMs: 35_000, output: 'json', json: true },
+	registryRealestateSearch: { endpoint: '/rest/registry_realestate_search', timeoutMs: 125_000, output: 'json' },
+	registryCorporateSearch: { endpoint: '/rest/registry_corporate_search', timeoutMs: 125_000, output: 'json' },
+	createRegistryRealestateJob: { endpoint: '/rest/registry_realestate_jobs', timeoutMs: 50_000, output: 'json' },
+	createRegistryCorporateJob: { endpoint: '/rest/registry_corporate_jobs', timeoutMs: 50_000, output: 'json' },
 	screenshot: { endpoint: '/rest/url_screenshot', timeoutMs: 75_000, output: 'binary', filename: 'screenshot.jpeg' },
 	youtubeMetadata: { endpoint: '/rest/youtube_metadata', timeoutMs: 60_000, output: 'json' },
 	youtubeThumbnail: { endpoint: '/rest/youtube_thumbnail', timeoutMs: 60_000, output: 'binary', filename: 'thumbnail.jpg' },
@@ -173,6 +202,57 @@ function normalizeBusinessNumber(value) {
 	return normalized;
 }
 
+const BID_BIZ_TYPES = ['물품', '공사', '용역', '외자'];
+const RTMS_PROPERTY_TYPES = ['apt', 'rh', 'sh', 'offi'];
+
+// 입찰공고·낙찰 조회 입력. bizType·기간·공고번호·업종코드·페이지를 정규화한다.
+function bidQueryInput(options) {
+	const config = options || {};
+	const input = {};
+	if (config.bizType !== undefined) {
+		if (!BID_BIZ_TYPES.includes(config.bizType)) {
+			throw new TypeError('bizType must be one of 물품, 공사, 용역, 외자.');
+		}
+		input.bizType = config.bizType;
+	}
+	for (const key of ['startDate', 'endDate']) {
+		if (config[key] === undefined) continue;
+		const digits = requiredString(key, config[key], 12).replace(/[^0-9]/g, '');
+		if (digits.length !== 8 && digits.length !== 12) {
+			throw new TypeError(`${key} must be YYYYMMDD or YYYYMMDDHHMM.`);
+		}
+		input[key] = digits;
+	}
+	if (config.bidNtceNo !== undefined) {
+		input.bidNtceNo = requiredString('bidNtceNo', config.bidNtceNo, 20).replace(/[^0-9]/g, '');
+	}
+	if (config.indstrytyCd !== undefined) {
+		input.indstrytyCd = requiredString('indstrytyCd', config.indstrytyCd, 10).replace(/[^0-9]/g, '');
+	}
+	if (config.pageNo !== undefined) input.pageNo = positiveInteger('pageNo', config.pageNo);
+	if (config.numOfRows !== undefined) input.numOfRows = positiveInteger('numOfRows', config.numOfRows);
+	return input;
+}
+
+// 실거래 분석 입력. 지역코드 5자리와 계약년월 6자리를 요구한다.
+function rtmsQueryInput(lawdCd, dealYmd, options) {
+	const code = requiredString('lawdCd', lawdCd, 5).replace(/[^0-9]/g, '');
+	if (!/^\d{5}$/.test(code)) throw new TypeError('lawdCd must contain exactly 5 digits.');
+	const month = requiredString('dealYmd', dealYmd, 6).replace(/[^0-9]/g, '');
+	if (!/^\d{6}$/.test(month)) throw new TypeError('dealYmd must be YYYYMM.');
+	const config = options || {};
+	const input = { lawdCd: code, dealYmd: month };
+	if (config.propertyType !== undefined) {
+		if (!RTMS_PROPERTY_TYPES.includes(config.propertyType)) {
+			throw new TypeError('propertyType must be one of apt, rh, sh, offi.');
+		}
+		input.propertyType = config.propertyType;
+	}
+	if (config.pageNo !== undefined) input.pageNo = positiveInteger('pageNo', config.pageNo);
+	if (config.numOfRows !== undefined) input.numOfRows = positiveInteger('numOfRows', config.numOfRows);
+	return input;
+}
+
 function normalizeUrl(value) {
 	const input = requiredString('url', value);
 	let parsed;
@@ -242,6 +322,44 @@ function compact(payload) {
 	return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== undefined));
 }
 
+// 선택 입력 객체를 받아 정해진 키만 남긴다. 값은 서버가 검증하므로 여기서는 객체 모양만 본다.
+function pickOptions(name, options, keys) {
+	if (options === undefined || options === null) return {};
+	if (typeof options !== 'object' || Array.isArray(options)) throw new TypeError(`${name} must be an object.`);
+	return compact(Object.fromEntries(keys.map(key => [key, options[key]])));
+}
+
+function nonEmptyList(name, value, max) {
+	if (!Array.isArray(value) || value.length === 0) throw new TypeError(`${name} must be a non-empty array.`);
+	if (value.length > max) throw new RangeError(`${name} must not have more than ${max} items.`);
+	return value;
+}
+
+// 차량번호는 공백을 빼고 보낸다. 형식(예: 12가3456)은 서버가 확인한다.
+function carNumber(name, value) {
+	return requiredString(name, value, 16).replace(/\s+/g, '');
+}
+
+function registryCorporateTarget(input) {
+	const config = input || {};
+	const corp = config.corpRegNo === undefined || config.corpRegNo === '' ? '' : requiredString('corpRegNo', config.corpRegNo, 20).replace(/[^0-9]/g, '');
+	const biz = config.bizNo === undefined || config.bizNo === '' ? '' : requiredString('bizNo', config.bizNo, 20).replace(/[^0-9]/g, '');
+	if (!corp && !biz) throw new TypeError('corpRegNo or bizNo is required.');
+	return corp ? { corp_reg_no: corp } : { biz_no: biz };
+}
+
+function registryJobId(jobId) {
+	const id = requiredString('jobId', jobId, 64);
+	if (!/^[A-Za-z0-9_-]{8,64}$/.test(id)) throw new TypeError('jobId is invalid.');
+	return id;
+}
+
+function geoTarget(input, name) {
+	const config = input || {};
+	if (typeof config === 'string') return { address: requiredString(name, config, 300) };
+	return pickOptions(name, config, ['address', 'x', 'y', 'point', 'pnu', 'addrType', 'includeZipcode', 'radius', 'categories', 'limit']);
+}
+
 function optionalRangeInteger(name, value, min, max) {
 	if (value === undefined || value === null || value === '') return undefined;
 	const number = Number(value);
@@ -263,7 +381,7 @@ function dataRequestInput(input) {
 	};
 }
 
-// 홈택스 민원증명. 발급 조건은 REST 필드명 그대로 보낸다(서버가 최상위 평면 이름을 읽는다).
+// 세무 민원증명. 발급 조건은 REST 필드명 그대로 보낸다(서버가 최상위 평면 이름을 읽는다).
 // 공통 인증 입력(name·birthDate·phone·authProvider)은 dataRequestInput 이 만든다.
 const INCOME_AMOUNT_CERT_OPTIONS = Object.freeze(['year', 'use_purpose', 'submit_to', 'delivery', 'format', 'engl_yn', 'quantity', 'email', 'fax_no', 'wallet_address']);
 const PENSION_CREDIT_CERT_OPTIONS = Object.freeze(['year', 'use_purpose', 'submit_to', 'delivery', 'format', 'address_open_yn', 'resno_open_yn', 'quantity', 'email', 'fax_no', 'wallet_address']);
@@ -828,6 +946,229 @@ class ApickClient {
 		return this._call('registryDocVerify', input);
 	}
 
+	// 입찰공고 분석. bizType 미지정 시 용역이며, 기간은 최대 31일이다.
+	bidNotice(options) {
+		return this._call('bidNotice', bidQueryInput(options));
+	}
+
+	// 낙찰 경쟁 분석. 입력은 bidNotice 와 같다.
+	bidAward(options) {
+		return this._call('bidAward', bidQueryInput(options));
+	}
+
+	// 매매 실거래 분석. 지역코드 5자리와 계약년월 6자리가 필요하다.
+	rtmsTrade(lawdCd, dealYmd, options) {
+		return this._call('rtmsTrade', rtmsQueryInput(lawdCd, dealYmd, options));
+	}
+
+	// 전월세 실거래 분석. 같은 단지 매매가로 전세가율을 계산해 돌려준다.
+	rtmsRent(lawdCd, dealYmd, options) {
+		const input = rtmsQueryInput(lawdCd, dealYmd, options);
+		// includeTrade=false 면 매매가 비교(전세가율) 없이 임대 분석만 받는다.
+		if (options && options.includeTrade !== undefined) input.includeTrade = options.includeTrade === false ? 'false' : 'true';
+		return this._call('rtmsRent', input);
+	}
+
+	// 기업 재무정보. 법인등록번호 13자리(하이픈 허용)와 선택 사업연도·항목·연결 구분.
+	corpFinance(crno, options) {
+		return this._call('corpFinance', Object.assign(
+			{ crno: requiredString('crno', crno, 20) },
+			pickOptions('options', options, ['bizYear', 'type', 'scope'])
+		));
+	}
+
+	// 건축물대장. pnu 또는 sigunguCd·bjdongCd·bun(·ji)으로 지번을 지정하고 type 으로 대장 종류를 고른다.
+	buildingRegister(options) {
+		const input = pickOptions('options', options, ['pnu', 'sigunguCd', 'bjdongCd', 'platGbCd', 'bun', 'ji', 'type', 'startDate', 'endDate', 'dongNm', 'hoNm', 'flrNo', 'pageNo', 'numOfRows']);
+		if (!input.pnu && !(input.sigunguCd && input.bjdongCd)) throw new TypeError('pnu or sigunguCd and bjdongCd are required.');
+		return this._call('buildingRegister', input);
+	}
+
+	// 앱스토어 리뷰. appId 는 숫자 앱 ID다.
+	appReviews(appId, options) {
+		return this._call('appReviews', Object.assign(
+			{ appId: requiredString('appId', String(appId == null ? '' : appId), 20) },
+			pickOptions('options', options, ['country', 'page'])
+		));
+	}
+
+	// 배출가스 인증정보. 차량번호가 아니라 배출가스인증번호를 받는다.
+	vehicleEmission(certNo) {
+		return this._call('vehicleEmission', { cert_no: requiredString('certNo', certNo, 40) });
+	}
+
+	// 자동차 리콜 대상 여부. carNo 와 vin 중 하나만 보낸다. 리콜 대상이 아니면 과금되지 않는다.
+	vehicleRecall(input) {
+		const config = input || {};
+		const hasCar = config.carNo !== undefined && config.carNo !== null && config.carNo !== '';
+		const hasVin = config.vin !== undefined && config.vin !== null && config.vin !== '';
+		if (hasCar === hasVin) throw new TypeError('Provide exactly one of carNo or vin.');
+		return this._call('vehicleRecall', hasCar
+			? { car_no: carNumber('carNo', config.carNo) }
+			: { vin: requiredString('vin', config.vin, 17).replace(/\s+/g, '').toUpperCase() });
+	}
+
+	// 하이패스 미납 여부. 미납이 없으면 과금되지 않는다.
+	hipassUnpaid(carNo) {
+		return this._call('hipassUnpaid', { car_no: carNumber('carNo', carNo) });
+	}
+
+	// 자동차세 계산(비영업용 승용). cc 는 배기량, carAgeYears 는 차령(년)이다.
+	vehicleTaxCalc(cc, options) {
+		const config = options || {};
+		if (cc === undefined || cc === null || cc === '') throw new TypeError('cc is required.');
+		return this._call('vehicleTaxCalc', compact({
+			cc: optionalRangeInteger('cc', cc, 50, 10000),
+			car_age_years: optionalRangeInteger('carAgeYears', config.carAgeYears, 0, 40),
+			year: optionalRangeInteger('year', config.year, 2000, 2100)
+		}));
+	}
+
+	// 주소 표준화·코드 변환. 주소 문자열 또는 { address | pnu, addrType, includeZipcode }.
+	geoStandardize(input) {
+		const body = geoTarget(input, 'input');
+		if (!body.address && !body.pnu) throw new TypeError('address or pnu is required.');
+		return this._call('geoStandardize', body);
+	}
+
+	// 대량 주소 좌표 변환(최대 50건).
+	geoBatchGeocode(addresses, options) {
+		return this._call('geoBatchGeocode', Object.assign(
+			{ addresses: nonEmptyList('addresses', addresses, 50) },
+			pickOptions('options', options, ['addrType', 'dedupe'])
+		));
+	}
+
+	// 좌표→주소·행정구역. { x, y } 또는 { point: '경도,위도' }.
+	geoReverse(input) {
+		return this._call('geoReverse', pickOptions('input', input, ['x', 'y', 'point']));
+	}
+
+	geoAddressSearch(query, options) {
+		return this._call('geoAddressSearch', Object.assign(
+			{ query: requiredString('query', query, 200) },
+			pickOptions('options', options, ['category', 'page', 'size'])
+		));
+	}
+
+	// 장소 검색. 기준점(origin 또는 x·y)을 주면 거리순으로 정렬한다.
+	geoPlaceSearch(query, options) {
+		return this._call('geoPlaceSearch', Object.assign(
+			{ query: requiredString('query', query, 200) },
+			pickOptions('options', options, ['origin', 'x', 'y', 'radius', 'sort', 'page', 'size'])
+		));
+	}
+
+	// 행정구역 코드. 주소 문자열 또는 { address | x·y | point, addrType, includeZipcode }.
+	geoAdminCode(input) {
+		return this._call('geoAdminCode', geoTarget(input, 'input'));
+	}
+
+	geoCompareAddress(addressA, addressB, options) {
+		return this._call('geoCompareAddress', Object.assign(
+			{ addressA: requiredString('addressA', addressA, 300), addressB: requiredString('addressB', addressB, 300) },
+			pickOptions('options', options, ['addrType'])
+		));
+	}
+
+	// 좌표 거리·면적. coordinates 는 ['경도,위도', ...] 또는 [[경도, 위도], ...](2~200개).
+	geoMeasure(coordinates, options) {
+		return this._call('geoMeasure', Object.assign(
+			{ coordinates: nonEmptyList('coordinates', coordinates, 200) },
+			pickOptions('options', options, ['mode', 'unit', 'matrix'])
+		));
+	}
+
+	// GeoJSON 면적·포함 분석. 본문은 1MB 이하여야 한다.
+	geoGeojsonAnalyze(geojson, options) {
+		if (!geojson || (typeof geojson !== 'object' && typeof geojson !== 'string')) throw new TypeError('geojson must be an object or a JSON string.');
+		return this._call('geoGeojsonAnalyze', Object.assign(
+			{ geojson },
+			pickOptions('options', options, ['simplify', 'point', 'x', 'y', 'includeGeometry'])
+		));
+	}
+
+	// 주소 품질 진단(최대 20건).
+	geoAddressQuality(addresses, options) {
+		return this._call('geoAddressQuality', Object.assign(
+			{ addresses: nonEmptyList('addresses', addresses, 20) },
+			pickOptions('options', options, ['addrType'])
+		));
+	}
+
+	geoAddressAutocomplete(query, options) {
+		return this._call('geoAddressAutocomplete', Object.assign(
+			{ query: requiredString('query', query, 200) },
+			pickOptions('options', options, ['category', 'size'])
+		));
+	}
+
+	// 행정구역 경계·면적. query 는 이름(예: 강남구) 또는 코드(예: 11680).
+	geoDistrictBoundary(query, options) {
+		return this._call('geoDistrictBoundary', Object.assign(
+			{ query: requiredString('query', String(query == null ? '' : query), 100) },
+			pickOptions('options', options, ['level', 'simplify', 'includeGeometry'])
+		));
+	}
+
+	// 주변 생활시설. 기준 주소 문자열 또는 { address | x·y | point, radius, categories, limit }.
+	geoNeighborhood(input) {
+		return this._call('geoNeighborhood', geoTarget(input, 'input'));
+	}
+
+	// 부동산 등기 검색. 주소(도로명·지번) 또는 부동산고유번호 14자리. 결과가 없으면 과금되지 않는다.
+	registryRealestateSearch(query) {
+		return this._call('registryRealestateSearch', { query: requiredString('query', query, 200) });
+	}
+
+	// 법인 등기 검색. corpRegNo(법인등록번호 13자리) 또는 bizNo(사업자등록번호 10자리) 중 하나.
+	registryCorporateSearch(input) {
+		return this._call('registryCorporateSearch', registryCorporateTarget(input));
+	}
+
+	// 부동산 등기 열람·발급 접수. 접수 즉시 job_id 를 돌려주며 getRegistryJob 으로 상태를 확인한다.
+	// 같은 요청을 다시 보낼 수 있게 idempotencyKey 를 넣어 두는 것을 권장한다.
+	createRegistryRealestateJob(options) {
+		const config = options || {};
+		if (!config.query && !config.pin) throw new TypeError('query or pin is required.');
+		return this._call('createRegistryRealestateJob', compact({
+			query: config.query === undefined ? undefined : requiredString('query', config.query, 200),
+			pin: config.pin === undefined ? undefined : requiredString('pin', config.pin, 20),
+			index: optionalRangeInteger('index', config.index, 1, 100),
+			usage: config.usage,
+			record_scope: config.recordScope,
+			include_cancelled: config.includeCancelled === undefined ? undefined : String(Boolean(config.includeCancelled)),
+			publish_resident_no: config.publishResidentNo === undefined ? undefined : String(Boolean(config.publishResidentNo)),
+			idempotency_key: config.idempotencyKey === undefined ? undefined : requiredString('idempotencyKey', config.idempotencyKey, 128)
+		}));
+	}
+
+	// 법인 등기 열람·발급 접수.
+	createRegistryCorporateJob(options) {
+		const config = options || {};
+		return this._call('createRegistryCorporateJob', Object.assign(registryCorporateTarget(config), compact({
+			usage: config.usage,
+			idempotency_key: config.idempotencyKey === undefined ? undefined : requiredString('idempotencyKey', config.idempotencyKey, 128)
+		})));
+	}
+
+	// 등기 작업 상태. 조회는 무료다.
+	getRegistryJob(jobId) {
+		return this._call('createRegistryRealestateJob', null, null, { endpoint: '/rest/registry_jobs/' + registryJobId(jobId), method: 'GET', timeoutMs: 35_000 });
+	}
+
+	// 완료된 등기 작업의 PDF. 전송이 끝난 다운로드만 과금된다.
+	downloadRegistryPdf(jobId) {
+		const id = registryJobId(jobId);
+		return this._call('createRegistryRealestateJob', null, null, {
+			endpoint: '/rest/registry_jobs/' + id + '?download=1',
+			method: 'GET',
+			output: 'binary',
+			filename: 'registry-' + id + '.pdf',
+			timeoutMs: 65_000
+		});
+	}
+
 	screenshot(url) {
 		return this._call('screenshot', { url: normalizeUrl(url) });
 	}
@@ -1238,7 +1579,7 @@ class ApickClient {
 		return this._call('requestTaxReturnHistory', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_tax_return_history' });
 	}
 
-	// 홈택스 민원증명 발급. 신청인 본인명의이고 발급 1건 60P 정액이다.
+	// 세무 민원증명 발급. 신청인 본인명의이고 발급 1건 60P 정액이다.
 	// 응답은 format(pdf·json·both)으로 고른다. json 이면 발급된 PDF를 파싱한 PDF데이터가 함께 온다.
 	requestIncomeAmountCert(input) {
 		return this._call('requestIncomeAmountCert', hometaxCertInput(input, INCOME_AMOUNT_CERT_OPTIONS));
@@ -1348,7 +1689,7 @@ class ApickClient {
 		return this._call('requestResidentRegistrationCho', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_resident_registration_cho' });
 	}
 
-	// 정부24 통합 조회. 한 번의 인증으로 고른 상품만 조회하고, 단가는 고른 상품의 합으로 정해진다.
+	// 민원서류 통합 조회. 한 번의 인증으로 고른 상품만 조회하고, 단가는 고른 상품의 합으로 정해진다.
 	requestGov24Bundle(input) {
 		const config = input || {};
 		const products = gov24BundleProductsInput(config.products);