timesfm
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
MCP server for Yandex Wordstat API — keyword research for Russian/CIS markets
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…
scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 12/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Yandex Wordstat MCP. Sigue https://mcp.popnx.com/i/stufently-yandex-wordstat-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Yandex Wordstat MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (WORDSTAT_FOLDER_ID) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Yandex Wordstat MCP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "yandex-wordstat": { "command": "npx", "args": [ "-y", "@stufently/yandex-wordstat-mcp" ], "env": { "WORDSTAT_API_KEY": "your-value", "WORDSTAT_FOLDER_ID": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Yandex Wordstat MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
WORDSTAT_FOLDER_ID ID de carpeta de Yandex Cloud para Search API v2. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
SettingsDeveloperEdit Config
{
"mcpServers": {
"yandex-wordstat": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-wordstat-mcp"
],
"env": {
"WORDSTAT_API_KEY": "your-value",
"WORDSTAT_FOLDER_ID": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Yandex Wordstat MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Yandex Wordstat MCP o muestra una herramienta de Yandex Wordstat MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Yandex Wordstat MCP
Yandex Wordstat MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Yandex Wordstat MCP
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Yandex Wordstat MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (WORDSTAT_FOLDER_ID) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Yandex Wordstat MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user yandex-wordstat --env WORDSTAT_API_KEY=your-value --env WORDSTAT_FOLDER_ID=your-value -- npx -y @stufently/yandex-wordstat-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Yandex Wordstat MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
WORDSTAT_FOLDER_ID ID de carpeta de Yandex Cloud para Search API v2. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user yandex-wordstat --env WORDSTAT_API_KEY=your-value --env WORDSTAT_FOLDER_ID=your-value -- npx -y @stufently/yandex-wordstat-mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Yandex Wordstat MCP en la lista como conectado
Usa Yandex Wordstat MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Yandex Wordstat MCP o muestra una herramienta de Yandex Wordstat MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Yandex Wordstat MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (WORDSTAT_FOLDER_ID) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Yandex Wordstat MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "yandex-wordstat": { "command": "npx", "args": [ "-y", "@stufently/yandex-wordstat-mcp" ], "env": { "WORDSTAT_API_KEY": "your-value", "WORDSTAT_FOLDER_ID": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Yandex Wordstat MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
WORDSTAT_FOLDER_ID ID de carpeta de Yandex Cloud para Search API v2. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
En la configuración de Yandex Wordstat MCP, WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Yandex Wordstat MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Yandex Wordstat MCP o muestra una herramienta de Yandex Wordstat MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Yandex Wordstat MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (WORDSTAT_FOLDER_ID) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Yandex Wordstat MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "yandex-wordstat": { "type": "stdio", "command": "npx", "args": [ "-y", "@stufently/yandex-wordstat-mcp" ], "env": { "WORDSTAT_API_KEY": "your-value", "WORDSTAT_FOLDER_ID": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Yandex Wordstat MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
WORDSTAT_FOLDER_ID ID de carpeta de Yandex Cloud para Search API v2. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
En la configuración de Yandex Wordstat MCP, WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Yandex Wordstat MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Yandex Wordstat MCP o muestra una herramienta de Yandex Wordstat MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user yandex-wordstat --env WORDSTAT_API_KEY=your-value --env WORDSTAT_FOLDER_ID=your-value -- npx -y @stufently/yandex-wordstat-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"yandex-wordstat": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-wordstat-mcp"
],
"env": {
"WORDSTAT_API_KEY": "your-value",
"WORDSTAT_FOLDER_ID": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"yandex-wordstat": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-wordstat-mcp"
],
"env": {
"WORDSTAT_API_KEY": "your-value",
"WORDSTAT_FOLDER_ID": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"yandex-wordstat": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@stufently/yandex-wordstat-mcp"
],
"env": {
"WORDSTAT_API_KEY": "your-value",
"WORDSTAT_FOLDER_ID": "your-value"
}
}
}
}WORDSTAT_API_KEY secreto obligatorio envWORDSTAT_FOLDER_ID obligatorio envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
npm: @stufently/yandex-wordstat-mcpSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub stufently, dueña del repo
Último cambio de código: hace 5 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para @stufently/yandex-wordstat-mcp@2.3.0
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/stufently-yandex-wordstat-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: WORDSTAT_API_KEY
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 5 días, y la última versión (2.3.0) llegó al registro hace 9 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Connect AI agents to Exa for web search, content fetching, and multi-step research.
Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.
Search and read Empryo's documentation. Read-only, no auth, no local access.
cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls
| Este Yandex Wordstat MCP | OpenSEO | Exa | Microsoft Learn MCP | Docs | COTAL actions (cotal.ai) | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | Sí | Sí | Sí | No | No |
| Revisiones básicas | 3/3 | 5/5 | 2/4 | 4/4 | 4/4 | 4/4 |
| Licencia | MIT | MIT | MIT | CC-BY-4.0 | NOASSERTION | Apache-2.0 |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
MCP server for Yandex Wordstat via Yandex Cloud Search API v2. Research keywords, analyze search volume trends, and explore regional search distribution for Russian and CIS markets.
v2.0: the legacy
api.wordstat.yandex.netAPI was shut down by Yandex in 2026. The server now talks tosearchapi.api.cloud.yandex.net/v2/wordstat/*and authenticates with a Yandex Cloud API key instead of an OAuth token. Tool names and parameters are unchanged.
This package is published as `@stufently/yandex-wordstat-mcp`; the unscoped name yandex-wordstat-mcp belongs to an unrelated publisher (see the note in the root README). Nothing is on the scope yet, so run it from source:
git clone https://github.com/stufently/yandex-mcp.git
cd yandex-mcp && bun install node packages/yandex-wordstat-mcp/src/index.mjs
Add to your MCP client config:
{
"mcpServers": { "yandex-wordstat": { "command": "node", "args": ["/path/to/yandex-mcp/packages/yandex-wordstat-mcp/src/index.mjs"], "env": { "WORDSTAT_API_KEY": "AQVN...", "WORDSTAT_FOLDER_ID": "b1g..." } } } }
Alternatively, put the credentials into ~/.config/yandex-cloud/wordstat.env (used as a fallback when the env vars are not set):
WORDSTAT_API_KEY=AQVN...
WORDSTAT_FOLDER_ID=b1g...
| Variable | Required | Description |
|---|---|---|
WORDSTAT_API_KEY | Yes | Yandex Cloud API key (secret, AQVN...) of a service account |
WORDSTAT_FOLDER_ID | Yes | Yandex Cloud folder ID (b1g...) used for billing and access checks |
console.yandex.cloud/folders/ /.... A billing account must be linked to the cloud.WORDSTAT_API_KEY; the key identifier (ajel...) is only needed to rotate or revoke the key later.The server enforces a client-side rate limit of 10 requests per second using a sliding window. Requests exceeding the limit are automatically queued. Additionally, 429 and 5xx responses trigger automatic retry with exponential backoff.
Get the Yandex Wordstat regions hierarchy tree.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
depth | number | No | 3 | Maximum tree depth (1-5) |
Returns a tree of regions with value (region ID), label (name), and children.
Get children of a specific region from the cached tree. Does not make an API call -- works from the cached region tree.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
regionId | number | Yes | -- | Region ID to get children for |
depth | number | No | 2 | Maximum subtree depth (1-3) |
Find popular search queries containing a keyword (last 30 days), plus associated queries.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
phrase | string | Yes | -- | Keyword or phrase to search for (max 400 chars) |
regions | number[] | No | -- | Region IDs to filter by |
devices | enum[] | No | -- | Device types: desktop, phone, tablet |
limit | number | No | 100 | Max phrases in response (1-2000) |
Returns { topRequests: [{ phrase, count }], associations: [{ phrase, count }], totalCount } sorted by search volume.
Analyze search volume trends over time for a keyword.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
phrase | string | Yes | -- | Keyword or phrase (max 400 chars) |
period | enum | No | monthly | Aggregation: daily, weekly, monthly |
fromDate | string | No | auto | Start date (YYYY-MM-DD) |
toDate | string | No | auto | End date (YYYY-MM-DD) |
regions | number[] | No | -- | Region IDs |
devices | enum[] | No | -- | Device types: desktop, phone, tablet |
The API enforces window rules that are documented nowhere and are returned as raw gRPC errors when broken (verified against the live API on 2026-07-29):
| Period | Rule |
|---|---|
daily | fromDate must be within the last 60 days — exactly 60 days back is rejected |
weekly | fromDate must be a Monday, toDate a Sunday, and the week must be over |
monthly | fromDate must be the 1st of a month, toDate the last day, and the month must be over |
Dates you pass are snapped to the nearest valid window instead of being rejected; every shift is listed in adjustments in both the text summary and structuredContent. A range that falls inside a single week or month expands to that whole period. A range that covers only the current, unfinished week or month cannot be served at all — the API rejects it — so the tool says so and names the latest available toDate instead of forwarding a 400.
Default date ranges by period:
daily: last 58 days (kept one day inside the limit so a request never expires on a UTC date rollover)weekly: last 52 full weeks, Monday to Sundaymonthly: last 12 full months, 1st to end of monthAll date math is done in UTC.
Returns an array of { date, count, share } data points.
Get regional distribution of search interest for a keyword.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
phrase | string | Yes | -- | Keyword or phrase (max 400 chars) |
regions | number[] | No | -- | Region IDs to filter (client-side, includes descendants) |
devices | enum[] | No | -- | Device types: desktop, phone, tablet |
limit | number | No | 20 | Maximum results (1-50) |
Returns an array of { regionId, regionName, count, share, affinityIndex } sorted by count. Region names are enriched from the cached region tree.
The region tree is fetched once on the first call to get-regions-tree, get-region-children, or regions, and cached for the entire server session. A flat lookup map is built for O(1) region name resolution.
MIT