Trends MCP

Trends MCP

Dados de tendências ao vivo para agentes de IA. Google, TikTok, YouTube, Amazon, Reddit e mais de 30 outras fontes. Uma conexão MCP, uma chave de API.

Obtenha uma chave de API gratuita · Documentação · Preços · Fontes de dados · 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%

Três ferramentas. Normalizadas de 0 a 100 onde o pipeline suporta. Sem chaves por plataforma. Sem scraping do seu lado.

Instalação rápida

Os mesmos quatro clientes do hero do site. Obtenha uma chave gratuita primeiro (100 req/mês). Claude e ChatGPT fazem login com OAuth. Cursor e VS Code: clique e depois coloque sua chave de /account se o deeplink usou um placeholder.

Depois pergunte: Using TrendsMCP, what's trending on Google right now?

Ferramentas · Fontes · Feeds · REST · Instalar em outros clientes

O que é isso

MCP hospedado em https://api.trendsmcp.ai/mcp. Mesma chave Bearer para POST https://api.trendsmcp.ai/api. Este repositório também tem um adaptador stdio para Glama e hosts locais.

Instalar em outros clientes

Substitua YOUR_API_KEY pela chave da sua conta.

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" }
    }
  }
}

Ferramentas

Listas de parâmetros sempre atualizadas: documentação.

get_time_series

Histórico semanal (ou diário) para uma source + keyword. Mesmo nome no MCP e no REST (mode: "get_time_series"). O REST também aceita get_trends como alias.

O índice é de 0 a 100 onde o pipeline suporta (100 = pico na janela retornada). volume está presente quando essa fonte tem uma série absoluta.

get_growth

Variação percentual ponto a ponto. Várias janelas em uma chamada ainda contam como uma solicitação para essa fonte + palavra-chave.

Predefinições: 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 classificada ao vivo. Sem palavra-chave. No MCP, type é obrigatório e deve corresponder ao nome do feed exatamente (incluindo maiúsculas). No REST, omita type somente se você pretende puxar todos os feeds (cobrado por feed).

Prompts que roteiam corretamente

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.

Fontes de palavras-chave

source em get_time_series / get_growth. Não são as mesmas strings de type nos feeds ao vivo.

source: "Google Trends" é inválido. Use google search para histórico e type: "Google Trends" para o quadro ao vivo.

Feeds ao vivo

type em get_top_trends. Copie o nome exatamente.

Listas de nomes de categorias: documentação.

Rankings iOS, repositórios do GitHub, Spotify, IMDb, Open Library, Substack e Top Websites são feeds, não valores de source. Não 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 Python: pip install trendsmcp.

Limites e erros

A cobrança anual é 20% menor. Mesmo catálogo de fontes em todos os planos. Limites de histórico gratuito e de “top N” estão em preços. Chamadas com falha não são cobradas. Acima da cota retorna 429 / rate_limited (sem cobranças surpresa).

Uma solicitação cobrada:

• get_time_series: uma fonte + palavra-chave
• get_growth: uma fonte + palavra-chave (todas as janelas dessa chamada incluídas)
• get_top_trends: por type (e paginação conforme documentado)

Não faça commit de chaves. Conectores do Claude.ai usam OAuth; outros clientes usam Authorization: Bearer ….

O que isso não faz

• Divisão por região / geo, consultas relacionadas ou tópicos relacionados
• Séries horárias
• get_time_series em várias fontes em uma chamada (use get_growth com uma lista source separada por vírgulas, ou várias chamadas de get_time_series)
• Inventar nomes de feeds: o type do MCP deve corresponder à tabela

Desenvolva este repositório

pip install -e .
python -m trends_mcp_server

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

Links

• Conta / chave
• Documentação
• Preços
• llms.txt
• TrendWatch (alertas no seu próprio repositório do GitHub)

MIT © Trends MCP