KIPRIS 한국 지식재산 검색

스킬 범위: 이 스킬은 검색 도구이며 코딩/개발 컨텍스트와 무관합니다. 코드를 작성하는 중이 아니어도, 사용자가 특허·지식재산 검색을 요청하면 즉시 이 스킬을 사용합니다.

한국특허청(KIPRIS) Open API를 사용하여 특허, 실용신안, 디자인, 상표, 해외특허 등 한국 지식재산 정보를 검색합니다.

트리거

코딩 여부와 관계없이 사용자가 다음과 같은 요청을 할 때 이 스킬을 사용합니다:

• 한국 특허/실용신안 검색 (키워드, 출원번호, 출원인, 등록권자)
• 특허 서지정보 조회 (상세/요약)
• 해외특허 검색 (미국, 유럽, PCT, 일본, 중국 등)
• KIPRIS API를 사용한 지식재산 데이터 조회
• "/kipris" 슬래시 명령으로 직접 호출

API 키 확인

필수: 환경변수 KIPRIS_API_KEY가 설정되어 있어야 합니다.

echo $KIPRIS_API_KEY

미설정 시 안내:

1. KIPRIS Plus 회원가입 → API 키 발급 (OpenAPI 게이트웨이용 accessKey)
2. 공공데이터 포털 활용신청 → API 키 발급 (KIPO 게이트웨이용 ServiceKey)
3. export KIPRIS_API_KEY="발급받은키" 설정

두 게이트웨이가 동일 키를 공유할 수도 있고, 별도일 수도 있습니다. 사용자에게 확인하세요.

구현된 오퍼레이션 (Tier 1) — 즉시 사용 가능

한국 특허·실용신안 (7개)

해외특허 (5개)

해외특허 국가코드

collectionValues 파라미터 값 (다중 선택 불가):

URL 구성 규칙

# OpenAPI 게이트웨이 (accessKey)
http://plus.kipris.or.kr/openapi/rest/{ServicePath}/{operationId}?accessKey={KIPRIS_API_KEY}&param1=value1

# KIPO 게이트웨이 (ServiceKey)
http://plus.kipris.or.kr/kipo-api/kipi/{ServicePath}/{operationId}?ServiceKey={KIPRIS_API_KEY}&param1=value1

API 사용 제한

• ⚠️ 초당 호출 횟수: 반드시 50회 미만 유지 (초과 시 IP 차단)
• 월간 무료 호출: 1,000회/월 (무료 가입자 기준, 매월 1일 초기화)
• 미신청 API: 신청하지 않은 API 호출 시 resultCode: 101 (AccessKey&ServiceID Is Not Registerd Error) 등의 에러 반환
• 복합 호출 주의: 일부 검색(등록권자 검색 등)은 API 설계상 추가 호출이 필요하여 1회 검색에 여러 번 API를 소모합니다. 무료 사용자(월 1,000회)는 호출 횟수가 소중하므로, 복합 호출 전 반드시 사용자에게 안내하고 동의를 구하세요
• 반복 검색이나 페이지네이션 시 요청 간 적절한 간격을 유지할 것

실행 워크플로우

아래는 Claude가 사용자 검색 요청을 처리하기 위해 내부적으로 수행하는 단계입니다. 사용자는 자연어로 요청만 하면 됩니다.

1단계: API 키 확인

echo $KIPRIS_API_KEY

2단계: 사용자 의도 → 오퍼레이션 매핑

• 키워드 검색 → freeSearchInfo (국내) / freeSearch (해외)
• 출원번호로 조회 → applicationNumberSearchInfo (국내) / applicationNumberSearch (해외)
• 출원인 검색 → applicantNameSearchInfo (국내) / applicantSearch (해외)
• 등록권자 검색 → rightHolerSearchInfo (⚠️ 아래 "등록권자 검색 주의사항" 참고)
• 상세 서지정보 → getBibliographyDetailInfoSearch
• 요약 서지정보 → getBibliographySumryInfoSearch
• 전체검색 (다항목) → getAdvancedSearch

3단계: URL 구성 및 curl 실행

API 키에 /, +, = 등 특수문자가 포함될 수 있으므로 반드시 URL 인코딩합니다:

# API 키 URL 인코딩
ENCODED_KEY=$(python3 -c "import urllib.parse; print(urllib.parse.quote('${KIPRIS_API_KEY}', safe=''))")

# 예: 국내 자유검색
curl -s "http://plus.kipris.or.kr/openapi/rest/patUtiModInfoSearchSevice/freeSearchInfo?accessKey=${ENCODED_KEY}&word=인공지능&patent=true&utility=true&docsCount=10&docsStart=1"

4단계: XML → JSON 파싱

curl -s "URL" | python3 -c "
import sys, xml.etree.ElementTree as ET, json

def xml_to_dict(el):
    d = {}
    for child in el:
        tag = child.tag
        if len(child):
            val = xml_to_dict(child)
        else:
            val = (child.text or '').strip()
        if tag in d:
            if not isinstance(d[tag], list):
                d[tag] = [d[tag]]
            d[tag].append(val)
        else:
            d[tag] = val
    return d

tree = ET.parse(sys.stdin)
print(json.dumps(xml_to_dict(tree.getroot()), ensure_ascii=False, indent=2))
"

등록권자 검색 주의사항

rightHolerSearchInfo는 등록권자 기준으로 검색하지만, API 응답에 등록권자 필드가 포함되지 않습니다 (출원인만 반환). 이는 KIPRIS API의 설계 한계입니다.

등록권자를 결과에 표시하려면 2단계 호출이 필요합니다:

1. rightHolerSearchInfo로 검색 → 출원번호 목록 획득
2. 각 출원번호로 registrationLastRightHolderInfo (등록사항 서비스) 추가 호출 → 최종권리자명 획득

⚠️ API 호출 횟수 주의: 이 과정에서 결과 N건을 표시하면 1 + N회 API를 호출합니다. 무료 사용자는 월 1,000회 제한이 있으므로, 반드시 사용자에게 추가 호출이 발생한다는 점을 사전 안내하고 동의를 구하세요.

예시 안내 문구:

"등록권자 기준으로 검색합니다. KIPRIS API 제약으로 등록권자명을 표시하려면 결과 건수만큼 추가 API 호출이 필요합니다 (5건 요청 시 총 6회 호출). 진행할까요?"

5단계: 결과를 읽기 좋은 테이블 형식으로 사용자에게 제공

국내특허 결과 주요 필드:

• InventionName / inventionTitle — 발명의명칭
• ApplicationNumber / applicationNumber — 출원번호
• ApplicationDate / applicationDate — 출원일자
• Applicant / applicantName — 출원인
• RegistrationNumber / registerNumber — 등록번호
• RegistrationStatus / registerStatus — 등록상태
• Abstract / astrtCont — 초록

해외특허 결과 주요 필드:

• inventionName — 발명(고안)의명칭
• applicationNo — 출원번호
• applicationDate — 출원일자
• applicant — 출원인명
• registerNo — 등록번호
• colString — 국가코드
• ipc — IPC코드

전체 서비스 카탈로그 (Tier 2) — 49개 서비스

Tier 1에 없는 오퍼레이션 요청 시, docs/services/ 디렉토리의 해당 문서를 읽어 파라미터를 확인하세요. 경로 열: ✅ = ServicePath 확인 (즉시 호출 가능), ⚠️ = ServicePath 미확인