Korea Business Verify (KBV)

Korea Business Verify（KBV）— MCP 服务

KBV 是一个托管式 MCP 服务，可实时查找并验证韩国企业——每天约有 10 次免费调用，之后按次付费（x402）。

你只需要公司名称。 搜索 "Samsung Electronics"——使用英文或韩文均可——KBV 会返回匹配的公司及其 10 位企业注册号（사업자등록번호），并按置信度排序。这一点很重要，因为其他所有韩国企业 API 都假设你已经有注册号，而外国 Agent 几乎总是没有。索引涵盖 940,000 家公司：所有 DART 信息披露企业（包括英文名称），以及所有注册的公共采购供应商，因此小企业也在其中，不只有大型企业集团。

有了注册号后，KBV 会返回注册状态（正常／暂停／注销）、税务类型，并可选择验证该号码是否与代表人姓名和开业日期匹配。数据由韩国国税厅（NTS）实时提供，并以规范化的英文 JSON 返回。

要向韩国发货？ 提供 10 位 HS 编码（最多可提供 100 个），KBV 就会返回韩国海关清关前要求的信息：相关法规、可批准的机构、需要取得的证书，以及引用主管公告内容的各项要求条件——请参阅进口要求。

无需账户、API 密钥或安装——将任何支持 MCP 的 Agent 连接到一个 URL：

https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

专为对韩国企业进行 KYB／尽职调查的 AI Agent 和开发者打造，适用于采购、签约、支付和市场平台入驻。

快速信息

MCP 端点	https://kbv-server-f7vfitmlkq-du.a.run.app/mcp
传输方式	MCP Streamable HTTP（POST）
健康检查	GET https://kbv-server-f7vfitmlkq-du.a.run.app/health → {"ok":true}
身份验证	无需
价格	每个 IP 每天约 10 次免费调用（仅为估算，不会严格限制），之后通过 x402 按次付费（$0.02–$0.05）——请参阅定价
工具	find_korean_business、check_korean_business_status、check_korean_business_batch、verify_korean_business、check_korea_import_requirements、check_korea_import_requirements_batch
REST API	GET /v1/business/search · GET /v1/business/{number}/status · POST /v1/business/verify · POST /v1/business/batch · GET /v1/korea-import/requirements · POST /v1/korea-import/requirements/batch — 请参阅 REST API
名称索引	940,000 家公司——DART 信息披露企业（包含英文名称）+ 注册的公共采购供应商
筛查	批量调用还会返回各公司的公共采购禁入记录（부정당업자 제재）
数据来源	来自韩国国税厅（국세청）的公共数据，每次请求都通过政府开放数据门户（data.go.kr）实时读取；名称索引来自 DART（금융감독원）和公共采购服务处（조달청）；进口要求来自韩国海关（관세청）和政府法制处（법제처）。KBV 独立运营，与上述机构均无关联——请参阅数据来源与许可
数据许可	韩国政府开放数据，无使用限制（이용허락범위 제한 없음）
隐私	KBV 不记录查询内容；GET URL 中的号码、搜索词和 HS 编码会进入云访问日志（保留 14 天）——请参阅隐私
发现	/.well-known/x402 · /llms.txt
区域	Google Cloud Run，首尔（asia-northeast3）

连接你的 Agent

Claude（claude.ai）

1. Settings → Connectors → Add custom connector
2. URL：https://kbv-server-f7vfitmlkq-du.a.run.app/mcp
3. 在聊天中启用该连接器并提问：“Check the status of Korean business 124-81-00998.”

Claude Code（CLI）

claude mcp add --transport http kbv https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

ChatGPT

1. Settings → Connectors（需要支持连接器 / 开发者模式的套餐）
2. 使用 URL https://kbv-server-f7vfitmlkq-du.a.run.app/mcp 添加自定义 MCP 连接器
3. 在对话中启用该连接器，并询问某个韩国企业的企业编号。

Cursor

将以下内容添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "korea-business-verify": {
      "url": "https://kbv-server-f7vfitmlkq-du.a.run.app/mcp"
    }
  }
}

其他 MCP 客户端

使用 Streamable HTTP 传输，并采用上述端点。客户端必须发送 Accept: application/json, text/event-stream（标准 MCP 客户端会自动执行此操作）。在浏览器中打开 /mcp 会按设计返回 Method not allowed——浏览器发送的是 GET，而 MCP 使用 POST。使用 /health 检查服务是否正常运行。

