오늘 AI 에이전트가 API를 호출해야 할 때, 그들은 벽에 부딪힙니다. 가입하세요. 키를 받으세요. 회전을 관리하세요. 요청 한도를 만납니다. 실제 사용과 일치하지 않는 구독료를 지불하세요.
그 모델은 사람들이 대시보드를 클릭하는 것을 위해 만들어졌습니다. 에이전트에게는 적합하지 않습니다.
우리는 최근에 AgentScrape를 출시했습니다. — AI 에이전트용 지불당 호출 웹 스크래핑 API로, x402 결제 프로토콜을 사용합니다. 각 호출당 Base 메인넷에서 0.001 USDC를 지불합니다. 가입이 없습니다. API 키가 없습니다. 에이전트는 요청당 지불하고 데이터를 받습니다.
이 포스트는 x402가 어떻게 작동하는지, 우리가 만든 것, 그리고 지금 바로 AgentScrape를 에이전트에 연결하는 방법에 대해 다루고 있습니다.
AI 에이전트용 API 키의 문제점
API 키는 정적인 세계를 위해 설계되었습니다: 하나의 개발자, 하나의 제품, 하나의 청구. 에이전트는 모든 세 가지 가정을 깨뜨립니다.
하나의 LangChain 에이전트가 한 작업을 위해 30개 이상의 다른 API를 호출할 수 있습니다. 각 API는 자신만의 키, 자신만의 인증 흐름, 자신만의 구독 등급을 원합니다. 개발자는 에이전트가 필요로 할 API를 예측해야 하며, 각각에 대해 가입하고 회전 로직을 구성해야 합니다.
결과는 에이전트가 유용한 작업을 할 수 없는 수많은 글루 코드가 되고 있습니다. 더 나아가, 에이전트는 개발자가 미리 준비하지 않은 API를 호출할 수 없습니다.
에이전트가 실제로 원하는 것은 서비스를 발견할 수 있는 프로토콜이며, 그 가격을 볼 수 있고, 필요한 정확한 호출을 지불할 수 있으며, 그냥 이동할 수 있는 것입니다. 계정은 없습니다. 키는 없습니다. 약속은 없습니다.
그 프로토콜이 있습니다. 그것은 x402라고 합니다.
60초 안에 x402는 어떻게 작동하나요
x402는 HTTP 402 상태 코드(1997년 이후 예약되었고 거의 사용되지 않는 "지불 필요" 코드)를 기반으로 한 결제 프로토콜입니다.
프로세스는 다음과 같습니다.
- 에이전트가 API를 호출합니다. 인증 없음.
- API는 HTTP 402로 응답합니다.본체에는 가격($0.001), 네트워크(기본 메인넷), 수신자 지갑 주소, 자산(USDC)이 포함됩니다.
- 대리인이 USDC 이체 승인서에 서명합니다EIP-3009 (가스리스, 오프체인 서명)을 사용하여
-
에이전트가 다시 통화를 시도합니다.서명된 결제 페이로드가 있는
X-PAYMENT헤더. - API는 중개 서비스를 통해 결제를 확인합니다.에 이어 on-chain으로 정리됩니다.
- API는 데이터를 반환합니다.
중개인이 모든 블록체인 상호작용을 처리합니다. API 서버는 RPC 노드, 뜨거운 지갑, 또는 트랜잭션 서명이 필요하지 않습니다. 에이전트는 자체 보유 지갑을 제외하고는 어디에도 계정이 필요하지 않습니다.
Coinbase는 생산용 x402 중개인을 운영합니다.api.cdp.coinbase.com/platform/v2/x402는 Base 메인넷에서는 중개 수수료를 0으로 부과하지만, 네트워크의 명목적 가스 비용만을 매입자를 위해 후원합니다.
우리가 구축한 것: AgentScrape v0.6.0
AgentScrape는 HTTP REST API와 MCP(모델 컨텍스트 프로토콜) 서버를 통해 여섯 가지 유료 도구를 노출합니다.
-
scrape_webpage— HTML/Markdown/텍스트/JSON 정리 -
extract_structured_data— Groq + Llama를 통해 스키마 정의된 JSON 추출 -
screenshot_webpage— 전체 페이지 PNG 캡처 및 뷰포트 제어 -
extract_metadata— Open Graph, Twitter 카드, JSON-LD 파싱 -
create_browser_session— 다단계 흐름용 영구 브라우저 컨텍스트 -
run_workflow— 하나의 호출에서 복합 다단계 작업
모든 도구는 호출당 $0.001입니다. 지갑당 처음 10번의 호출은 평가를 위해 무료입니다.
The Stack
전체가 Cloudflare Workers에서 실행됩니다:
- 런타임: Cloudflare Workers (V8 isolate, global edge deployment)
- 브라우저: Cloudflare Browser Rendering (managed headless Chrome)
-
HTTP 프레임워크: Hono v4 with
@x402/honov2 payment middleware -
MCP 전송:
agents/mcp+agents/x402를 Cloudflare Agents SDK -
에서 제공합니다Facilitator:
api.cdp.coinbase.com/platform/v2/x402 -
Coinbase CDP에서Auth:
joseEd25519 JWT로 서명되었으며__JHSNS_SEG_e70ffb6c_57__ (Web Crypto API를 통해 Workers와 호환됨) - AI 추출:Groq 추론을 사용한 Llama 4 Scout (17B)
워커는 ~1000줄의 TypeScript입니다. 전체 배포 번들: 548 KB gzipped. 차가운 시작: 72ms.
지금 시도해보세요
Claude 데스크탑, Cursor, 또는 어떤 MCP 클라이언트에서의 MCP 서버로
Smithery를 한 명령어로 설치하세요:
npx -y @smithery/cli install hshintelligence/agentscrape --client claude
는 대리인이 직접 호출할 수 있는 6개의 유료 도구를 등록합니다. 대리인은 Cloudflare의 agents/x402 클라이언트 래퍼를 통해 자동으로 결제를 처리합니다 — 당신은 키 프롬프트를 본 적이 없습니다.
직접 HTTP API로
# 1. Request — get a 402 with payment requirements
curl -X POST https://agent-scrape.healingsunhaven.workers.dev/scrape \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com","format":"markdown"}'
# Response:
# HTTP/2 402
# payment-required: <base64-encoded x402 v2 PaymentRequired>
Thepayment-required 헤더는 완전한 x402 v2 결제 요구 사항 객체로 디코딩됩니다: scheme, network, amount, USDC 자산 주소, payTo 지갑, 및 timeout.
@x402/fetch를 사용하거나 x402-compliant 래퍼를 사용하는 클라이언트는 결제를 서명하고 자동으로 재시도합니다. 두 번째 호출은 스크래핑된 데이터를 반환합니다.
무료 계층
만약 지갑 설정 없이 스크래핑을 테스트하고 싶다면, HTTP API는 30일마다 지갑당 10회 무료 호출을 제공합니다. 어떤 식별자든 x402-payer 헤더를 설정하세요:
curl -X POST https://agent-scrape.healingsunhaven.workers.dev/scrape \
-H "Content-Type: application/json" \
-H "x402-payer: my-test-id" \
-d '{"url":"https://news.ycombinator.com"}'
이번에 배송하며 배운 점
빌드에서 다른 팀들이 시간을 절약할 수 있는 몇 가지 메모:
CDP 페리토리터 URL은api.cdp.coinbase.com/platform/v2/x402, not x402.org/facilitator. x402.org 주관자는 테스트넷 전용입니다 (Base Sepolia, Solana Devnet). 실제 돈을 Base 메인넷에서 사용하려면 CDP 엔드포인트와 CDP API 키가 필요합니다.
인증은 Ed25519 JWT로, API 키 헤더가 아닙니다. 검증/정산에 대한 각 호출은 새로 서명된 JWT가 필요하며, 클레임으로는 iss: "cdp", sub: <keyId>, aud: ["cdp_service"]가 포함되어야 합니다.uri: "<METHOD> api.cdp.coinbase.com<path>"이고 120초 만료 시간입니다.
CDP는 원시 88자리 base64 키를 제공하지만 PKCS#8 PEM은 제공하지 않습니다. jose 라이브러리는 PKCS#8이 필요합니다. 변환은 간단합니다: 디코딩된 키의 첫 32바이트를 가져오고, Ed25519 PKCS#8 ASN.1 접두사 (302e020100300506032b657004220420)를 앞에 붙이고, PEM 헤더로 감싸면 됩니다.
agents/x402와 @x402/core 패키지는 동일하게 공유합니다.FacilitatorConfig 인터페이스. 당신은 하나의 createAuthHeaders 콜백을 작성하고 HTTP 미들웨어(HTTPFacilitatorClient)와 MCP 레이어(withX402) 모두에 전달합니다.
Coinbase Bazaar(그들의 공식 x402 발견 디렉토리)는 자동으로 인덱싱됩니다. PR 없이, 양식 없이, мани페스트 파일 없이.bazaarResourceServerExtension를 추가하고declareDiscoveryExtension() 경로당, CDP를 통해 성공적인 결제를 완료하고, 당신의 서비스가 api.cdp.coinbase.com/platform/v2/x402/discovery/resources에 10분 안에 표시됩니다.
AgentScrape의 다음 단계
오늘, 모든 도구는 48시간 시장 검증에 대해 $0.001의 평가가 적용됩니다. 결제 데이터를 확보한 후, 가격은 작업당 실제 컴퓨팅 비용을 반영하는 계층 구조로 변경됩니다.
우리는 또 다른 두 개의 인접 제품을 개발하고 있습니다: AgentParse (PDF/OCR 추출)와 AgentSearch (인터넷 + arXiv + GitHub을 통한 연합 검색). 세 가지 모두 동일한 x402 결제 표면을 공유하므로 하나를 채택한 에이전트는 다른 것들을 무료로 사용할 수 있습니다.
에이전트를 구축하고 API-키 접착 코드를 건너뛰고 싶다면 AgentScrape를 시도해 보세요. 리포지토리를 별표로 하고 Smithery를 통해 설치하거나 HTTP 엔드포인트를 직접 호출하세요. 피드백과 버그 보고는 환영합니다.
링크: