검색당 결제 API 디스커버리 엔진 구축 — API 키 없이, 암호화만 (x402)
Source: Dev.to
The problem
에이전트가 자신에게 없는 기능—날씨 데이터, 이미지 생성, 가격 피드, 웹 스크래핑—이 필요할 때, 스스로 유료 API를 찾을 좋은 방법이 없습니다. 오늘날 모든 API 수익 모델은 인간이 가입한다는 전제를 가지고 있습니다. 기계가 “이 기능을 원합니다, 여기 결제합니다, 결과를 주세요”라고 말할 표준적인 방법이 없습니다.
그 격차를 제가 메우려고 합니다.
x402란 무엇인가?
x402는 HTTP 402 Payment Required 상태 코드를 실현하는 오픈 프로토콜입니다. 클라이언트가 x402‑지원 엔드포인트에 결제 없이 접근하면 서버는 기계가 읽을 수 있는 결제 요청과 함께 402를 반환합니다. 클라이언트는 온‑체인(보통 Base 메인넷의 USDC)으로 결제하고, payment‑proof 헤더를 첨부한 뒤 다시 시도합니다 — 모두 한 번의 라운드‑트립으로 이루어집니다. 계정도, API 키도, 대시보드도 필요 없습니다. 지갑과 HTTP 클라이언트만 있으면 됩니다.
What x402search does
x402search 은 x402‑지원 API를 위한 디스커버리 엔진입니다. x402 생태계 전반에 걸쳐 13,000+ 개의 API를 인덱싱하고, Claude, Cursor, Windsurf 및 모든 MCP‑호환 에이전트가 네이티브하게 호출할 수 있는 MCP (Model Context Protocol) 도구를 통해 노출합니다.
- 각 검색은 Base 메인넷에서 $0.01 USDC 가 소요되며 — x402 프로토콜을 사용하는 에이전트가 자동으로 결제합니다.
- 회원가입 필요 없음, 레이트‑리밋 티어 없음, API 키 교체 필요 없음.
- 검색 도구는 자연어 질의를 이해하고 네트워크(
eip155:8453for Base)와 최대 가격에 대한 필터를 지원합니다. - 결과에는 엔드포인트 URL, 설명, 가격 및 실제 API 호출에 필요한 결제 메타데이터가 포함됩니다.
2줄 설치
다음 내용을 MCP 구성에 추가하세요 (Claude Desktop, Cursor, Windsurf 등):
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": ["-y", "x402search-mcp"],
"env": {
"WALLET_PRIVATE_KEY": ""
}
}
}
}귀하의 지갑에는 Base 메인넷에 소량의 USDC가 필요합니다. 검색당 $0.01이므로 $1으로 100개의 쿼리를 수행할 수 있습니다. MCP 서버가 결제를 자동으로 처리하므로 에이전트는 단순히 search_x402_apis에 쿼리 문자열을 전달하면 됩니다.
내부 작동 방식
- 에이전트가
search_x402_apis를 호출합니다. - MCP 서버가
POST요청을https://x402search.xyz/v1/search에 보냅니다. - 서버는 결제 요청을 포함한
402응답을 반환합니다: 네트워크eip155:8453, 금액10000(6자리 소수점 형식의 0.01 USDC), 수신자 주소, 그리고 논스. - x402 클라이언트 라이브러리가 Base 메인넷에서 USDC 전송을 서명하고 제출하며, 증명을 담은
X-Payment헤더를 첨부하고 요청을 재시도합니다. - 서버가 온‑체인 결제를 검증하고 검색 결과를 반환합니다.
MCP 서버는 표준 Axios 인스턴스를 감싸기 위해 @x402/axios를 사용하고, EVM 서명을 위해 @x402/evm(viem 사용), 그리고 @modelcontextprotocol/sdk를 통해 도구를 stdio에 노출합니다. 개인 키는 로컬에 머무르며—에이전트 환경을 떠나지 않습니다.
현재 상황
- 인덱서는 라이브이며, CDP Bazaar 데이터셋을 대상으로 12,845+ 리소스를 인덱싱하고 있습니다.
- 검색 API는 Base 메인넷에서 실행 중이며 실제 결제를 받고 있습니다.
- MCP 패키지는 npm에 게시되었습니다.
다음 단계
- CDP Bazaar를 넘어선 더 넓은 인덱스 범위
- 키워드 + 시맨틱 하이브리드 검색
- API를 찾을 뿐만 아니라 자동으로 다단계 워크플로를 구성할 수 있는 에이전트
- 가장 많이 조회된 기능들의 공개 리더보드
Try it
- npm package: x402search-mcp
- Source code: x402-index/x402search-mcp
- Live index: x402search.xyz
MCP로 빌드하거나 x402 생태계를 탐색하고 있다면, 스타를 눌러주시고 현재 작업 중인 내용을 알려주세요. 특히 에이전트가 하나의 작업에서 여러 유료 API를 compose 해야 하는 경우에 대해 궁금합니다 — 바로 그 부분이 흥미롭습니다.