---
id: daily-korean-patent-search
name: "korean-patent-search"
url: https://skills.yangsir.net/skill/daily-korean-patent-search
author: nomadamas
domain: legal
tags: ["korean", "patent", "search", "legal", "api"]
install_count: 2400
rating: 4.30 (11 reviews)
github: https://github.com/nomadamas/k-skill
---

# korean-patent-search

> 通过韩国 KIPRIS Plus 官方 API 检索专利信息，支持关键词、申请号等多种查询方式

**Stats**: 2,400 installs · 4.3/5 (11 reviews)

## Before / After 对比

### 韩国专利信息检索效率提升

**Before**:

在没有 `korean-patent-search` 技能之前，用户需要手动访问 KIPRIS Plus 官方网站。他们必须在网页界面上输入关键词或出愿号进行搜索，然后逐页浏览结果。找到相关专利后，用户需要手动复制粘贴出愿号、发明名称、出愿人、摘要等信息到本地文档或电子表格中。如果需要结构化数据用于进一步分析或系统集成，则必须手动解析网页内容，这不仅耗时且容易出错，尤其当网站布局发生变化时。对于批量查询，这种手动操作的效率极低，且难以保证数据的一致性和准确性。

**After**:

使用 `korean-patent-search` 技能后，专利信息检索流程实现显著自动化。用户只需获取 KIPRIS Plus API 密钥，并通过提供的 `python3` 辅助脚本执行简单的命令行操作。无论是通过关键词（如 `python3 scripts/patent_search.py --query "배터리"`）进行搜索，还是通过出愿号查询详细信息，技能都能直接调用 KIPRIS Plus 官方 API。它会自动解析 XML 响应并输出结构化的 JSON 数据，包含出愿号、发明名称、出愿人、摘要等关键信息。这极大地提高了检索效率，确保数据格式统一性，并支持轻松集成到其他应用程序或自动化工作流中，节省大量手动处理时间。

| Metric | Before | After | Change |
|---|---|---|---|
| 检索单个专利所需时间 | 180秒 | 5秒 | -97.22% |
| 获取结构化数据所需额外处理时间 | 120秒 | 0秒 | -100% |

## Readme

# korean-patent-search

# 한국 특허 정보 검색

## What this skill does

KIPRIS Plus(키프리스 플러스) 공식 Open API로 한국 특허/실용신안 공개·공고 데이터를 검색한다.

v1 범위:

- 키워드 검색 (`getWordSearch`)

- 출원번호 기준 서지 상세 조회 (`getBibliographyDetailInfoSearch`)

- 구조화된 JSON 출력

- 표준 `python3` helper 동봉

## When to use

- "배터리 관련 한국 특허 찾아줘"

- "출원번호 1020240001234 특허 요약 보여줘"

- "KIPRIS API로 특허 검색 결과를 JSON으로 받고 싶어"

- "출원인/IPC/초록까지 포함한 한국 특허 검색 결과가 필요해"

## Prerequisites

- 인터넷 연결

- `python3`

- KIPRIS Plus에서 발급받은 API 키

helper 환경변수: `KIPRIS_PLUS_API_KEY`

- 실제 요청 쿼리 파라미터명: `ServiceKey`

- 설치된 skill payload 안에 `scripts/patent_search.py` helper 포함

## Inputs

- 키워드 검색

필수: `--query`

- 선택: `--year`

- 선택: `--page-no`

- 선택: `--num-rows`

- 선택: `--exclude-patent`

- 선택: `--exclude-utility`

- 상세 조회

필수: `--application-number`

## Workflow

- `KIPRIS_PLUS_API_KEY` 또는 `--service-key` 로 ServiceKey를 확보한다. 공공데이터포털에서 복사한 percent-encoded 값도 helper가 한 번 정규화해서 그대로 받을 수 있다.

- 키워드 검색이면 `getWordSearch` endpoint를 호출한다.

- 출원번호 상세 조회면 `getBibliographyDetailInfoSearch` endpoint를 호출한다.

- XML 응답의 header/body/items 구조를 파싱한다.

- 출원번호, 발명의명칭, 출원인, 초록, 공개/공고/등록 메타데이터를 JSON으로 정리한다.

## CLI examples

```
export KIPRIS_PLUS_API_KEY=your-service-key
python3 scripts/patent_search.py --query "배터리"
python3 scripts/patent_search.py --query "배터리" --year 2024 --num-rows 5
python3 scripts/patent_search.py --application-number 1020240001234

```

## Response policy

- 공식 KIPRIS Plus Open API 응답만 사용한다.

- 키가 없으면 `KIPRIS_PLUS_API_KEY` 또는 `--service-key` 를 정확히 안내한다.

- 검색 결과는 최소한 출원번호, 발명의명칭, 출원일자, 출원인, 초록을 포함해 정리한다.

- 상세 조회는 `getBibliographyDetailInfoSearch` 기준으로 공개/공고/등록 메타데이터를 함께 정리한다.

- API 에러 코드는 숨기지 말고 그대로 surfaced 한다.

## Done when

- 유효한 ServiceKey로 `getWordSearch` 또는 `getBibliographyDetailInfoSearch` 호출이 가능하다.

- helper가 JSON을 출력한다.

- 에러 시 `KIPRIS_PLUS_API_KEY` / `ServiceKey` 관련 안내가 분명하다.

- 응답에 출원번호와 발명의명칭이 포함된다.

## Notes

- KIPRIS Plus 포털: `https://plus.kipris.or.kr/portal/data/service/List.do?subTab=SC001&entYn=N&menuNo=200100`

- 공공데이터포털 문서: `https://www.data.go.kr/data/15058788/openapi.do`

- v1 helper는 `getWordSearch`, `getBibliographyDetailInfoSearch` 두 operation에 집중한다.

- 공공데이터포털 안내 기준으로 개발계정은 자동승인, 운영계정은 별도 심의 대상이다.

Weekly Installs514Repository[nomadamas/k-skill](https://github.com/nomadamas/k-skill)GitHub Stars3.1KFirst Seen6 days agoSecurity Audits[Gen Agent Trust HubPass](/nomadamas/k-skill/korean-patent-search/security/agent-trust-hub)[SocketPass](/nomadamas/k-skill/korean-patent-search/security/socket)[SnykPass](/nomadamas/k-skill/korean-patent-search/security/snyk)Installed onantigravity512codex512opencode511github-copilot511kimi-cli511amp511

---
*Source: https://skills.yangsir.net/skill/daily-korean-patent-search*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-korean-patent-search/markdown*