01 · 启动两个本地服务
先运行网站,再在项目目录的另一个终端运行 HTTP MCP。两个端口可显式调整。
npm run local # 另一个终端 npm run mcp:http -- --port 4322 --upstream-port 4321
从发现能力,到查询结果、核对执行。用 MCP 工具或两种语言的 SDK,把发现、报价、执行与核对接入你的工作流。
给支持 Streamable HTTP 的本机 AI 客户端使用。网站和 MCP 服务分别运行,默认使用演示或模拟,也可显式只读已有真实记录。
先运行网站,再在项目目录的另一个终端运行 HTTP MCP。两个端口可显式调整。
npm run local # 另一个终端 npm run mcp:http -- --port 4322 --upstream-port 4321
地址 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 账本。登录、核对权限、连接工具。应用获得独立授权,你可以随时撤销。
https://datanavoapi.com/api/mcp本地授权开放目录和固定样本,不使用客户 Key,也不消耗 TEST 点数。
mcp:read读取能力目录mcp:demo运行固定样本本轮不开放 OAuth 账户数据、客户计费或真实供应商执行。原有 Key 接入继续独立使用。
内置验收器可直接开始;自己的本机客户端先登记精确回调地址。
授权码通过 PKCE 交换,工具按已批准范围提供。
手动刷新短期令牌,或回到连接页撤销授权。
只读取公开元数据,不创建授权或执行工具。
按需发现接口,让 AI 先理解参数,再执行你需要的请求。
find按任务和平台发现内容、评论或账号能力。只读取目录,不发起数据执行。
{ "query": "评论", "platform": "douyin" }describe读取参数、示例和返回字段,让 AI 知道下一步需要什么。
{ "capability": "douyin.videos.comments.list" }call演示模式读取固定样本。客户模拟模式使用你的 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 分钟。适用于支持 stdio 的 MCP 客户端。网页只生成配置,不会启动调用或修改本机文件。
npm run local,保持服务开启。客户端需要能找到 Node.js。scripts/mcp-server.mjs 与同项目下的 public/sdk/guanliu.mjs,不要只移动脚本。公开演示不扣客户测试点数,也不会调用真实供应商。
填写项目绝对路径后,即可复制配置。
{
"mcpServers": {
"guanliu": {
"command": "node",
"args": [
"/绝对路径/guanliu/scripts/mcp-server.mjs"
],
"env": {
"GUANLIU_MCP_MODE": "demo",
"GUANLIU_MCP_PORT": "4321"
}
}
}
}gl_test_,live 只读使用 gl_live_;真实执行与支付保持关闭。请用DataNavoAPI查找“抖音评论”能力,读取参数说明,然后用演示 ID demo-video-001 获取一页评论。注明这是固定样本,保留 request_id 和数据来源;先不要翻页。
{
"capability": "douyin.videos.comments.list",
"params": {
"id": "demo-video-001"
}
}响应中的 meta.mode 为 demo,meta.provider 为 fixture。
客户模式必须传 idempotency_key。查询同一请求保留原编号、参数和场景;更换编号会视为新的执行。
先保留编号。需要确认结果时,用同一编号查询回执;MCP 与 SDK 都不会自动重试或翻页。
网络中断不等于执行失败。保留编号与 request_id,在执行工作台核对,不要换号重发。
JavaScript 与 Python 轻 SDK。标准运行时即可使用,下载后放在你的脚本旁边。
ES Module · Node.js
使用环境变量传入客户 Key,返回 HTTP 状态与完整响应。附 TypeScript 类型声明。
Standard library · Python 3
无需额外依赖,使用相同的能力、参数和幂等规则。只连接本机模拟网关。
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
? '结果未确认。保留原编号,不要换号重发。'
: '请求未发出,请先检查配置和参数。');
}import os
from guanliu import GuanliuClient, GuanliuError
client = GuanliuClient(
os.environ['GUANLIU_CUSTOMER_API_KEY'], port=4321
)
# 为每个新逻辑请求分配编号;查询同一请求时保留它。
request_id = 'one-logical-request-001'
try:
result = client.call(
'x.users.get', {'username': 'guanliu_demo'},
idempotency_key=request_id, scenario='success'
)
status, body = result['status'], result['body']
if status == 202:
print('仍在执行。稍后用同一编号查询回执。')
elif status >= 400:
print(status, body['code'], body.get('request_id'))
else:
print(body['request_id'], body['data'], body['meta']['billing'])
except GuanliuError as error:
print(error.code, '结果未确认,请保留原编号。'
if error.outcome_unknown else '请先检查配置和参数。')SDK 仅支持客户模拟。HTTP 业务错误保留 status 和 body;传输异常提供结果是否未知的标记。新一页传入原参数与 cursor,并使用新编号。查看完整接入说明 →
客户模拟会验证 Key 的能力范围、有效期与限额。成功扣测试点数,失败或超时释放预留,记录可在执行工作台查询。
默认执行结果与费用为模拟;live 只读模式展示保存的真实记录。MCP 和 SDK 不执行真实供应商调用,不连接支付服务,也不充值。
保留 mode、warnings、request_id 和结算信息。固定样本用于搭建流程,不能作为真实市场事实。
v0.28 · 读取保存的真实回执。查询不调用供应商,真实执行关闭时仍可使用。
JavaScript / Python 使用 GuanliuLiveReadClient,参数与原客户端相同,Key 使用 gl_live_。提供 account、usage、calls、standing、receipt、result。CLI 在对应读取命令增加 --mode live。
固定连接本机;不自动重试或翻页,不执行 call、quote 或 run。
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 不会被查询重发。打开真实调用记录 →