kakao-bar-nearby

nomadamas/k-skill

Find nearby bars in Korea using Kakao Local API with real-time details.

What is kakao-bar-nearby?

Searches for bars (술집) near a user's location using the official Kakao Local API, then retrieves current open status, menus, and seating information from Kakao Map detail pages. Use when users ask for nearby bar recommendations in Korean contexts.

Accepts user location input and queries the official Kakao Local API for bars
Retrieves Kakao Map detail links for each result
Checks real-time open/closed status from Kakao Map pages
Extracts menu information from business detail pages
Gathers seating and facility hints from Kakao Map listings

How to install kakao-bar-nearby

npx skills add https://github.com/nomadamas/k-skill --skill kakao-bar-nearby

Prerequisites

Node.js 18 or later
Access to official Kakao Local API credentials
npx or npm installed

Claude Code

Cursor

Windsurf

Cline

How to use kakao-bar-nearby

1.Install the skill using: npx skills add https://github.com/nomadamas/k-skill --skill kakao-bar-nearby
2.Run: npx -y @nomadamas/k-skill@0 instruct kakao-bar-nearby to get runtime-specific instructions
3.Provide your location when prompted by the agent
4.Review the returned bar listings with open status, menus, and seating details
5.Follow Kakao Map links for additional information as needed

Use cases

Good for

User asks '근처 술집 어디 있어?' (Where are nearby bars?) and needs current options
Finding bars with specific current availability in a Korean city
Discovering bar menus and seating capacity before visiting
Locating bars near a specific address or landmark in Korea

Who it's for

Users seeking bar recommendations in Korea
Travelers or locals looking for dining/drinking venues
Anyone needing real-time bar status and menu information

kakao-bar-nearby FAQ

What location formats does this skill accept?

The skill asks for user location input; refer to the CLI instructions via 'npx -y @nomadamas/k-skill@0 instruct kakao-bar-nearby' for specific supported formats.

Does this skill work outside Korea?

The skill is designed for Korean bar searches using Kakao Local API and Kakao Map, so functionality is limited to Korea.

Can I use this for bulk bar data collection?

No. The legal disclaimer explicitly prohibits systematic or bulk crawling and database building. Use only for personal, non-organizational lookups.

What happens if a bar is closed?

The skill retrieves real-time open/closed status from Kakao Map detail pages, so you will see current availability before visiting.

Do I need Kakao API credentials?

Yes, you need official Kakao Local API access. The skill uses the official API, not scraping.

Full instructions (SKILL.md)

Source of truth, from nomadamas/k-skill.

name: kakao-bar-nearby description: 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. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다. license: MIT metadata: category: food locale: ko-KR phase: v1

kakao-bar-nearby

Get the full instructions (required first step)

Run this and follow its output as the primary instructions for this skill:

npx -y @nomadamas/k-skill@0 instruct kakao-bar-nearby

The CLI detects the current runtime (Dolshoi vault/CloakBrowser vs generic) and prints only the applicable instructions, always up to date. Helper files bundled with the CLI are listed by:

npx -y @nomadamas/k-skill@0 files kakao-bar-nearby

Keep the CLI and every coding-agent skill install current (including Vercel Agent Skills) with:

npx -y @nomadamas/k-skill@0 update

If npx is unavailable, install Node.js 18+ or follow https://github.com/NomaDamas/k-skill#readme, or read the source instructions at https://github.com/NomaDamas/k-skill/blob/main/kakao-bar-nearby/instruction.md.

Legal disclaimer (required)

This skill is not an official feature of, officially supported by, affiliated with, sponsored by, approved by, or developed in collaboration with any third-party trademark owner or service operator it identifies. Third-party names are used only to describe the skill's function, lookup target, or compatibility.

Any automated collection of publicly accessible information must be limited to personal, non-organizational lookup. Do not use this skill for systematic or bulk crawling, database building, access-control or block circumvention, or conduct that interferes with a third party's business or service.

Read the full Korean legal disclaimer, including the cited Korean Supreme Court precedents and statutory limits, before use:

npx -y @nomadamas/k-skill@0 read kakao-bar-nearby references/DISCLAIMER.md

Hard rules even without the CLI

Never execute payment, message/email delivery, final submission, cancellation, or public posting without the user's explicit approval immediately beforehand.
Never ask for, print, or store plaintext credentials in chat, files, or shell arguments.
Never bypass legal, physical-presence, CAPTCHA, identity-proofing, or electronic-signature boundaries.