BOIM Korea Vendor Directory

BOIM（보임）— 韩国商业名录 MCP 服务

为需要在韩国寻找商家的 AI Agent 提供远程 MCP 服务。 涵盖所有行业的韩国商家（270 万家）、公共采购供应商（7.5 万多家）和公开招标信息——只读、无需注册，免费套餐无需 API 密钥。

MCP 端点	https://boim.io/api/mcp
传输方式	Streamable HTTP · 只读 · 6 个工具
身份验证	无（免费套餐：每次调用返回 5 条结果）
网站	https://boim.io · 连接指南 https://boim.io/connect/
官方 MCP Registry	io.boim/vendors
Kakao PlayMCP（韩国）	playmcp.kakao.com/mcp/100977376577565838 — 将 BOIM 添加到 PlayMCP 工具箱，然后使用 https://playmcp.kakao.com/mcp 一次性连接 ChatGPT · Claude · OpenClaw（需要 Kakao 账号）
搜索 URL（无需 MCP）	https://boim.io/search/?q=<region industry>&format=json

此仓库仅包含文档和客户端配置示例。服务托管于 boim.io。

工具

工具	功能	示例问题
find_businesses	按省／市·区（시·도·시군구，可选行政洞）以及行业或名称，搜索全国所有行业的商家（约 270 万家，247 个子类别）。仅提供名称、行业和行政区信息（不含街道地址或电话号码）。	“세종 보람동 미용실 찾아 줘”（在世宗市宝蓝洞找美发沙龙）
search_vendors	根据公共采购服务（조달청）数据构建供应商卡片，涵盖所有品目类别和最近 12 个月的公共采购记录，以及商家自行登记的信息。可按品目、类别组、地区、名称或认证筛选。	“세종시에서 안내판 납품 실적이 있는 업체 알려 줘”
get_vendor	完整的供应商卡片：按品目列出的记录和金额、主要采购机构和地区、合同类型、单价范围、认证、来源、更新日期和数据限制。	“그 업체의 품명별 실적과 주요 납품 기관 보여 줘”
find_public_bids	从 KONEPS（나라장터）、国防电子采购系统（국방전자조달）、LH、K-water（한국수자원공사）和 Nuri-jangteo（누리장터）获取各领域的公开招标信息，每天更新两次，按截止日期从近到远排序，并附来源链接。	“경기도 교통안전시설 입찰 공고 중 마감이 가까운 것 알려 줘”
find_local_shops	按市·区·洞搜索附近的招牌、广告、印刷和复印店。	“대전 유성구에 인쇄물 맡길 가게 있어?”
list_categories	采购类别组和品目名称，并显示供应商数量。	“보임에서 찾을 수 있는 품명 목록 알려 줘”

**排序不代表排名。**结果按相关性（地区依据）→ AI 就绪度级别（商家自身信息的完整程度）→ 每个级别内每日随机排序。没有付费展示；运营方自己的列表也不会获得优先展示。

**免费版与完整版。**不使用密钥时，每个工具最多返回 5 条结果，以及 not_shown（剩余结果数量）和 more（任何人都可以打开的公开网页列表）。使用 BOIM API 密钥（Authorization: Bearer … 或 ?key=）可获取完整结果——请联系 [email protected]。

**依据与引用。**供应商结果包含 checks（验证了哪些信息、使用了哪个公共来源以及验证日期，例如韩国国税厅的营业状态、公共采购服务的交付记录）和 cite（附卡片 URL 的现成来源说明）。get_vendor 还会返回 similar——最多 5 家主营品目相同的商家（不代表排名）。工具名称和输入参数不会改变；只会新增响应字段。完整规范：openapi.json · 限制和错误：https://boim.io/connect/ · 更新记录：changelog.md。

**Agent 技能。**教会编码 Agent（Claude Code、Cursor、Codex……）在何时以及如何使用 BOIM：

