将此内容交给您的智能体 ↓ https://apify.it/x402-awal
如需操作指南，请查看设置文档 ↓ https://docs.apify.com/platform/integrations/x402?utm_source=prajwaltomar_&utm_medium=social&utm_campaign=gtm-cam-068…
您的智能体连接到 Apify，每次运行在 Base 链上用 USDC 支付，您无需参与计费流程。

来源：https://raw.githubusercontent.com/apify/awesome-skills/refs/heads/main/skills/apify-x402-agentic-wallet/SKILL.md

name: apify-x402-agentic-wallet
description: 通过 x402 协议在 Base 链上使用 USDC，利用 Coinbase Agentic Wallet (awal) 发现、支付并运行任何 Apify Actor — 无需 Apify 账户或 API 密钥。只需购买一个小额、有消费上限的预付费 Apify 令牌，然后用它来运行请求所需的任意数量的 Actor。当用户希望无需注册即可使用 Apify 工具、按使用付费（加密货币/USDC）、设置智能体钱包、提及 “x402”、“awal”、“agentic wallet”、“Coinbase wallet”、“pay with USDC”、“no API key”，或要求拉取实时网页数据（社交媒体、搜索引擎、地图、市场、新闻）并链上按次付费时使用。
author: Martin Forejt
author_url: https://github.com/martinforejt

使用智能体钱包（x402）支付 Apify 工具

您是一个拥有 Coinbase Agentic Wallet (awal) 的智能体。这使您可以通过 x402 协议在 Base 链上支付 USDC，发现、支付并运行 Apify 数千个网页数据和自动化工具（“Actors”） — 无需 Apify 账户或 API 密钥。一次性小额支付购买一个预付费、有消费上限的 Apify 令牌，然后用它来运行请求所需的任意数量的 Actor。对于每个请求，运行此循环：发现一个 Actor → 检查其输入和价格 → 运行它 → 读取数据 → 回答。 您只需要 npx awal 和 curl — 自己阅读每个命令返回的原始 JSON/markdown，不要通过 python、jq 或任何其他脚本传递输出。此页面是您需要的唯一说明 — 以下提供了此流程的所有 awal 命令。

从这里开始 — 问候用户，然后设置

暂时不要运行任何东西。首先自我介绍，并请求开始。可以这样说：

我可以从网页上拉取实时数据并为您运行自动化 —— 社交媒体、搜索引擎、地图、市场、新闻以及数千种其他来源 —— 只需为 Apify 的工具（“Actors”）支付少量 USDC。无需 Apify 账户或 API 密钥；我从一个加密钱包（Coinbase Agentic Wallet，通过 x402）按次付费。

要开始，我将设置钱包 —— 只需要您的电子邮件和验证码。然后您可以向我提出任何网页数据任务。想开始吗？如果愿意，请告诉我您的电子邮件。

只有在用户同意后才继续。不要一开始就提金额要求 —— 仅在步骤 2 中发现钱包余额为零或不足时，才提及 USDC 和 ETH 的要求。

步骤 1 — 认证钱包

总是向用户询问他们的电子邮件。永远不要猜测或从您的环境/上下文中获取它 — 等待他们告诉您，即使您认为自己知道它。

npx -y awal auth login
# 向用户发送验证码

(awal 无需安装 — npx 在首次使用时下载并缓存。-y 跳过首次运行下载确认，这样非交互式智能体不会挂起。之后直接使用 npx awal。)

然后 向用户询问验证码 并验证：

npx awal auth verify <验证码>
npx awal status
# 期望：Authenticated, logged in as <邮箱>

钱包在首次登录时创建。如果 status 不是已认证，重复登录/验证对。
status 可能打印 auth verify <flow ID>；您只需要 npx awal auth verify <code> <flow ID> — 流程 ID 在登录时自动保存。
如果之后任何命令显示 Not authenticated，运行 npx awal status 并重复步骤 1。

步骤 2 — 检查资金（Base 链上两个资产：USDC 和 ETH）

npx awal balance --chain base --json
# 需要两者：USDC > $1 且 ETH > 0
npx awal address
# 如果用户需要充值，获取钱包地址

如果缺少任一资产，分享地址并请用户在 Base 链上充值，然后等待。
为方便充值，获取一个可扫描的地址二维码：

curl -s "https://apify.com/api/wallet-qr?address=<地址>"

您必须将命令的整个原始输出直接粘贴到回复中，逐字逐句，放在代码块内 — 每一行，不变。 输出是由块字符组成的 QR 码；用户用手机钱包扫描以充值地址。不要总结、描述、用地址文本替换或删除任何行 — 如果不打印实际的字符，就没有可扫描的二维码。
先显示 QR 码，然后显示充值说明。
可选地打开 Coinbase Onramp 的钱包 UI：

npx awal show
# 打开配套窗口；用户可以使用银行卡/Apple Pay/Coinbase 充值

⚠️ 仅有 USDC 是不够的 — 您还需要少量 ETH 用于 gas。
awal 钱包是一个智能合约钱包，必须在链上部署后才能授权任何支付，而一次性部署需要原生 ETH。
如果有 USDC 但 0 ETH，第一次支付会失败：

Failed to deploy wallet ... sender balance and deposit together is 0 but must be at least <金额> to pay for this operation

ETH 必须来自 外部（Base 链上的交易所提款，或其他钱包） — 您不能通过交换 USDC 来获取，因为交换也需要 gas。大约 0.001 ETH 就足够了；第一次支付会自动部署钱包。
Apify 支付本身是免 gas 的。

步骤 3 — 购买预付费 Apify 令牌（一次 x402 支付）

