THE AGENT CONNECTION

接上你的 AI,
每次调用都有回音。

从发现能力,到查询结果、核对执行。用 MCP 工具或两种语言的 SDK,把发现、报价、执行与核对接入你的工作流。

04 / 07 / 03 DEMO / TEST / LIVE READ21 PLATFORMSLOCAL / TEST ONLY
LOCAL CONNECTIONSTDIO / JSON-RPC
你的 AI 客户端SUPPORTS MCP STDIO
find · describe · account¹ · quote¹ · run¹ · call · read_more
DataNavoAPICAPABILITY ROUTER
237 项能力 · 同一份合同 · 每次执行可追溯
ANOTHER LOCAL CONNECTION

也可以通过 HTTP 连接。

给支持 Streamable HTTP 的本机 AI 客户端使用。网站和 MCP 服务分别运行,默认使用演示或模拟,也可显式只读已有真实记录。

01 · 启动两个本地服务

先运行网站,再在项目目录的另一个终端运行 HTTP MCP。两个端口可显式调整。

npm run local

# 另一个终端
npm run mcp:http -- --port 4322 --upstream-port 4321

02 · 在本机客户端添加地址

地址 http://127.0.0.1:4322/mcp。匿名连接默认 demo;客户模拟需在客户端配置请求头 X-Guanliu-Mode: simulated 和 Authorization: Bearer <客户Key>,不要把 Key 放在 URL。

传输版本为 2025-06-18,使用 JSON 响应与会话编号。客户端自动完成初始化;此独立 Key 端点没有 SSE 推送或自动重试;网站内 OAuth 使用下方独立入口。

LOCAL ONLYlocalhost 地址供本机客户端访问,云端 ChatGPT 无法直接连接你的电脑。不要把密钥填入共享文档。本地 HTTP 接入与 stdio 复用同一组工具和 TEST 账本。
AUTHORIZE A CONNECTION

让连接,先经过你的同意。

登录、核对权限、连接工具。应用获得独立授权,你可以随时撤销。

一个地址,开始连接

https://datanavoapi.com/api/mcp

本地授权开放目录和固定样本,不使用客户 Key,也不消耗 TEST 点数。

YOU CHOOSE THE SCOPE
mcp:read读取能力目录
find · describe
mcp:demo运行固定样本
call · read_more

本轮不开放 OAuth 账户数据、客户计费或真实供应商执行。原有 Key 接入继续独立使用。

  1. 01选择应用与权限

    内置验收器可直接开始;自己的本机客户端先登记精确回调地址。

  2. 02确认后,执行样本

    授权码通过 PKCE 交换,工具按已批准范围提供。

  3. 03到期、刷新或撤销

    手动刷新短期令牌,或回到连接页撤销授权。

检查本地发现入口

只读取公开元数据,不创建授权或执行工具。

现在不需要购买域名。云端客户端接入需稳定 HTTPS 域名与部署,本机地址不能从云端直连。

完整授权说明 ↗
A SMALL, CLEAR TOOLSET

从一个问题,到一份结果。

按需发现接口,让 AI 先理解参数,再执行你需要的请求。

01find

先找到能力

按任务和平台发现内容、评论或账号能力。只读取目录,不发起数据执行。

{ "query": "评论", "platform": "douyin" }
02describe

再确认合同

读取参数、示例和返回字段,让 AI 知道下一步需要什么。

{ "capability": "douyin.videos.comments.list" }
03call

带着编号,发起请求

演示模式读取固定样本。客户模拟模式使用你的 Key,并把执行结果写入测试账本。

{ "capability": "…", "params": { "id": "…" } }
quote¹ 仅客户 simulated 模式提供。输入 capability、params 和可选 max_credits,读取价格、余额和 Key 预算;不执行、不预留。call 可设置 max_credits,read_more 默认沿用前页上限。匿名 demo 仍为原四个工具。
account¹ 客户模拟模式只读查询:what=balance 核对 TEST 余额与预算,what=usage 配合 filters 查看当前 Key 的已保存调用;what=calls 查询模拟执行,receipt / result 配合 request_id 只读原状态与结果;what=standing 配合原 idempotency_key 查询逻辑请求。显式选择页码,不会自动翻页。在网页检查密钥 →
run¹ 客户模式共七个工具。run 的 create 需显式 confirm:true 与独立幂等编号,只保存本地 TEST 任务预算;get 只读已有预算。后续 call 显式带 run_id 才使用预算,不自动执行或充值。
read_more接收 mcp.next_page_token,保留原查询与场景。客户模拟模式为新一页使用新编号;重试同一页保持原编号。令牌在当前进程保留 10 分钟。
CONNECT YOUR WORKSPACE

先选运行方式,
再接上你的客户端。

适用于支持 stdio 的 MCP 客户端。网页只生成配置,不会启动调用或修改本机文件。

  1. 启动DataNavoAPI网站在项目目录运行 npm run local,保持服务开启。客户端需要能找到 Node.js。
  2. 准备完整项目路径保留 scripts/mcp-server.mjs 与同项目下的 public/sdk/guanliu.mjs,不要只移动脚本。
  3. 复制配置,重启客户端使用客户模拟时,在客户端配置中替换 Key 占位符。Key 不需要交给 AI,也不需要填入此页面。
