호스팅 MCP로 Zillow 매매·임대·매각 완료 매물을 검색하기

누구에게 맞나

이미 Claude, Cursor, Windsurf를 쓰고 있으며 매매, 임대, 매각 완료 조건으로 Zillow 매물을 검색한 뒤 한 건의 전체 정보를 읽으려는 사람에게 맞다. 호스팅 MCP이며 읽기 전용 도구가 두 개, 결과는 구조화 JSON이다. Zillow 계정은 필요 없고 서비스를 직접 호스팅할 필요도 없다.

아직 HasData API key가 없는 사람에게는 맞지 않다. 키는 HasData 콘솔에서 무료로 만들며 카드를 묶지 않는다. 체험은 약 200회 호출을 덮는다(회당 5크레딧). 원격 서비스이며 가장 짧은 경로는 URL 하나와 x-api-key 요청 헤더다. 로그아웃 방문자가 Zillow.com에서 볼 수 있는 공개 매물 페이지만 읽는다. 로그인 후에만 나오는 내용은 보이지 않는다.

3분 만에 첫 시도 끝내기

공식 경로는 하나다: Claude로 HTTP를 통해 호스팅 엔드포인트에 접속한다. npx 로컬 런처를 주 설치와 나란히 두지 말 것.

claude mcp add --transport http zillow "https://mcp.hasdata.com/api/mcp?apis=zillow" --header "x-api-key: HASDATA_API_KEY"

전제: 이 기기에 MCP 클라이언트가 있고 HasData 콘솔에서 받은 API key가 있어야 한다. 콘솔은

https://app.hasdata.com/sign-up?utm_source=github&utm_medium=syndication&utm_campaign=zillow-mcp

설정 위치는 이 claude mcp add가 쓰는 클라이언트 항목이다. 서비스 이름은 zillow, 요청 헤더는 x-api-key다. HASDATA_API_KEY를 콘솔의 실제 키로 바꾸고, 다른 비밀 자리 표시를 지어내지 말 것.

첫 호출은 원문이 명시한 읽기 전용 검색이다. 매매, 임대, 매각 완료로 매물을 거르고 원문이 말한 풍부한 필터를 붙여 구조화 JSON을 받는다. 원문은 도구 함수 이름이나 필드 표를 주지 않으므로 search/get 이름을 지어내지 말 것. 성공 신호는 클라이언트가

https://mcp.hasdata.com/api/mcp?apis=zillow

에 연결된 뒤, 매매/임대/매각 완료 검색 한 번이 JSON 매물 기록을 돌려주고 키 부족이나 헤더 필드 오류가 아닌 것이다.

읽기 전용은 위험이 없다는 뜻이 아니다. 이 호출은 원격 HasData 서비스에 닿고, 그 서비스가 Zillow 공개 페이지를 읽는다. 체험은 약 5크레딧/회, 약 200회다.

사용 사례

사례 1: 매매, 임대, 매각 완료로 여러 매물을 검색한다. 먼저 상태를 정한 뒤 구조화 결과를 보려는 사람에게 맞다. 증거는 필터가 풍부하다고 쓰지만 모든 필터 필드를 나열하지 않는다. 클라이언트가 실제로 내놓고 이 세 상태에 대응하는 매개변수만 쓴다.

사례 2: 한 부동산의 전체 정보를 읽는다. 이미 대상 매물이 있고 완전한 JSON만 필요한 사람에게 맞다. 증거는 “read a single property in full, all as structured JSON”만 쓴다. 입력이 Zillow URL인지 내부 ID인지는 없다. 빠졌으면 클라이언트의 해당 도구 설명에서 멈추고 매개변수를 지어내지 말 것.

사용 경계

HasData API key가 필수다. Zillow 계정이 없어도 된다. 로그아웃 방문자가 볼 수 있는 공개 매물 페이지만 읽는다. 체험은 무료, 카드 없음, 약 200회, 회당 약 5크레딧. 원격 서비스이며 컨테이너는 필요 없다. stdio 경로의 npx -y @hasdata/zillow-mcp와 환경 변수 HASDATA_API_KEY는 주 경로가 아니다. 증거가 명시한 읽기 전용 도구는 두 개다: 세 종류 매물 검색, 한 건 전체 정보. 도구 함수 이름도 취소 경로도 없다.

https://github.com/HasData/zillow-mcp