AgentReady Woo – Toolkit für die Agentic-Commerce-Bereitschaft selbst gehosteter WooCommerce-Shops

Live unter app.utilityhouse.xyz.

AgentReady scannt einen selbst gehosteten WooCommerce-Shop und bewertet, wie bereit er für den KI-Agenten-Commerce (MCP/A2A) ist. Anschließend stellt es den Live-Katalog über einen Produkt-Feed und eine MCP-Tool-Oberfläche bereit, die Shopping-Agenten abfragen und über die sie einkaufen können. Der Checkout erfolgt immer auf der eigenen Website des Händlers über eine signierte, zeitlich begrenzte Warenkorb-Übergabe – Kartendaten passieren AgentReady nie.

Verbinden Sie einen Shop, indem Sie seine URL und einen schreibgeschützten WooCommerce-REST-API-Schlüssel einfügen, der im eigenen WordPress-Admin des Händlers generiert wird (Settings → Advanced → REST API). Keine Plugin-Installation erforderlich. Der Schlüssel ist mit einem Klick widerrufbar und AgentReady schreibt nie in den Shop – nur schreibgeschützter Katalogzugriff.

Was es tut

• Kostenloser Bereitschafts-Scan – bewertet jeden WooCommerce-Shop auf einer Skala von 100 Punkten: Discovery-Dateien, Store-API-Gesundheit, Feed-Qualität, Warenkorb-Übergabe-Unterstützung.

• Live-Produkt-Feed – wird regelmäßig vom Shop neu synchronisiert; Preis und Lagerbestand bleiben aktuell.

• Agent-Discovery-Datei – /.well-known/agenticweb.md pro verbundenem Shop, damit Agenten herausfinden können, was der Feed eines Shops unterstützt, bevor sie ihn aufrufen.

• MCP-Tool-Oberfläche – Agenten rufen search_products, get_offer, get_feed, create_cart_link und verify_cart_link gegen den Live-Katalog eines Shops auf.

• Signierte Warenkorb-Übergabe – HMAC-signierte, einmalige Add-to-Cart-Links, die in ≤60 Minuten ablaufen; der Käufer schließt den Checkout auf der eigenen Website des Händlers ab.

• Dashboard – Sichtbarkeit von Agenten-Traffic und verpassten Chancen für den Händler.

Related MCP server: WooCommerce MCP Server

MCP-Endpunkte

Dieses Repository stellt zwei verschiedene MCP-Oberflächen bereit, die eine gemeinsame Tool-Call-Form verwenden (POST {tool, input} – MCP-förmig, nicht das vollständige JSON-RPC-2.0-Protokoll; siehe „Status“ unten):

• Pro-Shop-Commerce-Tool – POST /mcp/{store_id} – die fünf oben aufgeführten Katalog-Tools, begrenzt auf den Live-Shop eines verbundenen Händlers.

• Bereitschafts-Scan-Tool – POST /mcp – ein einzelnes globales, x402-zahlungsgesteuertes Tool (agentready_woo_agentic_commerce_readiness_toolkit_for_self_h), das die Agenten-Bereitschaft jedes WooCommerce-Shops auf Abruf bewertet.

Status

Bereitgestellt und in Produktion, mit einer echten Paddle-Abrechnungsintegration und einem D1-gestützten Finanzledger für das x402-gesteuerte Bereitschafts-Scan-Tool. Die Testsuite (npm test) deckt Authentifizierung, Abrechnungs-Webhooks, den Bereitschafts-Scanner und die MCP-Tool-Oberfläche ab.

Die MCP-Tool-Call-Form ist bewusst minimal – {tool, input} über JSON – und nicht das vollständige JSON-RPC-2.0-MCP-Protokoll. Die Anbindung des offiziellen @modelcontextprotocol/sdk-Frameworks ist ein verfolgtes Folgeprojekt, kein Blocker für die aktuelle Nutzung (siehe mcp-registry/server.json für die registrybezogene Beschreibung).

Lokale Entwicklung

npm install
npm run typecheck
npm test

Bereitstellung

Cloudflare Workers, über wrangler.toml in diesem Repository (D1-Bindung, Routing für benutzerdefinierte Domains, Geheimnisse als Inline-Kommentare dokumentiert – Geheimnisse selbst werden nie committet, sondern nur mit wrangler secret put gesetzt).

npx wrangler deploy

Lizenz

Proprietär. Der Quellcode wird hier für die Transparenz des MCP-Registry / der Agenten-Discovery veröffentlicht; dies ist keine Open-Source-Lizenzgewährung.