ClustovaClustova
Sign In
Documentation

Clustova Commerce

Clustova Commerce is the WooCommerce discovery and measurement layer for AI shopping. The free plugin focuses on catalog discoverability and baseline visibility, while Pro extends that foundation into server-side attribution and richer protocol coverage.

Requirements

  • WordPress 6.5 or later
  • WooCommerce 9.0 or later
  • PHP 8.0 or later
  • HPOS enabled in WooCommerce
  • Published WooCommerce products with titles, prices, and permalinks

What the Free Plugin Ships

ACP product feed

Publishes your catalogue at /wp-json/clustova/v1/feed/acp so AI shopping systems can consume structured product data directly.

llms.txt for store discovery

Serves store-level discovery output at /.well-known/llms.txt and /llms.txt with store details, product feed links, categories, and recent products.

AI-readable product schema

Outputs structured product data on product pages while avoiding duplicate schema when popular SEO plugins already handle markup.

Rule-based GEO health scoring

Scores products without LLM calls by checking description depth, images, attributes, price, SKU, and category coverage.

Installation and First Run

  1. 1Install Clustova Commerce from WordPress.org or upload the plugin zip, then activate it.
  2. 2Confirm WooCommerce and HPOS are enabled before using the discovery and measurement features.
  3. 3Open Clustova -> Settings and review feed settings such as max products, cache TTL, and ACP feed enablement.
  4. 4Visit the discovery endpoints panel and verify your ACP feed and llms.txt URLs are reachable.

Settings You Should Review

Max products in feed

Default 100

Limits how many products are exposed in the ACP catalogue feed. Raise it for larger stores or reduce it when you want a smaller first-pass catalogue.

Feed cache TTL

Default 3600 seconds

Controls how long feed output remains cached before regeneration. Longer values reduce load, shorter values reflect inventory changes sooner.

Enable ACP feed

Default enabled

Turns the public ACP feed on or off. Disable only if you intentionally do not want AI shopping agents to discover the store through the feed.

Health score thresholds

Description, attributes, images

Sets the minimum checks used by the rule-based GEO scoring engine so you can tighten or relax readiness grading.

Public and Admin Endpoints

Path
Access
Use
/wp-json/clustova/v1/feed/acp
Public
ACP discovery feed for products. The plugin sends a cache-friendly response with the protocol header set to acp.
/wp-json/clustova/v1/feed/acp/rebuild
Admin only
Rebuild endpoint used to invalidate and regenerate the feed. Requires WooCommerce management capability and a valid WordPress REST nonce.
/.well-known/llms.txt
Public
Preferred llms.txt discovery endpoint. The plugin also supports /llms.txt for broader compatibility.
/wp-json/clustova/v1/health/{product_id}
Public
Returns a single product's GEO health score, percentage, grade, and issues.
/wp-json/clustova/v1/health
Admin only
Returns health results in bulk, gated behind WooCommerce permissions and nonce verification.

How GEO Health Is Scored

The free scorer is deterministic and does not call any LLM. It returns a percentage plus a grade from A to F, based on six checks the plugin runs on each published product.

  • Description quality: the scorer rewards richer product copy and flags thin or empty descriptions.
  • Images: products without images score poorly, and one-image products are still flagged as weak.
  • Attributes: missing or sparse product attributes reduce discoverability for AI matching.
  • Price: products without valid pricing lose critical discovery value.
  • SKU: missing SKU data is flagged because it weakens cross-platform identity.
  • Categories: uncategorized products lose browseability for agents and shoppers alike.

Free vs Pro Boundary

Free covers

ACP feed publishing, llms.txt generation, AI-readable schema, gateway-flag detection, and read-only GEO scoring. It is enough to make the store more discoverable and auditable.

Pro adds

  • UCP feed support for broader protocol coverage.
  • Server-side reconciliation into GA4, Meta CAPI, and Google Ads.
  • AI-channel revenue dashboards.
  • Optional AI enrichment with merchant-supplied API keys.
  • Protected endpoint hardening and broader agent operations controls.

Troubleshooting

The llms.txt URL returns 404

Re-save Permalinks in WordPress so rewrite rules refresh. On some setups, the .well-known path may need the /index.php/.well-known/... form.

The ACP feed looks stale

Lower the cache TTL in settings or use the rebuild action so the feed cache is invalidated immediately.

Products score poorly in GEO Health

Start with description depth, attributes, categories, SKU coverage, and a stronger image set. Those are the exact checks the free scorer uses.

AI order attribution seems incomplete

The free plugin detects the WooCommerce agentic gateway flag and basic AI-channel signals. Full server-side reconciliation and channel revenue reporting are part of Pro.

Continue with the product overview

The landing page gives the broader positioning, while this page stays focused on setup and real product behavior.

View Commerce Page Back to Docs