🔐
上传前先看:我们怎么存你的持仓数据 — 加密保存,数据库里查不到明文。
免费试用 了解详情
Privora 泊睿

FOR AI AGENTS

AI Agent 怎么接入 Privora 泊睿

四条真实可用的通道,覆盖从「不注册就能试」到「自己写脚本直连」的全部场景。这里只写平台已经上线、能验证的能力——每条命令你都可以自己跑一遍。

这份指南是给谁看的

如果你是一个 AI agent(或者在给 agent 写接入代码),这里列出了 Privora 泊睿目前对外开放的全部四条接入方式,以及每条方式已知的安装步骤和常见错误。不确定选哪条,先看下面的对比表。

四条通道怎么选

四条通道都基于同一套底层能力(GET /agent/skills 与 POST /agent/skills/execute),差异只在协议形态与是否需要注册。

四条 agent 接入方式在认证要求、安装方式与适用场景上的对比
接入方式 要不要注册 怎么装 适合场景
ClawHub 官方 skill 包 需要 Privora 账号 + Bearer Token clawhub install privora-cn-quant 已经在用 ClawHub 生态客户端(Claude / OpenClaw 等)
MCP Server(stdio) 可选(不设 token 为匿名模式) npm install -g 官网 tarball Claude Code / Cursor / Windsurf / Cline / Codex CLI 等原生 MCP 客户端
Bearer Token + HTTP API 需要 Privora 账号 + Bearer Token curl 或任意 HTTP 客户端直连 REST 接口 自己写脚本或已有的 agent 框架,要求最大灵活度
匿名只读 不需要 无需安装,直接调公开端点 先验证平台能做什么,再决定要不要注册

分通道安装指南

四条通道装法不同,但最终都打到同一套 GET /agent/skills + POST /agent/skills/execute dispatcher 上。

ClawHub 官方 skill 包

  1. 先在 /login 注册账号,在「个人设置 → Token 管理」创建 Bearer Token
  2. 在支持 ClawHub 的客户端里执行 clawhub install privora-cn-quant(全量能力)或 clawhub install privora-alert(只要实时告警)
  3. 按插件提示配置 LG_AGENT_TOKENLG_AGENT_BASE_URL=https://privora.cn
  4. 直接用自然语言提问,例如「帮我查一下资产 21 最新的数据」

两个包共享同一套底层脚本,装哪个只影响 catalog 里能看到多少 skill,不影响调用方式。

MCP Server(stdio)

把同一套 GET /agent/skills / POST /agent/skills/execute 包装成原生 MCP tool,适配 Claude Code、Cursor、Windsurf、Cline、Codex CLI 等支持 stdio MCP 的客户端。

npm install -g https://privora.cn/downloads/privora-mcp-server-0.1.0.tgz
curl -fsSLO https://privora.cn/downloads/privora-mcp-server-0.1.0.tgz
curl -fsSLO https://privora.cn/downloads/privora-mcp-server-0.1.0.tgz.sha256
sha256sum -c privora-mcp-server-0.1.0.tgz.sha256
npm install -g ./privora-mcp-server-0.1.0.tgz
{
  "mcpServers": {
    "lg-agent": {
      "command": "lg-agent-mcp-server",
      "env": {
        "LG_AGENT_BASE_URL": "https://privora.cn",
        "LG_AGENT_TOKEN": "lgatk_your_token_here"
      }
    }
  }
}
LG_AGENT_BASE_URL 默认是 http://localhost:3000,网站安装的版本必须显式设成 https://privora.cn,否则每次调用都连不上。LG_AGENT_TOKEN 可选——不设则以匿名模式运行,能看到全部 11 个 tool,但能不能真正调用取决于匿名白名单。

固定 11 个 tool:4 个协议层 meta-tool(list_skills / describe_skill / execute_skill / whoami)+ 7 个一等公民 tool(dataasset_listdataasset_getdataasset_schema_getdataasset_metadata_getdataasset_data_getdataasset_data_get_realtimemarketplace_item_list)。

Bearer Token + HTTP API

最直接的一条通道:拿到 Token 后用任意 HTTP 客户端直接调 REST 接口,不需要装任何插件。

export LG_AGENT_TOKEN="lgatk_your_token_here"
export LG_AGENT_BASE_URL="https://privora.cn"

curl -s "$LG_AGENT_BASE_URL/agent/skills" \
  -H "Authorization: Bearer $LG_AGENT_TOKEN"

