Ecommerce Trends MCP

Trends MCP

为 AI Agent 提供实时趋势数据。覆盖 Google、TikTok、YouTube、Amazon、Reddit 和其他 30 多个来源。一个 MCP 连接，一个 API 密钥。

获取免费 API 密钥 · 文档 · 定价 · 数据源 · 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%

三个工具。对于支持该处理流程的数据，均标准化为 0–100。无需为各平台单独配置密钥，也无需自行抓取数据。

快速安装

与网站首页横幅展示的四个客户端相同。请先获取免费密钥（每月 100 次请求）。Claude 和 ChatGPT 会通过 OAuth 登录。对于 Cursor 和 VS Code：点击按钮；如果深度链接使用了占位符，再填入 /account 中的密钥。

然后提问：Using TrendsMCP, what's trending on Google right now?

工具 · 数据源 · 信息流 · REST · 在其他客户端中安装

这是什么

托管的 MCP 服务，地址为 https://api.trendsmcp.ai/mcp。POST https://api.trendsmcp.ai/api 使用相同的 Bearer 密钥。本仓库还提供一个 stdio 适配器，供 Glama 和本地宿主使用。

在其他客户端中安装

将 YOUR_API_KEY 替换为你账户中的密钥。

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

工具

始终更新的参数列表：文档。

get_time_series

获取一个 source + keyword 的每周（或每日）历史数据。MCP 和 REST 使用相同的名称（mode: "get_time_series"）。REST 也接受 get_trends 作为别名。

在支持的处理流程中，指数范围为 0–100（100 = 返回时间范围内的峰值）。当来源有绝对值序列时，会提供 volume。

get_growth

计算两个时间点之间的百分比变化。一次调用包含多个时间窗口，仍按该来源 + 关键词计为一次请求。

预设值：7D 14D 30D 1M 2M 3M 6M 9M 12M 1Y 18M 24M 2Y 36M 3Y 48M 60M 5Y MTD QTD YTD。

get_top_trends

实时排名列表。无需关键词。在 MCP 中，必须提供 type，且其值必须与信息流名称完全一致（包括大小写）。在 REST 中，只有在打算提取所有信息流时才省略 type（按信息流计费）。

能正确路由的提示词

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.

关键词来源

get_time_series / get_growth 中的 source。与实时信息流中的 type 字符串不同。

source: "Google Trends" 无效。查询历史数据时使用 google search，查询实时榜单时使用 type: "Google Trends"。

实时信息流

get_top_trends 中的 type。请原样复制名称。

类别名称列表：文档。

iOS 榜单、GitHub 仓库、Spotify、IMDb、Open Library、Substack 和 Top Websites 都是信息流，不是 source 值。不存在 source: "web traffic"。

REST API

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())

Python 客户端：pip install trendsmcp。

限额和错误

按年计费可优惠 20%。所有套餐使用相同的来源目录。免费套餐的历史数据和“前 N 名”上限请参阅定价。失败的调用不计费。超出配额时会返回 429 / rate_limited（不会产生意外的超额费用）。

每个计费请求：

• get_time_series：一个来源 + 一个关键词
• get_growth：一个来源 + 一个关键词（该调用中的所有时间窗口均包含在内）
• get_top_trends：每个 type 计费（分页按文档说明）

不要提交密钥。Claude.ai 连接器使用 OAuth；其他客户端使用 Authorization: Bearer …。

此工具不支持的功能

• 区域 / 地理位置细分、相关查询或相关主题
• 小时级时间序列
• 在一次调用中通过 get_time_series 查询多个来源（请使用带逗号分隔 source 列表的 get_growth，或多次调用 get_time_series）
• 自行编造信息流名称：MCP type 必须与表格中的一致

开发此仓库

pip install -e .
python -m trends_mcp_server

CI：.github/workflows/ci.yml。安全：SECURITY.md。问题：github.com/trendsmcp-ai/Trends-MCP/issues。

链接

• 账户 / 密钥
• 文档
• 定价
• llms.txt
• TrendWatch（在你自己的 GitHub 仓库中接收提醒）

MIT © Trends MCP