bibverify-opencode

BibTeX 인용 메타데이터 검증 도구. OpenCode /bib 명령어 플러그인 + CLI.

논문의 BibTeX 파일에서 인용 정보(저자, 연도, 저널, 볼륨, 페이지 등)가 실제 논문 메타데이터와 일치하는지 CrossRef/OpenAlex API를 통해 자동 검증합니다.

OpenCode 플러그인으로 설치 (권장)

1. Python 패키지 설치 (런타임 의존성)

pip install git+ssh://[email protected]/YOUR_USERNAME/bibverify-opencode.git

# 또는 로컬
pip install /path/to/bibverify-opencode

2. opencode.json에 플러그인 추가

npm에 퍼블리시한 경우:

{
  "plugin": [
    "oh-my-opencode@latest",
    "bibverify-opencode"
  ]
}

로컬 개발 또는 private repo인 경우:

{
  "plugin": [
    "oh-my-opencode@latest",
    "file:///path/to/bibverify-opencode"
  ]
}

3. 사용

OpenCode에서 /bib 명령어를 사용합니다. AI 도구로 노출되지 않으며, 명시적으로 명령어를 입력할 때만 동작합니다.

/bib                    # 프로젝트 내 모든 .bib 파일 자동 탐색 + 검증
/bib refs.bib           # 특정 파일 검증
/bib path/to/refs.bib   # 경로 지정

검증 결과는 AI에게 자동 전달되어 분석 요약을 제공합니다.

CLI로 직접 사용

pip install .

# 기본 실행
bibverify refs.bib

# 모든 필드 표시
bibverify refs.bib --verbose

# JSON 출력
bibverify refs.bib --output json

# API rate limit 개선 (이메일 등록)
bibverify refs.bib --email [email protected]

검증 흐름

BibTeX 엔트리
    │
    ▼
[1] DOI → CrossRef 직접 조회
    │ 실패
    ▼
[2] 제목 → CrossRef 검색 (상위 3건 매칭)
    │ 실패
    ▼
[3] DOI → OpenAlex 조회
    │ 실패
    ▼
[4] 제목 → OpenAlex 검색
    │ 실패
    ▼
  NOT FOUND

검증 결과 해석

| 상태 | 점수 | 의미 | |------|------|------| | ✓ PASS | ≥ 85% | 모든 메타데이터 일치 | | ~ WARN | 55-85% | 일부 필드 불일치 | | ✗ FAIL | < 55% | 심각한 불일치 | | — N/A | 0% | 논문을 찾지 못함 |

필드별 비교 항목: title, authors, year, journal, volume, number, pages, doi, publisher

API 정보

• CrossRef (1차): 무료, API 키 불필요. email 등록 시 polite pool (50 req/sec)
• OpenAlex (폴백): 무료, 일 100회 (이메일 없이), 100K회 (이메일 등록)

라이선스

MIT