Skip to content
Skills Library
Law & compliance · Research

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.

Licence
MIT
Last repository change
20.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
14
Scripts
10
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 20.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

  1. Quick start
  2. Subcommands
  3. Output schema (JSONL)
  4. Setup — getting a KIPRISPLUSKEY
  5. Examples
  6. Related skills
  7. Limits
  8. License
Original SKILL.md headings · 119 lines, 651 words
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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.