get_wordstat
Получить частотность (приблизительное количество запросов в месяц) для одной или нескольких ключевых фраз за один вызов — сразу по нескольким регионам (до 5) и типам точности. Для каждой фразы возвращаются частотность в разрезе «тип × регион», похожие и вложенные (популярные) запросы, а при запросе seasonality — сезонность спроса по месяцам. Передавайте все фразы одной строкой через запятую в одном вызове, а не делайте отдельный вызов на каждую фразу.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"keywords": "<keywords>"
},
"name": "get_wordstat"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Устаревший одиночный тип точности; если задан — будет приведён к types=[type]. Используйте types. | |
| types | No | Типы точности сравнения (можно несколько сразу). general — все запросы с этой фразой (широкое соответствие). quoted — точная фраза в кавычках, любые словоформы. exact — только слова в заданной форме, порядок не важен. По умолчанию — ["general"]. | |
| region | No | Устаревший одиночный регион; если задан — будет приведён к regions=[region]. Используйте regions. | |
| regions | No | Список идентификаторов регионов (до 5). Значение null в списке — частотность без учёта региона. По умолчанию — Россия. | |
| keywords | Yes | Одна или несколько ключевых фраз, разделённых запятыми (например: "купить телефон, купить ноутбук"). Передавайте все фразы одной строкой в одном вызове, а не вызывайте инструмент отдельно для каждой фразы. | |
| seasonality | No | Запрос сезонности спроса за период до 24 месяцев. Если задан — start и end обязательны. | |
| need_related_phrases | No | Возвращать похожие фразы | |
| need_including_phrases | No | Возвращать вложенные (популярные) фразы |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Частотность по фразам в разрезе «тип × регион» | |
| types | Yes | Запрошенные типы точности | |
| regions | Yes | Регионы запроса с их названиями (из included.regions) | |
| task_id | Yes | Идентификатор задачи, по которому открывается её страница | |
| seasonality | No | Сезонность спроса (временные ряды по месяцам), если запрашивалась | |
| seasonality_device | No | Тип устройства сезонности: desktop / mobile | |
| seasonality_months | No | Месяцы, за которые рассчитана сезонность (список дат-границ месяцев) |