PayCrawl

How a paid request works

A publisher protects and prices a machine-readable route. An agent discovers the quote, applies its local policy, and pays only when the quote is approved. There is no reader checkout and PayCrawl does not custody either wallet.

1. 01

   Send a request to the protected route.

2. 02

   Read the 402 Payment Required response.

3. 03

   Validate the price, asset, network, and payout address.

4. 04

   Sign the payment with the persistent agent wallet.

5. 05

   Retry with PAYMENT-SIGNATURE.

6. 06

   Read the content and PAYMENT-RESPONSE receipt.

Give the agent a limit. It handles the payment flow.

Install the skill

Add the PayCrawl workflow skill to the agent project. It handles discovery, quote validation, wallet setup, payment, and receipt handling.

npx skills add Some1Uknow/paycrawl --skill paycrawl --agent '*' --yes --full-depth

Approve a publisher once

Set a per-request ceiling, a total budget, and a request limit. For an unknown publisher, the agent shows the origin, payout address, and price before it pays. After approval, it keeps that origin and payout pair in its local policy. A changed payout address requires approval again.

Fund only when asked

On macOS, the agent creates its encrypted dedicated Celo wallet and Keychain secret on the first request. It reuses that wallet later. If an approved request needs funds, it gives you one wallet address and a bounded Celo USDC amount. Do not paste a private key or send USDC directly to a publisher.

Ask the agent

Use PayCrawl to crawl https://paycrawl-gateway.raghu250407.workers.dev/agent/page/article-1.
Use only Celo USDC. Ask me before approving a new publisher. Do not spend
more than 0.001 USDC on this request or 0.01 USDC in total. Return the
content and PAYMENT-RESPONSE receipt.

Protect the origin. Set the price.

Publisher deployment is self-hosted. You keep control of the origin, payout wallet, route policy, and Cloudflare account.

Requirements

• An HTTPS origin for the protected content.
• An origin token that blocks direct access.
• A Celo wallet address for USDC payments.
• A Cloudflare account for the Worker resources.

Publish a paid route

Lock the origin with its token. Create the Worker resources, then add the origin, payout address, and route prices as secrets. Each configured /agent/* route then returns its payment quote automatically.

Public endpoints

Current scope

• Publisher deployment requires a Cloudflare account.
• An agent wallet needs Celo USDC before its first payment.
• The website does not hold wallet keys or funds.