运行方式

公开演示不扣客户测试点数,也不会调用真实供应商。

固定连接 127.0.0.1

填写项目绝对路径后,即可复制配置。

MCP CLIENT CONFIG / JSON
{
  "mcpServers": {
    "guanliu": {
      "command": "node",
      "args": [
        "/绝对路径/guanliu/scripts/mcp-server.mjs"
      ],
      "env": {
        "GUANLIU_MCP_MODE": "demo",
        "GUANLIU_MCP_PORT": "4321"
      }
    }
  }
}
配置仅在此页面生成,不会保存。simulated 使用 gl_test_,live 只读使用 gl_live_;真实执行与支付保持关闭。
YOUR FIRST CONVERSATION

给 AI 一个明确的起点。

请用DataNavoAPI查找“抖音评论”能力,读取参数说明,然后用演示 ID demo-video-001 获取一页评论。注明这是固定样本,保留 request_id 和数据来源;先不要翻页。

callDEMO / TOOL ARGUMENTS
{
  "capability": "douyin.videos.comments.list",
  "params": {
    "id": "demo-video-001"
  }
}

响应中的 meta.mode 为 demo,meta.provider 为 fixture。

01 / IDENTIFY

一个请求,一个编号

客户模式必须传 idempotency_key。查询同一请求保留原编号、参数和场景;更换编号会视为新的执行。

02 / WAIT

202 表示仍在执行

先保留编号。需要确认结果时,用同一编号查询回执;MCP 与 SDK 都不会自动重试或翻页。

03 / TRACE

结果未知,也能追踪

网络中断不等于执行失败。保留编号与 request_id,在执行工作台核对,不要换号重发。

THE SAME GATEWAY, YOUR CODE

也可以,从几行代码开始。

JavaScript 与 Python 轻 SDK。标准运行时即可使用,下载后放在你的脚本旁边。

PY

Python

Standard library · Python 3

无需额外依赖,使用相同的能力、参数和幂等规则。只连接本机模拟网关。

下载 Python SDK
SIMULATED · x.users.get
保存 SDK 后,在同目录运行
import { GuanliuClient, GuanliuError } from './guanliu.mjs';

const client = new GuanliuClient({
  apiKey: process.env.GUANLIU_CUSTOMER_API_KEY,
  port: 4321
});
// 为每个新逻辑请求分配编号;查询同一请求时保留它。
const requestId = 'one-logical-request-001';

try {
  const { status, body } = await client.call(
    'x.users.get', { username: 'guanliu_demo' },
    { idempotencyKey: requestId, scenario: 'success' }
  );
  if (status === 202) {
    console.info('仍在执行。稍后用同一编号查询回执。');
  } else if (status >= 400) {
    console.info(status, body.code, body.request_id);
  } else {
    console.log(body.request_id, body.data, body.meta.billing);
  }
} catch (error) {
  if (!(error instanceof GuanliuError)) throw error;
  console.info(error.code, error.outcomeUnknown
    ? '结果未确认。保留原编号,不要换号重发。'
    : '请求未发出,请先检查配置和参数。');
}

SDK 仅支持客户模拟。HTTP 业务错误保留 status 和 body;传输异常提供结果是否未知的标记。新一页传入原参数与 cursor,并使用新编号。查看完整接入说明 →

YOUR CLIENT / YOUR NEXT STEP

按你的开发方式接入。

CLEAR BY DESIGN

每个结果,都带着它的身份。

权限与结算贯通

客户模拟会验证 Key 的能力范围、有效期与限额。成功扣测试点数,失败或超时释放预留,记录可在执行工作台查询。

本地运行,测试点数

默认执行结果与费用为模拟;live 只读模式展示保存的真实记录。MCP 和 SDK 不执行真实供应商调用,不连接支付服务,也不充值。

保留来源与状态

保留 mode、warnings、request_id 和结算信息。固定样本用于搭建流程,不能作为真实市场事实。

LIVE RECORDS / READ ONLY

让 Agent 核对已经发生的请求。

v0.28 · 读取保存的真实回执。查询不调用供应商,真实执行关闭时仍可使用。

独立的 live 只读客户端

JavaScript / Python 使用 GuanliuLiveReadClient,参数与原客户端相同,Key 使用 gl_live_。提供 account、usage、calls、standing、receipt、result。CLI 在对应读取命令增加 --mode live。

固定连接本机;不自动重试或翻页,不执行 call、quote 或 run。

三个 Agent 工具

stdio 使用 GUANLIU_MCP_MODE=live;HTTP 使用 X-Guanliu-Mode: live 与 Bearer Key。Key 仅放在本机客户端配置中。

仅提供 find、describe、account。account 的 what 支持 balance、usage、calls、standing、receipt、result;公开目录不代表真实执行授权。

READ ONLY只读当前 Key。免费额度按账户共享,预留按供应商单位分列,实际供应商成本未知。pending / unknown 不会被查询重发。打开真实调用记录 →