apick-api 4.11.0 → 4.12.1

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# 4.12.1
+
+- 요금 안내 문구를 정리했습니다. 모델별 판매 단가, 실제 사용량 기준, 기본요금·소수점 올림, 견적 API처럼 청구되는 결과만 적습니다. 에이전트 상품 응답 타입에서 더 이상 내려오지 않는 요금 필드 하나를 뺐습니다. 요금과 동작은 바뀌지 않습니다.
+
+- Billing notes now describe only what you are charged: per-model rates, actual usage, base fees, rounding and the quote API. Removed one billing field from the agent product type that the server no longer returns. Prices and behaviour are unchanged.
+
+# 4.12.0
+
+- 입찰·부동산 분석 4종을 SDK에 추가했습니다. `bidNotice(options)`·`bidAward(options)` 는 공공기관 입찰공고의 예산구간·발주기관·업종 분포와 마감 임박도, 낙찰률 분포·업체 집중도를 분석합니다. `rtmsTrade(lawdCd, dealYmd, options)` 는 매매 실거래의 ㎡당 중위가·면적/가격/층 분포·시세 이탈 거래를, `rtmsRent(lawdCd, dealYmd, options)` 는 전세 비중·보증금/월세 분포·매매 대비 전세가율을 계산합니다. 응답은 `summary`·`distribution`·`insights` 중심이며 원본 목록(`items`·`totalCount`)은 제공하지 않습니다.
+
+- Added four bid and real-estate analytics methods. `bidNotice(options)` and `bidAward(options)` analyse public-sector bid notices (budget, agency and industry distributions, closing urgency) and award results (success-rate bands, winner concentration). `rtmsTrade(lawdCd, dealYmd, options)` covers median price per square metre, area/price/floor bands and price outliers, while `rtmsRent(lawdCd, dealYmd, options)` computes jeonse share, deposit and monthly-rent bands and the jeonse ratio against sale prices. Responses centre on `summary`, `distribution` and `insights`; raw lists (`items`, `totalCount`) are not returned.
+
 # 4.11.0
 
 - 증빙서류 통합발급 묶음 2종을 추가했습니다. `requestIncomeCertBundle()`·`getIncomeCertBundle()`은 소득금액증명과 연금보험료등 소득세액 공제확인서를, `requestBusinessCertBundle()`·`getBusinessCertBundle()`은 사업자등록증명·부가가치세 과세표준증명·표준재무제표증명을 휴대폰 승인 한 번으로 함께 발급합니다. 접수 20P, 최초 결과는 84P·126P입니다. 사업자 묶음은 `business_no`와 대표자 본인 확인(`agreed: true` 또는 `bind_id`)이 없으면 서버를 부르기 전에 `TypeError`를 던집니다.

package/README.md

@@ -97,6 +97,10 @@ Leave the allowed-IP list blank for unrestricted access. To restrict access, reg
 | `linkedinCompany(url)` | 링크드인 회사 정보 / LinkedIn company | JSON |
 | `linkedinJob(url)` | 링크드인 채용공고 / LinkedIn job posting | JSON |
 | `courtAuction(caseNo, court)` | 법원 경매사건 조회 / Court auction case | JSON |
+| `bidNotice(options)` | 입찰 공고 분석 / Bid notice analytics | JSON |
+| `bidAward(options)` | 낙찰 경쟁 분석 / Bid award analytics | JSON |
+| `rtmsTrade(lawdCd, dealYmd, options)` | 매매 시장 분석 / Sale market analytics | JSON |
+| `rtmsRent(lawdCd, dealYmd, options)` | 전월세 시장 분석 / Rent market analytics | JSON |
 | `registryDocVerify(issueNo, options)` | 등기·증명서 발급확인 / Registry certificate verification | JSON |
 | `createTtsJob(text, options)` | 한국어 내레이션 작업 접수 / Create TTS job | JSON |
 | `getTtsJob(jobId)` | TTS 작업 상태 / TTS job status | JSON |
