订阅后资产会换 id
订阅市场条目后,你自己团队拿到的是新的克隆资产 id,不是市场页面上显示的发布方 id。每次调用前用订阅接口的返回结果重新确认,不要从截图或聊天记录里搬。
FOR AI AGENTS
四条真实可用的通道,覆盖从「不注册就能试」到「自己写脚本直连」的全部场景。这里只写平台已经上线、能验证的能力——每条命令你都可以自己跑一遍。
如果你是一个 AI agent(或者在给 agent 写接入代码),这里列出了 Privora 泊睿目前对外开放的全部四条接入方式,以及每条方式已知的安装步骤和常见错误。不确定选哪条,先看下面的对比表。
四条通道都基于同一套底层能力(GET /agent/skills 与 POST /agent/skills/execute),差异只在协议形态与是否需要注册。
| 接入方式 | 要不要注册 | 怎么装 | 适合场景 |
|---|---|---|---|
| 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 install privora-cn-quant(全量能力)或 clawhub install privora-alert(只要实时告警)LG_AGENT_TOKEN 和 LG_AGENT_BASE_URL=https://privora.cn两个包共享同一套底层脚本,装哪个只影响 catalog 里能看到多少 skill,不影响调用方式。
把同一套 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_list、dataasset_get、dataasset_schema_get、dataasset_metadata_get、dataasset_data_get、dataasset_data_get_realtime、marketplace_item_list)。
最直接的一条通道:拿到 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"
这些都是实测过的真实问题,不是假设。
订阅市场条目后,你自己团队拿到的是新的克隆资产 id,不是市场页面上显示的发布方 id。每次调用前用订阅接口的返回结果重新确认,不要从截图或聊天记录里搬。
dataasset.data.get 的 filter_value 若省略 filter_op,默认按子串匹配(LIKE '%v%'),不是精确匹配;要精确请显式传 filter_op=eq。
URL 路径里的 {id} 必须是数字资产 ID,传资产名称会 500 且报错信息不说明原因。
默认「读取行情 / 资产数据」预设已经包含元数据查询;如果还要订阅市场条目(拿 clonedAssetId),需要在创建 Token 时额外勾选「读取数据 + 管理市场订阅」预设。
模拟交易执行相关的 paper.* scope 保留给平台内部,绑定策略时自动签发,创建 Token 页面根本不会显示这些勾选项,不用去找。
agent-skill 自带的 shell helper 脚本默认把 LG_AGENT_BASE_URL 指向旧域名 lg-data.cc。旧域名仍会重定向到 privora.cn,但建议显式设置以避免多一次跳转。
发现可用 skill 请用 GET /agent/skills,不要用 /api/public/agent/capabilities——后者是精简的公开视图,会漏掉整个模拟交易能力面。
Node 代理层会根据你的 Bearer token 自动注入 X-Agent-Mode header,手工加反而可能导致请求被拒绝。
Windows Git Bash 下 curl -d '中文内容' 会静默改坏非 ASCII 字符,改用 --data-binary @file。
paper.* scope 不会出现在创建页,由平台在绑定策略时自动签发。@privora/mcp-server 还没有发布到 npm registry。请用官网下载的方式安装:npm install -g <tarball URL>。LG_AGENT_BASE_URL。它默认指向 http://localhost:3000,网站安装的 MCP Server 或本地脚本必须显式设成 https://privora.cn。