get_keyword_info
Retrieve detailed keyword metrics including competition levels, CPC, search volume trends, and intent analysis for up to 1000 keywords using this tool within Hubble MCP Server.
Instructions
키워드 정보 조회 (최대 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: 구글 + 네이버 검색량
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| req_param | Yes |
Input Schema (JSON Schema)
{
"$defs": {
"KeywordParameters": {
"properties": {
"gl": {
"default": "kr",
"description": "국가 코드",
"enum": [
"kr",
"jp"
],
"title": "Geolocation",
"type": "string"
},
"keywords": {
"description": "요청 키워드",
"items": {},
"maxItems": 1000,
"minItems": 1,
"title": "keyword(list)",
"type": "array"
}
},
"required": [
"keywords"
],
"title": "KeywordParameters",
"type": "object"
}
},
"properties": {
"req_param": {
"$ref": "#/$defs/KeywordParameters"
}
},
"required": [
"req_param"
],
"title": "get_keyword_infoArguments",
"type": "object"
}