agentmods.dev

realestate-mcp: Instructions file for Claude Code

CLAUDE.md

realestate-mcp CLAUDE.md is an instructions file for Claude Code from hlucent/realestate-mcp. It costs 848 tokens per session, scanned A, original, MIT.

Project-specific instructions for Claude Code when working on a real-estate data server. The server wraps nine South Korean government property-transaction APIs as MCP tools, a standard way for AI assistants to call software services.

In plain words
What is it for?
Use it when changing the realestate-mcp project, including its shared client, property-search tools, configuration, request handling, or Fly.io deployment.
Why use it?
It tells the coding agent which files and documents to read, how the server is structured, and how to save tokens while working. This reduces unnecessary exploration of the codebase and API documents.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions CLAUDE.md.

This is hlucent/realestate-mcp's own configuration. It tells Claude Code how to work on realestate-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything realestate-mcp configures →

not rated 0repo 2mo ago A scan 848 tokens original MIT
View source ↗ hlucent/realestate-mcp
Reuse

Borrowing it

Nothing to install: this file belongs to hlucent/realestate-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/hlucent/realestate-mcp/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/hlucent/realestate-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for realestate-mcp CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/hlucent/realestate-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/hlucent/realestate-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/hlucent/realestate-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/hlucent/realestate-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for realestate-mcp CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/hlucent/realestate-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/hlucent/realestate-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 848 This file is loaded in full into every session.
When invoked 848 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00848 $0.00848
Opus 5.5 $0.00339 $0.00339
Sonnet 5.5 $0.00170 $0.00170
Haiku 4.5 $0.00085 $0.00085

Measured 2mo ago against content hash 1daa1ac1a2b1, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

realestate-mcp CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 43 lines

What it actually says

CLAUDE.md — 이 프로젝트에서 작업하는 Claude를 위한 지침

이 파일은 세션 시작 시 가장 먼저, 그리고 유일하게 읽어야 하는 파일이다. 과거 대화나 전체 소스를 다시 훑지 말고, 이 문서 + 필요한 개별 파일만 열어서 작업할 것.

프로젝트 한 줄 요약

국토교통부 실거래가 공공데이터(data.go.kr) 9종 API를 MCP 도구로 감싸는 서버. 매매/전월세 × (단독다가구/아파트/연립다세대/오피스�텔) 조합.

토큰 절약 원칙 (중요)

  1. API 원문 PDF/기술문서를 통째로 읽지 말 것. 스펙 요약은 docs/api-spec/*.md에 이미 표로 정리되어 있음. 새 필드 추가 등 진짜 원문 확인이 필요할 때만 원본 참조.
  2. 매 세션 전체 git log를 훑지 말 것. 최근 상태는 docs/devlog/의 가장 최신 파일 하나만 보면 충분하다 (누적 로그가 아니라 스냅샷 방식).
  3. 소스 전체를 view하지 말고 src/client.ts(공통 로직)와 지금 작업할 src/tools/xxx.ts 파일만 연다. 8개 tools 파일은 서로 거의 동일한 패턴이므로 1개를 참고 템플릿으로 삼아 나머지를 유추해 작성하면 됨(전부 열어볼 필요 없음).
  4. 응답은 항상 결론(변경 요약)부터 — 사용자 지침(userPreferences)의 두괄식 원칙 준수.

아키텍처 (자세한 설계는 docs/ARCHITECTURE.md)

  • src/client.ts : serviceKey 조립, XML→JSON 파싱, 에러코드(01~32) 매핑 — 공통 1개
  • src/tools/*.ts : 8개 도구, 각자 endpoint URL + 응답 필드 스키마(zod)만 다름
  • src/config.ts : endpoint URL 상수 (serviceKey는 여기 없음)
  • src/keyContext.ts : AsyncLocalStorage로 요청별 serviceKey 격리 (아래 배포 방식 참고)
  • src/index.ts : Express + StreamableHTTPServerTransport 기반 HTTP MCP 서버 (/mcp)

배포 (Fly.io)

  • https://realestate-mcp-hlucent.fly.dev/mcp 로 배포됨. seoul-air-quality-mcp, construction-alert-mcp와 동일한 패턴: serviceKey를 서버 환경변수/Fly secrets로 저장하지 않고, 요청마다 ?key=... 쿼리 파라미터로 받아 AsyncLocalStorage에 격리 보관한다 (src/keyContext.ts). 서버 프로세스 자체는 키를 모른다.
  • 배포는 .\deploy.ps1 -CommitMessage "..." (커밋→push→flyctl deploy→smoke test 자동화, construction-alert-mcp/deploy.ps1과 동일 구조).

현재 진행 상태

→ docs/devlog/에서 파일명 날짜순 가장 마지막 항목 확인. (예: 2026-08-07.md)

작업 규칙

  • 새 기능/수정 완료 시 반드시 docs/devlog/YYYY-MM-DD.md를 자동 생성/갱신할 것 (형식은 docs/devlog/_TEMPLATE.md 참고). 사용자가 수동으로 안 씀.
  • 커밋 메시지는 feat:, fix:, docs:, refactor: 등 conventional commits 형식.
  • serviceKey는 코드/커밋에 절대 포함 금지 (.env, .gitignore 처리됨).
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 43 lines · 848 tokens per session scan A 1daa1ac1a2b1

Subscribe to this mod's changes

realestate-mcp CLAUDE.md is an instructions file published in the GitHub repository hlucent/realestate-mcp (0 stars, last pushed 2mo ago), licensed MIT. It adds 848 tokens to every session, about $0.0034 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Backend and APIs
Related

realestate-mcp CLAUDE.md compared with instructions from other repositories

realestate-mcp CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
realestate-mcp CLAUDE.mdhlucent/realestate-mcpInstructions file02mo agoMITA848Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode