google-patent-cli 0.1.1

Google Patents metadata fetcher — command-line tool

google-patent-cli

Google Patents에서 특허 메타데이터를 조회하는 커맨드라인 도구입니다.

설치

# pipx (권장 — 격리된 환경)
pipx install google-patent-cli

# uv
uv tool install google-patent-cli

# pip
pip install google-patent-cli

사용법

특허 조회

# 기본 (JSON 출력)
gpc lookup US20250350789

# 텍스트 형식
gpc lookup US12514139B2 --format text

# TSV 형식
gpc lookup US20250350789 --format tsv

# 단일 필드만 출력
gpc lookup US20250350789 --field title

# 여러 필드 선택
gpc lookup US20250350789 --fields title,assignee,filing_date

# 파일로 저장
gpc lookup US12514139B2 --output-dir ./output
gpc lookup US12514139B2 --format text --output-dir ./output

사용 가능한 필드 목록

gpc fields

필드명	설명
publication_number	공개번호 (예: US12514139B2)
number_without_kind	Kind code 제외 번호
application_number	출원번호
kind_code	Kind code (예: B2, A1)
country	국가 코드
title	발명의 명칭
abstract	요약
inventors	발명자 목록
assignee	출원인 / 양수인
filing_date	출원일
publication_date	공개일
cpc_codes	CPC 분류 코드 목록
claims	청구항 목록
description	상세설명 전문

프록시 / SSL 설정

사내 네트워크나 프록시 환경에서는 설정 파일을 사용합니다.

gpc configure

설정은 ~/.patent-cli.toml 에 저장됩니다.

[proxy]
https = "http://proxy.example.com:8080"
http  = "http://proxy.example.com:8080"

[ssl]
ca_bundle = "/path/to/ca-bundle.crt"

옵션

gpc lookup --help

Options:
  -f, --format [json|text|tsv]  출력 형식 (기본: json)
  --field FIELD                  단일 필드 값만 출력
  --fields F1,F2,...             쉼표 구분 필드 목록
  -t, --timeout INTEGER          HTTP 타임아웃 (초, 기본: 15)
  -o, --output-dir DIR           결과 파일 저장 폴더
  -v, --verbose                  디버그 로그 출력

python -m 으로 실행

python -m google_patent_cli lookup US12514139B2

면책 조항

이 도구는 Google Patents 공개 웹 페이지를 스크래핑합니다. Google 이용 약관을 준수하여 사용하세요. 과도한 요청은 IP 차단으로 이어질 수 있습니다.

라이선스

MIT