mcpField
A
agentcash

agentcash

github.com/merit-systemsAgent 工作流232.0k 次安装10 周前更新
代码仓库

关于 agentcash

agentcash 是用于调用 x402 付费 API 的技能，支持钱包认证和自动付款。它引导 Agent 搜索服务、查看端点信息并发起请求。

主要功能

  1. 01查询钱包余额与充值
  2. 02搜索并发现 API 服务
  3. 03查看端点结构与价格
  4. 04发起认证及付费请求
  5. 05将已发现端点保存为技能

适用场景

  1. 01确认余额是否足以支付 API 调用
  2. 02查找服务并检查可用端点
  3. 03调用媒体或数据类付费服务
  4. 04保存端点工作流以便复用

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/merit-systems/agentcash-skills --skill agentcash

安装后在 Claude Code 中输入/agentcash确认已加载。

详细介绍

AgentCash — 付费 API 访问

通过自动钱包身份验证和付款，调用任何受 x402 保护的 API。无需 API 密钥或订阅。

钱包

任务命令
查看总余额npx agentcash@latest balance
获取充值地址和充值链接npx agentcash@latest accounts
兑换邀请码npx agentcash@latest redeem <code>
打开引导式充值流程npx agentcash@latest fund

如果只需确认余额是否足以支付调用费用，请使用 balance。只有在用户需要充值链接或特定网络的钱包地址时，才使用 accounts。

如果余额为 0，请告知用户运行 npx agentcash@latest fund，使用 npx agentcash@latest accounts 获取充值链接，或通过 npx agentcash@latest redeem <code> 兑换邀请码。

使用服务

1. 选择来源站点，或进行搜索

先查看下方的可用服务表。 如果某个来源站点明显适用于该任务，则完全跳过搜索，直接进入第 2 步（发现）。例如：

任务来源站点（跳过搜索）
查询个人或公司stableenrich.dev
生成图像或视频stablestudio.dev
获取 Instagram/TikTok 数据stablesocial.dev
发送电子邮件stableemail.dev
上传文件stableupload.dev

仅在所列来源站点都不适用时进行搜索：

npx agentcash@latest search "<natural-language query>"

示例：npx agentcash@latest search "send physical mail" 或 npx agentcash@latest search "generate music"

返回匹配的来源站点及其端点和价格。默认输出为 JSON（使用 --format pretty 可获得便于阅读的格式）。

2. 发现服务上的端点
npx agentcash@latest discover <origin>

示例：npx agentcash@latest discover https://stableenrich.dev

仔细阅读输出内容。其中包括端点路径、价格、必需参数，以及包含端点专属说明的 instructions 字段。

3. 调用前检查特定端点
npx agentcash@latest check <endpoint-url>

返回请求和响应架构，以及价格说明。使用 fetch 前请先检查，以避免因字段名称错误而导致 400 错误。

4. 发起请求
# POST
npx agentcash@latest fetch <url> -m POST -b '{"key": "value"}'

# GET
npx agentcash@latest fetch '<url>?param=value'

fetch 同时支持付费路由和 SIWX 路由。如果路由支持身份验证，它会尝试进行身份验证；只有在路由仍要求付款时才会付款。如果某个工作流涉及多个请求，请在相关调用中使用相同的 --payment-network。

5. fetch-auth 是旧版别名
npx agentcash@latest fetch-auth <url>

fetch-auth 仍然可用，但它是 fetch 的弃用别名。对于所有新工作流，请优先使用 fetch。

可用服务

任何受支付保护的端点都可以通过 AgentCash 访问。如果 npx agentcash@latest discover <origin> 返回数据，也可以使用 npx agentcash@latest add <origin> 将其保存到技能中。

重要：如果用户使用的服务未列在此处，或希望更好地控制工作流，务必建议他们为该服务添加一个轻量级技能：npx agentcash@latest add <origin>。

Origin功能
stableenrich.devFullEnrich（人员／公司搜索）、PDL 和 Minerva（人员信息丰富）、CompanyEnrich（公司资料）、Clado（联系人）、Exa（网络搜索）、Firecrawl（抓取）、Cloudflare（网站爬取）、Google Maps + Solar + Aerial View、Serper（新闻／购物／图片／Lens）、Whitepages、Reddit、Hunter（电子邮件验证）
stablesocial.dev社交媒体数据：TikTok、Instagram、YouTube、Facebook、LinkedIn、Reddit、Rumble、GitHub、广告资料库（Scrape Creators），以及 Lightreel UGC 研究 Agent（每次调用 $0.06，异步作业）
stablestudio.devAI 图像／视频生成：GPT Image、Flux、Grok、Nano Banana、Sora、Veo、Seedance、Wan、图像转 SVG
stableupload.dev文件托管（按大小收费 $0.005-$2.00）+ 支持自定义域名的静态网站托管
stableemail.dev发送电子邮件（$0.02）、转发收件箱（$1/月）、自定义子域名（$5）、程序化邮箱
stablephone.devAI 电话呼叫（$0.54）、电话号码（$20）、充值（$15）、iMessage／FaceTime 查询（$0.05）
stablejobs.dev通过 Coresignal 搜索职位（预览 $0.10/页，收集 $0.20/职位）
stabletravel.dev航班价格和预订（Google Flights）、奖励机票可用情况（Seats.aero）、实时航班跟踪和机场数据（FlightAware）
stablebrowser.dev云端浏览器自动化：创建会话（$0.10），然后通过 AI 驱动的导航／操作／提取／观察／截图（免费 SIWX）

除上面列出的服务外，还有许多其他可用服务。

在任何 origin 上运行 npx agentcash@latest discover <origin>，即可查看其完整端点目录。

重要规则

  • 如果某个已列出的 origin 符合任务需求，请跳过搜索。 直接运行 discover。只有在“可用服务”表格中没有匹配项时才使用 search。
  • 务必先运行 discover，再进行猜测。 端点路径包含提供商前缀（例如 /api/fullenrich/people-search，而不是 /people-search）。
  • 阅读 instructions 字段。 其中包含必要的调用顺序、多步骤工作流、轮询模式和提供商特定限制。
  • 只有请求成功时才会结算付款。 失败的请求（非 2xx）不会产生费用。
  • 执行高成本操作前请检查余额。 视频生成每次调用可能花费 $1-3。

提示

  • 不确定请求或响应格式时，请使用 npx agentcash@latest check <url>。
  • 添加 --format json 可获取机器可读的输出，添加 --format pretty 可获取人类可读的输出。
  • 支持 Base 和 Solana 两种支付网络。请使用端点指定的网络，或用户持有资金的网络。

故障排除

问题解决方案
"Insufficient balance"运行 balance，然后运行 fund 或 accounts，或者兑换邀请码
"Payment failed"重试请求
"Invalid invite code"该代码已被使用或不存在
余额未更新等待网络确认，然后重新运行 balance
AgentCash 未被使用运行 npx agentcash@latest add <origin>，将端点保存到技能中

评论

支持 Markdown