@@ -306,9 +310,9 @@ if (job.data.status === 'completed') {
 
 Submission reserves an upper bound; successful completion settles actual charges. Disconnects do not cancel billing. Explicit cancellation settles work already performed. MP3 and ASS each allow one completed download; interrupted downloads can be retried.
 
-정규화는 기본 켜짐이며 발음을 다듬는 스킬 요금이 추가됩니다. `normalize_text: false`(SDK `normalizeText: false`)로 실행과 요금을 끕니다. 스킬 최종가는 기본요금(판매자 금액·기본 수수료) + AI 원가 × 환율 × 1.4입니다. 정규화 실패는 제작을 중단하며, 서버·공급자의 최종 제작 실패는 정규화까지 전액 환불합니다. ASS에는 원문을 표시합니다.
+정규화는 기본 켜짐이며 발음을 다듬는 스킬 요금이 추가됩니다. `normalize_text: false`(SDK `normalizeText: false`)로 실행과 요금을 끕니다. 스킬 최종가는 기본요금(판매자 금액·기본 수수료) + 실제 AI 사용료입니다. 정규화 실패는 제작을 중단하며, 서버·공급자의 최종 제작 실패는 정규화까지 전액 환불합니다. ASS에는 원문을 표시합니다.
 
-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.
 
 ## 신분증 마스킹 / Identity masking
 
@@ -468,6 +472,9 @@ Court auction lookup is synchronous. A case number belongs to one court, so pass
 등기·증명서 발급확인 `registryDocVerify(issueNo, options)` 는 증명서에 인쇄된 발급확인번호 12자리(하이픈·공백 허용)와 문서 종류 `options.kind`(`realestate` 기본, `corporate`, `movable`)를 받습니다. 응답은 `verified`·`status`·`message`·`document`·`issued_date`·`registry_office` 이며 증명서 원문은 포함되지 않습니다. 발급일로부터 3개월 이내 발급분만 확인됩니다.
 `registryDocVerify(issueNo, options)` verifies the 12-character verification number printed on an issued registration certificate (hyphens and spaces are accepted); `options.kind` selects `realestate` (default), `corporate` or `movable`. The result carries `verified`, `status`, `message`, `document`, `issued_date` and `registry_office` — never the certificate itself — and only certificates issued within the last three months can be verified.
 
+입찰·부동산 4종은 원본 목록이 아니라 **분석 결과**를 돌려줍니다. `bidNotice(options)`·`bidAward(options)` 는 업무구분·기간·공고번호를 받고 `summary`·`distribution`·`insights` 를, 낙찰은 여기에 `competitors`·`low_rate` 를 더합니다. `rtmsTrade(lawdCd, dealYmd, options)` 는 ㎡당 중위가와 면적·가격·층 분포, 단지별 시세, 직거래·해제 비중, 시세 이탈 거래를, `rtmsRent` 는 전세 비중, 보증금·월세 분포, 보증금 대비 연월세 비율, 갱신 비중과 같은 단지 매매 대비 전세가율을 계산합니다. `items`·`totalCount` 같은 원본 목록은 제공하지 않습니다.
+The four bid and real-estate methods return **analytics**, not raw lists. `bidNotice(options)` and `bidAward(options)` take a business type, period or notice number and return `summary`, `distribution` and `insights`; awards add `competitors` and `low_rate`. `rtmsTrade(lawdCd, dealYmd, options)` returns median price per square metre, area/price/floor bands, per-complex medians, direct-deal and cancellation shares and price outliers, while `rtmsRent` computes jeonse share, deposit and monthly-rent bands, annual rent to deposit ratio, renewal share and the jeonse ratio against same-complex sale prices. Raw lists such as `items` and `totalCount` are not returned.
+
 증빙서류 묶음 2종은 휴대폰 승인 한 번으로 담긴 증명을 함께 발급합니다. 소득 묶음은 소득금액증명·연금보험료등 소득세액 공제확인서(결과 `result.incomeAmountCert`·`result.pensionCreditCert`), 사업자 묶음은 사업자등록증명·부가가치세 과세표준증명·표준재무제표증명(결과 `result.businessRegistrationCert`·`result.vatTaxBaseCert`·`result.financialStatementCert`)입니다. 접수 20P, 최초 결과는 84P·126P로 개별 발급 합계보다 30% 쌉니다. 사업자 묶음은 대표자 본인 확인을 받으므로 `agreed: true` 또는 이전 응답의 `bind_id`(같은 계정·같은 사업자등록번호, 90일)를 보내야 하며, 빠지면 SDK가 호출 전에 `TypeError` 를 던집니다. 일부 증명만 발급되면 `status` 가 `PARTIAL_SUCCESS` 이고 결과 단가는 그대로 청구됩니다.
 The two certificate bundles issue every included certificate after a single phone approval. Acceptance is 20P and the first result is 84P (income) or 126P (business), 30% below issuing each certificate separately. The business bundle requires representative consent: send `agreed: true` or a `bind_id` from a previous response (same account and business number, valid for 90 days); the SDK throws a `TypeError` before calling the server when both are missing. If only some certificates are issued, `status` is `PARTIAL_SUCCESS` and the bundle result price still applies.
 
@@ -559,9 +566,9 @@ if (status.data.status === "completed") {
 
 ## 서브에이전트 / Subagent
 
-설치형 `apick-agent` 상품은 `apick-subagent` 스킬 패키지와 전용 REST·MCP를 사용합니다. 설치비·도입비·구독료 없이 원가 +40%(2026-11-06부터 분석 원가는 시간대와 관계없이 혼잡 시간대 단가 기준 20%, 자료 선별 원가는 40%)(소수점 올림, 2026-11-06부터 AI 사용 작업 기본 5P), 승인된 동일 결과 캐시 1P, 충전 잔액 외 상품 한도 없음. [연동 가이드](https://apick.app/dev_guide/subagent).
+설치형 `apick-agent` 상품은 `apick-subagent` 스킬 패키지와 전용 REST·MCP를 사용합니다. 설치비·도입비·구독료 없이 성공한 작업만 사용량대로 정산(소수점 올림, 2026-11-06부터 AI 사용 작업 기본 5P), 승인된 동일 결과 캐시 1P, 충전 잔액 외 상품 한도 없음. [연동 가이드](https://apick.app/dev_guide/subagent).
 
-The installed `apick-agent` product uses the `apick-subagent` skill package and dedicated REST/MCP interfaces. No installation, setup or subscription fee. Confirmed 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 cache reuse costs 1 point, with no product quota beyond prepaid balance. [Integration guide](https://apick.app/dev_guide/subagent).
+The installed `apick-agent` product uses the `apick-subagent` skill package and dedicated REST/MCP interfaces. 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 cache reuse costs 1 point, with no product quota beyond prepaid balance. [Integration guide](https://apick.app/dev_guide/subagent).
 
 ```sh
 npx -y apick-mcp --server subagent

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');

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,9 +25,9 @@ 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회만 허용하며 전송 중단은 재시도할 수 있습니다. 접수 응답 유실 시 같은 입력과 멱등 키를 재사용하세요. 서버·공급자 최종 실패는 정규화까지 환불하며, 연결 종료는 작업 취소가 아닙니다. 취소 시 이미 수행된 작업분을 정산합니다.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apick-api",
-  "version": "4.11.0",
+  "version": "4.12.1",
   "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

@@ -61,6 +61,10 @@ 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' },
 	screenshot: { endpoint: '/rest/url_screenshot', timeoutMs: 75_000, output: 'binary', filename: 'screenshot.jpeg' },
 	youtubeMetadata: { endpoint: '/rest/youtube_metadata', timeoutMs: 60_000, output: 'json' },
@@ -173,6 +177,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;
@@ -828,6 +883,26 @@ 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) {
+		return this._call('rtmsRent', rtmsQueryInput(lawdCd, dealYmd, options));
+	}
+
 	screenshot(url) {
 		return this._call('screenshot', { url: normalizeUrl(url) });
 	}

package/src/index.d.ts

@@ -297,6 +297,137 @@ export interface RegistryDocVerify {
 	readonly registry_office: string | null;
 }
 
+export interface BidQueryOptions {
+	readonly bizType?: '물품' | '공사' | '용역' | '외자';
+	readonly startDate?: string;
+	readonly endDate?: string;
+	readonly bidNtceNo?: string;
+	readonly indstrytyCd?: string;
+	readonly pageNo?: number;
+	readonly numOfRows?: number;
+}
+
+export interface RtmsQueryOptions {
+	readonly propertyType?: 'apt' | 'rh' | 'sh' | 'offi';
+	readonly pageNo?: number;
+	readonly numOfRows?: number;
+}
+
+export interface DistributionEntry {
+	readonly name?: string;
+	readonly band?: string;
+	readonly count: number;
+	readonly share_pct: number;
+}
+
+export interface BidSummary {
+	readonly total: number;
+	readonly agency_count: number;
+	readonly industry_count: number;
+	readonly budget_total: number | null;
+	readonly budget_median: number | null;
+	readonly closing_within_3d: number;
+	readonly closed: number;
+	readonly first_close_at: string | null;
+	readonly last_close_at: string | null;
+}
+
+export interface BidPosting {
+	readonly bid_no: string;
+	readonly bid_name: string;
+	readonly agency: string;
+	readonly notice_at: string | null;
+	readonly close_at: string | null;
+	readonly days_left: number | null;
+	readonly urgency: string;
+	readonly budget: number | null;
+	readonly budget_band: string;
+	readonly industry: string;
+	readonly method: string;
+}
+
+export interface BidNotice {
+	readonly summary: BidSummary;
+	readonly distribution: {
+		readonly by_agency: readonly DistributionEntry[];
+		readonly by_industry: readonly DistributionEntry[];
+		readonly by_method: readonly DistributionEntry[];
+		readonly by_budget_band: readonly DistributionEntry[];
+		readonly by_urgency: readonly DistributionEntry[];
+	};
+	readonly deadlines: readonly BidPosting[];
+	readonly largest: readonly BidPosting[];
+	readonly insights: readonly string[];
+}
+
+export interface BidAward {
+	readonly summary: {
+		readonly total: number;
+		readonly winner_count: number;
+		readonly avg_success_rate: number | null;
+		readonly median_success_rate: number | null;
+		readonly success_rate_stdev: number | null;
+		readonly avg_participants: number | null;
+		readonly rate_sample: number;
+		readonly winner_concentration_hhi: number | null;
+		readonly success_amount_total: number | null;
+	};
+	readonly distribution: {
+		readonly by_winner: readonly DistributionEntry[];
+		readonly by_agency: readonly DistributionEntry[];
+		readonly by_rate_band: readonly DistributionEntry[];
+	};
+	readonly competitors: readonly { readonly name: string; readonly wins: number; readonly share_pct: number; readonly amount_total: number | null }[];
+	readonly low_rate: readonly BidPosting[];
+	readonly insights: readonly string[];
+}
+
+export interface RtmsTrade {
+	readonly summary: {
+		readonly total: number;
+		readonly complex_count: number;
+		readonly median_amount: number | null;
+		readonly median_price_per_sqm: number | null;
+		readonly avg_price_per_sqm: number | null;
+		readonly direct_deal_share_pct: number | null;
+		readonly canceled_count: number;
+		readonly median_area: number | null;
+		readonly median_build_year: number | null;
+	};
+	readonly distribution: {
+		readonly by_complex: readonly DistributionEntry[];
+		readonly by_area_band: readonly DistributionEntry[];
+		readonly by_amount_band: readonly DistributionEntry[];
+		readonly by_floor: readonly DistributionEntry[];
+	};
+	readonly complexes: readonly Readonly<Record<string, unknown>>[];
+	readonly anomalies: readonly Readonly<Record<string, unknown>>[];
+	readonly insights: readonly string[];
+}
+
+export interface RtmsRent {
+	readonly summary: {
+		readonly total: number;
+		readonly complex_count: number;
+		readonly jeonse_count: number;
+		readonly jeonse_share_pct: number | null;
+		readonly median_deposit: number | null;
+		readonly median_monthly_rent: number | null;
+		readonly median_deposit_per_sqm: number | null;
+		readonly avg_annual_rent_to_deposit_pct: number | null;
+		readonly renewal_share_pct: number | null;
+	};
+	readonly distribution: {
+		readonly by_complex: readonly DistributionEntry[];
+		readonly by_deposit_band: readonly DistributionEntry[];
+		readonly by_monthly_band: readonly DistributionEntry[];
+		readonly by_contract_type: readonly DistributionEntry[];
+	};
+	readonly complexes: readonly Readonly<Record<string, unknown>>[];
+	readonly jeonse_ratio: Readonly<Record<string, unknown>> | null;
+	readonly insights: readonly string[];
+}
+
 export interface LinkedinJob {
 	readonly job_posting_id: string;
 	readonly title: string;
@@ -888,6 +1019,10 @@ export class ApickClient {
 	linkedinJob(url: string): Promise<ApickResult<LinkedinJob>>;
 	courtAuction(caseNo: string, court: string): Promise<ApickResult<CourtAuction>>;
 	registryDocVerify(issueNo: string, options?: { readonly kind?: 'realestate' | 'corporate' | 'movable' }): Promise<ApickResult<RegistryDocVerify>>;
+	bidNotice(options: BidQueryOptions): Promise<ApickResult<BidNotice>>;
+	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>>;
 	screenshot(url: string): Promise<ApickBinaryResult>;
 	youtubeMetadata(url: string): Promise<ApickResult<YoutubeMetadata>>;
 	youtubeThumbnail(url: string): Promise<ApickBinaryResult>;
@@ -1074,7 +1209,7 @@ export interface SkillSummary {
 export interface SkillDetail extends SkillSummary {
 	description: string; billing_rule: 'validated_result' | 'subagent_usage'; limits: SkillLimits | null;
 	delivery?: 'installed_agent'; installation?: {package:string;command:string;api_key_env:string;guide:string;usage:string};
-	billing?: {markup_percent:number;installation_points:number;base_points:number;complete_cache_points:number;quota:null};
+	billing?: {installation_points:number;base_points:number;complete_cache_points:number;quota:null};
 	input_schema: Record<string, unknown>; output_schema: Record<string, unknown>;
 	examples: unknown[]; stats: Record<string, unknown> | null; published_at: string | null;
 }