AgentReady Woo

Name: AgentReady Woo
Author: utilityhouse.xyz

远程服务

app.utilityhouse.xyz开发工具07 周前更新

代码仓库访问官网

关于 AgentReady Woo

AgentReady Woo 检查 WooCommerce 商店面向 Agent 的公开接口，并支持经所有者授权的发布门禁。它为部署团队提供附带原因的状态，不修改订单、结账或库存，也不访问支付信息。

主要功能

01只读 WooCommerce 公开预检
02检查 robots、JSON-LD、MCP、UCP 和 ACP
03提供状态及未知原因说明
04所有者授权的发布门禁
05Node 24 部署 Action

适用场景

01发布后检查商店协议接口
02在部署工作流中加入就绪门禁
03审核签名的插件汇总证据

MCP 相关

托管的 MCP 端点提供公开商店扫描、发布预检和所有者授权门禁运行工具。部分门禁工具需要限定范围的 bearer token 和经过验证的商店所有权。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://app.utilityhouse.xyz/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http xyz-utilityhouse-agentready-woo https://app.utilityhouse.xyz/mcp

Cursor.cursor/mcp.json{"mcpServers":{"xyz-utilityhouse-agentready-woo":{"type":"http","url":"https://app.utilityhouse.xyz/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"xyz-utilityhouse-agentready-woo":{"type":"http","url":"https://app.utilityhouse.xyz/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"xyz-utilityhouse-agentready-woo":{"type":"http","url":"https://app.utilityhouse.xyz/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"xyz-utilityhouse-agentready-woo":{"serverUrl":"https://app.utilityhouse.xyz/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
demo	boolean	否	运行确定性的合成演示，而不是扫描真实店面。
store_url	string	否	WooCommerce 店面的公开 HTTPS 源站，例如 https://shop.example.com

详细介绍

AgentReady Woo — WooCommerce 发布门禁

在发布后验证面向 Agent 的 WooCommerce 界面——无需接触订单、结账或支付凭据。

运行免费的公开预检，或将无依赖的 Node 24 操作添加到部署工作流。默认情况下，只有明确的 HOLD 才会导致 CI 失败；BLOCKED、UNMEASURED 和 UNREADABLE 仍会作为弃权结果显示。

- name: AgentReady Woo preflight
  uses: tytutueh13-sudo/agentready-woo@v1
  with:
    store-origin: https://shop.example

发布检查能为你提供什么

一次只读的公开预检，检查 WooCommerce、robots、JSON-LD、MCP、UCP 和 ACP 界面。
有限的决策结果和未知原因列表，而不是虚高的准备度评分。
可选的所有者授权门禁，使用已签名的 WordPress 汇总证据。
不创建订单、不预留库存、不修改结账，也不访问支付信息。

在线服务：app.utilityhouse.xyz

AgentReady 会先进行被动的公开预检，然后允许经过验证的商店所有者依据已签名的插件证据，做出固定到特定版本的发布决策。无法读取的目标会返回弃权结果，而不是伪造低分。

这不是认证、排名承诺或结账测试。根级工具不会创建订单、预留库存、发送客户邮件，也不会处理支付凭据。

公开 MCP 工具

POST https://app.utilityhouse.xyz/mcp 使用 MCP JSON-RPC 2.0，并公布五种工具。请始终以 tools/list 作为权威架构。

工具	用途
`scan_woo_store_readiness`	对公开商店进行一般性审计，并提供评分和修复列表
`preflight_woo_store`	针对特定更新或发布提供协议系列证据

另外三种工具用于启动、读取和认领经所有者授权的发布门禁运行。它们需要限定范围的 bearer 令牌以及经过验证的商店所有权。

当通用扫描器无法读取目标时，会返回 state: UNREADABLE 和 score: null。针对真实商家商店的诊断准确性尚未测量。发布门禁结算已禁用。

GitHub Action

此仓库包含一个无依赖的 Node 24 操作。它调用相同的公开预检接口，生成带原因代码的作业摘要，并且仅在出现明确的 HOLD 时失败。BLOCKED 和 UNMEASURED 仍会作为弃权结果显示。

如果工作流只应检查这四种协议系列，请添加 families: woo,robots,jsonld,mcp。

公开端点对每个目标源每天允许调用三次，对每个调用 IP 每天允许调用十次。此操作不会更改商店中的任何内容。

WordPress 插件

wordpress-plugin/utilityhouse-release-gate-for-woocommerce 的版本为 1.2.1。它会在连接前提供实用的本地准备度快照。启用插件不会联系 UtilityHouse，也不会创建计划任务。管理员必须手动发送一次，或单独选择启用每日签名汇总证据计划。

证据信封包含版本标识符、不透明的商店/运行字段、时间戳、随机数、系列名称以及汇总检查状态/计数。它不包含客户、订单、支付、电子邮件、地址、产品描述、URL、凭据或原始日志字段。

使用以下命令构建确定性的插件包：

npm run build:plugin

在固定版本的 WordPress Playground 演示中尝试仅限本地的快照，无需接触真实商店。此临时站点未配置 UtilityHouse 端点，也不会发送任何证据。

REST 预检

POST https://app.utilityhouse.xyz/api/v2/preflight 的文档位于 mcp-registry/openapi-preflight.yaml。HTTP 200 不一定意味着目标已完成测量；请检查返回的 state 和各系列的检查结果。

单独的电商功能

已认证账号可以将只读 WooCommerce 凭据连接到绑定商店的目录、优惠和签名购物车移交功能，访问路径为 /mcp/{store_id}。这是单独的产品约定，不会授予 Release Gate 访问权限。结账和付款仍在商家的商店中进行。

开发

npm install
npm run typecheck
npm test
npm run test:wordpress

此公开仓库是用于审核的镜像，并非生产部署源。其 wrangler.toml 中的数据库 ID 是占位符。部署通过私有 monorepo 进行。

许可证范围

action.yml 和 action/** 根据 action/LICENSE 中的 MIT License 获得许可。
wordpress-plugin/utilityhouse-release-gate-for-woocommerce/** 根据插件标头和 readme.txt 中的声明，采用 GPL-2.0-or-later 许可。
除非某个文件或子树明确声明许可证，否则其余服务器、测试、部署或镜像文件均不授予任何许可。这些文件仍保留所有权利。

这些范围限定的许可证不适用于托管的 AgentReady 服务、其数据、商标或私有部署配置。

支持 Markdown

登录后评论