AgentReady Woo — 자체 호스팅 WooCommerce 스토어를 위한 에이전틱 커머스 준비도 툴킷

라이브: app.utilityhouse.xyz.

AgentReady는 자체 호스팅 WooCommerce 스토어를 스캔하여 AI 에이전트 커머스(MCP/A2A)에 얼마나 준비되었는지 점수를 매기고, 제품 피드와 MCP 도구 표면을 통해 라이브 카탈로그를 노출하여 쇼핑 에이전트가 쿼리하고 구매할 수 있게 합니다. 체크아웃은 항상 서명된 시간 제한 장바구니 핸드오프를 통해 판매자 자신의 사이트에서 완료되며, 카드 데이터는 AgentReady를 통과하지 않습니다.

스토어를 연결하려면 URL과 판매자 자신의 WordPress 관리자(설정 → 고급 → REST API)에서 생성된 읽기 전용 WooCommerce REST API 키를 붙여넣으세요. 플러그인 설치가 필요 없습니다. 키는 한 번의 클릭으로 취소할 수 있으며 AgentReady는 스토어에 절대 쓰지 않습니다 — 읽기 전용 카탈로그 액세스만 가능합니다.

기능

• 무료 준비도 스캔 — 모든 WooCommerce 스토어를 100점 만점으로 평가: 디스커버리 파일, Store API 상태, 피드 품질, 장바구니 핸드오프 지원.

• 라이브 제품 피드 — 일정에 따라 스토어에서 재동기화되며 가격과 재고가 최신 상태로 유지됩니다.

• 에이전트 디스커버리 파일 — 연결된 각 스토어에 대한 /.well-known/agenticweb.md로, 에이전트가 호출하기 전에 스토어의 피드가 지원하는 것을 찾을 수 있습니다.

• MCP 도구 표면 — 에이전트는 스토어의 라이브 카탈로그에 대해 search_products, get_offer, get_feed, create_cart_link, verify_cart_link를 호출합니다.

• 서명된 장바구니 핸드오프 — HMAC 서명, 단일 사용, 60분 이내 만료되는 장바구니 추가 링크; 구매자는 판매자 자신의 사이트에서 체크아웃을 완료합니다.

• 대시보드 — 판매자를 위한 에이전트 트래픽 및 놓친 기회 가시성.

Related MCP server: WooCommerce MCP Server

MCP 엔드포인트

이 저장소는 하나의 도구 호출 형태(POST {tool, input} — MCP 형태이지만 전체 JSON-RPC 2.0 프로토콜은 아님, 아래 "상태" 참조)를 공유하는 두 개의 별도 MCP 표면을 노출합니다:

• 스토어별 커머스 도구 — POST /mcp/{store_id} — 위에 나열된 다섯 가지 카탈로그 도구로, 연결된 한 판매자의 라이브 스토어로 범위가 지정됩니다.

• 준비도 스캔 도구 — POST /mcp — x402 결제 게이트가 있는 단일 전역 도구(agentready_woo_agentic_commerce_readiness_toolkit_for_self_h)로, 요청 시 모든 WooCommerce 스토어의 에이전트 준비도를 점수화합니다.

상태

배포되어 프로덕션에서 사용 중이며, 실제 Paddle 결제 통합과 x402 게이트 준비도 스캔 도구를 위한 D1 기반 재무 원장이 있습니다. 테스트 스위트(npm test)는 인증, 결제 웹훅, 준비도 스캐너, MCP 도구 표면을 다룹니다.

MCP 도구 호출 형태는 의도적으로 최소화되어 있습니다 — JSON을 통한 {tool, input} — 전체 JSON-RPC 2.0 MCP 프로토콜 대신입니다. 공식 @modelcontextprotocol/sdk 프레임을 연결하는 것은 추적되는 후속 작업이며 현재 사용에 대한 차단 요인은 아닙니다(레지스트리용 설명은 mcp-registry/server.json 참조).

로컬 개발

npm install
npm run typecheck
npm test

배포

Cloudflare Workers, 이 저장소의 wrangler.toml을 통해 (D1 바인딩, 사용자 정의 도메인 라우팅, 비밀은 인라인 주석으로 문서화 — 비밀 자체는 절대 커밋되지 않으며 wrangler secret put으로만 설정됩니다).

npx wrangler deploy

라이선스

독점. 소스는 MCP 레지스트리 / 에이전트 디스커버리 투명성을 위해 여기에 게시됩니다. 이는 오픈소스 라이선스 부여가 아닙니다.