housing-official-price

Look up Korean apartment and individual-house official prices from realtyprice.kr.

7.4k|904|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill housing-official-price
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: housing-official-price
Source: https://github.com/NomaDamas/k-skill/tree/main/housing-official-price
Command: npx skills add https://github.com/NomaDamas/k-skill --skill housing-official-price

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires housing-official-price.

What problem does it solve?

Finding Korean government official housing prices (공시가격) for apartments and individual houses normally requires navigating the realtyprice.kr website manually, resolving complex names, dong/ho selectors, and PNU codes by hand. This Skill automates that lookup and returns normalized price history JSON.

Core Features & Use Cases

  • Apartment Official Price History: Search apartment complex candidates by name, then retrieve per-unit official price history by dong/ho selection.
  • Individual House Lookup by PNU: Query 개별주택가격 history using an exact 19-digit PNU code.
  • Typed Failure Modes: Structured error codes for ambiguous candidates, invalid PNU, upstream drift, and timeouts so agents can ask the user instead of guessing.
  • Use Case: A user asks "서울 우리 아파트 101동 502호 공시가격 알려줘" — the Skill searches candidates, asks the user to disambiguate if multiple match, and returns the year-by-year official price history.

Quick Start

Ask the agent to look up the official housing price for a specific apartment unit or individual house address using the housing-official-price skill.

Frequently Asked Questions about housing-official-price

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I look up Korean apartment official price (공시가격) programmatically?

Use the searchApartmentCandidates function with a complex name, then call lookupApartmentOfficialPrice with the chosen candidate plus dong and ho selectors. The result is a normalized JSON price history sourced from realtyprice.kr.

How to find individual house official price by PNU in Korea?

Call lookupIndividualHousePriceByPnu with an exact 19-digit PNU code. The function returns yearly official price history including base date, notice date, price in won, and area figures. Missing or inferred PNU digits are rejected.

Does this skill require an API key or login for realtyprice.kr?

No login, API key, CAPTCHA solving, or browser session is required. It calls the public browser-visible web data surface of realtyprice.kr directly from the user's machine and does not route through k-skill-proxy.

What is the difference between official price and transaction price in Korea?

Official price (공시가격) is a government-assessed value published annually, not a market or transaction price. For actual transaction data (실거래가) use a real-estate transaction skill, and for land official price use a 공시지가 skill instead.

Why does apartment lookup return an ambiguous candidate error?

AMBIGUOUS_APARTMENT_CANDIDATE occurs when multiple complexes match the search name. The skill intentionally refuses to guess; show the user the candidate list with addresses and aptCodes and ask them to choose.