real_estate_in_korea

한국 아파트 실거래 매매/전세 가격 조회하기 위한 파이썬 유틸리티

Quick Start

• Requirements

  • Python 3.x
  • 아파트 실거래자료 openapi 키 신청

• Install package

  $ git clone https://github.com/byung-u/real_estate_in_korea
  $ python3 setup.py build
  $ python3 setup.py install
  

• Run

  • 3달치 아파트 매매가 확인 (def: 마포구 대흥동 자이)

    $ real_estate_in_korea -m 3
    
    전세가 조회인 경우 뒤에 --rent 추가 이하 동일
    $ real_estate_in_korea -m 3 --rent
    

  • 원하는 '구' 정보로 아파트 정보 확인

    $ real_estate_in_korea -g 서초구
    

  • 알고자하는 그 아파트를 검색

    $ real_estate_in_korea -g 중구 -d 황학동 -t 황학 -m 6
    $ real_estate_in_korea -g 서대문구 -d 북가좌동 -t 한양 -m 60
    

• Options

  • g : xx구(서초구, 마포구, 강북구, ... )
  • d : xx동(서초동, 공덕동, 우이동, ... )
  • t : 아파트(자이, SK리더스뷰, 레미안, ... )
  • m : 조회 기간 (월 단위)
  • s : 방 크기 (m²)
  • S : 조회 시작할 월 (201702)
  • --rent : 전세가 조회 (명령어에 없으면 default로 매매가 조회)

  • --text : 출력 포멧 변경 (x,xx,x,x,x,x,x)

      만약 오늘이 201702 이고 -m 3 옵션을 주면
      201702 201701 201612 3달치를 조회하게 됨
      max: 36 month 제한 (일단은 limit을 둠)
    

Release

• 0.1.0 (Sunday, 12 February 2017)

  • 서울 아파트 매매가 조회기능
  • 옵션 추가 (구, 동, 아파트, 조회기간)

• 0.2.0 (Friday, 24 February 2017)

  • 전국 아파트 매매가 조회기능 추가
  • 아파트 전세가 조회기능
  • 옵션 추가 (크기, 월단위 시작날짜)

• 0.2.1 (...)

  • 출력 포멧 추가 (for using pandas, pyplot)

License

Real_estate_in_korea is licensed under the terms of the MIT License (see the file LICENSE).