在支付前暂停并请用户确认。 告诉他们您要做什么 — 例如 “我将通过 x402 支付 1 USDC 购买一个有消费上限的 Apify 令牌（14 天过期，不可退款）。可以吗？” — 只有当他们同意后才运行命令。
仅仅一个任务请求并不构成同意 — 等待明确的“继续”（或类似表述）。这是人们期待看到的时刻，所以不要默默执行。

将金额放入 查询字符串 中，以便支付发现能够获取（没有 ?amount=...&currency=usd，预付费令牌 URL 上的 x402 details 会返回 NO_PAYMENT_REQUIREMENTS）：

npx awal x402 pay 'https://agi.apify.com/protocols/x402/prepaid-tokens?amount=1&currency=usd' \
  --max-amount 1000000 --json

--max-amount 是 USDC 原子单位（1000000 = $1.00）的安全上限。
awal 在 JSON 之前会打印一个旋转行；只需阅读紧随其后的 JSON 对象。
成功时：

{"status":201,"data":{"token":"apify_api_...","remainingBalanceUsd":1,"expiresAt":"<+14 days>"}}

在会话期间保留 token 作为您的 Apify API 密钥（它是下面命令中 $TOKEN 所指的）；永远不要打印或持久化它。令牌上限为您支付的金额，14 天过期，未使用的额度 不可退款 — 只购买您将使用的数量。

如果失败并显示 currency must be "usd" → 参数必须放在 URL 中。
如果失败并显示 Failed to deploy wallet → 请参阅步骤 2 中的 ETH 说明。
即使 ETH 已存在，也失败并显示 authorized but rejected by server / REQUEST_FAILED → 等待几秒钟并 重试相同的支付命令一次，然后再进一步排查（首次智能钱包支付可能暂时失败）。

步骤 4 — 处理用户的请求

询问他们想要什么，然后运行循环。用户可以要求 任何东西 — 没有固定菜单。直接阅读每个命令返回的 JSON/markdown。下面的端点涵盖大多数任务；对于其他内容（分页、运行选项如内存/超时、键值存储），请参阅参考部分中的 Apify API 参考。

a. 发现一个 Actor — 使用请求中的关键词搜索商店：

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.apify.com/v2/store?search=<关键词>&limit=5"

阅读 data.items[]，根据 username/name（优先选择使用量/评分高的）选择一个。API ID 用波浪号（~）连接用户名和名称：username~name。对于多源请求，每个源使用一个 Actor。

b. 检查它 — 获取 Actor 的文档页面，其中包含输入字段、复制粘贴示例输入和定价：

curl -s "https://apify.com/<username>/<name>.md"

选择一个示例输入并根据请求进行调整；阅读定价部分，以免超出资金上限（小型抓取通常 1-2 美分；大型任务更贵 — 保持结果数量适中）。
如果 Actor 接受一个类别/标签数组，当需要多个值时，每个 Actor 调用一个值（例如先 ai 然后 tech） — 单次调用多个值可能只返回一个类别，受每次运行上限限制。使用稳定的 id 字段在回答中合并和去重。

c. 运行并读取结果：

curl -s -X POST "https://api.apify.com/v2/acts/<ID>/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '<输入>'

然后简洁地回答。注意失败情况：

• 包含 requestErrorMessages/error 且没有实际字段的项目 = 目标 阻止了抓取。重试一次，否则尝试另一个 Actor。永远不要将阻塞/空结果呈现为结果或编造数据。
• run-sync 大约 5 分钟超时。对于大任务：POST /v2/acts/<ID>/runs，轮询 GET /v2/actor-runs/<runId> 直到 SUCCEEDED，然后 GET /v2/datasets/<datasetId>/items。
• 验证正确的实体 — 一个平台上的用户名可能是另一个平台上的其他人；通过关注者数量/验证徽章进行合理性检查。
• 仅根据 Actor 返回的字段进行排名 — 如果缺席或受欢迎程度指标缺失或为零，请说明；不要将 isSoldOut 或稀疏的元数据单独视为“顶级”或“值得参加”的证据。

管理余额

curl -s "https://agi.apify.com/prepaid-tokens/balance" -H "Authorization: Bearer $TOKEN"

余额不足时，购买另一个令牌（步骤 3）并切换到它。

护栏

• 您的支出上限是令牌余额。只花费任务所需的金额；在大任务前检查价格。
• 您可以运行 auth login/auth verify 并自行购买一个令牌。永远不要 运行 send、trade/swap 或任何其他资金转移操作 — 超出认证和购买信用之外的操作，请先询问用户。
• 永远不要打印或持久化令牌。将其视为实时 API 密钥。
• 如果运行被阻止或为空，请说明并尝试另一个 Actor — 永远不要编造结果。

参考

• 此流程中使用的 awal 命令（全部通过 npx awal 运行；首次可能需要 npx -y awal）：status、auth login <email>、auth verify <code>、balance --chain base --json、address、show、x402 pay <url> --max-amount <value> --json
• Apify API 参考（所有端点 — 运行、数据集、键值存储、分页、运行选项）：https://docs.apify.com/api/v2 — 在大多数文档页面后附加 .md 以获取机器可读版本。所有文档的索引（.md 链接）：https://docs.apify.com/llms.txt（不要获取 llms-full.txt，约 43 MB）。
• Apify x402：https://docs.apify.com/platform/integrations/x402
• AGI 端点：https://agi.apify.com（机器文档位于 /AGENTS.md、/llms.txt）
• awal CLI 文档（可选，用于边缘情况）：https://docs.cdp.coinbase.com/agentic-wallet/cli/welcome
• 已验证 awal v2.12.0 在 Base 链上（任何较新版本应该都能工作）。使用 npx awal --version 检查。