Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
본 글은 HTTP 402 프로토콜을 활용하여 AI 에이전트가 계정이나 API 키 없이 호출할 수 있는 웹 도구 사용법을 설명합니다. 솔라나 USDC 기반의 결제 시스템을 통해, 에이전트는 호출당 소액의 비용만 지불하고 마크다운 생성 및 요약 기능을 사용할 수 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기저는 두 가지 작은 웹 유틸리티를 x402 — 즉 HTTP 402 결제 필요(Payment Required) 프로토콜 — 뒤에 배치했습니다. 이를 통해 AI 에이전트는 계정이나 API 키 없이 호출할 수 있으며, 솔라나의 USDC로 호출당 극히 적은 금액을 지불합니다.
기본 URL: https://agent-tools.faling-bot.workers.dev
| 엔드포인트 | 가격 | 기능 설명 |
|---|---|---|
POST /api/markdown | $0.002 | 공개 웹 페이지를 가져와 깔끔한 마크다운(제목, 본문 텍스트, 링크)으로 반환합니다. |
POST /api/summarize | $0.003 | {text} 또는 {url}의 글머리 기호 요약본을 생성합니다 (Workers AI에서 실행되는 Llama 3.1 8B 사용). |
이 서비스는 Cloudflare Worker 위에서 실행됩니다. 결제는 PayAI facilitator에 의해 검증 및 정산되며, 이 주체가 솔라나 가스비를 후원하므로, 지불하는 에이전트는 USDC만 필요합니다.
402 응답과 함께 JSON 본문 및 PAYMENT-REQUIRED 헤더(base64 JSON, x402 v2)를 받게 됩니다. 이 헤더에는 허용되는 내용(예: scheme: exact, network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), USDC 민트 주소, 그리고 원자 단위로 된 금액(2000 = $0.002)이 명시됩니다.PAYMENT-SIGNATURE 헤더(v1의 경우 X-PAYMENT도 허용됨)를 사용하여 재시도합니다.200 응답을 반환합니다. 정산 영수증은 PAYMENT-RESPONSE에 포함됩니다. 만약 입력이 유효하지 않거나 상위 페이지 호출에 실패하면, 결제는 정산되지 않습니다.curl -i -X POST https://agent-tools.faling-bot.workers.dev/api/markdown \
-H 'content-type: application/json' -d '{"url":"https://example.com"}'
# HTTP/2 402 + payment requirements
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactSvmScheme } from "@x402/svm/exact/client";
import { toClientSvmSigner } from "@x402/svm";
...
또한, https://agent-tools.faling-bot.workers.dev/mcp에 상태 비저장(stateless) 스트리밍 가능한 HTTP MCP 엔드포인트가 있습니다. 이곳에는 url_to_markdown 및 summarize 도구가 포함되어 있습니다. 이는 공식 MCP 레지스트리에서 dev.workers.faling-bot.agent-tools/x402-web-tools로 등록되어 있습니다. 결제 없이 도구를 호출하면 x402 요구 사항과 함께 isError를 반환합니다. 지불하려면, 베이스64(base64) 결제 페이로드(payment payload)를 arguments.x402_payment 또는 _meta["x402/payment"]로 전달해야 합니다. 아직 모든 MCP 클라이언트가 이 기능을 지원하지 않으므로, 일반(plain) HTTP 엔드포인트가 더 신뢰할 수 있는 옵션입니다.
/llms.txt: 에이전트를 위한 짧은 가이드/openapi.json: x-payment-info가 포함된 OpenAPI 3.1 (이는 x402scan에 인덱싱됩니다.)/.well-known/x402: x402 리소스 목록/.well-known/agent.json: A2A 에이전트 카드AI의 도움을 받아 작성됨.