Skip to main content
Glama

BOIM Korea Vendor Directory

전 업종 업체 찾기(전국 약 277만 곳)

find_businesses
Read-onlyIdempotent

[보임 — 한국 업체·입찰 공고 찾기] 음식·소매·수리·개인 서비스·과학·기술·교육·보건의료·부동산·숙박·시설관리·임대·예술·스포츠 등 모든 업종(상권업종 소분류 247개)의 전국 영업 중 업체를 시·도·시군구(·행정동)와 업종으로 찾습니다(지역 필수). 소상공인시장진흥공단 상가(상권)정보 공공 데이터로, 상호·업종·행정동만 있고(상세 주소·전화 없음) 순서는 이름순입니다(평가 아님). 결과마다 시군구×업종 목록 주소(list_page)와, 업체가 직접 등록해 하는 일·연락처·가격 안내를 올렸는지 확인할 수 있는 AI 준비도 주소(ready)가 붙습니다. 공공 조달 실적이나 업체가 직접 등록한 정보가 있는 업체 카드는 search_vendors가 더 자세합니다.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNo
queryNo상호에 들어간 말(region 안에서 찾는다)
regionYes시·도와 시·군·구(예: 세종, 대전 유성구, 서울 강남구). 마지막 낱말이 행정동이면 동으로 좁힌다(예: 세종 보람동)
categoryNo업종(예: 한식, 카페, 미용실, 치과, 세탁소, 인테리어, 학원). 소분류·중분류·대분류 이름 일부

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.2/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish read-only/idempotent safety, and the description adds substantial context beyond them: the public data source, that records contain only 상호·업종·행정동 with no detailed address or phone, that ordering is alphabetical rather than rating-based, and that each result carries list_page and ready URLs. For a lookup tool this is unusually rich behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and the region-required constraint are front-loaded, but the single dense paragraph is heavy with parenthetical asides, and the '[보임 — 한국 업체·입찰 공고 찾기]' prefix references 입찰 공고 (bid notices), which belongs to a sibling tool and mildly muddies the scope.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description correctly explains what each result returns (list_page, ready URLs) and what fields are absent (no address or phone), which is the key completeness burden. It leaves limit/pagination behavior and the default result count unstated, a modest remaining gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 75% and the schema already documents region narrowing and category examples, which the description largely restates ('지역 필수', 동 단위 축소, 247 subcategories). The undocumented 'limit' parameter is never explained, so the description adds only marginal meaning over the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('전국 영업 중 업체를 ... 찾습니다') plus the full category scope (247 상권업종 소분류, region required), so an agent immediately knows this is a nationwide business-directory lookup, not a bid or vendor-search tool. It explicitly contrasts itself with search_vendors, making sibling disambiguation concrete.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'지역 필수' tells the agent a region must be supplied, and the closing sentence routes to search_vendors when procurement records or owner-registered detail are needed. It does not address the other siblings (find_local_shops, get_vendor, list_categories), so exclusions are incomplete but the primary conditional is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources