Soomgo-gather

데이터 수집을 위한 다양한 플랫폼의 심플한 인터페이스를 제공합니다.


Keywords
Naver, NaverSearchAD, GA, collect, data, gather, soomgo-gather, soomgo
License
MIT
Install
pip install Soomgo-gather==2.0

Documentation

Soomgo-gather

Soomgo-gather는 (주)브레이브모바일에서 서비스 중인 숨고 에서 데이터 수집을 위해 구현한 통합 패키지입니다.

PyPI - Python Version Coverage Status Packagist License

데이터 파이프라인을 구축하다보면 다양한 플랫폼에서 데이터를 수집해야하는 경우가 있습니다. 플랫폼마다 프로토콜도 다르고, API 명세도 일원화되지 않다보니 실제로 수집하기까지 오랜시간이 소요됩니다. 또한, 대부분 수집을 위한 플랫폼들은 어느 조직이든 비슷합니다. 예로, 마케팅 데이터를 수집하기 위해서는 GA, 네이버검색광고시스템 겠죠.

Soomgo-gather 는 최소한의 시간으로 최대한 빨리 데이터를 수집할 수 있도록 심플한 인터페이스를 제공합니다.


Read the documentation on ReadTheDocs!


Supported platform

Installation and usage

Installation

Soomgo-gatherpip install soomgo-gather 로 설치할 수 있고, Python 3.6 이상부터 지원하고 있습니다.

Usage

Soomgo-gather 를 사용하는 방법은 간단합니다.

아래는 Naver Search AD.Bizmoney 를 수집하는 예시입니다.

from soomgogather.naver import Bizmoney

bizmoney = Bizmoney(api_key='_', secret_key='_', customer_id='_')

r = bizmoney.exhaust(params={
    'search_start_dt': '20211118',
    'search_end_dt': '20211118',
 })

if r.status_code == 200:
     print(r.json())

아래는 Kakao Keyword AD의 리포트를 수집하는 예시입니다.

from soomgogather.kakao import KeywordReport

k = KeywordReport(
  path='adAccounts',
  access_token='_',
  ad_account_id='_'
)
r = k.report()
if r.status_code == 200:
  print(r.json())

# access_token이 유요하지 않다면 갱신이 필요합니다.

k = KeywordReport(
  path='adAccounts',
  access_token='_',
  ad_account_id='_',
  user_refresh_token='_',
  rest_api_key='_',
)
r = k.report()

License

MIT

Contributing

환영합니다! 프로젝트에 기여하고 싶다면 가이드를 읽어주세요.

방법은 어렵지 않습니다. 이슈를 생성하고, feature 브랜치에 작업하여 main 브랜치를 타겟으로 PR을 보내주시면 됩니다.

Changelog