{"skill":{"slug":"kipris-cli","displayName":"kipris-cli","summary":"Korean patent / trademark / design search via KIPRIS Plus OpenAPI (특허청). Search patents (특허/실용신안), trademarks (상표), and designs (디자인) by keyword, applicant,...","description":"---\nname: kipris-cli\ndescription: 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.\nlicense: MIT-0\n---\n\n# kipris-cli — Korean Patent / Trademark / Design search (KIPRIS Plus)\n\nFive 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.\n\n> **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.\n\n## Quick start\n\n```bash\nexport KIPRIS_PLUS_KEY=\"<your-32-char-key>\"   # from plus.kipris.or.kr (free, ~1d approval)\n\n# Patent search by keyword\nbin/kipris-cli patent --word \"양자컴퓨팅\" --rows 10\n\n# Trademark availability check\nbin/kipris-cli trademark --word \"AURORA\" --rows 5\n\n# Design search\nbin/kipris-cli design --word \"smart watch\"\n\n# Patent bibliographic detail by application number\nbin/kipris-cli patent-detail --app-no 1020230012345\n\n# Search patents by applicant name (개인/법인)\nbin/kipris-cli applicant --name \"삼성전자주식회사\" --rows 20\n```\n\n## Subcommands\n\n| Command | Endpoint | Use case |\n|---|---|---|\n| `patent` | `patUtiModInfoSearchSevice/patUtiModInfoSearch` | Patent + 실용신안 keyword search |\n| `trademark` | `TrademarkInfoSearchService/trademarkInfoSearchInfo` | Brand availability + competitor TM watch |\n| `design` | `DesignInfoSearchService/designInfoSearchInfo` | Industrial design search |\n| `patent-detail` | `patUtiModInfoSearchSevice/patUtiModBibliographicInfoSearch` | Full bibliographic detail by 출원번호 |\n| `applicant` | `patUtiModInfoSearchSevice/patUtiModInfoSearchByApplicantName` | All filings by applicant (출원인) |\n\n### Common flags\n\n- `--word \"<query>\"` — free-text Korean or English (UTF-8)\n- `--app-no <13-digit>` — 출원번호 (1020230012345 = 특허, 4020210012345 = 상표, 3020230012345 = 디자인)\n- `--rows N` — page size (default 30, max 500)\n- `--page N` — 1-indexed page (default 1)\n- `--format json|xml|jsonl` — output (default jsonl)\n- `--key <KEY>` — override `$KIPRIS_PLUS_KEY`\n\n### Patent-specific filters (subcommand `patent`)\n\n- `--applicant \"<name>\"` — 출원인명\n- `--inventor \"<name>\"` — 발명자명\n- `--ipc \"<code>\"` — IPC 분류 (e.g. `G06N`)\n- `--pat true|false` — include 특허 (default true)\n- `--utility true|false` — include 실용신안 (default true)\n- `--last-update YYYYMMDD` — 최종변경일 since\n\n### Trademark-specific filters (subcommand `trademark`)\n\n- `--applicant \"<name>\"`\n- `--class \"<NICE int>\"` — 상품분류 (NICE classification 1-45)\n- `--reg-status \"registered|pending|rejected|expired\"` — 권리상태\n- `--start-date YYYYMMDD` / `--end-date YYYYMMDD` — 출원일 range\n\n## Output schema (JSONL)\n\nEach line is one record (patent/TM/design). Common fields normalized across types:\n\n```json\n{\n  \"type\": \"patent\",\n  \"app_no\": \"1020230012345\",\n  \"title_ko\": \"양자 회로 최적화 방법 및 장치\",\n  \"title_en\": \"Method and apparatus for quantum circuit optimization\",\n  \"applicant\": \"삼성전자주식회사\",\n  \"inventors\": [\"홍길동\", \"김철수\"],\n  \"app_date\": \"20230101\",\n  \"reg_no\": null,\n  \"reg_date\": null,\n  \"pub_no\": \"1020240054321\",\n  \"pub_date\": \"20240715\",\n  \"ipc\": [\"G06N10/40\", \"G06F17/14\"],\n  \"abstract\": \"...\"\n}\n```\n\nTrademarks add `nice_class`, `tm_kind` (문자/도형/입체); designs add `locarno_class`, `parts`.\n\n## Setup — getting a KIPRIS_PLUS_KEY\n\n1. Sign up at <https://plus.kipris.or.kr> (free; corporate or individual).\n2. 마이페이지 → API 신청 → 무료 quota (월 10,000건).\n3. Approval is typically same-business-day for personal, 2-3 days for corporate.\n4. Copy the 32-char `ServiceKey` and `export KIPRIS_PLUS_KEY=...`.\n\n> ⚠️ 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.\n\n## Examples\n\n- **`examples/competitor-patent-watch.sh`** — daily JSONL feed of new patents filed by a competitor (paginated + dedup).\n- **`examples/brand-availability-check.sh`** — check if a brand name has TM filings in NICE classes 9, 35, 42 (typical SaaS classes).\n- **`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.\n\n## Related skills\n\n- `opendart-cli` — corporate disclosures (pair for IP-vs-financial due diligence)\n- `nts-bizno-cli` — KYB business-number lookup (anchor entity name)\n- `juso-address-cli` — registered address resolution\n- `kosis-cli` — R&D investment statistics overlay\n\n## Limits\n\n- **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.\n- **Latency**: typical 200–800ms per call.\n- **Rate limit**: 30 req/sec hard cap from KIPRIS Plus. Bulk operations should sleep `0.05s` between calls.\n\n## License\n\nMIT-0. No warranty. Built using only the publicly documented KIPRIS Plus OpenAPI specification.\n","tags":{"kipris":"0.1.0","korea":"0.1.0","kr-public-data":"0.1.0","latest":"0.1.0","patent":"0.1.0","trademark":"0.1.0"},"stats":{"comments":0,"downloads":360,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1777857789729,"updatedAt":1778492842520},"latestVersion":{"version":"0.1.0","createdAt":1777857789729,"changelog":"v0.1.0 — initial release. 5 subcommands wrapping KIPRIS Plus OpenAPI: patent, trademark, design, patent-detail, applicant. JSONL output. Examples for competitor watch, brand availability, M&A IP snapshot.","license":"MIT-0"},"metadata":null,"owner":{"handle":"chloepark85","userId":"s176h4kgd3ahcdsgj48g3epf1584a12v","displayName":"Chloe Park","image":"https://avatars.githubusercontent.com/u/15118976?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780090737999}}