Google Trends MCP

Un servidor MCP local que permite a Claude (o a cualquier cliente MCP) consultar Google Trends directamente — interés de búsqueda a lo largo del tiempo, consultas y temas relacionados, desgloses por regiones y búsquedas de tendencia en tiempo real — para que puedas hacer investigación de mercado dentro de una conversación, sin cambiar de pestaña a trends.google.com y tener que pegar capturas de pantalla.

Está pensado para investigación de mercado de uso personal. No requiere clave de API — Google Trends no tiene una API pública oficial, así que esto envuelve pytrends, el cliente estándar no oficial de Python, en un servidor MCP.

Herramientas

Todas las herramientas usan geo="IN" (India) por defecto, salvo que se indique lo contrario — pasa geo="" para todo el mundo, o cualquier código de país ISO ("US", "GB", etc.). timeframe acepta el formato de pytrends, p. ej. "today 12-m", "today 5-y", "now 7-d", o un rango explícito "2024-01-01 2024-06-01".

interest_over_time(keywords, timeframe="today 12-m", geo="IN")

Interés de búsqueda relativo (0–100) a lo largo del tiempo para hasta 5 palabras clave, comparadas una al lado de la otra. Las palabras clave que superen las 5 primeras se descartan silenciosamente. Cada registro incluye isPartial — un valor true en el punto de datos más reciente significa que ese período aún no ha terminado y su valor es provisional; no interpretes una caída en ese punto como un cambio real de tendencia.

related_queries(keyword, timeframe="today 12-m", geo="IN")

Consultas de búsqueda relacionadas más populares y en aumento para una sola palabra clave. Devuelve {"top": [...], "rising": [...]}, cada uno una lista de registros {"query": ..., "value": ...}. Los valores de top son interés relativo de 0 a 100. Los valores de rising son el incremento porcentual — excepto un valor de 5000%, que es el marcador "Breakout" de Google para indicar crecimiento explosivo desde una base casi nula, no un porcentaje literal.

related_topics(keyword, timeframe="today 12-m", geo="IN")

Lo mismo que related_queries, pero con agrupaciones de temas (las propias agrupaciones de Google) en lugar de cadenas de consulta en bruto — los registros incluyen topic_title y topic_type junto a value. La misma convención de Breakout se aplica a rising.

interest_by_region(keyword, timeframe="today 12-m", geo="IN")

Interés de búsqueda de una palabra clave desglosado por estado/región dentro del geo indicado. Devuelve una lista de registros {"geoName": ..., "<keyword>": 0-100}, uno por cada región.

trending_now(geo="india")

Las búsquedas con más tendencia de hoy para un país. Nota: el formato de geo aquí es diferente — es el nombre completo del país en minúsculas ("india", "united_states"), no un código ISO como en las otras cuatro herramientas. Es una inconsistencia real en los propios endpoints de Google, no un error.

Limitación conocida: en el momento de crear escribir esto, trending_now devuelve un HTTP 404. Google parece haber retirado el endpoint heredado (hottrends/dailytrends/realtimetrends) del que dependen los métodos de búsqueda de tendencias de pytrends, confirmado al probar las tres variantes que ofrece pytrends. Es un problema upstream que no puede solucionarse en este código; falla limpiamente con una cadena de error legible en lugar de colgarse. Las otras 4 herramientas utilizan una familia distinta de endpoints, que aún funciona y no se ve afectada. Si Google restaura el endpoint o pytrends lo soluciona con un parche, esto volverá a funcionar sin necesidad de cambios aquí.

Todas las herramientas capturan los fallos (límites de petición, errores de red, el caso anterior) y devuelven una cadena de error simple en lugar de bloquearse — pot hub años since Google Trends no es un endpoint estable, sino una API raspada; este es un comportamiento esperado, no algo excepcional.

Configuración

Requiere Python 3.10+ y uv.

git clone https://github.com/jain-eshan/google-trends-mcp.git
cd google-trends-mcp
uv sync

Registro con Claude Code

claude mcp add google-trends -- uv run --directory /absolute/path/to/google-trends-mcp server.py

Verifica que se ha conectado:

claude mcp list

Deberías ver google-trends en la lista como ✔ Connected. Inicia una conversación nueva de Claude Code después del registro: las sesiones ya abiertas no lo detectarán un servidor recién agregado.

Uso

Una vez registrado, solo pide a Claude usarlo — por ejemplo:

"Usa el de google-trends MCP para comparar el interés en 'labor grown diamonds' vs 'diamond jewellery' in India durante los últimos 12 meses, y muéstrame las consultas relacionadas."

Opcional: skill /trends

Esta repo incluye una skill de Claude Code en .claude/skills/trends/SKILL.md que envuelve las herramientas en bruto en un flujo de trabajo de investigación y síntesis — decide qué herramientas son relevantes para tu tema y escribe un resumen natural, en vez de volcar el JSON en bruto. Si usas Claude Code, la skill se detecta automáticamente desde este repo; solo ejecuta:

/trends <your topic>

Notas de diseño

• Solo datos, sin síntesis en el servidor. Cada herramienta devuelve datos crudos y estructurados; a interpretación (si la tendencia es real, qué significa un marcador Breakout, qué se merece señalar) ocurre en la conversación que llama, no está incrustada en las piezas de escrita. Esto simplifica el servidor y deja que el que estén llamando (Claude, otro cliente MCP) aplique su buen juicio.

• Sin dependencias específicas aparte de mcp[cli] y pytrends. No se usa base de datos, ni archivo de config, ni un clave.

• No hay suite de pruebas formal. Esto envuelve un endpoint de terceros procesado con scripting; una suite de pruebas probaría sobre todo estilo de pytrends y la forma actual de respuesta de Google, no este código. En su lugar, cada herramienta se verificó con datos reales Google Trends durante el desarrollo.

Licencia

MIT — consulta LICENSE.