odp-oa-cli

USPTO ODP(Open Data Portal) API를 통해 미국 특허 심사과정 문서를 다운로드하고, XML 파싱을 거쳐 구조화된 Markdown으로 변환하는 CLI 도구.

생성된 MD 파일을 Claude Code, Gemini CLI 등 AI 에이전트에게 전달하여 심사 전략 분석을 수행하는 워크플로우를 지원한다.

요구사항

• Python 3.13+
• uv
• USPTO API 키 (ODP 포털에서 발급)

설치

# 로컬 개발
uv sync

# PyPI에서 설치
pip install odp-oa-cli

API 키 설정

# 대화형 설정 (권장) — ~/.oa-cli.toml 에 저장
uspto-oa configure

# 현재 설정 확인
uspto-oa configure --show

또는 환경변수로 지정:

export USPTO_API_KEY=your_api_key_here

사용법

# 1. 문서 다운로드 (file/{app_num}/ 에 저장)
uspto-oa download 16330077

# 2. XML 파싱 → prosecution.md 생성
uspto-oa extract 16330077
# 결과: file/16330077/16330077_prosecution.md

# 특허번호 입력 (출원번호 자동 변환)
uspto-oa download US12228644B2

# 특정 문서 코드만 다운로드
uspto-oa download 16330077 --doc-codes CTNF,CTFR,NOA

# 강제 재다운로드 (기존 파일 덮어쓰기)
uspto-oa download 16330077 --force

# 상세 로그
uspto-oa -v download 16330077

# 일회성 API 키 지정
uspto-oa download 16330077 --api-key YOUR_KEY

커맨드 옵션

uspto-oa download <application>

uspto-oa extract <application>

워크플로우

uspto-oa download {app_num}
    └─ file/{app_num}/ 에 XML / PDF 저장

uspto-oa extract {app_num}
    └─ file/{app_num}/{app_num}_prosecution.md 생성
         └─ AI 에이전트 (Claude Code / Gemini CLI)
              └─ 심사 전략 분석, 요약, 질의응답

수집 대상 문서 코드

생성 파일 구조

file/{app_num}/{app_num}_prosecution.md:

PyPI 배포

uv build
uv run twine upload dist/*