工具

find_korean_business

当你不知道企业注册编号时，按名称查找企业——这是此处其他所有操作的起点。

输入：

{ "name": "Samsung Electronics" }

输出（真实示例，已缩略）——返回候选项，不会武断地只给出一个结果：

{
  "query": "Samsung Electronics",
  "candidates": [
    {
      "business_number": "1248100998",
      "name": "삼성전자",
      "name_en": "SAMSUNG ELECTRONICS CO,.LTD",
      "confidence": 1,
      "match": { "type": "exact", "field": "name_en" },
      "evidence": { "status": "active", "tax_type": "general", "listed": true }
    },
    {
      "business_number": "6178117517",
      "name": "삼성전자판매",
      "confidence": 0.75,
      "match": { "type": "prefix", "field": "name" },
      "evidence": { "status": "active", "tax_type": "general", "listed": false }
    }
  ],
  "note": "4 companies match this name equally well; they are distinct legal entities. Compare the evidence fields before acting."
}

• 支持韩语或英语。 系统会忽略法律实体形式造成的差异：Samsung Electronics、SAMSUNG ELECTRONICS CO,.LTD 和 삼성전자(주) 都会匹配同一家公司。
• confidence 反映名称的匹配方式（exact > prefix > contains），并根据来源和上市状态进行调整。match 会指出匹配的字段，因此评分过程并非黑箱。
• evidence 用于区分名称相似的公司：实时注册状态、税种、地区（城市 / 区）以及公司是否上市。
• 名称可能存在歧义——"Samsung Electronics" 确实会匹配四个不同的法律实体。KBV 会通过 note 返回所有实体，而不是擅自选定其中一个。
• 没有匹配项时，会返回 candidates: [] 并附带说明。 这是有效结果，不是错误：查询失败会通过 HTTP 503 和 error 字段返回。

check_korean_business_status

根据韩国企业的 10 位企业注册编号查询其注册状态。

输入——允许使用连字符 / 空格；系统会在内部进行规范化：

{ "business_number": "124-81-00998" }

输出（真实示例——Samsung Electronics）：

{
  "business_number": "1248100998",
  "status": "active",
  "status_code_raw": "01",
  "tax_type": "general",
  "closed_date": null,
  "checked_at": "2026-08-24T10:08:20.082Z",
  "source": "Korea National Tax Service (NTS)",
  "cache": false
}

字段说明：

• status：active | suspended | closed | not_registered
• tax_type：general | simplified | exempt | non_profit | unknown
• closed_date：ISO 日期（"2023-01-31"），仅适用于已关闭的企业，否则为 null
• checked_at：查询韩国国税厅（NTS）的 ISO 8601 UTC 时间戳
• cache：仅当 NTS API 暂时不可用并返回缓存结果（最久为 24 小时前）时为 true；此时 checked_at 表示原始获取时间

格式正确但未在 NTS 注册的编号会返回 "status": "not_registered"（而不是错误）。

check_korean_business_batch

单次调用最多查询 100 家企业——无需往返查询 100 次，即可筛查供应商或客户名单。

输入：

{ "business_numbers": ["124-81-00998", "220-81-62517"] }

输出——每个输入编号对应一条结果（保留顺序，架构与上述相同），并附带摘要：

{
  "results": [
    { "business_number": "1248100998", "status": "active", "...": "..." },
    { "business_number": "2208162517", "status": "active", "...": "..." }
  ],
  "summary": { "total": 2, "active": 2, "suspended": 0, "closed": 0, "not_registered": 0 }
}

• 每条结果还包含 sanctions——该公司被公共采购禁入的记录（부정당업자 제재），active 表示当前仍在生效。公司即使处于正常运营状态，也仍可能被禁止参与公共合同；summary.sanctioned 会统计名单中有多少家公司受到制裁。空数组表示已完成筛查且无记录；字段缺失表示此服务未加载禁入数据——两者含义不同。
• 整个批次只会发起 一次上游 NTS 查询。
• 过去 24 小时内查询过的编号可能会使用缓存结果（标记为 "cache": true，并保留原始 checked_at），这些编号不会纳入上游查询。
• 超过 100 个编号或任何格式错误的编号都会在发起查询之前被拒绝。

verify_korean_business

