SuperAPI AI 工具集

bitrefill-cli

设计与创作

查看项目

更新于 10-15 20:06

技能介绍

用途:通过 Bitrefill CLI 搜索、购买并交付数字商品(礼品卡、手机充值、eSIM)。需 Bitrefill 账号,认证用 API key 或 OAuth;另需加密钱包用于发送加密货币或向 x402 端点(Base 上的 USDC)付款,钱包和用于在品牌网站兑换代码的浏览器 MCP/CLI 均不由本技能提供。

主要能力:核心流程为 search-products → get-product-details → buy-products → get-invoice-by-id 或 list-orders。搜索时 --country 必须为大写 ISO Alpha-2(如 US、IT),--product_type 取 giftcard 或 esim;用 --query "*" 可发现分类 slug 并作为 --category。详情返回 packages 数组,package_value 作为 buy-products 的 package_id,忽略 <&> 复合键,只取其后值;面额有数字、时长、命名三类,命名或时长必须精确且区分大小写。buy-products 的 --cart_items 必须是 JSON 数组,单次最多 15 项。

使用方式:安装 npm install -g @bitrefill/cli;源码安装 git clone https://github.com/bitrefill/cli.git && cd cli && pnpm install && pnpm build && npm link。设置 export BITREFILL_API_KEY=YOUR_API_KEY,或不带 key 运行命令触发浏览器 OAuth,令牌存于 ~/.config/bitrefill-cli/api.bitrefill.com.json,可用 bitrefill logout 清除。支付中 balance(余额)即时交付,usdc_base 配合 x402 可让具备 x402 能力的智能体自主完成支付,其他加密货币需轮询发票状态。

适用场景与限制:适合自动化购买与交付。本技能不是钱包,不负责存储私钥或管理加密钱包。购买涉及真实资金,默认购买前确认产品、面额、价格与支付方式;仅当用户明确同意时才可自主购买。礼品卡代码类似现金,应安全存储、优先加密或内存存储,不公开分享。数字商品交付后退款受限,仅在其无法使用时可能退款,按欧盟消费者权益不适用 14 天反悔。建议使用专用低余额账户,记录每笔购买。品牌网站的反机器人机制可能阻止兑换,此时应询问用户是否手动完成。详情见 https://www.bitrefill.com/terms/。