AgentReady Scoring

A composite score that tells agents how ready product data is for automated decision-making.

What is AgentReady Scoring?

AgentReady scoring evaluates extracted product data across five dimensions to produce a single score (0-1) indicating how suitable the data is for autonomous agent workflows like purchasing, comparison, or inventory management.

Five Dimensions

Dimension	Weight	Description
Completeness	0.30	Percentage of expected fields present. Core fields (title, price, currency) weighted more heavily.
Confidence	0.25	Average per-field confidence score from the extraction pipeline.
Structure	0.20	Data format quality: correct types, valid URLs, proper currency codes, parseable prices.
Actionability	0.15	Can an agent act on this data? Requires price + availability + product URL at minimum.
Freshness	0.10	How recent is the extraction? Cached data older than 24h gets a penalty.

Usage

Inline with extraction

Add include_score=true to any enrichment request:

{
  "url": "https://www.grainger.com/product/DAYTON-1-3-HP-Condenser-Fan-Motor-4M206",
  "include_score": true
}

Standalone scoring

Score existing product data via POST /api/score:

{
  "product": {
    "title": "DAYTON 1/3 HP Condenser Fan Motor",
    "price": 142.50,
    "currency": "USD",
    "brand": "Dayton",
    "sku": "4M206",
    "availability": "InStock"
  }
}

Response Example

{
  "agent_ready_score": {
    "overall": 0.87,
    "dimensions": {
      "completeness": {
        "score": 0.92,
        "weight": 0.30,
        "details": {
          "core_fields_present": 6,
          "core_fields_expected": 7,
          "optional_fields_present": 3
        }
      },
      "confidence": {
        "score": 0.88,
        "weight": 0.25,
        "details": {
          "mean_confidence": 0.88,
          "min_confidence": 0.72,
          "fields_above_0.8": 5
        }
      },
      "structure": {
        "score": 0.85,
        "weight": 0.20,
        "details": {
          "valid_price_format": true,
          "valid_currency_code": true,
          "valid_url": true,
          "valid_availability_enum": true
        }
      },
      "actionability": {
        "score": 0.80,
        "weight": 0.15,
        "details": {
          "has_price": true,
          "has_availability": true,
          "has_product_url": true,
          "has_add_to_cart": false
        }
      },
      "freshness": {
        "score": 0.95,
        "weight": 0.10,
        "details": {
          "extraction_age_hours": 0.5,
          "cached": false
        }
      }
    },
    "scoring_version": "2026-04-08-v1",
    "methodology_url": "https://shopgraph.dev/methodology"
  }
}

B2B Awareness

For B2B products, the scoring system detects and rewards additional fields:

• MOQ (Minimum Order Quantity) — detected from product pages
• Lead time — shipping/delivery time for bulk orders
• Bulk pricing tiers — volume discount breakpoints
• Manufacturer part number — cross-reference capability