skills.rest
NomaDamas
NomaDamasOFFICIAL
Explore all skills by this author →
WebsiteGitHub

localdata-business-status

Query Korean local business operating status from LOCALDATA permit CSV files.

7.4k|904|Updated Mar 24, 2026
Search Tags:#korea#public data#영업상태#localdata#business status#permit data#csv lookup
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill localdata-business-status
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: localdata-business-status
Source: https://github.com/NomaDamas/k-skill/tree/main/localdata-business-status
Command: npx skills add https://github.com/NomaDamas/k-skill --skill localdata-business-status

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Checking whether a neighborhood business in Korea (restaurant, cafe, lodging, pharmacy, salon, academy) is currently operating, suspended, or closed normally requires navigating government portals manually. This Skill queries the Ministry of the Interior and Safety's LOCALDATA permit dataset directly, returning operating status, permit dates, closure dates, business type, and addresses without any API key.

Core Features & Use Cases

  • Operating Status Lookup: Retrieves 영업/휴업/폐업 (operating/suspended/closed) status, detailed status, permit date (business age), closure date, and road/lot addresses for local businesses.
  • 208 Industry Categories: Supports all LOCALDATA permit industries, searchable by slug or Korean name (e.g., 약국, 숙박업, 일반음식점), across 245 local government regions.
  • No Authentication Required: Downloads region-level CP949 CSV files directly from file.localdata.go.kr with a 1-day local cache, no API key or proxy needed.
  • Use Case: Ask whether a specific hotel in Jeju is still operating and how long it has been licensed, using only the trade name and city/district.

Quick Start

Ask the agent to check whether a business named 호텔샬롬 in 제주제주시 is currently operating in the lodging industry using the localdata-business-status skill.

Frequently Asked Questions about localdata-business-status

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a Korean business is still operating?▼

Provide the trade name and city/district (시군구) to the lookup script, which downloads the LOCALDATA permit CSV for that region and matches the business name. It returns operating status, permit date, closure date, and addresses without requiring an API key.

What is the LOCALDATA dataset in Korea?▼

LOCALDATA is the Ministry of the Interior and Safety's local administrative permit dataset covering 208 licensed business categories such as restaurants, lodgings, and pharmacies. It is published as region-level CSV files on file.localdata.go.kr and updated daily with a two-day lag.

Does LOCALDATA lookup require an API key or login?▼

No authentication is required. The skill downloads public CSV files directly from file.localdata.go.kr using only a Referer header, so no API key, account, or proxy is needed.

Can I search Korean businesses by business registration number?▼

No. The LOCALDATA permit data does not include business registration numbers, so matching is by trade name string only. Same-name businesses may appear, and identity against a registration number cannot be confirmed.

Why does the LOCALDATA lookup require a region parameter?▼

Nationwide files per industry are hundreds of megabytes, so the skill downloads city/district-level CSV files instead. You must specify a 시군구 region such as 서울종로구 or 제주제주시, which maps to one of 245 local government codes.

What Python dependencies does the LOCALDATA script need?▼

Only Python 3 with the standard library. The script uses argparse, csv, urllib, and json, so no pip packages or external dependencies need to be installed.

Related Skills

Explore More Data & Analytics Skills→
seolcodingseolcoding

household-waste-info

Provides South Korean waste disposal schedules, locations, and sorting methods per 시군구 via official public data API.

Community
Intermediate
judicialmindjudicialmind
18

environmental-law

Provides guidance on environmental compliance, Phase I/II ESA due diligence, and permitting strategies.

Official
Intermediate
duhu2000duhu2000
4

invoice-reconciliation-qcc

Reconcile invoices against purchase orders and delivery confirmations with QCC MCP verification.

Community
Advanced
NomaDamasNomaDamas
7.1k

nts-business-registration

Verifies Korean business registration authenticity and status via NTS public API proxy.

Official
Intermediate