验证企业注册号是否与提供的代表姓名和开业日期相符（KYB 身份核验），并在同一次调用中获取当前状态。

输入：

{
  "business_number": "124-81-00998",
  "representative_name": "홍길동",
  "opening_date": "1969-01-13",
  "address": "경기도 수원시"
}

• representative_name 和 opening_date（YYYY-MM-DD）为必填项。
• address 为可选项，可提高匹配精度。
• 姓名和地址应使用在 NTS 登记的形式（韩文）。

输出 — 与上述相同的架构，另加 identity_match：

{
  "business_number": "1248100998",
  "status": "active",
  "status_code_raw": "01",
  "tax_type": "general",
  "closed_date": null,
  "checked_at": "2026-08-24T10:08:23.483Z",
  "source": "Korea National Tax Service (NTS)",
  "cache": false,
  "identity_match": false
}

只有在 NTS 确认注册号、代表姓名和开业日期均与其记录相符时，identity_match 才为 true。

check_korea_import_requirements

按 10 位韩国 HS（HSK）编码，查询韩国海关清关产品前要求提供的材料。缺少所需批准的货物会在边境被扣留或退回。

输入：

{ "hs_code": "8516710000", "direction": "import" }

• hs_code：10 位数字；可包含点号、连字符和空格。输入 6 位数字会返回该子目下的 10 位编码供选择——不同编码的要求各不相同，因此 KBV 不会猜测。
• direction："import"（默认值，货物进入韩国）或 "export"。
• 无效编码会在任何查询或付款前被拒绝（400 hs_code_not_found）。对于未知编码，绝不会回答“无要求”。
• 8516710000（咖啡机）是免费测试编码：返回完整结果，不消耗免费额度——一次回答包含三部法规和五个可选机构。

输出（根据 8516710000 的实际响应删节）：

{
  "hs_code": "8516710000",
  "item_name_en": "Coffee or tea makers",
  "hs_code_valid": true,
  "requirements_checked": true,
  "has_requirements": true,
  "requirement_count": 3,
  "requirements": [
    {
      "statute_name_en": "Electrical Appliances and Consumer Products Safety Control Act",
      "statute_name_ko": "전기용품 및 생활용품 안전관리법",
      "certificate_name_ko": "전기용품 및 생활용품 요건확인서",
      "certificate_name_en": null,
      "certificate_name_en_unofficial": "Requirement confirmation for electrical appliances and consumer products",
      "approving_agencies": [
        { "code": "105", "name_ko": "국가기술표준원", "name_en": "Korean Agency for Technology and Standards" },
        { "code": "257", "name_ko": "한국화학융합시험연구원", "name_en": "Korea Testing & Research Institute" }
      ],
      "agencies_note": "Any one of the listed agencies may issue this certificate.",
      "condition": {
        "text_ko": "[전기용품 및 생활용품 안전관리법]\n. 정격전압이 30V초과 1000V이하의 교류전원 …",
        "text_en_unofficial": null,
        "granularity": "hs10",
        "source": { "notice_no": "제2026-46호", "effective_from": "2026-07-16", "url": "https://www.law.go.kr/행정규칙/…" }
      }
    }
  ],
  "governing_notice": {
    "notice_no": "제2026-46호",
    "index": { "notice_serial": "2100000282502", "last_checked_at": "2026-10-23T01:56:51Z", "check_status": "current" }
  },
  "attribution": "Source: Ministry of Government Legislation (법제처), law.go.kr",
  "tariff": {
    "source_as_of": "2026-02-11",
    "rates": [
      { "type": "A", "type_meaning": "Basic rate (기본세율)", "rate": "8" },
      { "type": "C", "type_meaning": "WTO concession rate (WTO 협정에 의한 양허관세)", "rate": "16" }
    ]
  },
  "source": "Korea Customs Service (KCS)",
  "disclaimer": "Fact lookup from public data. Not a legal customs determination. …"
}

解读方式：

