RankLens

API / MCP

把 KYNO RankLens 的实时排名数据接进你的代码和 AI 客户端。

开发者

认证

所有请求使用 Bearer token。密钥来自 .env.local 的 RANKLENS_API_KEY；正式版会按账号签发独立密钥。

Authorization: Bearer YOUR_KEY

REST API

一次 POST 查询某个域名在 Google 前 100 名中的位置，返回排名、匹配 URL、前 10 名结果和结果总数。

POST /api/v1/rank

请求体

{
  "query": "hiking backpack",
  "domain": "example.com",
  "locale": "us",
  "device": "desktop"
}

cURL

curl -X POST http://localhost:3000/api/v1/rank \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"hiking backpack","domain":"example.com","locale":"us","device":"desktop"}'

响应示例

{
  "query": "hiking backpack",
  "domain": "example.com",
  "position": 12,
  "url": "https://example.com/collections/hiking-backpack",
  "topResults": [ { "position": 1, "title": "...", "url": "..." } ],
  "targetResult": null,
  "totalResults": 2453571,
  "checkedAt": "2026-10-19",
  "source": "live"
}

MCP 接入

把 MCP 地址添加到 Claude Code、Cursor 或任何支持 Streamable HTTP 的客户端，用自然语言查询排名。

MCP URL

http://localhost:3000/api/mcp

Claude Code 配置

claude mcp add --transport http ranklens http://localhost:3000/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"

可用工具

  • check_rank — 查询某个搜索词下目标域名的 Google 排名
  • list_regions — 列出支持的国家/地区和设备
  • list_link_opportunities — 按分类、DR、dofollow 和费用筛选外链机会库
  • get_link_opportunity — 按 id 或域名查看单个外链机会
  • get_backlink_summary — 查询域名的外链概况（引荐域名、外链数、丢失外链）
  • find_link_gap — 找出链接了竞品但没链接你的域名
  • get_recent_backlinks — 查看最近新增或丢失的外链

限制与计费

API 每分钟最多 30 次请求；同一关键词、地区和设备在 10 分钟内命中缓存。每次真实查询消耗一次 DataForSEO 请求。

当前为单 key 演示实现。正式版需要把 API Key 绑定到用户和套餐，并在服务端校验额度。

升级到 Pro