korean-patent-search Skill (NomaDamas) for Claude Code: What It Does and How to Install It

Makes Claude search Korean patents and utility models by keyword, or look one up by application number, through the KIPRIS Plus Open API.

Installs: 8.9K; on skills.sh
Stars: 8.2K; on GitHub
Files: 3; besides SKILL.md
Updated: Nov 2026; last repo commit

Claude runs a bundled Python helper that calls the KIPRIS Plus API and prints structured JSON. Each result carries the application number, title, application date, applicant and abstract, and the detail lookup adds publication, announcement and registration data. It is a community skill from NomaDamas, not a KIPRIS tool.

You need your own KIPRIS Plus API key, set as KIPRIS_PLUS_API_KEY, plus python3 and Node.js 18 or newer for the npx step. SKILL.md is a stub that has Claude run an npx command to print the live instructions. The repo copy is instruction.md.

Good for

Inventors and IP staff checking Korean patents on a topic such as batteries
Anyone who needs a patent summary from a known application number
Developers who want KIPRIS results as JSON

Install korean-patent-search

Claude Code

Copy this prompt.

Install the korean-patent-search skill in Claude Code. Run this command:

/plugin marketplace add NomaDamas/k-skill
/plugin install k-skill@k-skill

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18 or newer.

Pick one route. The plugin route installs the k-skill plugin, which covers the whole repo: 135 top-level skill folders (counted from the repo tree), with no hooks or MCP config files in the tree. The skills CLI and folder routes install only korean-patent-search. The skill needs your own KIPRIS Plus API key, python3 and Node.js 18 or newer, and runs npx at use time. There is no Claude app upload route.

From the project README. Source.

What's in the skill

When it loads

Search Korean patent and utility-model publications through the official KIPRIS Plus Open API with keyword search plus application-number detail lookup.

Sections in SKILL.md

Get the full instructions (required first step)
Hard rules even without the CLI

Key facts

Author: NomaDamas (repo owner; k-skill collection for Korean users)
License: MIT
Installs on skills.sh: 8,865 (Nov 2, 2026)
GitHub stars: 8,232 for the whole nomadamas/k-skill repo (Nov 2, 2026)
Last repo commit: Nov 1, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: warn
What it includes: 4 files including SKILL.md: instruction.md, skill.json and scripts/patent_search.py
Needs: A KIPRIS Plus API key (KIPRIS_PLUS_API_KEY), python3, internet access, Node.js 18 or newer for the npx step
Helper script: scripts/patent_search.py, which sends requests to plus.kipris.or.kr
Part of: The k-skill plugin: 135 top-level skill folders in the repo tree

What it includes

SKILL.md tells Claude to run this first and follow its output
Fetches the current instructions from the k-skill npm package. The repo copy of those instructions is instruction.md.
Runs code · Bootstrap: npx -y @nomadamas/k-skill@0 instruct korean-patent-search
patent_search.py --query calls getWordSearch
Options: --year, --page-no, --num-rows, --exclude-patent and --exclude-utility. Prints JSON.
Try: “배터리 관련 한국 특허 찾아줘”
Runs code · Keyword search
patent_search.py --application-number calls getBibliographyDetailInfoSearch
Returns bibliographic data with publication, announcement and registration metadata.
Try: “출원번호 1020240001234 특허 요약 보여줘”
Runs code · Application number detail
Lists number, title, date, applicant and abstract for each hit
instruction.md tells Claude to show API error codes as they are and to use only KIPRIS Plus responses.
Read · Result summary
Extra npx commands SKILL.md lists for helper files and updates
SKILL.md lists npx -y @nomadamas/k-skill@0 files and update, which it says keeps the CLI and every coding-agent skill install current.
Runs code · k-skill files and update commands

From the official docs

Permissions

High risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Claude runs whatever the k-skill npm package prints
SKILL.md says to run npx -y @nomadamas/k-skill@0 instruct korean-patent-search and follow its output as the primary instructions. Claude therefore acts on text that comes from an npm package at run time, and the @0 tag floats across 0.x releases, so the instructions can change without any change to SKILL.md. Read the output before Claude acts on it. github.com
Your KIPRIS key travels in the request URL
The helper builds the request URL with ServiceKey as a query parameter and sends it to plus.kipris.or.kr. Use a key you can revoke, and avoid passing it with --service-key on a shared machine. github.com
npx -y installs packages without asking
The bootstrap command and the exec command that runs the Python helper both use npx -y @nomadamas/k-skill@0, which downloads and runs third-party code. github.com
The plugin route installs the whole k-skill set
The k-skill plugin in the repo tree has 135 top-level skill folders, including skills that cover other services. The skills CLI route can install just this one. github.com
The k-skill CLI can send a usage event
docs/usage-analytics.md says the CLI can send a cli_invocation event to PostHog with a random local ID stored in ~/.config/k-skill/analytics-id, the command, skill name, CLI version, runtime mode and success. It says command arguments, input, file contents and credentials are not sent. Set KSKILL_ANALYTICS_DISABLED=1 to opt out. github.com
Hard rules in SKILL.md
SKILL.md says never to run payment, message delivery, final submission, cancellation or public posting without explicit approval, and never to handle plaintext credentials in chat or files. github.com

Technical details

Turning on read-only	No read-only mode. The helper's two operations are searches.
Talks to	plus.kipris.or.kr (KIPRIS Plus API, hard-coded in the helper). npm registry (@nomadamas/k-skill via npx). us.i.posthog.com (k-skill CLI usage event, unless you opt out)
Sign-in and keys	You supply your own KIPRIS Plus key through KIPRIS_PLUS_API_KEY or --service-key. The helper puts it in the request URL as ServiceKey. SKILL.md says never to ask for, print or store plaintext credentials in chat, files or shell arguments.
Scopes	Reads KIPRIS_PLUS_API_KEY from your environment, or --service-key Sends your search terms and the key to plus.kipris.or.kr Runs a bundled Python helper and installs and runs npm packages through npx

Questions

What does the korean-patent-search skill do?

It makes Claude search Korean patent and utility-model publications by keyword and look up a patent by application number. Results come back as JSON from the KIPRIS Plus Open API.

Do I need an API key?

Yes. instruction.md requires a KIPRIS Plus API key, read from KIPRIS_PLUS_API_KEY or passed with --service-key. It notes that, per the data.go.kr guide, development accounts are approved automatically and operating accounts are reviewed.

Is it made by KIPRIS?

No. It is a community skill from NomaDamas that calls the official KIPRIS Plus API. It is not made by KIPRIS.

How do I install it?

Use the install box at the top of this page. The repo README documents a Claude Code plugin that installs the whole k-skill set and a skills CLI command that installs one skill. Set your key as KIPRIS_PLUS_API_KEY and have python3 available.

Can I use it in the Claude app?

There is no upload route on this page. The skill runs a Python helper through npx on your machine, so it needs a client that can run commands locally, such as Claude Code or Codex.

What can it search?

Two operations: a keyword search and a lookup by application number. instruction.md says version 1 of the helper covers only those two.

Does it send usage data?

docs/usage-analytics.md says the k-skill CLI can send a usage event to PostHog (random local ID, command, skill name, CLI version, runtime mode, success). It says command arguments, input, file contents and credentials are not sent, and KSKILL_ANALYTICS_DISABLED=1 opts out.

Is it safe?

It runs npx with -y, which downloads and runs an npm package without asking, and Claude follows the instructions that package prints. The Python helper sends your API key in the request URL to plus.kipris.or.kr. Read the printed instructions before Claude acts on them, and see the permissions section on this page.

Information

updated Nov 2, 2026

Repository: nomadamas/k-skill
Folder: korean-patent-search

nomadamas/k-skill skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

k-skill README · github.com
k-skill marketplace.json · github.com
korean-patent-search SKILL.md · github.com
korean-patent-search instruction.md · github.com
patent_search.py · github.com
k-skill CLI usage analytics · github.com