• 一项要求 = 一部法规 + 一份证书。 海关 API 会按审批机构逐行返回；KBV 会将其归并，因此咖啡机的七行记录对应三项要求，其中电气安全要求列出了五个机构——任意一个机构都可以签发证书。
• condition.text_ko 是从海关指定公告中逐字引用的内容，具有权威性。 KBV 不会翻译该内容（text_en_unofficial 始终为 null）：这些条款规定了法律门槛，例如电压范围、容量限制和适用范围的例外；翻译错误可能导致你漏办所需证书。KBV 也不会判断某项条件是否适用于你的产品；只有你知道产品的电压、用途或成分。
• granularity: "hs10" 表示该条件对应公告中此具体编码的条目。如果没有此类条目，KBV 会回退到公告正文中的法规条目（"statute_group"，其中 items_ko 将各适用范围与所需文件对应列出），并说明该条件的粒度较粗。
• governing_notice.index 告诉你条件依据公告的哪个修订版本，以及 KBV 上次向 law.go.kr 确认该版本仍然有效的时间（每天检查）。check_status: "check_overdue" 表示距上次确认已有三天或更久——依据这些条件行事前，请先打开公告查看。
• 韩文名称具有权威性：联系机构或申请证书时，请使用 name_ko。只有机构自行发布英文名称时，才会显示英文机构名称；证书名称没有官方英文译名，并标记为 _unofficial。
• 关税：费率依据韩国海关服务文件中截至 source_as_of 日期公布的数据。只有费率类型 A（基本税率）和 C（WTO 减让税率）会显示名称；其他代码按原样返回，并附有来源数据集链接。出口不征关税。

四种情况，绝不混淆：

情况	响应
编码有效，找到要求	200，requirements: [...]
编码有效，无要求	200，requirements: []，并注明这是确定结果（例如螺栓，7318152000）
编码无效	400 hs_code_not_found（或有候选编码时返回 hs_code_incomplete）——未查询任何内容，也未收费
海关 API 无法访问	503 upstream_unavailable，且 requirements_checked: false——不表示“无要求”。仍会返回商品名称和关税。未收费。

免费与付费。 免费版（REST 中使用 ?free=1）会告知编码是否受限制、要求数量，以及商品名称和关税（"detail": "summary"）。法规、机构、证书和引用的条件属于付费响应。MCP 工具调用会在免费额度内返回完整响应。

check_korea_import_requirements_batch

一次筛查整个产品目录：最多 100 个 HS 编码，每个编码使用与上文相同的架构。

输入：

{ "hs_codes": ["8516710000", "7318152000", "8471300000", "9999999999"], "direction": "import" }

输出（节选）：

{
  "direction": "import",
  "results": [
    { "hs_code": "8516710000", "has_requirements": true, "requirement_count": 3, "requirements": ["…"] },
    { "hs_code": "8471300000", "has_requirements": true, "requirements": ["…"] },
    { "hs_code": "7318152000", "has_requirements": false, "requirements": [] }
  ],
  "summary": {
    "total": 4, "checked": 3, "with_requirements": 2, "clear": 1, "failed": 0, "duplicates_merged": 0,
    "invalid_hs": [{ "index": 3, "input": "9999999999", "error": "hs_code_not_found", "message": "Not a current 10-digit Korean HS (HSK) code." }]
  },
  "governing_notice": { "…": "…" },
  "attribution": "Source: Ministry of Government Legislation (법제처), law.go.kr",
  "disclaimer": "…"
}

• 受限编码排在最前面，然后是无法检查的编码，最后是明确无问题的编码——只需查看列表顶部，就能知道海关会拦截哪些商品。无法检查的编码绝不会列在明确无问题的编码中。
• 无效编码不会导致调用失败。 它们会列在 summary.invalid_hs 中（对于 6 位输入，还会列出 10 位候选编码），不会进行查询，也不会收费。如果批次中没有任何有效编码，则免费返回 400 no_valid_hs_codes。
• 重复编码只查询和收费一次。每个商品都会重复出现的字段（通知、署名、免责声明）只在顶部说明一次。
• 计费：每个实际查询的有效编码收费 $0.02（客户端授权 $2.00；最终结算金额按实际用量计算）。查询失败的编码会以 requirements_checked: false 返回，且不收费。测试编码 8516710000 在此处也免费。

REST API

相同操作也可通过普通 HTTP 端点使用——JSON 架构与 MCP 工具相同，且无需身份验证。添加 ?free=1 即可使用每日免费额度（每个 IP 每天约 10 次查询）；不添加此标记时，未付费的请求会返回带有 x402 付款要求的 402：

# Find a company by name — the free tier returns names, numbers and confidence
curl -G "https://kbv-server-f7vfitmlkq-du.a.run.app/v1/business/search" \
  --data-urlencode "q=Samsung Electronics" --data-urlencode "free=1"