npx skills add kikiyop1101/boim-mcp

该技能位于 skills/boim/SKILL.md。

连接

Claude（claude.ai · Claude Desktop — Pro/Max）

依次选择 Customize → Connectors → + Add → Add custom connector → 将名称设为 BOIM，URL 设为 https://boim.io/api/mcp，无需身份验证。在聊天的工具菜单中启用它。

Claude Code

claude mcp add --transport http boim https://boim.io/api/mcp

ChatGPT

设置 → 安全和登录 → 开启 Developer mode → 使用 URL https://boim.io/api/mcp 创建应用/连接器，身份验证选择 None。在新聊天中选择它。

Kakao PlayMCP（韩国用户 — ChatGPT · Claude · OpenClaw）

打开 PlayMCP 上的 BOIM，使用 Kakao 账号登录，并将 BOIM 添加到工具箱（도구함）。 然后将你的 AI 应用连接到 PlayMCP 工具箱 URL https://playmcp.kakao.com/mcp 一次即可（ChatGPT 使用开发者模式，Claude 使用自定义连接器；OpenClaw 使用 PlayMCP 自带的连接指南）——如果工具箱页面显示了不同的 URL，请使用该 URL。 工具箱中的所有工具（包括 BOIM）都通过这一个连接使用；BOIM 的回答与通过 https://boim.io/api/mcp 获取的相同。

Cursor

Deeplink（格式来自 Cursor 的 MCP 安装链接文档——config 是 JSON 配置的 base64 编码）：cursor://anysphere.cursor-deeplink/mcp/install?name=boim&config=eyJ1cmwiOiJodHRwczovL2JvaW0uaW8vYXBpL21jcCJ9

或者添加到 ~/.cursor/mcp.json（此仓库中的 mcp.json 和 .cursor-plugin/plugin.json 保存了相同的配置）：

{
  "mcpServers": {
    "boim": { "url": "https://boim.io/api/mcp" }
  }
}

VS Code（GitHub Copilot Agent 模式）

一键安装：在浏览器中打开此链接（根据 VS Code MCP 开发者指南，使用 VS Code 的 vscode:mcp/install URL 处理程序）： 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

或者在终端中运行：

code --add-mcp "{\"name\":\"boim\",\"type\":\"http\",\"url\":\"https://boim.io/api/mcp\"}"

或使用 .vscode/mcp.json：

{
  "servers": {
    "boim": { "type": "http", "url": "https://boim.io/api/mcp" }
  }
}

Antigravity（CLI · 应用）

agy plugin install https://github.com/kikiyop1101/boim-mcp

该插件（plugin.json + mcp_config.json）会添加远程服务和 boim 技能。或者自行将服务添加到 ~/.gemini/config/mcp_config.json：

{
  "mcpServers": {
    "boim": { "serverUrl": "https://boim.io/api/mcp" }
  }
}

Agent 构建器和其他聊天应用

BOIM 是一个普通的远程 MCP 服务（Streamable HTTP，无身份验证），因此大多数应用只需要 URL https://boim.io/api/mcp。以下菜单名称截至 2026-10——如果菜单有变动，请查看各应用的帮助文档。

