API / MCP

新词数据 API 与 MCP 使用指南

读取采集新词、手机历史和热词视图,供后续按主题匹配站点。所有请求都只读。

包含在专业版年付($288/年)中:每个账户可在「API 与 MCP 密钥」创建自己的密钥,每个密钥每天 10,000 次请求。

第一步:创建密钥

登录后打开账户菜单里的「API 与 MCP」,点「创建密钥」。密钥只显示一次,请立刻复制到你的密码管理器或服务器环境变量里——之后无法找回,只能吊销。

每个账户最多同时持有 10 个有效密钥。给每台机器单独建一个,泄露时只吊销那一个,不影响其它脚本。

打开密钥页

Authorization: Bearer <your key>

配额与错误码

每个密钥每天 10,000 次请求,按 UTC 零点重置。账户页显示今天整账户已用量。

每次成功响应都会带上剩余配额,脚本可以据此提前降速:

x-api-quota-limit: 10000
x-api-quota-used: 137
x-api-quota-reset: 1761868800
  • 401 invalid_read_token — 没有带 Authorization 请求头,或密钥已吊销。在浏览器地址栏直接打开接口也算这一种。
  • 403 plan_required — 密钥有效,但它所属的账户当前不是有效期内(未过期)的专业版年付。
  • 429 quota_exceeded — 该密钥今天的额度已用完,UTC 零点恢复。

关键词 API

GET https://trendis.money/api/v1/keywords

把密钥放进环境变量后运行:

curl -H "Authorization: Bearer $TRENDIS_API_KEY"   'https://trendis.money/api/v1/keywords?source=collected&limit=100'
  • source=collected — 全部新旧扫描记录,包括未达到热词门槛的词;可加 collector=old|new|all、keyword、limit=1..200。按 nextCursor 继续读取,直到为 null。
  • source=history — 手机采集的 1H、4H、24H、7D、30D 历史;可加 range、kind、keyword、exact、dedupe、heat、limit、cursor。按 nextCursor 读完。
  • source=hot — 热度至少 1000 的 Rising 视图;可加 page、pageSize=5..200、search、seed、domainStatus、minGrowth、dedup。按 page/pages 翻页。
curl -G -H "Authorization: Bearer $TRENDIS_API_KEY"   --data-urlencode 'source=collected' --data-urlencode 'limit=100'   --data-urlencode 'cursor=<previous nextCursor>'   https://trendis.money/api/v1/keywords

同一 7D 手机记录可能同时出现在 collected 和 history;跨来源合并时按关键词、时间窗和采集时间去重。

远程 MCP

https://trendis.money/mcp · JSON-RPC over HTTP POST;同样使用 Bearer 密钥。

在支持自定义 HTTP 请求头的 MCP 客户端中添加远程服务器 URL,并配置 Authorization: Bearer <密钥>。连接后会出现三个工具:

  • list_collected_keywords — 全部采集词
  • list_keyword_history — 手机历史
  • list_hot_keywords — 热词视图

例如,直接调用工具:

curl -H "Authorization: Bearer $TRENDIS_API_KEY"   -H 'Content-Type: application/json'   -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_collected_keywords","arguments":{"limit":100}}}'   https://trendis.money/mcp

客户端先用 initialize 与 tools/list 完成发现;工具结果的 structuredContent 含 items、nextCursor 等字段。MCP 地址也不能靠浏览器地址栏直接查看。