real-estate-search Skill for Claude Code: Korean Home Prices

Looks up Korean apartment, officetel, villa and house sale and rent prices from official transaction records. Part of the k-skill collection.

Installs: 9.2K; on skills.sh
Stars: 8.2K; on GitHub
Files: 4; besides SKILL.md
Updated: Nov 2026; last repo commit

real-estate-search makes your agent look up real transaction and rent prices in Korea. It finds the district code first, then queries a hosted proxy that serves Ministry of Land, Infrastructure and Transport (MOLIT) records, and returns a short summary: number of deals, median, low and high price, and the top 3 to 5 deals.

The SKILL.md in the folder is a short stub. It tells the agent to run an npx command from the k-skill package to load the full instructions. So it needs Node.js with npx and a network connection. The instructions say you do not need your own API key. Korea only: it lists overseas property prices as out of scope.

Good for

People checking recent sale or rent prices in a Korean district or complex
Buyers, renters and agents who want median, low and high prices for a month
Claude Code and Codex users who already run skills

Install real-estate-search

Claude Code

Copy this prompt.

Install the real-estate-search skill in Claude Code. Run this command:

/plugin marketplace add NomaDamas/k-skill
/plugin install k-skill@k-skill

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

The plugin route installs every skill listed in the manifest (135) and namespaces them, for example /k-skill:lotto-results, so this one is /k-skill:real-estate-search. The repo root has no hooks, agents or .mcp.json file. The skills CLI route installs this skill alone. Pick one route, not both. The README suggests installing the whole set first and running the k-skill-setup skill for shared setup.

From the project README. Source.

What's in the skill

When it loads

Korean apartment/officetel/villa/single-house real transaction price and rent lookups via k-skill-proxy. Based on tae0y's real-estate-mcp and MOLIT public data APIs.

Sections in SKILL.md

Get the full instructions (required first step)
Hard rules even without the CLI

Key facts

Author: NomaDamas (k-skill collection); based on tae0y's real-estate-mcp and MOLIT public data
License: MIT (SKILL.md frontmatter; the repo has a LICENSE file)
Installs on skills.sh: 9,239 (Nov 2, 2026)
GitHub stars: 8,232 for the whole k-skill repo (Nov 2, 2026)
Last repo commit: Nov 1, 2026
Files in the folder: 5: SKILL.md, instruction.md, skill.json, scripts/nationwide_daily_report.py, tests/test_nationwide_daily_report.py
Needs: Node.js 18+ with npx (SKILL.md); no user API key (instruction.md)
Part of: The k-skill plugin and skill collection (135 skills listed in plugin.json)

What it includes

Runs an npx command from the k-skill package to get the full instructions
SKILL.md says this is a required first step. The command is npx -y @nomadamas/k-skill@0 instruct real-estate-search.
Runs code · Load instructions
Turns a district name into the 5-digit legal-district code
Calls GET /v1/real-estate/region-code on the hosted proxy with q, for example a district name such as 강남구.
Try: “강남구 아파트 매매 실거래가”
Network · Region code lookup
Fetches sale or rent records for a district and month
Nine asset and deal pairs: apartment, officetel, villa and single-house for trade and rent, plus commercial trade. Commercial rent is not supported. You give lawd_cd and a deal month (YYYYMM).
Try: “마포구 아파트 전세 실거래가 보여줘”
Network · Price lookup
Runs a Python script that tallies official MOLIT CSV downloads by outcome
Covers 8 combinations: apartment, officetel, villa and single-house, each for sale and rent. It reports success, empty, failure and unexecuted counts, and exits with code 1 if any combination fails.
Runs code · Nationwide daily report
Summarizes region, asset type and month, deal count, median, low, high and top deals
The instructions ask for a short summary and say not to mix real transactions with asking prices.
Compact answer

From the official docs

Permissions

Medium risk

The skill runs a package from npm and sends your queries to a hosted proxy, so a changed package or proxy could change what happens. Check the commands your agent proposes before you approve them.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It runs a package from npm every time
SKILL.md tells the agent to run npx -y @nomadamas/k-skill@0 instruct real-estate-search first, and the real instructions come from that package at run time. The install guide says npx fetches the latest compatible 0.x version, so the instructions can change without you reinstalling. The -y flag installs the package without asking you. Review what your agent runs. github.com
Search terms go to a hosted proxy
Region queries and deal months go to the k-skill proxy, which holds the data-source key. The README links a privacy notice for proxy-backed skills. Set KSKILL_PROXY_BASE_URL to use your own proxy. github.com
The report script contacts the MOLIT site directly
nationwide_daily_report.py builds a cookie-enabled HTTP opener and requests lists and CSV files from rt.molit.go.kr. Run it only when you want the nationwide report. github.com
The k-skill CLI can send usage statistics
Per the repo docs, each CLI call can send an event with a random local id, the command, the skill name, CLI version, runtime mode and success flag to PostHog. Command arguments, inputs and credentials are not in it. Set KSKILL_ANALYTICS_DISABLED=1 to opt out. github.com

Technical details

Talks to	npm registry (npx). k-skill-proxy.nomadamas.org. rt.molit.go.kr. us.i.posthog.com (usage statistics unless opted out)
Sign-in and keys	No user key. The data-source key is held by the hosted proxy, per instruction.md.
Scopes	Runs npx -y @nomadamas/k-skill@0 to load instructions Sends district codes and months to k-skill-proxy.nomadamas.org The nationwide report runs a Python script that talks to rt.molit.go.kr

Questions

What does real-estate-search do?

It looks up real sale and rent transaction records for Korean apartments, officetels, villas and houses. It uses the district code and a month, then summarizes the deals. It does not cover overseas property or asking prices.

How do I install it?

Use the install box above. The plugin route installs the whole k-skill set; the skills CLI route installs this skill alone. You need Node.js 18 or newer, because the skill loads its instructions through npx.

Does it need an API key?

The instructions say you do not need your own key. The key for the data source lives on the hosted proxy. The nationwide report reads official CSV files directly and needs no proxy or service key, per instruction.md. You can point it at your own proxy with KSKILL_PROXY_BASE_URL.

Does it work in the Claude app or Claude.ai?

It needs Node.js and npx on your machine, so use Claude Code or another coding agent. The README lists Claude Code, Codex, OpenCode and OpenClaw/ClawHub as supported.

Is it safe?

It runs an npm package through npx and sends your search terms to a hosted proxy, so read the safety box before you use it on a work machine. Its hard rules forbid payments, sending messages and public posts without your approval right before.

How is it different from daangn-realty-search or housing-official-price?

real-estate-search reports government-recorded deals and rents. The README describes daangn-realty-search as listings on Daangn Realty, and housing-official-price as government assessed prices. These are separate skills in the same collection.

Information

updated Nov 2, 2026

Repository: nomadamas/k-skill
Folder: real-estate-search

nomadamas/k-skill skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 7

k-skill README · github.com
k-skill plugin.json · github.com
k-skill install guide · github.com
real-estate-search SKILL.md · github.com
real-estate-search instruction.md · github.com
k-skill CLI usage analytics · github.com
nationwide_daily_report.py · github.com