Claude를 사용하여 무료 클라이언트 사이드 팩트 체크 도구 구축 — BYOK, 백엔드 없음, 4가지 구조화된 검증
요약
Claude를 활용하여 백엔드 없이 클라이언트 사이드에서 작동하는 팩트 체크 도구인 'Reality Check'를 소개합니다. 사용자의 API 키를 직접 사용하는 BYOK 방식을 채택하여 보안과 비용 효율성을 동시에 확보했습니다.
핵심 포인트
- 출처, 증거, 맥락, 감정의 4가지 독립적 검증 구조
- 백엔드와 DB가 없는 완전한 클라이언트 사이드 아키텍처
- 사용자 API 키를 브라우저 상태에만 유지하는 보안 설계
- Claude의 웹 검색 도구를 활용한 실시간 정보 검증
문제점
대부분의 팩트 체크 (fact-checking) 도구는 추론 과정을 설명하지 않고 결과만 제공합니다. 이는 장기적으로 유용하지 않습니다. 사용자는 답변은 얻을 수 있지만, 다음 헤드라인을 스스로 생각할 수 있는 프레임워크를 얻지는 못하기 때문입니다.
내가 만든 것
Reality Check는 실시간 웹 검색 기능이 있는 Claude를 사용하여 모든 헤드라인에 대해 네 가지 독립적인 검증을 수행합니다:
- 출처 검증 (Source Check) — 누가 이것을 만들었는가, 출처가 신뢰할 수 있는가?
- 증거 검증 (Evidence Check) — 어떤 증거가 주장을 뒷받침하는가, 검증 가능한가?
- 맥락 검증 (Context Check) — 이것이 최근의 것이며 원래의 맥락에 있는가?
- 감정 검증 (Emotional Check) — 프레이밍 (framing)이 정보를 전달하기보다 조작하도록 설계되었는가?
각 검증은 결과와 추론을 반환합니다. 0~100 사이의 전체 신뢰도 점수가 전체 상황을 요약합니다.
아키텍처 (Architecture)
완전한 클라이언트 사이드 (client-side) 방식입니다. 백엔드 서버가 없습니다. 데이터베이스가 없습니다. 제가 운영하는 서버리스 함수 (serverless functions)도 없습니다.
BYOK (Bring Your Own Key) — 사용자가 자신의 Anthropic API 키를 직접 제공합니다. 키는 React 컴포넌트 상태 (state)에만 존재하며, localStorage나 쿠키에 절대 기록되지 않습니다. 페이지를 닫으면 삭제됩니다. API 호출은 anthropic-dangerous-direct-browser-access 헤더를 사용하여 브라우저에서 api.anthropic.com으로 직접 전송됩니다.
스택 (Stack): React 18 + Vite, Tailwind CSS, web_search_20250305 도구가 포함된 claude-sonnet-4-6 (분석당 최대 2회 검색으로 제한).
실제 예시
테스트 대상: _"Senate Passes Resolution Directing Trump to End Hostilities With Iran" (상원, 트럼프에게 이란과의 적대 행위를 중단하도록 지시하는 결의안 통과)"
점수: 88/100 — 신뢰할 수 있음 (Likely Reliable). 출처와 증거 모두 양호함 (NBC, CBS, NPR, PBS, ABC, AP를 통해 확인됨). 맥락과 감정은 주의 필요 (Use Caution)로 표시됨 — "지시한다 (Directs)"라는 단어는 법적 강제성을 암시하지만, 실제 결의안은 상징적이며 구속력이 없습니다. 개념 스포트라이트: 클릭베이트 (Clickbait).
기술적으로는 정확하지만, 의도적으로 오해를 불러일으키는 프레이밍입니다. 이 도구는 그 차이를 잡아냅니다.
링크
- 라이브: https://realitycheck-project.vercel.app
- 소스: https://github.com/Virerra/reality-check
- 라이선스: MIT
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기