| get_search_path | Make a request to the Path Finder API of Hubble with proper error handling.
Args:
keyword: str, 검색 키워드
gl: str, 지역 코드 한국 일본(kr, jp)
limit: int, 검색 경로 분석 결과 최대 개수(기본값 200)
Returns:
dict[str, Any] | None: 검색 경로 분석 결과
|
| get_keyword_info | 키워드 정보 조회 (최대 1000개 키워드 조회 가능)
키워드 정보 조회 결과는 키워드 정보 조회 결과 형식에 따라 반환됩니다.
args:
req_param: KeywordParameters, 키워드 정보 조회 요청 파라미터
returns:
dict[KeywordResponse, Any] | None: 키워드 정보 조회 결과
KeywordResponse 는 아래와 같은 정보를 포함합니다:
ads_metrics:
- competition: 경쟁도 수준 (LOW: 0-33, MEDIUM: 34-66, HIGH: 67-100)
- competition_index: 구글 검색광고 경쟁도 (0-100)
- cpc: 클릭당 비용
- volume_avg: 최근 3개월 월평균 검색량
- volume_total: 최근 12개월 총 검색량
- volume_trend: 3개월 전 대비 검색량 증감율
- gg_volume_avg: 구글 최근 3개월 월평균 검색량
- gg_volume_total: 구글 최근 12개월 총 검색량
- gg_volume_trend: 구글 검색량 증감율
- nv_volume_avg: 네이버 최근 3개월 월평균 검색량
- nv_volume_total: 네이버 최근 12개월 총 검색량
- nv_volume_trend: 네이버 검색량 증감율
intents:
- I: Informational
- N: Navigational
- C: Commercial
- T: Transactional
monthly_volume:
- month: 해당 월
- gg: 구글 검색량
- nv: 네이버 검색량
- total: 구글 + 네이버 검색량 |
| get_graph_info | 키워드 관계 정보(허블의 클러스터 파인더 결과 조회, 키워드 관계 정보 조회)
args:
req_param: ClusterParameters, 키워드 관계 정보 조회 요청 파라미터
returns:
dict[ClusterResponse, Any] | None: 키워드 관계 정보 조회 결과
ClusterResponse 는 아래와 같은 정보를 포함합니다:
nodes: 키워드(노드) 리스트
nodes_count: 키워드(노드) 수
rels: 관계 리스트
rels_count: 관계 수
closeness: 관계에서 키워드가 출현한 위치.
distance: 모든 관계에서 키워드가 출현한 위치.
type: PEOPLE_ALSO_SEARCH_FOR | RELATED_SEARCHES | REFINEMENTS | PEOPLE_ALSO_ASK_FOR |
| get_serp_info | |
| crawl_web_page | 웹 페이지 크롤링
args:
url_list: List[str], 크롤링할 웹 페이지 리스트
returns:
dict[Any] | None: 크롤링 결과 |
| crawl_google_suggest_extensions | 키워드에 대한 구글 서제스트 확장 키워드 수집 요청
args:
keyword: str, 키워드
gl: Literal['kr', 'us', 'jp'] = "kr", 국가 코드
returns:
dict[Any] | None: 구글 서제스트 확장 키워드 수집 결과
키워드 확장
suggestions(common)
키워드의 suggestions(1 depth) + 1 depth 결과들의 suggestions(2 depth)
suffix(나라별)
한국 (gl : kr) : 2405개
keyword + space (1 개)
keyword + 한글 자음(ㄱ~ㅎ: 19 개)
keyword + 한글 음절 (2350 개)
keyword + 알파벳(a~z: 26 게)
keyword + 숫자(0~9: 10 개)
미국 (gl : us) : 37개
keyword + space (1 개)
keyword + 알파벳(a~z: 26 개)
keyword + 숫자(0~9: 10 개)
일본 (gl : jp) : 2318개
keyword + space (1 개)
keyword + 히라가나 (46 개)
keyword + 히라가나 * 히라가나 (2116 개)
keyword + 가타카나 (46 개)
keyword + 일어 음절 (73 개)
keyword + 알파벳(a~z: 26 개)
keyword + 숫자(0~9: 10 개) |
| crawl_google_trends | 구글 트렌드 수집 요청
최근 며칠 이내의 키워드 트렌드 추이를 0~100 사이의 값으로 표현 됩니다.
(검색량은 아니고, 검색 관심도를 나타냅니다. 해당 수치는 0~100 사이의 값으로 표현 됩니다.)
trends: 기간을 기준으로 차트에서 가장 높은 지점 대비 검색 관심도를 나타냅니다.
값은 검색 빈도가 가장 높은 검색어의 경우 100, 검색 빈도가 그 절반 정도인 검색어의 경우 50,
해당 검색어에 대한 데이터가 충분하지 않은 경우 0으로 나타납니다.
args:
keywords: List[str], 키워드 리스트
location: Literal['South Korea', 'Japan'],
timeframe: Literal['now 1-H', 'now 7-d', 'today 1-m'],
gl: Literal['kr', 'jp']
returns:
dict[Any] | None: 구글 트렌드 수집 결과 |