BOIM 보임 — Korean business directory
Integrates BOIM with GitHub Copilot in VS Code agent mode, enabling Korean business, procurement vendor, and public bid searches through BOIM tools.
Allows Hermes Agent to use BOIM as its web-search backend via TAVILY_BASE_URL or SEARXNG_URL, querying Korean business and procurement data.
Allows LangChain search and scraping components (SearxSearchWrapper, Tavily, Exa, FireCrawlLoader) to use BOIM endpoints as a web-search backend for Korean business and procurement data.
Provides a SearXNG-compatible search API so SearXNG plugins and related clients can query BOIM's Korean business, vendor, and public bid data.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
BOIM (보임) — Korean Business Directory MCP Server
Remote MCP server for AI agents that need to find businesses in Korea. Korean businesses across all industries (2.7M+), public-procurement vendors (75,000+), open public bids and traditional markets with market days (1,393) — read-only, no sign-up, no API key for the free tier.
MCP endpoint |
|
Transport | Streamable HTTP · read-only · 6 tools |
Auth | none (free tier: 5 results per call) |
Website | https://boim.io · connect guide https://boim.io/connect/ |
Official MCP Registry |
|
Kakao PlayMCP (Korea) | playmcp.kakao.com/mcp/100977376577565838 — add BOIM to your PlayMCP toolbox, then connect ChatGPT · Claude · OpenClaw once with |
Search URL (no MCP needed) |
|
This repository contains documentation and client configuration examples only. The server is hosted at boim.io.
Tools
Tool | What it does | Example question |
| All industries nationwide (2.7M+ businesses, 247 sub-categories) by province / city·district (시·도·시군구, optional 행정동) and industry or name. Name, industry and district only (no street address or phone). When the industry is a market word (전통시장 · 오일장 · 장날 · "traditional market"), the answer also carries | "세종 보람동 미용실 찾아 줘" (hair salons in Boram-dong, Sejong) · "세종 장날 언제야?" |
| Vendor cards built from Public Procurement Service (조달청) data — every item category, last 12 months of public-procurement records — plus information registered by the businesses themselves. Filter by item, category group, region, name or certification. | "세종시에서 안내판 납품 실적이 있는 업체 알려 줘" |
| Full vendor card: records and amounts by item, main buyer agencies and regions, contract types, unit-price range, certifications, sources, update date and data limits. | "그 업체의 품명별 실적과 주요 납품 기관 보여 줘" |
| Open public bids in all fields from KONEPS (나라장터), Defense e-Procurement (국방전자조달), LH, K-water (한국수자원공사) and Nuri-jangteo (누리장터), refreshed twice a day, closest deadline first, with source links. | "경기도 교통안전시설 입찰 공고 중 마감이 가까운 것 알려 줘" |
| Neighborhood sign, advertising, print and copy shops by city·district·dong. | "대전 유성구에 인쇄물 맡길 가게 있어?" |
| Procurement category groups and item names with vendor counts. | "보임에서 찾을 수 있는 품명 목록 알려 줘" |
Ordering is not a ranking. Results are sorted by relevance (region evidence) → AI-readiness band (how complete the business's own information is) → a daily shuffle within each band. No paid placement; the operator's own listing gets no boost.
Free vs. full. Without a key each tool returns up to 5 results, plus not_shown (how many more) and more (a public web list anyone can open). Full results are available with a BOIM API key (Authorization: Bearer … or ?key=) — contact public-id@naver.com.
Evidence and citation. Vendor results carry checks (what was verified, by which public source, on which date — e.g. National Tax Service business status, Public Procurement Service deliveries) and cite (a ready-made source line with the card URL). get_vendor also returns similar — up to 5 businesses with the same main item (not a ranking). Tool names and inputs do not change; new response fields are only added. Full spec: openapi.json · limits and errors: https://boim.io/connect/ · changes: changelog.md.
Agent skill. Teach a coding agent (Claude Code, Cursor, Codex…) when and how to use BOIM:
npx skills add kikiyop1101/boim-mcpThe skill lives in skills/boim/SKILL.md.
Related MCP server: mcp-kr-g2b
Connect
Claude (claude.ai · Claude Desktop — Pro/Max)
Customize → Connectors → + Add → Add custom connector → name BOIM, URL https://boim.io/api/mcp, no authentication. Turn it on from the tools menu in a chat.
Claude Code
claude mcp add --transport http boim https://boim.io/api/mcpClaude Code plugin (MCP server + skill)
This repository is also a Claude Code plugin marketplace. Add it once, then install the boim plugin:
claude plugin marketplace add kikiyop1101/boim-mcp
claude plugin install boim@boim-mcpInside a session: /plugin marketplace add kikiyop1101/boim-mcp, then /plugin install boim@boim-mcp.
The plugin (.claude-plugin/plugin.json + .mcp.json) adds two things: the remote MCP server https://boim.io/api/mcp (read-only, no authentication) and the boim skill. It has no hooks, commands or local code. Your search words go only to boim.io, and the plugin keeps no data of its own.
ChatGPT
Settings → Security and login → turn on Developer mode → create an app/connector with the URL https://boim.io/api/mcp, authentication None. Pick it in a new chat.
Kakao PlayMCP (Korean users — ChatGPT · Claude · OpenClaw)
Open BOIM on PlayMCP, sign in with a Kakao account and add BOIM to your toolbox (도구함).
Then connect your AI app once to the PlayMCP toolbox URL https://playmcp.kakao.com/mcp (ChatGPT developer mode, Claude custom connector; OpenClaw uses PlayMCP's own connection guide) — if the toolbox screen shows a different URL, use that one.
All tools in your toolbox, BOIM included, work through that one connection; BOIM answers are the same as from https://boim.io/api/mcp.
Cursor
Deeplink (format from Cursor's MCP install-link docs — config is base64 of the JSON config): cursor://anysphere.cursor-deeplink/mcp/install?name=boim&config=eyJ1cmwiOiJodHRwczovL2JvaW0uaW8vYXBpL21jcCJ9
Or add to ~/.cursor/mcp.json (this repository's mcp.json and .cursor-plugin/plugin.json hold the same config):
{
"mcpServers": {
"boim": { "url": "https://boim.io/api/mcp" }
}
}VS Code (GitHub Copilot agent mode)
One-click: open this link in a browser (VS Code's vscode:mcp/install URL handler, per the VS Code MCP developer guide):
vscode:mcp/install?%7B%22name%22%3A%22boim%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fboim.io%2Fapi%2Fmcp%22%7D
Or from a terminal:
code --add-mcp "{\"name\":\"boim\",\"type\":\"http\",\"url\":\"https://boim.io/api/mcp\"}"or .vscode/mcp.json:
{
"servers": {
"boim": { "type": "http", "url": "https://boim.io/api/mcp" }
}
}Antigravity (CLI · app)
agy plugin install https://github.com/kikiyop1101/boim-mcpThe plugin (plugin.json + mcp_config.json) adds the remote server and the boim skill. Or add the server to ~/.gemini/config/mcp_config.json yourself:
{
"mcpServers": {
"boim": { "serverUrl": "https://boim.io/api/mcp" }
}
}Agent builders and other chat apps
BOIM is a plain remote MCP server (Streamable HTTP, no auth), so most apps only need the URL https://boim.io/api/mcp. Menu names below are as of 2026-10 — check each app's help if they move.
Dify — Tools → MCP → add an MCP server (HTTP): server URL
https://boim.io/api/mcp, a name and a server identifier (e.g.boim). Dify imports the 6 tools for your apps and workflows.n8n — attach an MCP Client Tool node to your AI Agent node: endpoint
https://boim.io/api/mcp, server transport HTTP Streamable (BOIM does not serve the legacy SSE transport), authentication None.Microsoft Copilot Studio — agent → Tools → Add a tool → New tool → Model Context Protocol: name, description, server URL
https://boim.io/api/mcp, authentication None.Grok (grok.com) — grok.com/connectors → New Connector → Custom → MCP server URL
https://boim.io/api/mcp, no authentication.Le Chat · Perplexity · Manus — Settings → Connectors (Le Chat: + Add Connector → Custom MCP Connector) → add a custom/remote MCP server with the URL
https://boim.io/api/mcp, no authentication. Some plans or workspace admins limit custom connectors.LangChain (Python) —
pip install "langchain[mcp]", then:from langchain.mcp import MCPAdapter async with MCPAdapter("https://boim.io/api/mcp") as adapter: tools = await adapter.list_tools()With the older
langchain-mcp-adapters:MultiServerMCPClient({"boim": {"transport": "streamable_http", "url": "https://boim.io/api/mcp"}}).
Clients that only speak stdio
{
"mcpServers": {
"boim": { "command": "npx", "args": ["-y", "mcp-remote", "https://boim.io/api/mcp"] }
}
}No MCP at all
Any agent that can fetch a URL can search:
https://boim.io/search/?q=세종 미용실&format=json (also &format=md, or Accept: text/markdown). Site summary for LLMs: https://boim.io/llms.txt
Use BOIM as your agent's web-search backend (just change the URL)
BOIM answers the common search-API request shapes, so many agent tools can point a search setting at BOIM without code changes. Answers come from BOIM data only (Korean businesses, vendor cards with public procurement records, live public bid notices, traditional markets) — no general web results. Any API key string works; BOIM neither uses nor stores the keys or auth headers you send.
Most of these settings replace an app's one web-search slot. To keep general web search and add Korean business lookup next to it, use the MCP server above, or a second slot where the app has one (marked side by side). n8n: use the MCP Client Tool node — its SearXNG tool node has a fixed tool name, so a second SearXNG node for BOIM cannot sit next to a web one.
Tool / SDK | Setting | Value | Checked |
|
|
| ✅ 2026-10-14 (search · extract) |
|
|
| ✅ 2026-10-14 (search) |
|
|
| ✅ 2026-11-01 (search) |
|
|
| ✅ 2026-11-01 (search) |
|
|
| ✅ 2026-10-14 (search · scrape) |
|
| Agent Card | ✅ 2026-10-14 (SendMessage) |
Hermes Agent |
|
| ✅ 2026-10-14 (our own bots) |
OpenClaw (SearXNG plugin) |
|
| metasearch JSON shape |
Open WebUI |
|
| request shape |
Open WebUI — External search · External web loader |
|
| request shape (bare JSON array) |
GPT Researcher | side by side |
| request shape |
Dify (marketplace plugins) | side by side SearXNG base URL · Brave base URL · Firecrawl base URL |
| request shape |
RAGFlow | SearXNG node |
| request shape |
Cherry Studio | Tavily provider API host · Parallel provider API host |
| response fields ( |
Mastra ( |
|
| response fields ( |
LangChain |
|
| request shape |
LibreChat |
|
| request shape |
Not changeable by URL: Ollama's web_search/web_fetch in the Python/JS libraries call ollama.com directly, and OpenRouter's web-search engines are a fixed list — use the MCP server there. For tools that let you set the URL, BOIM also answers the same request shapes at POST /api/web_search {query, max_results} and POST /api/web_fetch {url}.
Endpoints (all CORS *, free, read-only):
POST /api/v1/search{"query" (string or array) | "q" | "objective" | "search_queries", "max_results" | "numResults" | "num" | "limit" | "count"}→ one response carryingresults[](title, url, content, score, id, text, snippet, highlights, excerpts),organic[](title, link, snippet),data[]andweb.results[], plusrequest_id·search_id·session_id. Every result URL is unique. Also atPOST /search,/v1/search,/v1beta/search,/v1/search/public,/api/web_searchand the trailing-slash / base forms/api/v1/search/·/api/v1/.?format=list→ a bare JSON array instead of an object: search[{link, url, title, snippet, content, raw_content}], read[{page_content, metadata}].GET /api/v1/search?q=…&format=json(also?query=) → metasearch shaperesults[](title, url, content, engine, score), pluswebPages.value[]andorganic_results[]·GET /api/v1/config→ metasearch engine/category config.POST /api/v2/search(also/v2/search) →{success, data: {web: [...]}}·GET /api/res/v1/web/search?q=(also/res/v1/web/search) →web.results[]·GET /res/v1/llm/context?q=(also under/api) →grounding.generic[](url, title, snippets).Read:
POST /api/v1/extract {urls}(also/v1/extract,/v1beta/extract) ·/api/v1/contents {urls|ids}·/api/v1/scrape,/v2/scrape {url}·/api/web_fetch {url}— BOIM URLs only (vendor cards, traditional-market pages, business-list rows and search URLs returned by the search above). In search, ask for full text withinclude_raw_content/textand each result carries it as markdown.When nothing in BOIM matches (weather, news, other countries…), the answer is empty with a
handoffhint, so your agent can fall back to a general web tool.A2A 1.0 JSON-RPC:
POST https://boim.io/api/a2a(SendMessage; legacymessage/sendtoo) → markdown answer + JSON results.NLWeb-style:
GET https://boim.io/ask?query=세종+미용실&streaming=0→results[](url, name, site, score, description, schema_object). MCP is also reachable athttps://boim.io/mcp.OpenAPI: https://boim.io/openapi.json · tool-sized spec (3 operations) for OpenAPI tool importers: https://boim.io/openapi-tools.json
Data sources
Data comes from Korean government open data on data.go.kr (usage terms: no restriction), plus the information businesses register on BOIM themselves. Refreshed daily (businesses and traditional markets monthly):
Small Enterprise and Market Service store data (소상공인시장진흥공단 상가(상권)정보, 15012005) — all-industry businesses
Public Procurement Service shopping-mall items, delivery requests and contracts (조달청 종합쇼핑몰 품목정보 15129471 · 계약정보 15129427) — vendor cards
Public bids: KONEPS (15129394), Defense e-Procurement (15158416), LH (15159012), K-water (15101635), Nuri-jangteo (15129456)
National Tax Service business status (국세청 사업자등록 상태) — closed businesses are removed
Traditional markets and market days (전통시장·장날, 1,393 markets — https://boim.io/markets/): Small Enterprise and Market Service national traditional-market standard data (전국전통시장표준데이터 15012894), market facilities (전통시장현황 15052837) and Onnuri gift-certificate merchant counts counted by market name (온누리상품권 가맹점 현황 3060079)
Not published: representative names, street addresses, business registration numbers, procurement officers' contact details. Exceptions: traditional markets are public facilities, so their public road-name address and main landline are shown; a business that registers itself shows the contact details it entered.
한국어 안내
보임(BOIM)은 AI 에이전트와 봇이 날마다 들르는 한국 업체 정보 통로입니다. 전 업종 전국 업체 270만 곳 넘게, 공공 조달 실적 업체 카드 약 7만 6천 곳(조달청 공공데이터 전 품목), 공공기관 입찰 공고 전 분야(나라장터·국방전자조달·LH·한국수자원공사·누리장터), 전국 전통시장 1,393곳의 장날·점포·주차·화장실(https://boim.io/markets/)을 MCP 주소 하나로 읽을 수 있습니다.
MCP 주소:
https://boim.io/api/mcp(읽기 전용, 인증 없음, 무료는 도구마다 5건 + 전체 목록 주소)카카오 PlayMCP로 쓰기: PlayMCP의 보임 쪽에서 카카오 계정으로 로그인해 도구함에 담고, ChatGPT(개발자 모드)·클로드(커스텀 커넥터)·오픈클로에 도구함 주소
https://playmcp.kakao.com/mcp를 한 번 연결합니다(도구함 화면에 다른 주소가 보이면 그 주소). 결과는 위 주소와 같습니다.순서는 관련도 → AI 준비 구간 → 같은 구간은 날마다 섞기입니다. 실적 많은 순이나 유료 순위가 아닙니다.
업체 결과마다 확인 근거(
checks— 무엇을·어디서·언제 확인)와 답에 붙일 출처 한 줄(cite)이 붙고,get_vendor는 같은 품명 업체 5곳(similar)도 줍니다. 설명서 https://boim.io/openapi.json · 변경 기록 https://boim.io/changelog.md코딩 에이전트용 사용 안내(스킬):
npx skills add kikiyop1101/boim-mcp클로드 코드 플러그인(MCP 서버+스킬):
claude plugin marketplace add kikiyop1101/boim-mcp다음claude plugin install boim@boim-mcp업체는 boim.io에서 무료로 등록하고(국세청 사업자 확인 뒤 자동 게시), AI 준비도 점수를 가입 없이 확인할 수 있습니다: https://boim.io/ready/
연결 방법(클로드·ChatGPT): https://boim.io/connect/
에이전트의 웹 검색 도구를 보임으로: 검색 설정의 주소만
https://boim.io/api/v1(읽기·크롤 주소는https://boim.io)로 바꾸면 보임 데이터로 답합니다(위 표). 일반 웹 검색을 그대로 두려면 MCP나 두 번째 검색 칸에 붙이세요. 보낸 키·인증 머리는 쓰지도 저장하지도 않습니다. A2A 에이전트 카드https://boim.io/.well-known/agent-card.json· 질문 창구https://boim.io/ask?query=
Terms
Site terms: https://boim.io/terms/ — automated bulk collection and redistribution of the site are not allowed; use the MCP server or the API.
This repository (documentation and configuration examples) is released under the MIT License.
Operator
Public identity Co., Ltd. (주식회사 퍼블릭아이디) — Sejong, Republic of Korea · public-id@naver.com · https://www.public-id.co.kr
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Access Korea’s G2B procurement and Nara Market data for bid notices, awards, contracts, statistics…
Global B2B intelligence for AI agents: 35M+ companies, 1.6M sanctions, KYB pack. 78 tools.
Company profile lookup and B2B company search for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides access to South Korean government procurement (G2B) and Nara Market shopping mall data, enabling users to search bid announcements, procurement statistics, product catalogs, and contract information through 15 specialized tools.5Apache 2.0
- FlicenseAqualityDmaintenanceEnables AI assistants to query and analyze Korean public procurement data from the Korea Public Procurement Service (G2B/Nuri) via 14 services and 156 operations, including bid announcements, contracts, prices, and statistics.171-

io.github.opendataofficial
AlicenseAqualityCmaintenanceEnables querying Korean procurement corporate profiles and qualifications using business registration numbers through natural language, leveraging the public data API from data.go.kr.254 npmMIT- AlicenseNot gradedqualityCmaintenanceEnables AI assistants such as Claude, ChatGPT, and Cursor to search Korean public procurement bid announcements, view detailed bid information, access pre-specifications, and analyze award history from 나라장터 (Public Procurement Service), with source links and no installation or API key required for basic use.MIT