B2A Agent-Discoverability Audit

Audits e-commerce sites for AI shopping agent discoverability, scoring product data, APIs, feeds, checkout compatibility, and description quality with priori...

Security Scan

The skill's instructions, inputs, and behaviour are coherent with an e-commerce discoverability audit and it does not request unrelated credentials or installs; use caution around live POST tests and rate limits.

Purpose & Capability

Name/description (audit e-commerce sites for AI shopping agent discoverability) match the instructions: inspecting product pages, JSON-LD, public product APIs, feeds, and checkout API endpoints — all directly relevant to the stated goal.

Instruction Scope

Instructions are scoped to public storefront endpoints and content inspection. One notable operational action is testing POST /wp-json/wc/store/v1/cart/add-item which may create carts or server-side state; this is relevant to checkout-compatibility testing but can have side effects and should be rate-limited and run with permission or against staging when possible.

Install Mechanism

Instruction-only skill with no install spec or code to write to disk—lowest installation risk.

Credentials

No environment variables, credentials, or config paths are requested. That aligns with the public-read nature of the checks described.

Persistence & Privilege

Skill is not forced-always, does not request persistent system modification, and does not attempt to modify other skills or global agent settings.

Assessment

This skill appears coherent for auditing public storefront discoverability. Before running: obtain the site owner's permission (to avoid unwanted traffic or side effects), prefer staging/test stores for POST-based checkout tests, rate-limit requests to avoid load, avoid creating real orders or modifying inventory, and ensure any appended reports are stored where you expect and do not leak private data. If you need the skill to test authenticated admin-only feeds, expect it to require credentials (none are requested now) — do not provide secrets unless you trust the source.

Skill: B2A Agent-Discoverability Audit

Version: 1.0 | Created: 2026-03-30

---

Purpose

Audit any e-commerce site (WooCommerce/Shopify/custom) for AI agent discoverability and shopping readiness. Outputs a scored report with prioritized fixes to make products visible to AI shopping agents (Google AI Shopping, Perplexity Shopping, AppFunctions agents).

When to Use

• Before launching a new product line
• When traffic is low despite active inventory
• As part of B2A (Business-to-Agent) commerce infrastructure setup
• Quarterly storefront health check

Inputs

• SITE_URL — the storefront URL to audit (e.g., https://example.com)
• STORE_TYPE — WooCommerce | Shopify | Custom (default: WooCommerce)

Outputs

• Scored report appended to a notes file
• 5-dimension score card (0–10 each)
• Prioritized fix list: 🔴 HIGH / 🟡 MEDIUM / 🟢 LOW

Audit Dimensions

1. Structured Data (schema.org/Product)

Check for:

• @type: Product with name, sku, url, image, description
• Offer block: price, priceCurrency, availability
• brand with @type: Brand
• gtin / gtin13 / gtin8 — required by Google Shopping and AI agent catalogs
• mpn (manufacturer part number)
• aggregateRating + reviewCount
• color, material, weight product attributes

Tool: Fetch any product page, inspect JSON-LD blocks.

2. Machine-Readable Catalog API

WooCommerce: Test GET /wp-json/wc/store/v1/products (public, no auth) Shopify: Test GET /products.json (public, no auth) Check: HTTP status, fields returned (id, name, sku, prices, images, in_stock)

3. Google Merchant Center / Shopping Feed

Test common feed URLs:

• /feed=products
• /google-shopping-feed/
• WooCommerce: Google Listings & Ads plugin
• Shopify: native GMC integration

4. Agent Checkout Compatibility

WooCommerce: Test POST /wp-json/wc/store/v1/cart/add-item availability Check for headless cart API, programmatic checkout support

5. Product Descriptions (AI Intent Matching)

Evaluate description quality:

• Length > 100 words with specs
• Includes: connection type, battery life, dimensions, weight, use cases
• No tagline-only descriptions

Scoring Rubric

Score	Meaning
9–10	Production-ready for AI agents
7–8	Good, minor fixes needed
5–6	Partial — key gaps present
3–4	Visible but not optimized
0–2	Invisible to AI shopping agents

Report Format

## [YYYY-MM-DD] B2A Agent-Discoverability Audit — {SITE_URL}

### Score Card
| Dimension | Score | Notes |
...

### 🔴 HIGH Priority
...

### 🟡 MEDIUM Priority  
...

### 🟢 LOW Priority (future)
...

Overall: X/10

Key Insight (from production use)

The biggest gap most e-commerce sites have: WooCommerce/Shopify APIs are browsable by agents, but without GTIN identifiers and a Google Merchant Center feed, products are invisible to Google AI Shopping, Perplexity Shopping, and Android AppFunctions agents. The fix is a free WooCommerce plugin + 30 minutes of product data entry. High leverage, low effort.