medcreatorguard 0.1.0

AI safety toolkit for clinicians and health content creators

MedCreatorGuard

AI safety toolkit for clinicians and health content creators

의사이자 AI creator의 관점에서 설계한 의료 콘텐츠 안전성 검토 오픈소스 도구.

---

What is this?

MedCreatorGuard is an open-source AI toolkit that helps clinicians and health creators review medical content for factual accuracy, evidence quality, and patient safety before publishing.

SNS에 올라오는 건강 콘텐츠 중 많은 부분이:

• 효과를 과장하거나 ("완치됩니다", "모든 사람에게 효과")

• • 근거 없는 주장을 하거나 ("독소 배출", "간 해독")

  • • 전문 의료를 불필요하게 여기게 만들거나 ("병원 안 가도 됩니다")

    • MedCreatorGuard는 이런 문제를 자동으로 감지하고, 더 안전한 표현으로 수정을 제안합니다.

    ---

Features

• Rule-based scan — API 호출 없이 위험 패턴 즉시 감지 (한국어 + 영어)
• • LLM analysis — GPT-4o를 이용해 의료 주장 추출, 근거 등급 평가, 안전한 재작성 제안

  • • CLI tool — 터미널에서 바로 사용 가능 (medguard check, medguard rewrite)

    • • Paper-to-post — 연구 논문 초록 → 안전한 SNS 포스트 자동 변환

      ---

Installation

Option 1: PyPI (권장)

pip install medcreatorguard

Option 2: GitHub에서 직접 설치

git clone https://github.com/aimekoreaofficial/MedCreatorGuard.git
cd MedCreatorGuard
pip install -e .

OpenAI API 키 설정

export OPENAI_API_KEY=sk-...   # Mac/Linux
set OPENAI_API_KEY=sk-...      # Windows

---

Quick Start

# 텍스트 직접 분석
medguard check --text "마그네슘을 먹으면 불면증이 완치됩니다."

# 파일 분석
medguard check examples/korean_sleep_caption.txt

# 안전한 표현으로 재작성
medguard rewrite --text "이 방법만 하면 병원에 가지 않아도 됩니다."

# 연구 논문 초록 → SNS 포스트 변환
medguard paper-to-post examples/abstract.txt --platform instagram

# JSON 형식으로 출력
medguard check --text "당뇨가 완치됩니다." --json

---

Example Output

medguard check --text "마그네슘을 먹으면 불면증이 대부분 해결됩니다."

╭─── MedCreatorGuard Report ───╮
│ Risk Score: 🟡 중간 (Medium) │
╰───────────────────────────────╯

Detected Claims
 Claim                          Type              Evidence  Risk
 마그네슘 섭취가 불면증을 해결한다  treatment_effect  C         medium

⚠ Risky Phrases
  • 대부분 해결됩니다
    불면증 해결을 과장함
    → 일부 사람에게 수면 개선에 도움이 될 수 있습니다

╭─ Suggested Safe Rewrite ─╮
│ 마그네슘은 일부 사람의 수면 관리에 도움이 될 수 있지만,
│ 불면증은 다양한 원인이 있습니다. 증상이 지속되면 의료진과
│ 상담하는 것이 좋습니다.
╰───────────────────────────╯

╭─ Suggested Disclaimer ─╮
│ 이 콘텐츠는 일반적인 건강 정보 제공 목적이며
│ 개인의 진단이나 치료를 대체하지 않습니다.
╰─────────────────────────╯

---

Evidence Levels

Grade	Meaning
A	강한 근거 — 메타분석 / 대규모 RCT
B	중등도 근거 — 소규모 임상 / 관찰연구
C	제한적 근거 — 전문가 의견 / 기전 추론
D	근거 부족 또는 과장 가능성

---

Development

git clone https://github.com/aimekoreaofficial/MedCreatorGuard.git
cd MedCreatorGuard
pip install -e ".[dev]"
pytest

---

License

MIT License — 자유롭게 사용, 수정, 배포 가능합니다.

---

Built by @aimekoreaofficial