BUYER TOOLKIT · CLI + MCP
安装一次，
让 AI 调用付费服务。
bizX402 Buyer Toolkit 把服务发现、报价、x402 付款和结果查询变成稳定的 CLI 与 MCP 工具。AI 可以完成流程编排，私钥和每次付费决定仍留在你的设备上。
AUTO DETECT 安装器自动识别 macOS / Linux 与 arm64 / amd64；Windows 当前未支持。
AI HANDOFF
把这一句话交给 AI
下面的入口是纯 Markdown，没有页面导航和视觉内容。ChatGPT、千问、豆包或本地 Agent 可以直接读取，并按安全约束完成安装与调用准备。
请读取 https://402demo.smallfishpte.com/service-cli-ai.txt，按文档安装并验证 bizX402 Buyer Toolkit。先执行只读的 doctor、services search、describe 和 quote。不得索取、读取、记录或传输我的私钥；需要导入 signer 时停下来让我本人在可信终端操作。任何付费调用前，向我展示 serviceRef、network、amountAtomic 和 maxAmountAtomic，并等待我确认。AI 可以安装和编排。AI 不应接触私钥，也不能替你批准支出。
INSTALL
下载、检查、安装
支持 macOS 与 Linux 的 arm64 / amd64。安装器会选择当前平台的发行包并验证 SHA-256；不要使用未经检查的 curl | sh。
DIRECT DOWNLOAD
选择你的系统
每个发行包都包含 bizx402 CLI 和 bizx402-mcp。Windows 当前未支持。
curl -fsS https://demo-api-1.smallfishpte.com/downloads/bizx402/install.sh \
-o /tmp/bizx402-install.sh
sed -n '1,240p' /tmp/bizx402-install.sh
sh /tmp/bizx402-install.sh
export PATH="$HOME/.local/bin:$PATH"
bizx402 version
bizx402 doctor安装后得到 bizx402 与 bizx402-mcp。若希望永久加入 PATH，请把 export 行写入你自己的 Shell 配置。
DISCOVER + QUOTE
先读目录，再决定调用
产品版本会变化。AI 应先搜索并使用返回的最新 serviceRef，再读取输入要求和实时报价，不应把示例版本永久写死。
bizx402 services search 图片安全
bizx402 services describe image-guard-security-scan@3
bizx402 quote image-guard-security-scan@3当前 Demo 报价为 Base Sepolia 上的 10000 atomic USDC，即 0.01 USDC；调用前仍以现场 quote 和 x402 challenge 为准。
SIGNER + PAYMENT
私钥不交给 AI
请由你本人在可信交互终端导入 EVM 私钥。输入会隐藏，并只写入操作系统 Keychain；CLI 参数、JSON、环境变量、MCP 配置和日志均不接受私钥。
bizx402 signer import
bizx402 signer status- 签名地址持有足够的 Base Sepolia 测试 USDC。
- 核对 serviceRef、网络、Token、收款地址和 amountAtomic。
- 设置 maxAmountAtomic 作为硬上限，并保留终端确认。
PAID CALL
调用图片安全检查
把示例路径替换为本机 JPEG 或 PNG。当前产品最大 8 MiB。命令先再次读取报价，再由你确认支付。
bizx402 call image-guard-security-scan@3 \
--file file=./sample.png \
--max-amount-atomic 10000
# 从返回结果读取 response.id，再查询异步状态
curl -fsS https://tools.smallfishpte.com/v1/images/<response.id>这是文件安全扫描，不是 OCR。当返回中的 terminal=true 时任务结束；只有 CLEAN 结果才应继续下载或使用原始内容。
MCP
让 Agent 直接调用
先用 command -v bizx402-mcp 找到绝对路径，再把下面配置加入支持 MCP stdio 的客户端。把 file-root 限制到允许 Agent 读取的图片目录。
{
"mcpServers": {
"bizx402": {
"command": "/absolute/path/to/bizx402-mcp",
"args": ["--file-root", "/absolute/path/to/approved-images"],
"env": {
"BIZX402_BASE_URL": "https://demo-api-1.smallfishpte.com",
"BIZX402_PROFILE": "default"
}
}
}
}search_servicesdescribe_servicequote_servicecall_serviceget_order
MCP 配置里绝对不要放私钥。Agent 发起 call_service 前，应先展示报价和支出上限，并获得你的明确批准。
CURRENT BOUNDARIES
当前可用范围
- 已支持目录搜索、产品描述、报价、EXACT 付费调用、订单查询、本地 Keychain Signer、stdio MCP。
- 尚未支持CLI 的 BATCH 充值通道、远程 MCP、硬件钱包/KMS、Image Guard 通用自动轮询。
- Demo 网络Base Sepolia 测试 USDC；不要向 Demo 签名地址转入主网资产。