{
  "schema_version": "sourcestrand-product-offer-v1",
  "product_id": "tw_public_company_signals_pack",
  "title": "Taiwan Public Company Signals Pack",
  "service_name": "Taiwan Public Company Signals Pack",
  "buyer_summary": "Which Taiwan listed-company profile, revenue, ESG, patent, and risk-policy streams help a buyer or AI assistant enrich public-company research without investment advice?",
  "canonical_base_url": "https://api.sourcestrand.com",
  "primary_buyer_jobs": [
    "AI research agents enriching Taiwan public-company watchlists with official-source context.",
    "B2B analysts linking public companies to revenue, patents, ESG, trade, or public-risk policy streams.",
    "Market researchers who need English buyer fields while preserving official source lineage."
  ],
  "free_validation": {
    "preview_url": "https://api.sourcestrand.com/v1/preview/tw-data-packs/public-company-signals",
    "expected_preview_shape": [
      "product",
      "package_scope",
      "streams",
      "sample_records",
      "concrete_sample_records",
      "record_backed_pack",
      "agent_specific_contracts",
      "entity_linking_contract",
      "change_feed_preview",
      "supplier_candidate_workflow",
      "stream_readiness",
      "coverage_summary",
      "freshness_policy",
      "agent_cache",
      "buyer_action_pack",
      "paid_unlock",
      "data_lineage",
      "limitations"
    ],
    "agent_tools_url": "https://api.sourcestrand.com/agent-tools.json",
    "route_intent_url_template": "https://api.sourcestrand.com/v1/agent/route-intent?query={buyer_question}",
    "change_feed_preview_url": "https://api.sourcestrand.com/v1/preview/changes/tw-data-packs?pack=public-company-signals&since={iso_datetime}",
    "dossier_preview_url": "https://api.sourcestrand.com/v1/preview/tw-company/dossier?query={business_id_or_name}"
  },
  "agent_purchase_hint": {
    "recommended_base_url": "https://api.sourcestrand.com",
    "recommended_network": "eip155:8453",
    "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name",
    "pay_when": [
      "The free preview matches the buyer task and the agent needs the complete record-backed buyer pack.",
      "The buyer wants to decide which Taiwan official-source streams should become the next paid data package.",
      "The buyer wants supplier candidates, sample record shapes, top fields, and next endpoint paths in one agent handoff.",
      "The response will be used to brief a human analyst or agent workflow with lineage and limitations preserved."
    ],
    "do_not_pay_when": [
      "Financial advice, valuation output, allocation guidance, or trading signal.",
      "Credit scoring, ESG scoring, legal advice, procurement advice, or risk clearance.",
      "A complete raw history export across every public-company disclosure."
    ]
  },
  "paid_endpoints": [
    {
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/public-company-signals",
      "price": "$0.03",
      "best_first_paid_step": true
    }
  ],
  "deeper_packs": [
    {
      "pack_id": "tw_company_brief",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-company/brief?business_id={business_id}",
      "use_when": "The buyer has a listed-company business_id and needs company-level context."
    },
    {
      "pack_id": "tw_procurement_supplier_lead_pack",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-procurement/supplier-lead-pack?q={keyword}",
      "use_when": "The buyer wants public procurement activity or incumbent context around a public company or sector."
    },
    {
      "pack_id": "tw_trade_import_export_pack",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/trade-import-export",
      "use_when": "The buyer wants trade category or country exposure streams adjacent to public-company research."
    },
    {
      "pack_id": "tw_compliance_risk_pack",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/compliance-risk",
      "use_when": "The buyer wants ESG, labor, environment, or other public-risk streams in the same research packet."
    }
  ],
  "entity_linking_contract": {
    "schema_version": "taiwan-entity-linking-contract-v1",
    "identity_keys": [
      "business_id",
      "company_name_zh",
      "company_name_en",
      "stock_code",
      "factory_name_zh",
      "source_record_key"
    ],
    "normalization_steps": [
      "Preserve original source-language names.",
      "Normalize whitespace and punctuation only for matching.",
      "Treat business_id and stock_code as routing hints, not legal identity certification."
    ],
    "next_free_endpoint": "https://api.sourcestrand.com/v1/preview/tw-company/dossier?query={business_id_or_name}",
    "next_paid_endpoints": [
      "https://api.sourcestrand.com/v1/paid/tw-company/brief?business_id={business_id}",
      "https://api.sourcestrand.com/v1/paid/tw-procurement/company-activity?business_id={business_id}",
      "https://api.sourcestrand.com/v1/paid/tw-entity-graph/relationship-pack?business_id={business_id}",
      "https://api.sourcestrand.com/v1/paid/tw-semiconductor/company-pack?business_id={business_id}"
    ],
    "boundary": "Entity linking is for buyer workflow routing and enrichment. It is not legal identity certification, beneficial ownership proof, credit scoring, or supplier ranking."
  },
  "freshness_policy": {
    "cache_ttl_seconds": 21600,
    "stale_after_seconds": 16200,
    "safe_to_cache": true,
    "valid_until_basis": "Preview and product metadata are generated per request; agents should re-fetch when stale before paying."
  },
  "x402_purchase": {
    "protocol": "x402",
    "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name",
    "payment_header_behavior": "Paid routes return HTTP 402 with PAYMENT-REQUIRED, Bazaar discovery metadata, and machine-readable x402 accepts when no valid payment header is provided.",
    "safety_note": "The buyer client signs locally. Do not send wallet private keys to this API."
  },
  "advice_boundary": "Informational record-backed buyer pack only; not legal, compliance, procurement, credit, investment, tax, accounting, or trading advice."
}