# Registration status (hyphens in the number are fine)
curl "https://kbv-server-f7vfitmlkq-du.a.run.app/v1/business/124-81-00998/status?free=1"

# KYB identity check
curl -X POST "https://kbv-server-f7vfitmlkq-du.a.run.app/v1/business/verify?free=1" \
  -H "Content-Type: application/json" \
  -d '{"business_number":"124-81-00998","representative_name":"홍길동","opening_date":"1969-01-13"}'

# Batch status check (up to 100 numbers)
curl -X POST "https://kbv-server-f7vfitmlkq-du.a.run.app/v1/business/batch?free=1" \
  -H "Content-Type: application/json" \
  -d '{"business_numbers":["124-81-00998","220-81-62517"]}'

# Import requirements for one HS code — the test code returns the full answer free
curl "https://kbv-server-f7vfitmlkq-du.a.run.app/v1/korea-import/requirements?hs_code=8516710000"

# Any other code: ?free=1 gives the summary (restricted or not, how many requirements, tariff)
curl "https://kbv-server-f7vfitmlkq-du.a.run.app/v1/korea-import/requirements?hs_code=7318152000&free=1"

# Exports: add direction=export
curl "https://kbv-server-f7vfitmlkq-du.a.run.app/v1/korea-import/requirements?hs_code=8516710000&direction=export"

# Screen a catalog (up to 100 codes; invalid ones are reported, not charged)
curl -X POST "https://kbv-server-f7vfitmlkq-du.a.run.app/v1/korea-import/requirements/batch?free=1" \
  -H "Content-Type: application/json" \
  -d '{"hs_codes":["8516710000","7318152000","9999999999"]}'

HTTP 状态码：200 表示成功（包括从缓存返回的结果）；400 表示输入无效；402 表示需要付款（未添加 ?free=1，或每日免费额度已用尽——通过 x402 按次付费）；503 表示上游服务（NTS 或 Korea Customs Service）暂时不可用，且没有缓存结果。

错误

错误会作为 MCP 工具错误（或 REST 4xx/5xx 响应）返回，并包含机器可读的 JSON 正文：

error	含义
invalid_business_number	企业编号不是 10 位。未执行任何查询。
invalid_opening_date	（verify）opening_date 不是 YYYY-MM-DD 格式。问题不在编号本身。未执行任何查询。
batch_limit_exceeded	单次批量调用中超过 100 个编号（或 HS 编码）。未执行任何查询。
invalid_request	（仅限 REST）请求正文与预期格式不符。
upstream_unavailable	NTS 或 Korea Customs Service API 停机或超出配额，且不存在缓存结果。请稍后重试。对于进口要求，这绝不表示“无要求”（requirements_checked: false）。
hs_code_not_found	不是当前有效的韩国 10 位 HS 编码。未查询或收费。
hs_code_incomplete	6 位子目：响应会列出 10 位 candidates。请选择一个并重新查询。未收费。
no_valid_hs_codes	（进口批量查询）提交的编码均无效；invalid_hs 会说明每个编码的原因。未收费。
hs_master_unavailable	无法加载 HS 编码表，因此无法验证编码。请稍后重试。未收费。

数据来源和许可

• KBV 是一项独立服务。 它并非由韩国国税厅（국세청）、韩国关税厅（관세청）、韩国政府采购厅（조달청）、金融监督院（금융감독원，DART）或法制处（법제처）运营、认可或关联。它会读取这些机构的公开开放数据，并在每条回复中说明这一点。
• 数据来源：
  • 注册状态、税种、身份匹配 — 韩国国税厅（국세청）在 data.go.kr 上提供的企业注册服务（사업자등록정보 진위확인 및 상태조회 서비스），每次请求都会实时查询。除“隐私”部分所述的 24 小时故障缓存外，KBV 不会留存国税厅注册数据的副本。
  • 名称索引（find_korean_business）— KBV 自建索引，数据来自 DART 披露申报企业（金融监督院，금융감독원）和在韩国政府采购厅（조달청）注册的供应商。如果 DART 申报企业的企业编号尚未收录在索引中，则会在搜索时从 DART 查询。
  • 禁入记录（批量）— KBV 自行保存的韩国政府采购厅（조달청）制裁名单（부정당업자 제재）；请求时不会调用外部服务。
  • 进口要求 — 请参阅下方条目。
