GoBuy Product Trust

Return the GoBuy Evidence Score (0-100) and complete signal breakdown for a single retailer listing on Amazon, Walmart, Target, or Best Buy. This is the GPV-1 gate evaluator: score >= 55 PASS, 35-54 FLAG, < 35 or not-indexed BLOCK. The returned verdict is an evidence tier (strong/moderate/weak), not a computed GPV-1 checkout decision. Use this for individual product lookups. To compare and rank multiple products, use `compare_products` instead. Use `analyze_reviews` only for explicitly requested Amazon review-sample analysis; this lookup never fetches reviews. Read-only — does not modify any state or place orders. Scores describe available marketplace records, not product quality or purchase recommendations.

{
  "type": "object",
  "properties": {
    "retailer": {
      "type": "string",
      "enum": [
        "amazon",
        "walmart",
        "target",
        "bestbuy"
      ],
      "description": "Marketplace containing the listing: amazon, walmart, target, or bestbuy."
    },
    "product_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Native retailer product ID, such as an Amazon ASIN (e.g. 'B0BXYCS74H')."
    }
  },
  "required": [
    "retailer",
    "product_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch Evidence Scores for 2-20 retailer listings and rank them by GoBuy Evidence Score (highest first). Use this when an agent is choosing between multiple products. For a single product lookup, use `check_product_trust` instead. Read-only — does not modify any state or place orders, and never fetches reviews. Unindexed products rank last. This is not purchase advice.

{
  "type": "object",
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "retailer": {
            "type": "string",
            "enum": [
              "amazon",
              "walmart",
              "target",
              "bestbuy"
            ],
            "description": "Marketplace containing the listing: amazon, walmart, target, or bestbuy."
          },
          "product_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "description": "Native retailer product ID, such as an Amazon ASIN (e.g. 'B0BXYCS74H')."
          }
        },
        "required": [
          "retailer",
          "product_id"
        ],
        "additionalProperties": false
      },
      "minItems": 2,
      "maxItems": 20,
      "description": "Array of 2-20 product references to compare and rank."
    }
  },
  "required": [
    "products"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Analyzes up to 100 recent reviews (~30-90 seconds). Bright Data can take longer. Use only when Amazon review-sample analysis is explicitly requested; use `check_product_trust` for an existing evidence score or `compare_products` to rank listings. On-demand sampling without your cookie; reviews are sorted within the returned sample, but the provider does not guarantee the listing's newest 100. May trigger paid Bright Data collection and writes a seven-day analysis cache. force_refresh bypasses that cache and may start another paid scrape. A later explicit call without force_refresh resumes a pending job without a new scrape. Heuristics do not prove authenticity.

{
  "type": "object",
  "properties": {
    "retailer": {
      "type": "string",
      "enum": [
        "amazon",
        "walmart",
        "target",
        "bestbuy"
      ],
      "description": "Marketplace containing the listing: amazon, walmart, target, or bestbuy."
    },
    "product_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Native retailer product ID, such as an Amazon ASIN (e.g. 'B0BXYCS74H')."
    },
    "force_refresh": {
      "type": "boolean",
      "default": false,
      "description": "Bypass the seven-day cache; may start a new paid review scrape. Leave false to reuse cache or resume a pending job."
    }
  },
  "required": [
    "retailer",
    "product_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Retrieve a previously scored independent store or Shopify storefront by domain: agent-readiness, trust signals, structured data, and review system. Use this first for an existing store score; it is read-only and does not crawl. If not scored yet, use `scan_store` for an explicit fresh scan. For a retailer product listing rather than a storefront, use `check_product_trust`.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "maxLength": 253,
      "pattern": "^(?=.{1,253}$)[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Score any online store live with a fresh crawl (~20 seconds). Use when `check_store_score` returns 404 or a fresh scan is explicitly requested. Use `check_store_score` instead to retrieve an existing result without crawling. Requires a full HTTP(S) URL and updates the stored store score; repeated calls can trigger new scans. For marketplace product evidence, use `check_product_trust` instead. Docs: https://docs-gobuy.pages.dev

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}