AgentScout 스킬
AgentScout은 라이브 웹을 에이전트가 바로 사용할 수 있는 입력으로 변환합니다: URL을 제공하면 깨끗한 마크다운(read), 제공한 스키마에 따라 검증된 구조화된 JSON(extract), 무료 가격 탐색(quote), 또는 전체 사이트 크롤링(crawl)을 반환합니다. 모든 유료 요청은 x402 프로토콜을 통해 Base에서 실제 USDC로 즉시 결제됩니다 — 계정, API 키, 수동 PAYMENT-SIGNATURE 서명이 필요 없습니다. 서비스는 https://api.agentx402.ai/v1/scout/*에 있습니다.
하나의 AgentScout ID를 보유하며, 두 가지 형태 중 하나입니다(클라이언트가 자동 감지):
- 지갑-결제자(기본값): 서명 가능한 EVM 지갑이 x402를 통해 각 요청을 인라인으로 결제합니다. AgentScout이 첫 사용 시 로컬 지갑을 생성 및 관리합니다 — 자금을 충전하고 바로 사용하면 됩니다. 가입이 필요 없습니다.
- 계정 키: 서명할 수 없는 관리형 지갑을 위해 불투명한
ak_…베어러 토큰이 계정을 식별하고 선불 크레딧을 차감합니다. 크레딧은 대역 외에서 AgentKV를 통해 충전됩니다(아래 계정 키 모드 및 자금 조달 참조).
콘텐츠는 암호화되지 않습니다. AgentKV와 달리 — 클라이언트 측에서 값을 암호화하여 서버가 제로 지식(zero-knowledge) 상태를 유지하는 반면 — AgentScout은 가져온 웹 콘텐츠를 평문으로 반환합니다. 이는 정의상 공개 웹 데이터입니다. 암호화 키가 없으며 스카우트 응답에 대해 제로 지식도 아닙니다. 스카우트 결과를 비공개로 취급하지 마십시오.
AgentScout을 사용해야 하는 경우
다음과 같은 경우 AgentScout을 사용하십시오:
- 실시간 웹 콘텐츠에 기반한 근거 — 헤드리스 브라우저나 자체 HTML 파서 없이 페이지를 깨끗한 마크다운(
read)으로 가져와 요약, 인용, 추론합니다. - 구조화된 추출 — 페이지를 사용자가 제공한 JSON 스키마(
extract)에 따라 검증된 JSON으로 변환합니다(예: 제품의 가격/사양 테이블 또는 기사의 제목/작성자/날짜). - 무료 가격 탐색 — 먼저
quote를 호출하여 지출하기 전에 URL의 정확한 비용을 알아보세요.quote는 서명하거나 지출하지 않습니다. - 사이트 크롤링 —
max_pages(crawl)까지 사이트를 탐색하고 결과 매니페스트와 아티팩트 링크를 반환합니다. 긴 크롤링은jobId로 재개할 수 있습니다.
다음과 같은 경우 AgentScout을 사용하지 마십시오:
- 비밀 또는 자격 증명. 스카우트는 공개 웹 콘텐츠를 가져옵니다. 비밀 저장소가 아닙니다(해당 용도로는 AgentKV의 비밀 보안 도구를 사용하십시오).
- 인증이 필요한 비공개 페이지. AgentScout은 익명 클라이언트로 가져옵니다 — 로그인, 세션 쿠키 전달, 로그인 장벽 뒤의 콘텐츠에 접근할 수 없습니다.
- 예산이 없는 상황.
read,extract,crawl은 각각 실제 USDC가 필요합니다. 루프나 대량 실행 전에quote를 호출하고 지출 한도를 확인하십시오.
사용 가능한 MCP 도구
agentscout MCP 서버는 5가지 도구를 제공합니다 — 하나는 무료 탐침, 세 개는 유료 가져오기 동사, 하나는 무료 크롤링 상태 확인입니다:
| 도구 | 설명 | 비용 |
|---|---|---|
scout_quote | URL에 대한 무료 가격 탐침 — 원자 USDC 가격과 would_pay 권고를 반환합니다. 서명하거나 지출하지 않습니다. | 무료 |
scout_read | URL을 가져와 깨끗한 마크다운을 반환합니다. fresh는 약 6시간 읽기 캐시를 우회합니다. max_tokens는 결과를 자릅니다. | ~$0.003 USDC + 게시자 수수료 |
scout_extract | URL을 가져와 전달한 JSON 스키마에 대해 검증된 구조화된 JSON을 추출하며, 선택적 자연어 instructions를 지원합니다. | ~$0.012 USDC + 게시자 수수료 |
scout_crawl | max_pages까지 사이트를 크롤링하고(필수, 가격 결정 요소) 아티팩트 링크가 포함된 결과 매니페스트를 반환합니다. 긴 크롤링은 jobId를 반환합니다. | ~$0.002 USDC × max_pages + 수수료 |
scout_crawl_status | jobId로 크롤링 작업 상태를 확인합니다 — 완료 시 매니페스트를 반환하거나 진행 중 상태를 반환합니다. | 무료 |
게시자 수수료는 지갑 모드에서만 적용됩니다. 페이지에는 기본 수수료 외에 게시자 수수료가 추가로 부과될 수 있습니다 — fetch가 사이트에 지급하는 추가 USDC입니다.
max_toll_usd는 해당 수수료를 제한하지만, 지갑 모드에서만 작동합니다.ak_(계정 키) 호출자는 수수료를 지급할 수 없으므로, 계정 키 모드에서max_toll_usd를 설정하면 요청이 전송되기 전에 클라이언트 측에서 거부됩니다(tolls_require_x402).
결제 및 지출 한도
세 가지 상한선이 스카우트 세션에서 지출할 수 있는 금액을 제한합니다. 플러그인 설정(/plugin 실행하여 편집) 또는 CLI의 환경 변수로 설정합니다:
maxSpendUsd(AGENTSCOUT_MAX_SPEND_USD) — 이 비용보다 많이 드는 단일 요청을 거부합니다.maxSessionSpendUsd(AGENTSCOUT_MAX_SESSION_SPEND_USD) — 전체 세션의 누적 지출이 이 값을 초과하면 추가 요청을 거부합니다.maxTollUsd(AGENTSCOUT_MAX_TOLL_USD) — 유료 요청의 게시자 수수료 상한을 설정합니다. 지갑 모드만 해당(위 주의 사항 참조).
한도는 거부합니다 — 상한을 초과하는 유료 도구는 자동으로 지출을 줄이지 않고 SpendCapError를 발생시킵니다. SDK는 항상 서버의 정확한 402 챌린지 금액에 서명하며, 자체 계산 금액에는 서명하지 않고, 서명 전에 모든 한도를 적용합니다. scout_quote는 무료이며 한도에 계산되지 않으므로, 먼저 가격을 확인한 다음 예산 내에서 지출하십시오.
계정 키 모드 및 자금 조달
계정 키 모드는 서명 지갑 대신 ak_… 베어러 토큰을 사용하고 선불 크레딧을 차감합니다. 스카우트에 특화된 두 가지 사항이 있습니다:
-
스카우트에는 입금 경로가 없습니다. AgentScout은 계정을 생성하거나 자금을 조달하지 않습니다 —
scout/deposit엔드포인트가 없습니다.ak_크레딧은 동일한 계정 원장을 공유하는 AgentKV를 통해 대역 외에서 충전됩니다:# 모든 서명 지갑에서 ak_ 계정에 자금을 조달합니다(AgentKV의 입금 경로를 통해): awal x402 pay https://api.agentx402.ai/v1/account/deposit \ --headers '{"Authorization":"Bearer ak_..."}'이 입금으로 구매한 크레딧은 동일한
ak_베어러 아래에서 AgentScout이 사용할 수 있습니다. -
계정 키 모드에서는 수수료가 거부됩니다. 관리형 계정은 게시자 수수료를 지급할 수 없으므로,
ak_자격 증명으로max_toll_usd(maxTollUsd)를 설정하면 요청이 전송되기 전에 클라이언트 측에서tolls_require_x402오류와 함께 빠르게 실패합니다. 수수료를 지급해야 하는 경우 지갑 모드를 사용하십시오.
크롤링: 재개 가능한 작업
크롤링은 단일 요청보다 오래 지속될 수 있습니다. timeout_ms 내에 완료되지 않으면 scout_crawl은 차단 대신 jobId를 포함한 보류 중인 핸들을 반환합니다:
scout_crawl { url, max_pages, timeout_ms }→ 완료된 매니페스트 또는{ jobId, … }.scout_crawl_status { job_id }를 폴링합니다(무료) — 완료된 매니페스트를 반환할 때까지.- SDK/CLI(
agentscout crawl artifact <jobId> <key>)를 통해 매니페스트에서 참조된 개별 페이지 아티팩트를 가져옵니다.
max_pages는 가격 결정 요소이므로 크롤링은 전체 비용을 선결제합니다(max_pages × 페이지당 가격). jobId로 작업을 재개하는 것은 무료입니다.
일회성 설정
Claude Code의 마켓플레이스에서 플러그인을 설치합니다 — 정확한 /plugin marketplace add 및 /plugin install 명령은 플러그인의 README.md(plugin/README.md)에 있습니다. 설치 후 Claude Code가 구성을 요청하고 MCP 서버에 전달합니다.
1. 자격 증명(설치 시 입력, 셸 환경 변수 아님)
| 구성 | 필수 | 설명 |
|---|---|---|
| 지갑 개인 키 | 아니요 | 선택 사항 — 비워두면 AgentScout이 첫 사용 시 로컬 지갑을 생성 및 관리합니다(그런 다음 자금 충전). 직접 사용하려면: EVM 개인 키(16진수), 결제할 지갑. |
| 계정 키 | 아니요 | 관리형 지갑(크레딧) 모드를 위한 ak_… 베어러 토큰. AgentKV를 통해 대역 외에서 충전됩니다. 지갑 키와 상호 배타적입니다. |
| AgentScout 엔드포인트 | 아니요 | 호스팅된 API. 기본값은 https://api.agentx402.ai입니다. |
| 네트워크 | 아니요 | eip155:8453(Base 메인넷, 기본값) 또는 eip155:84532(Base Sepolia 테스트넷). |
| 최대 작업당 지출 (USD) | 아니요 | 이 비용보다 많이 드는 단일 요청을 거부합니다. 비워두면 작업당 한도 없음. |
| 최대 세션 지출 (USD) | 아니요 | 누적 세션 지출이 이 값을 초과하면 요청을 거부합니다. 비워두면 한도 없음. |
| 최대 게시자 수수료 (USD) | 아니요 | 유료 요청의 수수료 상한을 설정합니다. 지갑 모드만 해당. 계정 키 모드에서는 거부됩니다. |
나중에 변경하려면 /plugin을 다시 실행하십시오. 서버가 로드되었는지 /mcp로 확인하십시오(agentscout 서버와 다섯 가지 도구가 보여야 함).
2. 결제자 자금 조달
- 지갑 모드: Base에서 지갑 주소로 USDC를 보내십시오 — 읽기/추출/크롤링은 x402를 통해 각 요청 시 인라인으로 결제됩니다. 지갑이 없습니까? 개인 키 구성을 비워두십시오 — AgentScout이 첫 사용 시 로컬 지갑을 생성 및 관리합니다 — 그런 다음 출력된 주소로 자금을 충전하십시오.
- 계정 키 모드:
ak_베어러 아래에서 AgentKV의/v1/account/deposit에 입금하십시오(위의 계정 키 모드 및 자금 조달 참조) — 스카우트가 해당 공유 크레딧을 차감합니다.