Skip to main content
Glama

BOIM Korea Vendor Directory

업체 카드 검색(공공 조달 실적·직접 등록 업체)

search_vendors
Read-onlyIdempotent

Find Korean vendors with public-procurement records or self-registered info by product, region, name or certification (Public Procurement Service open data; not a ranking). [보임 — 한국 업체·입찰 공고 찾기] 조달청 공공 데이터(종합쇼핑몰 계약 품목 + 최근 1년 조달 실적, 전 품목)로 정리한 한국 업체를 찾습니다. 품명은 조달청 물품분류(예: 안내판, 복사용지, 사무용 의자, 노트북컴퓨터, 소화기, 철근, 급식 식자재), 분야는 물품분류 대분류. 순서는 관련도(지역 근거) → AI 준비 구간(업체가 확인·등록한 정보가 얼마나 갖춰졌는지) → 같은 구간은 날마다 섞기이며, 실적 많은 순서나 유료 순위가 아닙니다. 결과의 ai_ready는 그 업체 카드가 AI가 바로 쓸 만큼 정보(하는 일·지역·연락처·가격 안내 등)를 갖췄는지입니다. region은 본사 소재지, 최근 1년 납품 실적 지역, 업체가 등록한 시공 지역(시·도·시군구, 예: 세종, 충남, 경기도 고양시)과 맞춰 보고, 결과의 match에 근거(본사/납품 실적/시공 가능 지역)를 적습니다. 품명 목록은 list_categories로 볼 수 있습니다.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "search_vendors"
  }
}

Input Schema

NameRequiredDescriptionDefault
certNo인증·구분 이름 일부(예: 여성기업, 사회적기업, 장애인기업, 중소기업자간 경쟁제품)
groupNo분야 = 조달청 물품분류 대분류 이름 일부(예: 출판물, 건자재, 가구, 사무용기기, 공공안전및치안장비) — list_categories로 확인
limitNo보여 줄 최대 건수(1~20). 결과가 이보다 많거나 공개 한도(5건)를 넘으면 나머지는 결과의 not_shown 수와 more 주소로 알려 줍니다
queryNo업체 이름이나 품명에 들어간 말
regionNo지역(예: 세종, 충청남도, 경기도 고양시)
categoryNo품명 — 화면 이름(예: 안내판, 현수막, 간판(광고판), 기타 인쇄물), 조달 품명(예: 광고판) 또는 8자리 물품분류번호

Output Schema