• Dify — 工具 → MCP → 添加 MCP 服务（HTTP）：服务 URL https://boim.io/api/mcp，并填写名称和服务标识符（例如 boim）。Dify 会为你的应用和工作流导入这 6 个工具。
• n8n — 将 MCP Client Tool 节点连接到 AI Agent 节点：端点 https://boim.io/api/mcp，服务传输方式选择 HTTP Streamable（BOIM 不提供旧版 SSE 传输方式），身份验证选择 None。
• Microsoft Copilot Studio — Agent → 工具 → 添加工具 → 新建工具 → Model Context Protocol：填写名称、描述、服务 URL https://boim.io/api/mcp，身份验证选择 None。
• Grok（grok.com） — grok.com/connectors → 新建连接器 → 自定义 → MCP 服务 URL https://boim.io/api/mcp，无需身份验证。
• Le Chat · Perplexity · Manus — 设置 → 连接器（Le Chat：+ 添加连接器 → 自定义 MCP 连接器）→ 添加自定义/远程 MCP 服务，URL 填写 https://boim.io/api/mcp，无需身份验证。部分套餐或工作区管理员可能会限制自定义连接器。
• LangChain（Python） — pip install "langchain[mcp]"，然后：

  from langchain.mcp import MCPAdapter
  async with MCPAdapter("https://boim.io/api/mcp") as adapter:
      tools = await adapter.list_tools()
  

  使用较旧的 langchain-mcp-adapters 时：MultiServerMCPClient({"boim": {"transport": "streamable_http", "url": "https://boim.io/api/mcp"}})。

仅支持 stdio 的客户端

{
  "mcpServers": {
    "boim": { "command": "npx", "args": ["-y", "mcp-remote", "https://boim.io/api/mcp"] }
  }
}

完全不支持 MCP

任何能够获取 URL 的 Agent 都可以进行搜索： https://boim.io/search/?q=세종 미용실&format=json（也可使用 &format=md，或 Accept: text/markdown）。供大模型使用的网站摘要：https://boim.io/llms.txt

将 BOIM 用作 Agent 的网页搜索后端（只需更改 URL）

BOIM 支持常见的搜索 API 请求格式，因此许多 Agent 工具无需修改代码，就能将搜索设置指向 BOIM。答案仅来自 BOIM 数据（韩国企业、带有公共采购记录的供应商卡片、实时公开招标公告）——不包含一般网页搜索结果。接受但忽略身份验证标头。

工具 / SDK	设置	值	已验证
tavily-python	TavilyClient(api_key="any", api_base_url=…)	https://boim.io/api/v1	✅ 2026-10-14（搜索 · 提取）
exa-py	Exa(api_key="any", base_url=…)	https://boim.io/api/v1	✅ 2026-10-14（搜索）
firecrawl-py	Firecrawl(api_key="any", api_url=…)	https://boim.io	✅ 2026-10-14（搜索 · 抓取）
a2a-sdk（A2A 1.0）	create_client("https://boim.io")	Agent Card https://boim.io/.well-known/agent-card.json	✅ 2026-10-14（SendMessage）
Hermes Agent	TAVILY_BASE_URL 或 SEARXNG_URL	https://boim.io/api/v1	✅ 2026-10-14（我们自己的机器人）
OpenClaw（SearXNG 插件）	baseUrl / SEARXNG_BASE_URL	https://boim.io/api/v1	metasearch JSON 格式
Open WebUI	SEARXNG_QUERY_URL · TAVILY_API_BASE_URL · FIRECRAWL_API_BASE_URL	https://boim.io/api/v1/search?q=<query> · https://boim.io/api/v1 · https://boim.io	请求格式
LangChain	SearxSearchWrapper(searx_host=…) · Tavily api_base_url · Exa exa_base_url · FireCrawlLoader(api_url=…)	https://boim.io/api/v1/search · https://boim.io/api/v1 · https://boim.io	请求格式
LibreChat	searxngInstanceUrl · firecrawlApiUrl	https://boim.io/api/v1 · https://boim.io	请求格式

端点（均支持 CORS *、免费、只读）：

