kakao-bar-nearby Skill for Claude Code: Find Bars Near a Korean Station or Area

Finds bars near a Korean station or neighbourhood you name, using Kakao Map, and checks open status and menus on each place page.

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

kakao-bar-nearby makes the agent ask where you are, then search Kakao's official Local API for bars around that place, nearest first. For the top 3 to 5 results it opens the Kakao Map place page to read open status, a few menu items and seating hints.

It always asks for your location first and never guesses it. A station, neighbourhood or landmark name works. The search goes through the k-skill hosted proxy, k-skill-proxy.nomadamas.org, and the instructions say you need no Kakao API key. Its SKILL.md is a stub that starts with npx -y @nomadamas/k-skill@0 instruct kakao-bar-nearby.

Good for

People in Korea choosing a bar near a station or district such as 강남 or 서울역
Groups who want to know about seating, such as group tables or a bar counter
Claude Code and Codex users who already run the k-skill collection

Install kakao-bar-nearby

Claude Code

Copy this prompt.

Install the kakao-bar-nearby 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 kakao-bar-nearby. The skill needs Node.js 18 or newer and runs npx at use time, so there is no Claude app upload route.

From the project README. Source.

What's in the skill

When it loads

Use when the user asks for nearby bars or 근처 술집. Ask for the user's location, search with the official Kakao Local API, then follow returned Kakao Map detail links for open-now, menu, and seating hints. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.

Sections in SKILL.md

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

Key facts

Author: NomaDamas (repo owner)
License: MIT (SKILL.md frontmatter)
Installs on skills.sh: 9,109 (Nov 2, 2026)
GitHub stars: 8,232 for the k-skill repo (Nov 2, 2026)
Last commit: Nov 1, 2026
Files: 5 files including SKILL.md: instruction.md, skill.json, and two legal notes in references/
Needs: Node.js for the npx step; a browser to open Kakao Map place pages

What it includes

Runs the k-skill npm command that prints the full instructions
SKILL.md says to run `npx -y @nomadamas/k-skill@0 instruct kakao-bar-nearby` first and follow the output.
Runs code · Get instructions first
Asks where you are before any search; never guesses
A station, district or landmark name is enough. If it is vague, it asks once more for a nearby station or neighbourhood.
Try: “서울역 근처 술집 찾아줘”
Ask for your location
Finds bars by distance through the k-skill proxy and Kakao Local API
Calls searchNearbyBarsByLocationQuery, which finds the anchor place first and then searches "<place> 술집" around the same point. The file shows limit 5 and radius 3000 as example options.
Network · Search Kakao Local
Opens each top result on Kakao Map for hours, menu samples and seating
Checks the page matches the candidate, then fills in open status, 2 to 3 menu items and seating hints such as group seats or bar table.
Network · Open place pages
Lists 3 to 5 places, open ones first, then by distance
Each entry has name, category, open status, menu, seating hint, phone, distance and the Kakao Map link.
Read · Rank and reply
Reports rate limits and blocked pages instead of guessing
A 429 means wait and do not repeat. If a place page is blocked or lacks a field, it shows the official result and a link and marks details unconfirmed.
Handle failures

From the official docs

Permissions

High risk

The skill sends the place you name to a hosted proxy and to Kakao, and it opens Kakao Map pages in a browser. Use a general area name if you do not want to share an exact spot.

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 kakao-bar-nearby 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 location text goes to a hosted proxy
The place you type is searched through k-skill-proxy.nomadamas.org. The README links the proxy privacy policy; read it first. github.com
It opens web pages in a browser
It opens the Kakao Map place page of the top results. If a page is blocked or shows a CAPTCHA, the instructions say not to work around it. github.com
The k-skill CLI can send usage statistics
The k-skill docs say it can send a random local id, the command, skill name, version, runtime mode and success flag to PostHog. 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 the user's explicit approval, and never to ask for or store plaintext credentials. github.com

Technical details

Talks to	k-skill-proxy.nomadamas.org. place.map.kakao.com. npm registry (k-skill package via npx)
Scopes	Shell command: npx Browser access to place.map.kakao.com

Questions

What does kakao-bar-nearby do?

It finds bars near a Korean location you name, using Kakao's Local API. It then opens each top result's Kakao Map page to read whether it is open, a few menu items and seating hints.

Does it know where I am?

No. The instructions require it to ask for your location first, and say the location is never inferred automatically.

How do I install kakao-bar-nearby?

Use the install box above. The README offers a plugin route for the whole k-skill collection or the skills CLI for this skill. The skill starts by running an npx command, so Node.js is needed.

Do I need a Kakao API key?

The instructions say no user API key is needed. Searches go through the k-skill hosted proxy at k-skill-proxy.nomadamas.org.

Where does my location go?

The place name you give is sent to the k-skill hosted proxy, which queries Kakao Local. The README links a privacy policy for the proxy at k-skill-proxy.nomadamas.org/privacy.

Is kakao-bar-nearby safe to run?

It runs an npx command and sends your place name to a hosted proxy and Kakao's servers. It also opens Kakao Map place pages in a browser. The k-skill CLI can send anonymous usage statistics too, which you can turn off with KSKILL_ANALYTICS_DISABLED=1.

Information

updated Nov 2, 2026

Repository: nomadamas/k-skill
Folder: kakao-bar-nearby

nomadamas/k-skill skills.sh

Sources

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

Show all 7

github.com · github.com
github.com · github.com
github.com · github.com
github.com · github.com
github.com · github.com
github.com · github.com
github.com · github.com