kipris-cli
/kipris-cli
Korean patent / trademark / design search via KIPRIS Plus OpenAPI (특허청). Search patents (특허/실용신안), trademarks (상표), and designs (디자인) by keyword, applicant, or application/registration number. Returns clean JSONL for AI agents. Use for prior-art search, competitor IP monitoring, brand-name availability checks, M&A due diligence, and Korean IP analytics. Requires a free KIPRIS_PLUS_KEY from plus.kipris.or.kr.
- Author
- LeoYeAI ↗
- Repository
- openclaw-master-skills ↗
- Licence
- MIT
- Last repository change
- 20.07.2026
Assessment and security
- Files in this package
- 14
- Scripts
- 10
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 20.07.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 10 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: bin/_kipris_common.sh, bin/_xml2jsonl.py, bin/applicant.sh, bin/design.sh, bin/patent-detail.sh, bin/patent.sh, bin/trademark.sh, examples/brand-availability-check.sh
What it does and when to use it
Korean patent / trademark / design search via KIPRIS Plus OpenAPI (특허청). Search patents (특허/실용신안), trademarks (상표), and designs (디자인) by keyword, applicant, or application/registration number. Returns clean JSONL for AI agents. Use for prior-art search, competitor IP monitoring, brand-name availability checks, M&A due diligence, and Korean IP analytics. Requires a free KIPRIS_PLUS_KEY from plus.kipris.or.kr.
Original author description
Korean patent / trademark / design search via KIPRIS Plus OpenAPI (특허청). Search patents (특허/실용신안), trademarks (상표), and designs (디자인) by keyword, applicant, or application/registration number. Returns clean JSONL for AI agents. Use for prior-art search, competitor IP monitoring, brand-name availability checks, M&A due diligence, and Korean IP analytics. Requires a free KIPRIS_PLUS_KEY from plus.kipris.or.kr.
How it works
- Quick start
- Subcommands
- Output schema (JSONL)
- Setup — getting a KIPRISPLUSKEY
- Examples
- Related skills
- Limits
- License
SKILL.md preview
---
name: kipris-cli
description: Korean patent / trademark / design search via KIPRIS Plus OpenAPI (특허청). Search patents (특허/실용신안), trademarks (상표), and designs (디자인) by keyword, applicant, or application/registration number. Returns clean JSONL for AI agents. Use for prior-art search, competitor IP monitoring, brand-name availability checks, M&A due diligence, and Korean IP analytics. Requires a free KIPRIS_PLUS_KEY from plus.kipris.or.kr.
license: MIT-0
---
# kipris-cli — Korean Patent / Trademark / Design search (KIPRIS Plus)
Five subcommands that wrap the **KIPRIS Plus OpenAPI** (특허청 한국특허정보원) — Korea's authoritative IP database covering ~5M patents, ~6M trademarks, ~1M designs. Every endpoint returns XML; this skill normalizes it to **JSONL** for AI-agent consumption.
> **Why this matters**: Korean IP lookups are otherwise locked behind kipris.or.kr's web UI. AI agents doing prior-art search, M&A target diligence, or brand-name availability checks need clean JSON access. This is the only ClawHub skill covering KIPRIS at the time of publish.
## Quick start
```bash
export KIPRIS_PLUS_KEY="<your-32-char-key>" # from plus.kipris.or.kr (free, ~1d approval)
# Patent search by keyword
bin/kipris-cli patent --word "양자컴퓨팅" --rows 10
# Trademark availability check
bin/kipris-cli trademark --word "AURORA" --rows 5
# Design search
bin/kipris-cli design --word "smart watch"
# Patent bibliographic detail by application number
bin/kipris-cli patent-detail --app-no 1020230012345
# Search patents by applicant name (개인/법인)
bin/kipris-cli applicant --name "삼성전자주식회사" --rows 20
```
## Subcommands
| Command | Endpoint | Use case |
|---|---|---|
| `patent` | `patUtiModInfoSearchSevice/patUtiModInfoSearch` | Patent + 실용신안 keyword search |
| `trademark` | `TrademarkInfoSearchService/trademarkInfoSearchInfo` | Brand availability + competitor TM watch |
| `design` | `DesignInfoSearchService/designInfoSearchInfo` | Industrial design search |
| `patent-detail` | `patUtiModInfoSearchSevice/patUtiModBibliographicInfoSearch` | Full bibliographic detail by 출원번호 |
| `applicant` | `patUtiModInfoSearchSevice/patUtiModInfoSearchByApplicantName` | All filings by applicant (출원인) |
### Common flags
- `--word "<query>"` — free-text Korean or English (UTF-8)
- `--app-no <13-digit>` — 출원번호 (1020230012345 = 특허, 4020210012345 = 상표, 3020230012345 = 디자인)
- `--rows N` — page size (default 30, max 500)
- `--page N` — 1-indexed page (default 1)
- `--format json|xml|jsonl` — output (default jsonl)
- `--key <KEY>` — override `$KIPRIS_PLUS_KEY`
### Patent-specific filters (subcommand `patent`)
- `--applicant "<name>"` — 출원인명
- `--inventor "<name>"` — 발명자명
- `--ipc "<code>"` — IPC 분류 (e.g. `G06N`)
- `--pat true|false` — include 특허 (default true)
- `--utility true|false` — include 실용신안 (default true)
- `--last-update YYYYMMDD` — 최종변경일 since
### Trademark-specific filters (subcommand `trademark`)
- `--applicant "<name>"`
- `--class "<NICE int>"` — 상품분류 (NICE classification 1-45)
- `--reg-status "registered|pending|rejected|expired"` — 권리상태
- `--start-date YYYYMMDD` / `--end-date YYYYMMDD` — 출원일 range
## Output schema (JSONL)
Each line is one record (patent/TM/design). Common fields normalized across types:
```json
{
"type": "patent",
"app_no": "1020230012345",
"title_ko": "양자 회로 최적화 방법 및 장치",
"title_en": "Method and apparatus for quantum circuit optimization",
"applicant": "삼성전자주식회사",
"inventors": ["홍길동", "김철수"],
"app_date": "20230101",
"reg_no": null,
"reg_date": null,
"pub_no": "1020240054321",
"pub_date": "20240715",
"ipc": ["G06N10/40", "G06F17/14"],
"abstract": "..."
}
```
Trademarks add `nice_class`, `tm_kind` (문자/도형/입체); designs add `locarno_class`, `parts`.
## Setup — getting a KIPRIS_PLUS_KEY
1. Sign up at <https://plus.kipris.or.kr> (free; corporate or individual).
2. 마이페이지 → API 신청 → 무료 quota (월 10,000건).
3. Approval is typically same-business-day for personal, 2-3 days for corporate.
4. Copy the 32-char `ServiceKey` and `export KIPRIS_PLUS_KEY=...`.
> ⚠️ The legacy `kipris.or.kr` API endpoints have been deprecated since 2024Q4. This skill uses the current `plus.kipris.or.kr/kipo-api/kipi/...` paths.
## Examples
- **`examples/competitor-patent-watch.sh`** — daily JSONL feed of new patents filed by a competitor (paginated + dedup).
- **`examples/brand-availability-check.sh`** — check if a brand name has TM filings in NICE classes 9, 35, 42 (typical SaaS classes).
- **`examples/m-and-a-ip-snapshot.sh`** — given a 사업자등록번호 (via `nts-bizno-cli`) → corporate name → all KIPRIS filings → consolidated CSV. Pairs naturally with `opendart-cli` for full M&A due-diligence chain.
## Related skills
- `opendart-cli` — corporate disclosures (pair for IP-vs-financial due diligence)
- `nts-bizno-cli` — KYB business-number lookup (anchor entity name)
- `juso-address-cli` — registered address resolution
- `kosis-cli` — R&D investment statistics overlay
## Limits
- **Quota**: free tier is 10,000 calls/month. Each `patent --rows 30 --page 1` = 1 call. The skill caches nothing — caller is responsible for pagination throttling.
- **Latency**: typical 200–800ms per call.
- **Rate limit**: 30 req/sec hard cap from KIPRIS Plus. Bulk operations should sleep `0.05s` between calls.
## License
MIT-0. No warranty. Built using only the publicly documented KIPRIS Plus OpenAPI specification.
Files in this package (14)
- README.md 2 KB
- SKILL.md 6 KB
- _meta.json 1 KB
- .clawhub/origin.json 1 KB
- bin/_kipris_common.sh 2 KB
- bin/_xml2jsonl.py 2 KB
- bin/applicant.sh 2 KB
- bin/design.sh 2 KB
- bin/patent-detail.sh 1 KB
- bin/patent.sh 3 KB
- bin/trademark.sh 3 KB
- examples/brand-availability-check.sh 1 KB
- examples/competitor-patent-watch.sh 2 KB
- examples/m-and-a-ip-snapshot.sh 2 KB
Versions
The database has no other skills named kipris-cli.
Database snapshot: 13.11.2026 · package version 48deed79c538 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100kipris-search
Run KIPRIS Plus searches (cached, call-budgeted) or import KIPRIS/other DB CSV/Excel exports into candidates.csv, logging scope in SEARCH_LOG.md. Use when the user says \"키프리스 검색\", \"KIPRIS\", \"특허 검색해줘\", \"엑셀 불러와\", \"CSV 반입\", or as step 2 of park-pipeline. - 100key-patent-review
Phase 2: pick key patents from the valid set — shortlist, fetch claims/forward citations/legal status from KIPRIS, then judge importance (핵심/주목/일반) on the independent claims with verbatim claim quotes ('confirmed' evidence). Use when the user says \"핵심특허\", \"주요특허 선정\", \"청구항… - 82ip_research
IP data research tools for patents, trademarks, and related USPTO/EPO/JPO records. Use when: - Looking up patents by number (US, EP, WO, JP, etc.) - Searching patent databases by keyword, assignee, inventor, or classification - Getting patent family, citation, or legal status… - 84prior-art-search
Guides Claude through a structured prior art search workflow using the Espacenet patent tools. Teaches progressive drill-down: CQL query construction, result triage by abstract, keyword search in full text, paginated claim/description reading, and family expansion. Produces a… - 100intellectual-property
Use when identifying intellectual property considerations for software products. Covers patents, copyrights, trademarks, trade secrets, and IP assignment with jurisdiction-specific considerations for software companies. USE FOR: software patents, copyright, trademarks, trade… - 100ip-patent-search
Patent prior-art and landscape intelligence, not generic patent help. Use for patent prior-art or landscape searches.