Skip to content

docs(x402): add AgentScrape as real-world example service #1249

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
hshintelligence wants to merge 1 commit into
base: main
Choose a base branch
from
+21 −2
Open

docs(x402): add AgentScrape as real-world example service #1249

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 21 additions & 2 deletions typescript/agentkit/src/action-providers/x402/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,7 @@ import { x402ActionProvider, X402Config } from "@coinbase/cdp-agentkit";
const config: X402Config = {
// Service URLs the agent can call (whitelist)
registeredServices: [
"https://api.example.com",
"https://weather.x402.io"
"https://agent-scrape.healingsunhaven.workers.dev"
],

// Allow agent to register new services at runtime
Expand Down Expand Up @@ -338,6 +337,26 @@ The following environment variables can be used to configure the provider:

Configuration object values take precedence over environment variables.

## Real-World Example Services

The x402 ecosystem includes live, production agent-native services you can use as references when learning the protocol. The following service implements the full x402 v2 specification on Base mainnet and serves as a useful reference for AgentKit users:

- **[AgentScrape](https://agent-scrape.healingsunhaven.workers.dev)** — Pay-per-call web scraping for AI agents. Six tools (scrape, extract, screenshot, metadata, session, workflow). MIT licensed open source. Live on Base mainnet with a 10-call free tier per wallet.
- x402 manifest: `https://agent-scrape.healingsunhaven.workers.dev/.well-known/x402.json`
- A2A Agent Card: `https://agent-scrape.healingsunhaven.workers.dev/.well-known/agent.json`
- Source: https://github.com/hshintelligence/agent-scrape

To call it from AgentKit:

```typescript
const provider = x402ActionProvider({
registeredServices: [
"https://agent-scrape.healingsunhaven.workers.dev"
],
maxPaymentUsdc: 0.01,
});
```

### Additional Resources

For more information on the **x402 protocol**, visit the [x402 documentation](https://docs.cdp.coinbase.com/x402/overview).
Loading