AgentReady Woo — kit de preparación para comercio agéntico para tiendas WooCommerce autoalojadas

Disponible en app.utilityhouse.xyz.

AgentReady escanea una tienda WooCommerce autoalojada y puntúa su preparación para el comercio con agentes de IA (MCP/A2A), y luego expone el catálogo en vivo a través de un feed de productos y una superficie de herramientas MCP que los agentes de compra pueden consultar y desde la que pueden comprar. El pago siempre se completa en el sitio del comerciante mediante una transferencia de carrito firmada y con límite de tiempo: ningún dato de tarjeta pasa nunca por AgentReady.

Conecta una tienda pegando su URL y una clave de API REST de WooCommerce de solo lectura generada en el propio administrador de WordPress del comerciante (Ajustes → Avanzado → REST API). No se requiere instalar ningún plugin. La clave se puede revocar con un clic y AgentReady nunca escribe en la tienda: solo acceso de solo lectura al catálogo.

Qué hace

• Escaneo de preparación gratuito — califica cualquier tienda WooCommerce sobre 100: archivos de descubrimiento, salud de la API de la tienda, calidad del feed, soporte de transferencia de carrito.

• Feed de productos en vivo — resincronizado desde la tienda según un horario; el precio y el stock se mantienen actualizados.

• Archivo de descubrimiento de agentes — /.well-known/agenticweb.md por tienda conectada, para que los agentes puedan saber qué soporta el feed de una tienda antes de llamarlo.

• Superficie de herramientas MCP — los agentes llaman a search_products, get_offer, get_feed, create_cart_link y verify_cart_link contra el catálogo en vivo de una tienda.

• Transferencia de carrito firmada — enlaces de añadir al carrito firmados con HMAC, de un solo uso y que expiran en ≤60 minutos; el comprador completa el pago en el sitio del comerciante.

• Panel de control — visibilidad del tráfico de agentes y de las oportunidades perdidas para el comerciante.

Related MCP server: WooCommerce MCP Server

Endpoints MCP

Este repositorio expone dos superficies MCP distintas que comparten una misma forma de llamada a herramienta (POST {tool, input} — con forma MCP, no el protocolo JSON-RPC 2.0 completo; ver "Estado" más abajo):

• Herramienta de comercio por tienda — POST /mcp/{store_id} — las cinco herramientas de catálogo listadas arriba, limitadas a la tienda en vivo de un comerciante conectado.

• Herramienta de escaneo de preparación — POST /mcp — una única herramienta global, con pago mediante x402 (agentready_woo_agentic_commerce_readiness_toolkit_for_self_h) que puntúa la preparación para agentes de cualquier tienda WooCommerce bajo demanda.

Estado

Desplegado y en uso en producción, con una integración real de facturación de Paddle y un libro de contabilidad financiera respaldado por D1 para la herramienta de escaneo de preparación con pago x402. La suite de pruebas (npm test) cubre autenticación, webhooks de facturación, el escáner de preparación y la superficie de herramientas MCP.

La forma de llamada a herramienta MCP es intencionadamente mínima — {tool, input} sobre JSON — en lugar del protocolo MCP JSON-RPC 2.0 completo. Conectar el marco oficial @modelcontextprotocol/sdk es un seguimiento registrado, no un bloqueo para el uso actual (ver mcp-registry/server.json para la descripción orientada al registro).

Desarrollo local

npm install
npm run typecheck
npm test

Despliegue

Cloudflare Workers, mediante wrangler.toml en este repositorio (enlace D1, enrutamiento de dominio personalizado, secretos documentados en línea como comentarios — los secretos nunca se confirman, solo se establecen con wrangler secret put).

npx wrangler deploy

Licencia

Propietaria. El código fuente se publica aquí para la transparencia del Registro MCP / descubrimiento de agentes; esto no es una concesión de licencia de código abierto.