About

프로젝트 개요

Clinicaltrials.gov Watcher는 선택된 치료 타겟(예: CCR8, TIGIT, B7-H3)과 관련된 임상시험의 변동 사항을 추적하도록 설계된 자동 모니터링 시스템입니다. ClinicalTrials.gov API v2를 활용하여, 이 프로젝트는 연구자와 임상의에게 경쟁 환경에 대한 명확하고 최신의 뷰를 제공합니다.

주요 기능

  • 자동 탐색 (Auto-Discovery): 정의된 타겟과 일치하는 새로운 임상시험을 자동으로 검색하고 등록합니다.
  • 자동 모니터링 (Automated Monitoring): 여러 타겟에 대한 임상시험의 상태 및 주요 매개변수에 대한 일 단위 업데이트를 제공합니다.
  • 변경 감지 (Change Detection): 모집 현황, 단계, 예상 종료일 등의 의미 있는 변화를 강조하는 지능형 비교(diffing) 엔진을 포함합니다.
  • 데이터 인사이트 (Data Insights): 각 타겟에 대한 임상시험 동향과 분포를 이해하는 데 도움이 되는 대화형 시각화 자료를 제공합니다.
  • 오픈 데이터 (Open Data): 심층 분석을 위해 통합된 모든 원시 데이터를 CSV 형식으로 다운로드할 수 있습니다.

동작 방식

  1. 자동 탐색 (Auto-Discovery): 각 타겟을 검색어로 새로운 임상에 대해 ClinicalTrials.gov API를 호출해 trials.yaml을 자동으로 추가합니다.
  2. 일일 감시 (Daily Watch): GitHub Actions 워크플로우가 24시간마다 실행되어 trials.yaml에 나열된 모든 NCT ID에 대한 최신 데이터를 가져옵니다.
  3. 분석 (Analysis): src/main.py 스크립트가 현재 데이터와 이전 스냅샷을 비교하여 변경 사항을 식별합니다.
  4. 리포트 생성 (Report Generation): 업데이트 내역이 타겟별 페이지에 기록되며, 최신 통계로 요약 정보가 갱신됩니다.
  5. 배포 (Publishing): 업데이트된 Quarto 웹사이트가 GitHub Pages에 자동으로 배포됩니다.

데이터 출처

모든 데이터는 공식 API를 통해 ClinicalTrials.gov에서 수집됩니다.

이 프로젝트는 Python, Quarto 및 GitHub Actions를 사용하였습니다.