Trends MCP

Trends MCP

Datos de tendencias en vivo para agentes de IA. Google, TikTok, YouTube, Amazon, Reddit y más de 30 fuentes. Una conexión MCP, una clave API.

Obtén una clave API gratuita · Documentación · Precios · Fuentes de datos · PyPI · Glama

You: Using TrendsMCP, compare 6-month growth for GLP-1 on Google, TikTok, and Amazon.

Agent: Google Search  +84%
       TikTok         +212%
       Amazon         +61%

Tres herramientas. Normalizado de 0 a 100 donde el pipeline lo permite. Sin claves por plataforma. Sin scraping de tu lado.

Instalación rápida

Los mismos cuatro clientes que el héroe del sitio. Obtén una clave gratuita primero (100 solicitudes/mes). Claude y ChatGPT te permiten iniciar sesión con OAuth. Cursor y VS Code: haz clic y luego coloca tu clave desde /account si el enlace profundo usó un marcador de posición.

Luego pregunta: Using TrendsMCP, what's trending on Google right now?

Herramientas · Fuentes · Feeds · REST · Instalar en otros clientes

Qué es esto

MCP alojado en https://api.trendsmcp.ai/mcp. La misma clave Bearer para POST https://api.trendsmcp.ai/api. Este repositorio también tiene un adaptador stdio para Glama y hosts locales.

Instalar en otros clientes

Reemplaza YOUR_API_KEY con la clave de tu cuenta.

claude mcp add --scope user --transport http trends-mcp https://api.trendsmcp.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "trends-mcp": {
      "url": "https://api.trendsmcp.ai/mcp",
      "transport": "http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "servers": {
    "trends-mcp": {
      "type": "http",
      "url": "https://api.trendsmcp.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "trends-mcp": {
      "serverUrl": "https://api.trendsmcp.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "trends-mcp": {
      "type": "streamableHttp",
      "url": "https://api.trendsmcp.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" },
      "disabled": false
    }
  }
}

{
  "mcpServers": {
    "trends-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.trendsmcp.ai/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer YOUR_API_KEY" }
    }
  }
}

pip install -e .
python -m trends_mcp_server

{
  "mcpServers": {
    "trends-mcp": {
      "command": "python",
      "args": ["-m", "trends_mcp_server"],
      "env": { "TRENDSMCP_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Herramientas

Listas de parámetros siempre actualizadas: documentación.

get_time_series

Historial semanal (o diario) para una source + keyword. El mismo nombre en MCP y REST (mode: "get_time_series"). REST también acepta get_trends como alias.

El índice es de 0 a 100 donde el pipeline lo permite (100 = pico en la ventana devuelta). volume está presente cuando esa fuente tiene una serie absoluta.

get_growth

Cambio porcentual punto a punto. Varias ventanas en una sola llamada siguen contando como una solicitud para esa fuente + palabra clave.

Presets: 7D 14D 30D 1M 2M 3M 6M 9M 12M 1Y 18M 24M 2Y 36M 3Y 48M 60M 5Y MTD QTD YTD.

get_top_trends

Lista clasificada en vivo. Sin palabra clave. En MCP, type es obligatorio y debe coincidir con el nombre del feed exactamente (incluidas las mayúsculas). En REST, omite type solo si tienes la intención de extraer todos los feeds (se factura por feed).

Prompts que se enrutan correctamente

Using TrendsMCP, what's trending on Google right now?
Using TrendsMCP, what are the hottest Reddit posts right now?
Using TrendsMCP, compare 6-month growth for creatine gummies on Google, TikTok, and Amazon.
Using TrendsMCP, show Google Search history for protein soda.
Via TrendsMCP, pull npm download history for langchain.
Using TrendsMCP, show Steam concurrent players for Elden Ring.
Via TrendsMCP, Android downloads for com.openai.chatgpt.
Using TrendsMCP, fastest-climbing Amazon best sellers in Toys Games this week.

Fuentes de palabras clave

source en get_time_series / get_growth. No son las mismas cadenas que type en los feeds en vivo.

source: "Google Trends" no es válido. Usa google search para el historial y type: "Google Trends" para el tablero en vivo.

Feeds en vivo

type en get_top_trends. Copia el nombre exactamente.

Listas de nombres de categorías: documentación.

Los rankings de iOS, repositorios de GitHub, Spotify, IMDb, Open Library, Substack y Top Websites son feeds, no valores de source. No existe source: "web traffic".

API REST

curl -sS -X POST https://api.trendsmcp.ai/api \
  -H "Authorization: Bearer $TRENDSMCP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"get_top_trends","type":"Google Trends","limit":5}'

import os, requests

r = requests.post(
    "https://api.trendsmcp.ai/api",
    headers={"Authorization": f"Bearer {os.environ['TRENDSMCP_API_KEY']}"},
    json={"mode": "get_growth", "source": "google search", "keyword": "bitcoin", "percent_growth": ["3M", "12M"]},
)
print(r.json())

Cliente de Python: pip install trendsmcp.

Límites y errores

La facturación anual es 20% menos. El mismo catálogo de fuentes en todos los planes. Los límites de historial gratuito y de "top N" están en precios. Las llamadas fallidas no se facturan. Superar la cuota devuelve 429 / rate_limited (sin sobrecargos sorpresa).

Una solicitud facturada:

• get_time_series: una fuente + palabra clave
• get_growth: una fuente + palabra clave (todas las ventanas de esa llamada incluidas)
• get_top_trends: por type (y paginación según lo documentado)

No confirmes claves. Los conectores de Claude.ai usan OAuth; otros clientes usan Authorization: Bearer ….

Lo que esto no hace

• Desglose por región / geo, consultas relacionadas o temas relacionados
• Series por hora
• get_time_series en varias fuentes en una sola llamada (usa get_growth con una lista de source separada por comas, o varias llamadas de get_time_series)
• Inventar nombres de feeds: el type de MCP debe coincidir con la tabla

Desarrolla este repositorio

pip install -e .
python -m trends_mcp_server

CI: .github/workflows/ci.yml. Seguridad: SECURITY.md. Problemas: github.com/trendsmcp-ai/Trends-MCP/issues.

Enlaces

• Cuenta / clave
• Documentación
• Precios
• llms.txt
• TrendWatch (alertas en tu propio repositorio de GitHub)

MIT © Trends MCP