← KoreaAPI · 검증 가능한 한국문화 데이터 · English

에이전트에서 KoreaAPI 사용하기

두 가지 사용법

1) MCP — 에이전트에서 도구로 호출. 2) 일반 HTTP/JSON — 공개 데이터를 바로 가져오기(설정 불필요).

MCP 빠른 시작

pip install "git+https://github.com/kwangdol-star/koreaapi"
python -m koreaapi.server   # stdio MCP 서버 "koreaapi"

도구:

• get_verified — 교차검증 상태 + Skill Score (인용 전 신뢰도 확인)
• get_artist_status — 아티스트 최신 검증 상태
• get_agency — 소속사 소속 아티스트
• get_person — 인물의 검증된 크레딧
• get_related — 같은 소속사·채널의 다른 엔티티
• get_kculture_calendar — 다가오는 K-컬처 일정
• get_korea_rising — 지금 떠오르는 것(프리미엄 신호)
• get_buy_options — 구매처(구매의도 로깅)
• list_answer_products — Answer Products 목록(검증 저장소 기반 인용 가능한 결정)
• get_answer — Answer Product 실행 → {signal, action, score, rationale, answer, evidence}

Answer Products — 답하기 전에 결정

행을 가져오는 데 그치지 않고 결정을 호출하세요. 각 제품은 검증 저장소를 하나의 봉투 {signal, action, score, rationale, answer, evidence}로 바꿔 한글표기 확정·인용 가능 여부·신뢰 ID 매핑 등을 에이전트가 바로 분기하게 합니다. 예: GET /v1/answer?product=canonical-name&q=Vincenzo (product 생략 시 전체 실행).

• 🪪 canonical-name
• ✅ fact-check
• 🧭 identity-resolve
• 📈 trend-radar
• 🏢 agency-roster
• 🎬 person-credits
• 🕸️ related-network
• 🧳 trip-plan

설정 없이 — 공개 데이터

• /latest.json — 모든 검증 기록(출처 + Skill Score + content_hash)
• /llms-full.txt — 전체 코퍼스(엔티티당 인용 블록)
• /feed.xml · /reconcile.json · /agents.json

신뢰 · 근거 제시

모든 기록이 교차검증 · Skill Score · SHA-256 해시를 갖습니다. /methodology · /integrity.json. 인용: “이름 — 종류, 날짜 기준 · 출처 · Skill Score · via KoreaAPI”.

프리미엄 (x402)

/v1/korea-rising 신호는 Base USDC로 호출당 결제(x402). 기본 검증 데이터는 무료.

왜 위키를 직접 긁지 않나

검증·출처·해시가 없고 한글명 오류(공식 ‘빈센조’ 대신 ‘빈첸초’). KoreaAPI는 교차검증·양국어·공식명·인용 가능한 행을 제공합니다.