curl -s -X POST "$LG_AGENT_BASE_URL/agent/skills/execute" \
  -H "Authorization: Bearer $LG_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary '{"skillId":"dataasset.list","params":{}}'
不要手动加 X-Agent-Mode header——Node 代理层会根据你的 Bearer token 自动注入这个头,手工加反而可能导致请求被拒绝。

匿名只读

不用注册、不用 Token,直接调公开只读端点即可试用:固定放行 10 个只读 skill(资产列表、schema、市场条目等),按 IP 分三档限流。适合先摸清楚平台能做什么,再决定要不要注册。

curl -s "https://privora.cn/agent/skills"

新手常踩的坑

这些都是实测过的真实问题,不是假设。

1

订阅后资产会换 id

订阅市场条目后,你自己团队拿到的是新的克隆资产 id,不是市场页面上显示的发布方 id。每次调用前用订阅接口的返回结果重新确认,不要从截图或聊天记录里搬。

2

filter_op 默认是子串匹配

dataasset.data.getfilter_value 若省略 filter_op,默认按子串匹配(LIKE '%v%'),不是精确匹配;要精确请显式传 filter_op=eq

3

URL 里的 {id} 必须是数字

URL 路径里的 {id} 必须是数字资产 ID,传资产名称会 500 且报错信息不说明原因。

4

订阅市场条目要单独选一个预设

默认「读取行情 / 资产数据」预设已经包含元数据查询;如果还要订阅市场条目(拿 clonedAssetId),需要在创建 Token 时额外勾选「读取数据 + 管理市场订阅」预设。

5

paper.* 不用去申请

模拟交易执行相关的 paper.* scope 保留给平台内部,绑定策略时自动签发,创建 Token 页面根本不会显示这些勾选项,不用去找。

6

helper 脚本默认域名是旧的

agent-skill 自带的 shell helper 脚本默认把 LG_AGENT_BASE_URL 指向旧域名 lg-data.cc。旧域名仍会重定向到 privora.cn,但建议显式设置以避免多一次跳转。

7

发现 skill 用 /agent/skills

发现可用 skill 请用 GET /agent/skills,不要用 /api/public/agent/capabilities——后者是精简的公开视图,会漏掉整个模拟交易能力面。

8

不要手动加 X-Agent-Mode

Node 代理层会根据你的 Bearer token 自动注入 X-Agent-Mode header,手工加反而可能导致请求被拒绝。

9

Windows 下 curl 非 ASCII 会被改坏

Windows Git Bash 下 curl -d '中文内容' 会静默改坏非 ASCII 字符,改用 --data-binary @file

常见问题

不注册能不能用?
可以。匿名模式下可以直接调 10 个只读 skill,包括资产列表、schema、市场条目查询等,按 IP 限流;查询实时行情、跑流程、写持仓等需要注册后创建 Bearer Token。
ClawHub skill 包和 MCP Server 有什么区别?
两者最终都调用同一套 GET /agent/skills / POST /agent/skills/execute dispatcher,区别只在协议形态:ClawHub skill 包面向 ClawHub 生态客户端,MCP Server 面向原生支持 stdio MCP 的客户端(Claude Code / Cursor / Windsurf / Cline / Codex CLI)。装哪个取决于你在用什么客户端,功能上没有优劣之分。
创建 Token 时该选哪个 scope 预设?
默认「读取行情 / 资产数据」预设已经包含元数据查询;如果还要订阅市场条目,需要额外选择「读取数据 + 管理市场订阅」预设。模拟交易执行相关的 paper.* scope 不会出现在创建页,由平台在绑定策略时自动签发。
为什么调用返回 404,或者读到了别人的数据?
多半是资产 id 用错了。订阅市场条目后,你自己团队拿到的是新的克隆资产 id,不是市场页面上显示的发布方 id。每次调用前用订阅接口的返回结果重新确认 id。
MCP Server 能不能从 npm registry 直接装?
暂时不能,@privora/mcp-server 还没有发布到 npm registry。请用官网下载的方式安装:npm install -g <tarball URL>
调用一直连不上是什么原因?
十有八九是没设 LG_AGENT_BASE_URL。它默认指向 http://localhost:3000,网站安装的 MCP Server 或本地脚本必须显式设成 https://privora.cn

现在就试一次

不想注册?先用匿名只读端点跑一次 GET /agent/skills 看看能拿到什么;准备好了,创建 Token 就能解锁全部能力。