AgentCash 用于调用受 x402 保护的付费 API,采用钱包自动认证与按次支付,无需 API 密钥或订阅。
用途:让代理或开发者以命令行方式访问各类付费数据与能力服务,按请求结算,失败请求(非 2xx)不收费。
主要能力:
- 钱包管理:npx agentcash@latest balance 查余额;npx agentcash@latest accounts 获取充值地址与链接;npx agentcash@latest redeem <code> 兑换邀请码;npx agentcash@latest fund 打开引导充值流程。
- 服务发现:npx agentcash@latest search "<自然语言查询>" 搜索服务;npx agentcash@latest discover <origin> 查看某服务的端点、价格与参数;npx agentcash@latest check <endpoint-url> 查看请求/响应结构与定价。
- 发起请求:npx agentcash@latest fetch <url> -m POST -b '{"key": "value"}' 或 GET 形式;fetch-auth 为已弃用别名,建议统一用 fetch。
- 持久化:npx agentcash@latest add <origin> 将端点保存为技能。
使用方式:先查余额,若为 0 则充值或兑换邀请码;优先在已知服务表中匹配 origin,匹配则跳过 search 直接 discover;阅读输出中的 instructions 字段,注意端点路径含提供方前缀;跨多请求时保持同一 --payment-network。
适用场景:人物/公司信息查询、图像视频生成、社媒数据、邮件发送、文件与静态站点托管、电话与消息、职位搜索、航班与旅行数据、云端浏览器自动化等。
限制:需钱包与 USDC 余额;视频生成等操作单次可能花费 1-3 美元,调用前应确认余额;支付网络需与端点要求或用户资金所在网络一致;邀请码无效通常表示已使用或不存在;余额未更新需等待网络确认。具体服务与价格以 discover 输出为准。