apick-api 4.12.1 → 4.13.0

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 사용료입니다. 정규화 실패는 제작을 중단하며, 서버·공급자의 최종 제작 실패는 정규화까지 전액 환불합니다. 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/tts.md

@@ -29,6 +29,6 @@ Normalization is enabled by default and costs extra. Disable it with `normalize_
 
 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.12.1",
+  "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',
@@ -66,6 +66,31 @@ const SERVICE_DEFINITIONS = Object.freeze({
 	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' },
@@ -297,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);
@@ -318,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']);
@@ -900,7 +963,210 @@ class ApickClient {
 
 	// 전월세 실거래 분석. 같은 단지 매매가로 전세가율을 계산해 돌려준다.
 	rtmsRent(lawdCd, dealYmd, options) {
-		return this._call('rtmsRent', rtmsQueryInput(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) {
@@ -1313,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));
@@ -1423,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);

package/src/index.d.ts

@@ -311,6 +311,8 @@ export interface RtmsQueryOptions {
 	readonly propertyType?: 'apt' | 'rh' | 'sh' | 'offi';
 	readonly pageNo?: number;
 	readonly numOfRows?: number;
+	/** rtmsRent 전용. false 면 같은 단지 매매가 비교(jeonse_ratio) 없이 임대 분석만 받는다. 기본 true. */
+	readonly includeTrade?: boolean;
 }
 
 export interface DistributionEntry {
@@ -428,6 +430,120 @@ export interface RtmsRent {
 	readonly insights: readonly string[];
 }
 
+export interface CorpFinanceOptions {
+	/** 사업연도 YYYY. 생략하면 조회 가능한 가장 최근 연도. */
+	readonly bizYear?: string;
+	readonly type?: 'all' | 'summary' | 'balance' | 'income';
+	readonly scope?: 'all' | 'consolidated' | 'separate';
+}
+
+export interface CorpFinance {
+	readonly company: { readonly crno: string; readonly bizYear: string; readonly currency: string };
+	readonly summary: readonly Readonly<Record<string, unknown>>[];
+	readonly balance: readonly Readonly<Record<string, unknown>>[];
+	readonly income: readonly Readonly<Record<string, unknown>>[];
+	readonly metrics: Readonly<Record<string, number | string | null>> | null;
+	readonly count: number;
+}
+
+export interface BuildingRegisterOptions {
+	/** 필지고유번호 19자리. 주면 sigunguCd·bjdongCd·bun·ji 는 쓰지 않는다. */
+	readonly pnu?: string;
+	readonly sigunguCd?: string;
+	readonly bjdongCd?: string;
+	readonly platGbCd?: string;
+	readonly bun?: string;
+	readonly ji?: string;
+	readonly type?: 'title' | 'recap' | 'basis' | 'floor' | 'expos' | 'area' | 'price' | 'wclf' | 'jibun' | 'district';
+	readonly startDate?: string;
+	readonly endDate?: string;
+	readonly dongNm?: string;
+	readonly hoNm?: string;
+	readonly flrNo?: number;
+	readonly pageNo?: number;
+	readonly numOfRows?: number;
+}
+
+export interface VehicleRecall {
+	readonly result: {
+		readonly car_no: string;
+		readonly vin: string;
+		readonly recall_target: boolean;
+		readonly recall_count: number;
+		readonly free_repair_count: number;
+		readonly recalls: readonly Readonly<Record<string, unknown>>[];
+		readonly free_repairs: readonly Readonly<Record<string, unknown>>[];
+		readonly checked_at: string;
+	};
+}
+
+export interface HipassUnpaid {
+	readonly result: {
+		readonly car_no: string;
+		readonly unpaid_target: boolean;
+		readonly unpaid_count: number;
+		readonly checked_at: string;
+	};
+}
+
+export interface VehicleTaxCalc {
+	readonly result: {
+		readonly year: number;
+		readonly cc: number;
+		readonly cc_rate: number;
+		readonly car_age_years: number;
+		readonly discount_rate: number;
+		readonly vehicle_tax: number;
+		readonly local_education_tax: number;
+		readonly total: number;
+	};
+}
+
+export type GeoAddrType = 'auto' | 'parcel' | 'road';
+/** 좌표 하나: '경도,위도' 문자열 또는 [경도, 위도]. */
+export type GeoCoordinate = string | readonly [number, number];
+
+export interface GeoTarget {
+	readonly address?: string;
+	readonly pnu?: string;
+	readonly x?: number;
+	readonly y?: number;
+	/** '경도,위도' (예: '127.025,37.504') */
+	readonly point?: string;
+	readonly addrType?: GeoAddrType;
+	readonly includeZipcode?: boolean;
+}
+
+export type RegistryCorporateTarget = { readonly corpRegNo: string; readonly bizNo?: undefined } | { readonly bizNo: string; readonly corpRegNo?: undefined };
+
+export interface RegistryRealestateJobOptions {
+	/** 검색에 사용한 주소 또는 부동산고유번호. pin 과 둘 중 하나는 필요하다. */
+	readonly query?: string;
+	/** 부동산고유번호 14자리 */
+	readonly pin?: string;
+	/** 검색 결과 행 번호(1부터), 기본 1 */
+	readonly index?: number;
+	readonly usage?: 'view' | 'issue' | 'transfer-gov24' | 'transfer-court';
+	readonly recordScope?: 'all' | 'part';
+	readonly includeCancelled?: boolean;
+	readonly publishResidentNo?: boolean;
+	/** 같은 접수를 다시 보낼 때 중복 접수·과금을 막는 키 */
+	readonly idempotencyKey?: string;
+}
+
+export interface RegistryJob {
+	readonly job_id: string;
+	readonly status: string;
+	readonly replay?: boolean;
+	readonly [key: string]: unknown;
+}
+
+export interface GeoNeighborhoodInput extends GeoTarget {
+	readonly radius?: number;
+	readonly categories?: readonly string[];
+	readonly limit?: number;
+}
+
 export interface LinkedinJob {
 	readonly job_posting_id: string;
 	readonly title: string;
@@ -541,7 +657,7 @@ export interface MaskResidentNumberOptions extends OcrOptions {
 export const AUTH_PROVIDERS: readonly [
 	'kakao', 'naver', 'toss', 'pass', 'samsung', 'kb', 'shinhan', 'hana', 'woori', 'ibk', 'nh', 'kakaobank', 'banksalad'
 ];
-/** 정부24 통합 조회에서 고를 수 있는 상품 키. */
+/** 민원서류 통합 조회에서 고를 수 있는 상품 키. */
 export const GOV24_BUNDLE_PRODUCTS: readonly [
 	'resident_registration', 'resident_registration_cho', 'driving_license', 'health_checkup',
 	'police_penalty', 'parking_fine_target', 'mortgage_loan', 'housing_refund_balance',
@@ -577,7 +693,7 @@ export interface ResidentRegistrationOptions {
 export interface RequestResidentRegistrationInput extends DataRequestInput, ResidentRegistrationOptions {}
 export interface RequestResidentRegistrationChoInput extends DataRequestInput, ResidentRegistrationOptions {}
 /**
- * 정부24 통합 조회 입력. `products` 로 조회할 상품 키를 고른다.
+ * 민원서류 통합 조회 입력. `products` 로 조회할 상품 키를 고른다.
  * 등본·초본을 고르면 `sido`·`sigungu` 가 필요하다.
  */
 export interface RequestGov24BundleInput extends DataRequestInput {
@@ -591,7 +707,7 @@ export interface RequestGov24BundleInput extends DataRequestInput {
 }
 
 /**
- * 홈택스 민원증명 발급 조건. 신청인 본인명의 발급이고 발급 1건 60P 정액이다.
+ * 세무 민원증명 발급 조건. 신청인 본인명의 발급이고 발급 1건 60P 정액이다.
  * `format` 은 응답 형식이고, `json`·`both` 이면 발급된 PDF를 파싱한 `PDF데이터` 가 함께 온다.
  * 코드 값(`use_purpose`·`submit_to`·`itrf_cd`)은 정부 공통코드다.
  */
@@ -655,7 +771,7 @@ export interface HometaxPdfData {
 	텍스트: string;
 	사유?: string;
 }
-/** 홈택스 민원증명 결과. `format` 이 json·both 이면 `발급문서`(base64)와 `PDF데이터` 가 함께 온다. */
+/** 세무 민원증명 결과. `format` 이 json·both 이면 `발급문서`(base64)와 `PDF데이터` 가 함께 온다. */
 export interface HometaxCertificateResultPayload {
 	문서확인번호: string;
 	귀속연도?: string;
@@ -1023,6 +1139,32 @@ export class ApickClient {
 	bidAward(options: BidQueryOptions): Promise<ApickResult<BidAward>>;
 	rtmsTrade(lawdCd: string, dealYmd: string, options?: RtmsQueryOptions): Promise<ApickResult<RtmsTrade>>;
 	rtmsRent(lawdCd: string, dealYmd: string, options?: RtmsQueryOptions): Promise<ApickResult<RtmsRent>>;
+	corpFinance(crno: string, options?: CorpFinanceOptions): Promise<ApickResult<CorpFinance>>;
+	buildingRegister(options: BuildingRegisterOptions): Promise<ApickResult>;
+	appReviews(appId: string | number, options?: { readonly country?: string; readonly page?: number }): Promise<ApickResult>;
+	vehicleEmission(certNo: string): Promise<ApickResult>;
+	vehicleRecall(input: { readonly carNo: string; readonly vin?: undefined } | { readonly vin: string; readonly carNo?: undefined }): Promise<ApickResult<VehicleRecall>>;
+	hipassUnpaid(carNo: string): Promise<ApickResult<HipassUnpaid>>;
+	vehicleTaxCalc(cc: number, options?: { readonly carAgeYears?: number; readonly year?: number }): Promise<ApickResult<VehicleTaxCalc>>;
+	geoStandardize(input: string | GeoTarget): Promise<ApickResult>;
+	geoBatchGeocode(addresses: readonly string[], options?: { readonly addrType?: GeoAddrType; readonly dedupe?: boolean }): Promise<ApickResult>;
+	geoReverse(input: { readonly x: number; readonly y: number } | { readonly point: string }): Promise<ApickResult>;
+	geoAddressSearch(query: string, options?: { readonly category?: GeoAddrType; readonly page?: number; readonly size?: number }): Promise<ApickResult>;
+	geoPlaceSearch(query: string, options?: { readonly origin?: string; readonly x?: number; readonly y?: number; readonly radius?: number; readonly sort?: 'distance' | 'relevance'; readonly page?: number; readonly size?: number }): Promise<ApickResult>;
+	geoAdminCode(input: string | GeoTarget): Promise<ApickResult>;
+	geoCompareAddress(addressA: string, addressB: string, options?: { readonly addrType?: GeoAddrType }): Promise<ApickResult>;
+	geoMeasure(coordinates: readonly GeoCoordinate[], options?: { readonly mode?: 'path' | 'polygon'; readonly unit?: 'm' | 'km'; readonly matrix?: boolean }): Promise<ApickResult>;
+	geoGeojsonAnalyze(geojson: Readonly<Record<string, unknown>> | string, options?: { readonly simplify?: number; readonly point?: string; readonly x?: number; readonly y?: number; readonly includeGeometry?: boolean }): Promise<ApickResult>;
+	geoAddressQuality(addresses: readonly string[], options?: { readonly addrType?: GeoAddrType }): Promise<ApickResult>;
+	geoAddressAutocomplete(query: string, options?: { readonly category?: GeoAddrType; readonly size?: number }): Promise<ApickResult>;
+	geoDistrictBoundary(query: string | number, options?: { readonly level?: 'L1' | 'L2' | 'L3' | 'L4'; readonly simplify?: number; readonly includeGeometry?: boolean }): Promise<ApickResult>;
+	geoNeighborhood(input: string | GeoNeighborhoodInput): Promise<ApickResult>;
+	registryRealestateSearch(query: string): Promise<ApickResult>;
+	registryCorporateSearch(input: RegistryCorporateTarget): Promise<ApickResult>;
+	createRegistryRealestateJob(options: RegistryRealestateJobOptions): Promise<ApickResult<RegistryJob>>;
+	createRegistryCorporateJob(options: RegistryCorporateTarget & { readonly usage?: 'view' | 'issue'; readonly idempotencyKey?: string }): Promise<ApickResult<RegistryJob>>;
+	getRegistryJob(jobId: string): Promise<ApickResult<RegistryJob>>;
+	downloadRegistryPdf(jobId: string): Promise<ApickBinaryResult>;
 	screenshot(url: string): Promise<ApickBinaryResult>;
 	youtubeMetadata(url: string): Promise<ApickResult<YoutubeMetadata>>;
 	youtubeThumbnail(url: string): Promise<ApickBinaryResult>;