{
  "capability_id": "brand_visibility_snapshot",
  "name": "Brand Visibility Snapshot",
  "examples_url": "/agents/examples/brand-visibility.json",
  "examples": [
    {
      "name": "Minimal request",
      "request": {
        "brand_name": "Mandarin Oriental"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "brand_visibility_snapshot",
          "schema_version": "1.0.0",
          "summary": "Brand Visibility Snapshot example response for agent integration testing.",
          "confidence": "medium",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "available",
              "freshness": "recent",
              "confidence": "medium",
              "limitations": []
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Example values are illustrative and should not be treated as live market evidence.",
            "Use production responses for current source health and confidence."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "score": 68,
          "strengths": [
            "Known brand demand exists across China-facing discovery surfaces."
          ],
          "gaps": [
            "Owned conversion routing remains only partially evidenced."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.63",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Full request",
      "request": {
        "brand_name": "Mandarin Oriental",
        "category": "luxury hospitality",
        "market_scope": "China outbound travelers evaluating Singapore",
        "notes": "Focus on RED, Douyin, WeChat service readiness, and search visibility.",
        "budget_usd": "0.63"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "brand_visibility_snapshot",
          "schema_version": "1.0.0",
          "summary": "Brand Visibility Snapshot example response for agent integration testing.",
          "confidence": "medium",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "available",
              "freshness": "recent",
              "confidence": "medium",
              "limitations": []
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Example values are illustrative and should not be treated as live market evidence.",
            "Use production responses for current source health and confidence."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "score": 68,
          "strengths": [
            "Known brand demand exists across China-facing discovery surfaces."
          ],
          "gaps": [
            "Owned conversion routing remains only partially evidenced."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.63",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Payment required",
      "request": {
        "brand_name": "Mandarin Oriental"
      },
      "response": {
        "success": false,
        "ok": false,
        "error": {
          "code": "PAYMENT_REQUIRED",
          "message": "Payment is required before this resource can be accessed.",
          "recoverable": true,
          "suggested_fix": "Attach a valid x402 payment proof for the listed capability price."
        },
        "meta": {
          "request_id": "req_example_error",
          "generated_at": "2026-05-02T00:00:00+08:00"
        }
      }
    },
    {
      "name": "Successful paid response",
      "request": {
        "brand_name": "Mandarin Oriental",
        "category": "luxury hospitality",
        "market_scope": "China outbound travelers evaluating Singapore",
        "notes": "Focus on RED, Douyin, WeChat service readiness, and search visibility.",
        "budget_usd": "0.63"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "brand_visibility_snapshot",
          "schema_version": "1.0.0",
          "summary": "Brand Visibility Snapshot example response for agent integration testing.",
          "confidence": "medium",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "available",
              "freshness": "recent",
              "confidence": "medium",
              "limitations": []
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Example values are illustrative and should not be treated as live market evidence.",
            "Use production responses for current source health and confidence."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "score": 68,
          "strengths": [
            "Known brand demand exists across China-facing discovery surfaces."
          ],
          "gaps": [
            "Owned conversion routing remains only partially evidenced."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.63",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Degraded source response",
      "request": {
        "brand_name": "Mandarin Oriental",
        "category": "luxury hospitality",
        "market_scope": "China outbound travelers evaluating Singapore",
        "notes": "Focus on RED, Douyin, WeChat service readiness, and search visibility.",
        "budget_usd": "0.63"
      },
      "response": {
        "success": true,
        "data": {
          "capability_id": "brand_visibility_snapshot",
          "schema_version": "1.0.0",
          "summary": "Brand Visibility Snapshot example response for agent integration testing.",
          "confidence": "low",
          "source_health": [
            {
              "source": "Public China signal layer",
              "status": "limited",
              "freshness": "recent",
              "confidence": "low",
              "limitations": [
                "Source coverage is partial for this request."
              ]
            },
            {
              "source": "Private platform backend analytics",
              "status": "not_checked",
              "freshness": "unknown",
              "confidence": "low",
              "limitations": [
                "No private account analytics are included in this example."
              ]
            }
          ],
          "limitations": [
            "Source coverage is partial; treat this output as directional until rechecked."
          ],
          "recommended_next_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ],
          "score": 68,
          "strengths": [
            "Known brand demand exists across China-facing discovery surfaces."
          ],
          "gaps": [
            "Owned conversion routing remains only partially evidenced."
          ],
          "priority_actions": [
            "Validate the returned source_health before presenting the result to an end user.",
            "Retry with narrower context if confidence is low or source coverage is limited."
          ]
        },
        "meta": {
          "request_id": "req_example_success",
          "generated_at": "2026-05-02T00:00:00+08:00",
          "pipeline_version": "v2"
        },
        "pricing": {
          "amount_usd": "0.63",
          "billing_basis": "per_request",
          "payment_status": "paid"
        }
      }
    },
    {
      "name": "Insufficient input error",
      "request": {},
      "response": {
        "success": false,
        "ok": false,
        "error": {
          "code": "INSUFFICIENT_INPUT",
          "message": "Request parameters failed validation.",
          "recoverable": true,
          "suggested_fix": "Provide brand_name and retry the request.",
          "missing_fields": [
            "brand_name"
          ]
        },
        "meta": {
          "request_id": "req_example_error",
          "generated_at": "2026-05-02T00:00:00+08:00"
        }
      }
    }
  ]
}