返回首页

API 与 MCP 文档

Anjin Radar(安针)REST API 与 MCP 服务器的使用说明:认证、调用上限、接口列表、从 Claude Code 与 Cursor 接入的方法,以及错误码。

最近更新: 2026-09-28

通过 REST API 与 MCP 服务器,可以获取 AI 工具排行榜、收款信号、关键词、趋势新词和外链投放源数据。船长及以上套餐可用。

快速开始

  1. 在价格页面订阅船长套餐。
  2. 在设置 → API 密钥创建密钥(最多 5 个)。
  3. 每个请求都带上 Authorization: Bearer <API 密钥> 请求头。

密钥创建后仍可再次复制,但请勿分享给他人。如有泄露,请删除后重新创建。删除的密钥最多 60 秒内失效。

降级或订阅结束后,密钥不会被删除,请求会以 403 plan_required 拒绝;重新升级到船长后,原来的密钥无需更换即可继续使用。

调用上限

  • 每月额度:10,000 次(按 UTC 自然月重置)
  • 频率限制:每分钟 10 次(平均每 6 秒 1 次)
  • 上限按用户计算:同一账户下的所有密钥,以及 REST 与 MCP 的调用,共享这两项上限。
  • 只有返回了数据的请求才计入额度。/api/v1/me、MCP 的 get_usage 与获取工具列表、参数错误的请求都不计入。
  • 可通过响应头 X-Quota-Limit / X-Quota-Remaining / X-Quota-Reset 与 X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset(重置时间均为 UNIX 秒)查看剩余次数。

REST API

基础地址为 https://anjinradar.com/api/v1。

curl -H "Authorization: Bearer sk_..." \
  "https://anjinradar.com/api/v1/tools?sort=mom&pageSize=10&locale=zh"

接口列表

  • GET /api/v1/tools — AI 工具流量增长榜
  • GET /api/v1/revenue — 按流向支付页面的流量推测的收款信号(并非实际营收)
  • GET /api/v1/keywords — 增长中的 AI 网站所获取的关键词
  • GET /api/v1/trends — Google Trends 上新近飙升的 AI 相关词
  • GET /api/v1/backlinks — 可以提交产品获取外链的投放源
  • GET /api/v1/{dataset}/facets — 该数据集可用的筛选代码(分类、类型、支付渠道等)及数量
  • GET /api/v1/me — 当前套餐与本月用量(不计入额度)

通用参数

  • page — 页码,从 1 开始
  • pageSize — 每页条数(1–100,默认 20)
  • search — 按域名、词或标签模糊匹配
  • sort — 排序。tools:mom visits dr new rank;revenue:score checkout mom visits new rank;keywords:occurrences volume cpc difficulty new rank;trends:score heat appear rank;backlinks:occurrences dr visits organic rank(均支持 oldest)
  • filter — 分类代码(keywords 为搜索意图,trends 为趋势形态)
  • locale — ja、en 或 zh(默认 ja),决定标签与描述的语言

数据集专属参数:tools 支持 siteType;revenue 支持 provider 与 flag(new / ai);keywords 支持 difficulty;trends 支持 cls 与 appear(7d 14d 30d older);backlinks 支持 flag(dofollow paid free anonymous,逗号分隔)。可用代码请通过 /facets 查询。未知参数或超出范围的值会返回 400。

返回格式

{
  "dataset": "tools",
  "locale": "zh",
  "page": 1,
  "pageSize": 10,
  "total": 2918,
  "updatedAt": "2026-09-27",
  "items": [{ "domain": "example.ai", "visits": 1200000, "visitsMom": 42.5 }]
}

visitsMom 等增长率为百分比数值(42.5 表示 +42.5%)。

MCP

地址为 https://anjinradar.com/api/mcp(Streamable HTTP)。支持自定义请求头的 MCP 客户端都可以接入,例如 Claude Code 与 Cursor。

Claude Code:

claude mcp add --transport http anjinradar https://anjinradar.com/api/mcp --header "Authorization: Bearer sk_..."

Cursor(~/.cursor/mcp.json):

{
  "mcpServers": {
    "anjinradar": {
      "url": "https://anjinradar.com/api/mcp",
      "headers": { "Authorization": "Bearer sk_..." }
    }
  }
}

工具

  • list_ai_tools — AI 工具流量增长榜
  • list_revenue_sites — 按支付页面流量推测的收款信号
  • list_keywords — AI 网站的关键词
  • list_trends — 飙升中的搜索词(传 includeSeries: true 可获取逐日热度)
  • list_backlinks — 外链投放源
  • get_facets — 各数据集的筛选代码
  • get_usage — 套餐与本月用量(不计入额度)

为节省智能体的上下文,MCP 默认每次返回 10 条,并省略仅供网页展示的字段。

错误码

出错时返回相应的 HTTP 状态码,以及 { "error": { "code": "...", "message": "..." } }。

401 missing_key
缺少 Authorization 请求头。
401 invalid_key
密钥无效或已被删除。
403 plan_required
需要船长及以上套餐,密钥仍会保留。
400 bad_request
参数不合法,错误信息会说明原因。
404 not_found
数据集不存在。
429 rate_limited

超出每分钟上限,请在 Retry-After 秒后重试。

429 quota_exceeded

本月额度已用完,将于下月 1 日(UTC)重置。

数据均为估算值。使用条件请参阅服务条款中的「API 与 MCP 的合理使用」。如需更高额度,请联系 support@anjinradar.com。