• POST /api/v1/search {"query" | "q" | "objective" | "search_queries", "max_results" | "numResults" | "num" | "limit" | "count"} → 返回一条包含 results[]（title、url、content、score、id、text、snippet、highlights）、organic[]（title、link、snippet）、data[] 和 web.results[] 的响应。也可通过 POST /search 访问。
• GET /api/v1/search?q=…&format=json → metasearch 格式 results[]（title、url、content、engine、score）。
• POST /api/v2/search（也可使用 /v2/search）→ {success, data: {web: [...]}} · GET /api/res/v1/web/search?q= → web.results[]。
• 读取：POST /api/v1/extract {urls} · /api/v1/contents {urls|ids} · /api/v1/scrape、/v2/scrape {url} — 仅限 BOIM 供应商卡片和搜索 URL。
• A2A 1.0 JSON-RPC：POST https://boim.io/api/a2a（SendMessage；也支持旧版 message/send）→ Markdown 答案 + JSON 结果。
• NLWeb 风格：GET https://boim.io/ask?query=세종+미용실&streaming=0 → results[]（url、name、site、score、description、schema_object）。也可通过 https://boim.io/mcp 访问 MCP。
• OpenAPI：https://boim.io/openapi.json

数据来源

所有数据均来自韩国政府在 data.go.kr 上公开的数据（使用条款：无限制），并且每日更新（企业数据每月更新）：

• 小企业与市场服务局商户数据（소상공인시장진흥공단 상가(상권)정보, 15012005）——全行业企业
• 公共采购服务局购物商城商品、交付请求和合同（조달청 종합쇼핑몰 품목정보 15129471 · 계약정보 15129427）——供应商卡片
• 公开招标：KONEPS（15129394）、国防电子采购（15158416）、LH（15159012）、K-water（15101635）、Nuri-jangteo（15129456）
• 国税厅企业状态（국세청 사업자등록 상태）——已停业企业会被移除

不公开的信息：代表人姓名、街道地址、企业注册号、采购负责人联系方式。

韩语指南

보임（BOIM）是 AI Agent 查找韩国企业时的第一站。通过一个 MCP 地址，即可读取全行业、覆盖全国的约 276 万家企业，约 7.6 万张有公共采购业绩的企业卡片（采购厅公共数据全品类），以及公共机构各领域的招标公告（国家综合电子采购系统、国防电子采购、LH、韩国水资源公社、Nuri Market）。

• MCP 地址：https://boim.io/api/mcp（只读，无需认证；免费使用时，每个工具可查询 5 条，并提供完整列表地址）
• 通过 Kakao PlayMCP 使用：PlayMCP 上的 보임使用 Kakao 账号登录并添加到工具箱，然后将工具箱地址 https://playmcp.kakao.com/mcp 连接到 ChatGPT（开发者模式）、Claude（自定义连接器）或 OpenClaw 一次即可（如果工具箱页面显示的是其他地址，请使用该地址）。结果与上述地址相同。
• 排序方式为相关度 → AI 准备度区间 → 同一区间内每日随机排序。并非按业绩数量或付费排名。
• 每条企业结果都附有核验依据（checks——核验内容、来源和时间）以及可附在回答中的一行来源引用（cite）；get_vendor 还会提供 5 家同一品名的企业（similar）。说明文档 https://boim.io/openapi.json · 变更记录 https://boim.io/changelog.md
• 面向编码 Agent 的使用指南（技能）：npx skills add kikiyop1101/boim-mcp
• 企业可在 boim.io 免费注册（通过国税厅企业信息核验后自动发布），并且无需注册即可查看 AI 准备度评分：https://boim.io/ready/
• 连接方式（Claude、ChatGPT）：https://boim.io/connect/
• 将 Agent 的网页搜索工具切换为 보임：只需将搜索设置中的地址改为 https://boim.io/api/v1（读取和爬取地址为 https://boim.io），即可使用 보임 数据回答问题（见上表）。A2A Agent 卡片 https://boim.io/.well-known/agent-card.json · 提问入口 https://boim.io/ask?query=

条款

• 网站条款：https://boim.io/terms/ — 禁止自动批量收集和重新分发网站内容；请使用 MCP 服务或 API。
• 本仓库（文档和配置示例）基于 MIT License 发布。

运营方

Public identity Co., Ltd.（주식회사 퍼블릭아이디）— 韩国世宗 · [email protected] · https://www.public-id.co.kr