{
  "name": "KoreaAPI",
  "description": "The verifiable data layer for Korean culture — callable by any AI agent (MCP), citable by any answer engine. Cross-verified, bilingual, Skill-scored, hash-verifiable.",
  "homepage": "https://aiagentlabs.co.kr/",
  "repository": "https://github.com/kwangdol-star/koreaapi",
  "languages": [
    "en",
    "ko"
  ],
  "mcp": {
    "transport": "stdio",
    "command": "python -m koreaapi.server",
    "install": "pip install 'git+https://github.com/kwangdol-star/koreaapi'  (or clone + uv sync)",
    "tools": [
      {
        "name": "get_verified",
        "description": "cross-verification status + Skill Score (check trust BEFORE citing)"
      },
      {
        "name": "get_resolve",
        "description": "resolve a fuzzy name / external ID / canonical id -> the verified entity (+ external IDs)"
      },
      {
        "name": "get_artist_status",
        "description": "latest verified status for a Korean artist"
      },
      {
        "name": "get_agency",
        "description": "who is under a 소속사 / label"
      },
      {
        "name": "get_person",
        "description": "verified credits for a person (director / actor / idol)"
      },
      {
        "name": "get_related",
        "description": "entities sharing a 소속사 / network"
      },
      {
        "name": "get_kculture_calendar",
        "description": "upcoming K-culture events"
      },
      {
        "name": "get_korea_rising",
        "description": "what is rising in Korea now (premium signal)"
      },
      {
        "name": "get_buy_options",
        "description": "where to buy a release / ticket / goods (logs buy-intent)"
      },
      {
        "name": "list_answer_products",
        "description": "list the Answer Products — named, citable decisions over the verified store"
      },
      {
        "name": "get_answer",
        "description": "run an Answer Product -> {signal, action, score, rationale, answer, evidence}"
      }
    ]
  },
  "data": {
    "open_json": "https://aiagentlabs.co.kr/latest.json",
    "llms_txt": "https://aiagentlabs.co.kr/llms.txt",
    "llms_full_txt": "https://aiagentlabs.co.kr/llms-full.txt",
    "feed_rss": "https://aiagentlabs.co.kr/feed.xml",
    "feed_json": "https://aiagentlabs.co.kr/feed.json",
    "reconcile": "https://aiagentlabs.co.kr/reconcile.json",
    "status": "https://aiagentlabs.co.kr/status.json"
  },
  "verification": {
    "methodology": "https://aiagentlabs.co.kr/methodology.html",
    "integrity": "https://aiagentlabs.co.kr/integrity.json",
    "attestation_log": "https://aiagentlabs.co.kr/integrity-log.jsonl",
    "per_record": "content_hash (SHA-256) on every record in latest.json"
  },
  "answer_products": {
    "endpoint": "/v1/answer",
    "catalog": "/v1/answer  (no params) · ?product=&q= runs one · ?q= runs all",
    "envelope": [
      "product",
      "name",
      "signal",
      "action",
      "score",
      "rationale",
      "answer",
      "evidence"
    ],
    "products": [
      {
        "id": "canonical-name",
        "name": "Canonical Name Resolver",
        "sector": "Identity / AEO",
        "about": "Confirm the authoritative Korean ↔ English spelling of an entity before you assert it."
      },
      {
        "id": "fact-check",
        "name": "Citability / Fact Check",
        "sector": "Trust / AEO",
        "about": "Decide whether a claim about an entity is safe to cite (cross-/triple-verified / certified)."
      },
      {
        "id": "identity-resolve",
        "name": "Entity ID Resolver",
        "sector": "Reconciliation",
        "about": "Map a fuzzy mention or external ID onto the canonical verified KoreaAPI entity."
      },
      {
        "id": "trend-radar",
        "name": "Korea Demand Radar",
        "sector": "Trends",
        "about": "Read what is rising in Korea now from accumulated demand signal."
      },
      {
        "id": "agency-roster",
        "name": "Agency Roster",
        "sector": "Knowledge Graph",
        "about": "List the verified artists under a Korean agency/label (소속사)."
      },
      {
        "id": "person-credits",
        "name": "Person Credits",
        "sector": "Knowledge Graph",
        "about": "Aggregate a Korean-culture person's verified credits across works."
      },
      {
        "id": "related-network",
        "name": "Related Network",
        "sector": "Knowledge Graph",
        "about": "Find entities sharing the same agency/network hub edge."
      },
      {
        "id": "trip-plan",
        "name": "Trip Plan (Region)",
        "sector": "Travel",
        "about": "Verified places + festivals in a region, plus signature Korean dishes — itinerary raw material."
      }
    ],
    "note": "named, citable decisions over the verified store (the agent's pre-answer step)"
  },
  "premium": {
    "protocol": "x402",
    "endpoint": "/v1/korea-rising",
    "asset": "USDC on Base",
    "pricing": "https://aiagentlabs.co.kr/pricing.html",
    "note": "agents pay per call autonomously; dormant until a receiving wallet is configured"
  },
  "cite_as": "Name — kind, as of <date> · source · Skill Score · via KoreaAPI"
}