• 底层数据集依据韩国政府开放数据政策发布，使用不受限制（이용허락범위: 제한 없음），因此回复可用于商业用途，也可自由引用。
• KBV 会将国税厅以韩语和代码形式提供的回复规范化为上文所述的稳定英文 JSON 架构；绝不会直接传递国税厅的原始载荷。
• 数据新鲜度：查询会直接访问国税厅登记系统。新注册的企业可能需要 1–2 个工作日才会出现在国税厅系统中。
• 进口要求实时来自韩国关税厅要求 API。条件摘录自法制处（법제처，law.go.kr）发布的海关指定公告（관세법 제226조 지정고시）——每条引用这些条件的回复都会附上归属信息 Source: Ministry of Government Legislation (법제처), law.go.kr。系统每天检查公告是否修订，并在公告变更时重建条件索引。HS 编码和商品名称：韩国关税厅 HS 编码表（data.go.kr 15049722）；关税税率：관세청_품목번호별 관세율표（data.go.kr 15051179），每年发布。

隐私

• KBV 自身的日志绝不包含查询内容。 服务只记录事件计数、结果和延迟，从不记录业务编号、姓名、地址、搜索词或 HS 编码。

• 您的输入会发送到哪里。 每个工具只会向上游服务发送回答问题所需的信息：

  工具 / 路由	发送至	发送内容
  check_korean_business_status · GET /v1/business/{number}/status	韩国国税厅，api.odcloud.kr	业务编号
  verify_korean_business · POST /v1/business/verify	韩国国税厅，api.odcloud.kr	业务编号、代表人姓名、开业日期，以及您提供的地址
  check_korean_business_batch · POST /v1/business/batch	韩国国税厅，api.odcloud.kr	业务编号（禁业记录来自 KBV 自有副本）
  find_korean_business · GET /v1/business/search	DART，opendart.fss.or.kr — 以及韩国国税厅，api.odcloud.kr	您的搜索词不会发送到任何地方；系统会在 KBV 自有索引中进行匹配。对于匹配的公司：如果 KBV 尚未保存其业务编号，就会将候选公司的 DART 公司代码（corp_code）发送给 DART；如果响应包含证据，就会将候选公司的业务编号发送给韩国国税厅（每次 MCP 调用均会发送；付费 REST 调用亦然）
  check_korea_import_requirements · ..._batch · /v1/korea-import/requirements	韩国海关总署，apis.data.go.kr	HS 编码以及方向（进口 / 出口）

  DART 公司代码可以标识一家公司，因此 DART 能看到查询了哪些公司的编号，但看不到您输入的文字。KBV 也会从其 Google Cloud Storage 项目中读取自有索引文件；查询数据不会写入其中。

• 一个由 HTTP 本身导致的例外： 三个 GET 端点会将输入放在 URL 中——GET /v1/business/{number}/status 中的业务编号、GET /v1/business/search?q= 中您搜索的公司名称或编号，以及 GET /v1/korea-import/requirements?hs_code= 中您查询的 HS 编码——因此这些信息会出现在 Google Cloud Run 为每个请求记录的平台访问日志中。这些日志会保留 14 天，之后自动删除。KBV 无法单独屏蔽日志中的某个字段：Cloud Logging 过滤的是整个日志条目，不会改写其中的内容。

• 不受影响： POST /v1/business/verify、POST /v1/business/batch、POST /v1/korea-import/requirements/batch 以及所有 MCP 工具调用（包括 find_korean_business 和 check_korea_import_requirements）都会在请求正文中发送输入，访问日志不会记录请求正文。如果您不希望任何标识符、搜索词或 HS 编码出现在日志中，请优先使用这些方式。

• 补充说明：韩国企业注册号是公开的公司标识符，而非个人数据。不过，个体经营者以个人名义注册，因此了解上述区别很重要。

• 服务设有短期内存缓存（最长 24 h，键经过哈希处理），仅用于在韩国国税厅服务中断时继续响应；缓存绝不会共享或导出。

定价

