byung-u/real_estate_in_korea

한국 아파트 매매/전세 가격 조회하기 위한 파이썬 스크립트

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.2.1 (current)

  • 출력 포멧 추가 (for using pandas, pyplot)
  • 설정 파일 삭제 (configparser -> os.environ.get)

• 0.2.0 (Friday, 24 February 2017)

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

• 0.1.0 (Sunday, 12 February 2017)

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

Configure

export SQLITE3_FOR_REK="$HOME/xxx"
export DATA_APT_RENT_URL="xxx"
export DATA_APT_TRADE_URL="xxx"
export DATA_APT_API_KEY="xxx"

License

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