RE Data Refinery MCP 서버

지저분한 부동산 데이터를 깨끗하고 점수가 매겨진, AI에 바로 사용할 수 있는 부동산 인텔리전스로 변환하는 Model Context Protocol (MCP) 서버로, 콜럼버스(Columbus, OH)와 주변 메트로 도시들을 대상으로 합니다.

일반적인 부동산 API와 달리 RE Data Refinery는 실시간 Zillow 데이터와 카운티 수준의 보강 데이터(GIS, 체납 세금, 보안관 매각, 허가, 검인 기록)를 결합하고 모든 매물에 대해 독점적인 투자 점수를 계산합니다. 에이전트는 구독이나 API 등급 없이 실행한 쿼리만 x402 마이크로페이먼트 프로토콜을 통해 Base 메인넷에서 지불합니다.

• 실시간 데이터 소스: ZillAPI

• 적용 범위: 14개 콜럼버스 메트로 도시에 걸쳐 등록된 150개 이상의 매물

• 결제: Base의 USDC, 유료 조회당 $0.35

• 전송: Claude Desktop, Claude Code, ChatGPT Desktop, Hermes 및 기타 MCP 클라이언트용 stdio / SSE

차별점

도구 (10)

빠른 시작

1. 종속성 설치

pip install "x402>=2.20.0" eth-account httpx

2. 저장소 클론

git clone https://github.com/areshms/re-refinery-mcp.git
cd re-refinery-mcp

3. 환경 구성

프로젝트 루트에 .env 파일을 만드세요:

# Required for paid Worker lookups
EVM_PRIVATE_KEY=0x...

# Optional
X402_SPEND_CAP=$1                    # max per-payment USD cap (default: $1)
REFINERY_BASE_URL=https://re-data-refinery.ares-hms.workers.dev
REFINERY_LOCAL_URL=http://localhost:5004

지갑에 조회 비용을 지불할 Base의 USDC가 있어야 합니다.

4. MCP 클라이언트에 추가

Claude Desktop / Claude Code:

{
  "mcpServers": {
    "re_refinery_mcp": {
      "command": "python3",
      "args": ["/path/to/re-refinery-mcp/re_refinery_mcp.py"],
      "env": {
        "EVM_PRIVATE_KEY": "${EVM_PRIVATE_KEY}",
        "X402_SPEND_CAP": "$1"
      }
    }
  }
}

로컬 개발 모드

USDC를 사용하지 않고 개발하거나 테스트하려면 x402를 비활성화하고 무료 로컬 API를 가리키세요:

export REFINERY_ENABLE_X402=false
export REFINERY_LOCAL_URL=http://localhost:5004
python3 re_refinery_mcp.py --transport stdio

그러면 유료 엔드포인트는 Worker 대신 localhost:5004를 호출합니다.

결제 작동 방식

1. 에이전트가 유료 엔드포인트를 요청합니다.

2. Worker가 HTTP 402 Payment Required 및 x402 결제 요구 사항으로 응답합니다.

3. MCP 클라이언트가 Base에서 Permit2 USDC 트랜잭션에 서명합니다.

4. CDP 파실리테이터가 서명을 검증하고 온체인에서 결제를 정산합니다.

5. Worker가 요청된 데이터를 반환합니다.

EVM_PRIVATE_KEY가 구성되면 이 모든 것이 자동으로 처리됩니다.

점수 산정 방법

모든 매물은 다음으로 보강됩니다:

• flip_score (0–100): Zestimate 대비 할인율, 시장 체류 일수, 동네 중앙값, 건물 연식, 대지 면적

• wholesale_score (0–100): 에쿼티 스프레드, 체납 세금, DOM, 소유자 거주 여부, Zestimate 대비 가격

• rental_yield_pct: 연간 임대료 추정치 ÷ 가격

• market_heat: 시장 체류 일수 및 최근 가격 추세에 따른 Hot / Warm / Cool

점수는 live-refinery 캐시에서 가져온 동네 중앙값을 기준으로 다시 계산됩니다.

요구 사항

• Python 3.11+

• x402>=2.20.0

• eth-account

• httpx

• Base 메인넷에 USDC가 있는 지갑

Worker

이 서버를 지원하는 Cloudflare Worker는 다음에 배포되어 있습니다:

https://re-data-refinery.ares-hms.workers.dev

Cloudflare의 x402 수익화 게이트웨이를 사용하는 최초의 부동산 데이터 리파이너리입니다.

라이선스

MIT

Hightower Marketing 제작 — 부동산 데이터가 AI 에이전트를 위해 작동하도록 만듭니다.