NameRequiredDescriptionDefault
citeNo답에 붙일 출처 한 줄
moreNo나머지를 볼 보임 웹 목록 주소(누구나 열람)
noteNo조건 풀이·안내
errorNo실패 사유(isError일 때만)
orderNo순서 기준(관련도·이름순 등 — 평가·순위 아님)
shownNo이번에 보인 수
totalNo조건에 맞는 전체 수
periodNo실적 기간
sourceNo자료 출처
resultsNo결과 줄(한 번에 5건까지)
updatedNo자료 갱신일
categoryNo알아들은 품명
not_shownNo보이지 않은 나머지 수(있을 때)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / limit / description
      Added value: +"보여 줄 최대 건수(1~20). 결과가 이보다 많거나 공개 한도(5건)를 넘으면 나머지는 결과의 not_shown 수와 more 주소로 알려 줍니다"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "category": {
      +      "description": "알아들은 품명"
      +    },
      +    "cite": {
      +      "description": "답에 붙일 출처 한 줄"
      +    },
      +    "error": {
      +      "description": "실패 사유(isError일 때만)"
      +    },
      +    "more": {
      +      "description": "나머지를 볼 보임 웹 목록 주소(누구나 열람)"
      +    },
      +    "not_shown": {
      +      "description": "보이지 않은 나머지 수(있을 때)"
      +    },
      +    "note": {
      +      "description": "조건 풀이·안내"
      +    },
      +    "order": {
      +      "description": "순서 기준(관련도·이름순 등 — 평가·순위 아님)"
      +    },
      +    "period": {
      +      "description": "실적 기간"
      +    },
      +    "results": {
      +      "description": "결과 줄(한 번에 5건까지)",
      +      "items": {
      +        "properties": {
      +          "ai_md": {
      +            "description": "업체 카드 마크다운 주소"
      +          },
      +          "ai_ready": {
      +            "description": "AI 준비도(업체가 확인·등록한 정보가 얼마나 갖춰졌는지)"
      +          },
      +          "business_status": {
      +            "description": "국세청 사업자 상태"
      +          },
      +          "categories": {
      +            "description": "주요 품명"
      +          },
      +          "checks": {
      +            "description": "확인 근거(무엇을·어디서·언제)"
      +          },
      +          "cite": {
      +            "description": "출처 한 줄"
      +          },
      +          "id": {
      +            "description": "업체 id(get_vendor에 넘김)"
      +          },
      +          "match": {
      +            "description": "지역 근거(본사·납품 실적·시공 가능 지역)"
      +          },
      +          "name": {
      +            "description": "상호"
      +          },
      +          "procurement_1y": {
      +            "description": "최근 1년 조달 실적 요약"
      +          },
      +          "region": {
      +            "description": "본사 지역"
      +          },
      +          "url": {
      +            "description": "업체 카드 주소"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "shown": {
      +      "description": "이번에 보인 수"
      +    },
      +    "source": {
      +      "description": "자료 출처"
      +    },
      +    "total": {
      +      "description": "조건에 맞는 전체 수"
      +    },
      +    "updated": {
      +      "description": "자료 갱신일"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed1 schema field changed
    • changedInput schema / properties / group / description
      Previous value: -"조달 실적 분야(지금 모은 품명: 공공안내·표지, 광고·간판, 교통안전시설, 인쇄·출력·판촉)"New value: +"분야 = 조달청 물품분류 대분류 이름 일부(예: 출판물, 건자재, 가구, 사무용기기, 공공안전및치안장비) — list_categories로 확인"
  3. Changed1 schema field changed
    • changedInput schema / properties / group / description
      Previous value: -"분야: 공공안내·표지, 광고·간판, 교통안전시설, 인쇄·출력·판촉"New value: +"조달 실적 분야(지금 모은 품명: 공공안내·표지, 광고·간판, 교통안전시설, 인쇄·출력·판촉)"
  4. First observed

TDQS

A4.4/5.0
Behavior5/5

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

Goes well beyond the readOnly/idempotent annotations: it discloses the exact ordering pipeline (relatedness → AI-ready tier → daily shuffle), that it is not paid placement, that results cap at 5 publicly with not_shown and a more URL, and that match lists the evidence source (HQ / delivery record / construction region). These are non-obvious behaviors an agent could not infer from structured fields.

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?

The ordering and match explanation are front-loaded and earn their place, but the definition restates itself in English and then at length in Korean, and the bracketed '보임' tag adds clutter. Useful density is diluted by this duplication rather than by filler sentences.

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 annotations covering safety and an output schema covering return shape, the description fills the remaining gaps: ai_ready meaning, match evidence, truncation behavior, and ordering. It stops short of explaining how to combine filters or when a different vendor tool is the better fit, which is the one remaining hole for a 6-parameter search tool.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description adds real value: it explains that region is matched against three distinct sources (HQ, last-year delivery, registered construction area) with examples, and that the result's match field reports which one applied. Category examples (screen name vs. PPS name vs. 8-digit code) also clarify the schema's three-way input.

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 ('Find Korean vendors with public-procurement records or self-registered info') plus the actual axes of search (product, region, name, certification), and explicitly disclaims ranking. An agent can tell this apart from find_businesses/find_local_shops by the public-procurement data source, which is named concretely.

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?

Gives clear usage context: item names come from the PPS classification, categories are top-level, and it routes to list_categories for the item list. It also sets expectations about ordering so the agent doesn't treat results as a ranking. It does not, however, say when to prefer find_local_shops or find_businesses over this tool, leaving sibling selection partly to inference.

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.