API & MCP

你的数据,
你的工作流。

连接你选择提供的经营数据,再通过网页、REST API 或 MCP 查询。接口访问需要网站授权。

01 / CONNECT

先选网站,再设权限

登录并创建或选择你有权管理的网站,在「数据连接」中创建接入凭据或只读凭据。接入凭据仅写入所选资源,只读凭据仅查询所选范围,两种用途不能混用。密钥只在创建时显示一次。

申请收录不要求接入数据。账号或接入能力未启用时,界面会提示不可用;没有连接的模块不会自动产生经营数据。

管理数据连接 ↗

02 / REST API

标准资源,按需接入

支持客户、事件、订单、支付、退款、订阅、成本、活动、营销支出、状态观测和汇总,共 11 类资源。完整字段、请求结构与权限说明可在 OpenAPI 中查看。

GET /api/v1/me/sites
GET /api/v1/sites/{siteId}/analytics/overview
GET /api/v1/sites/{siteId}/analytics/acquisition
POST /api/v1/sites/{siteId}/ingest/events
Authorization: Bearer <YOUR_SCOPED_CREDENTIAL>

接口基址:https://radar.nexotoken.net。示例中的 siteId 为网站 UUID;每次请求使用对应用途和范围的凭据。请在自己的服务端保管凭据,不要放入公开网页代码。

查看 OpenAPI 3.1 ↗

03 / DATA CONTRACT

让重试和更正有据可查

批次包含 schema_version、batch_id 和 records;例如事件资源使用 events.v1。单批最多 500 条,请求体最多 1 MiB。同一批次原样重试沿用 batch_id;更正业务记录时使用新的批次标识、相同记录标识和更高的 revision。

时间使用带时区的 ISO 8601,报表默认北京时间。金额使用 amount_minor 整数与 currency 币种,例如人民币 12.34 元写为 amount_minor=1234、currency=CNY。只发送分析所需字段,不发送客户聊天正文、密码或其他密钥。

04 / READ-ONLY MCP

在支持 MCP 的工具中查自己的数据

服务地址:https://radar.nexotoken.net/mcp。使用 OAuth 授权一个网站及读取范围;当前连接器需要由运营方预先注册客户端与准确回调地址,尚不支持任意客户端自动注册。完成配置前,不能直接粘贴地址就连接成功。

get_site_overview({ site_id: "<SITE_UUID>" })
get_acquisition({ site_id: "<SITE_UUID>" })
get_geo_overview({ site_id: "<SITE_UUID>" })
list_geo_reports({ site_id: "<SITE_UUID>" })

MCP 只读,不修改数据、不执行 SQL、不启动收费采集。连接可在工作台撤销;财务和客户等数据需要相应权限。

05 / AVAILABILITY

先确认数据已经存在

REST 和 MCP 查询读取同一套已授权数据,不会因为调用查询自动开始采集。GEO 当前提供公开页面检查;Claude 等回答引擎尚未接通时,相关答案、引用和趋势返回不可用状态。接口文档描述数据契约,不代表每个账号都已启用所有能力。

查看数据口径与限制 ↗