• 编号 124-81-00998 免费且不受限制。 Samsung Electronics 是一家真实的上市公司，可免于每日额度限制，因此接入客户端无需任何费用。数据来自实时 NTS 数据，而非测试数据。
• 免费额度：每个 IP 地址每天约可查询 10 次（批量调用按每个编号计 1 次），每天 00:00 UTC 重置。计数器保存在服务器内存中：按服务器实例分别计数，并在服务重新部署时重置，因此该数量仅供参考，并非严格执行。无需账户或密钥。MCP 工具会自动使用此额度；REST 调用需附加 ?free=1 才能使用——未附加该参数时，REST 会返回包含 x402 付款要求的 402 响应。MCP 和 REST 共用同一个计数器。
• 查找免费，确认付费。 GET /v1/business/search?q=…&free=1 会在免费额度内返回名称、企业编号和置信度——只知道公司名称的 Agent 始终可以查询到编号。付费调用会额外返回 evidence 字段（状态、税务类型、地区、上市信息），用于区分名称相似的公司。
• 超出免费额度后，REST 端点按次付费，使用 x402 协议（Base 主网上的 USDC，可由 Agent 付款，无需注册）：
  • GET /v1/business/search — $0.02（包含证据的候选结果）
  • GET /v1/business/{number}/status — $0.02
  • POST /v1/business/verify — $0.05
  • POST /v1/business/batch — 每个编号 $0.02（授权金额最高为 $2.00，按实际使用量结算）
  • GET /v1/korea-import/requirements — $0.03（附加 ?free=1 时返回摘要：商品名称、关税、该编码是否受限以及要求数量；付费调用会额外返回法规、审批机构、证书和所引述的条件。HS 编码 8516710000 始终免费且返回完整信息）
  • POST /v1/korea-import/requirements/batch — 每个查询的有效 HS 编码 $0.02（授权金额最高为 $2.00，按实际使用量结算；无效编码、查询失败及 8516710000 均不收费）
• 超出免费额度的 MCP 工具调用会返回 free_tier_exceeded 错误，并指向上述付费 REST 端点。
• 公平使用：上游 NTS 额度由所有用户共用；免费层让低频使用无需付费，而高流量则转为付费调用。

常见问题

我只知道公司的名称，还能使用吗？ 可以，这正是 find_korean_business（或 GET /v1/business/search）的用途。输入英文或韩文名称，即可获取匹配的公司及其注册号，并按置信度排序。这里的其他工具都需要注册号；你可以通过这种方式获取注册号。

名称搜索能查到小型公司吗，还是只能查到大型集团？ 两者都可以。索引整合了 DART 信息披露申报企业（约 119k 家，几乎都有英文名称）和所有注册参与公共采购的供应商（约 821k 家），其中就包括韩国的小型和中型企业。

什么是韩国企业注册号？ 这是韩国国税厅（National Tax Service）向韩国境内所有注册企业签发的 10 位标识符（사업자등록번호，常写作 123-45-67890）。

我可以查询韩国公司是否仍在经营吗？ 可以——调用 check_korean_business_status；"status": "active" 表示企业当前仍在注册并经营，"closed" 则包含注销日期。

我可以在交易前核实韩国公司的身份（KYB）吗？ 可以——使用注册号、代表人姓名和开业日期调用 verify_korean_business；identity_match: true 表示国税厅确认这三项信息均匹配。

我可以一次筛查整份供应商名单吗？ 可以——check_korean_business_batch（或 POST /v1/business/batch）每次最多接受 100 个号码，并返回每个号码的注册状态以及任何公共采购禁入信息，另附汇总，统计当前被禁入的供应商数量。两者结合才是实际的筛查问题：供应商可能正常经营，但仍被禁止参与公共合同。

我可以在不消耗免费调用次数的情况下进行测试吗？ 可以。无论使用哪个端点或工具，查询 124-81-00998（Samsung Electronics）都不会计入每日额度；在批量查询中也一样，只有其他号码会计费。响应数据来自国税厅的实时数据。

我需要 API 密钥吗？ 不需要。连接到 MCP URL 并调用工具，或直接调用 REST 端点即可。

自行托管／开发

该服务开放供本地开发使用（Node.js ≥ 22、TypeScript、Express + official MCP SDK）：

cp .env.example .env       # put your own data.go.kr DECODING key in NTS_SERVICE_KEY
npm install
npm run dev                # → http://localhost:8080  (MCP at /mcp)
npm test                   # vitest, upstream fully mocked — no network

部署指南（Google Cloud Run）：参见 DEPLOY.md。架构和设计规范：参见 DESIGN.md。