Japan Procurement

@pipeworx/japan-procurement

日本政府招标公告——来自中央各部委、全部 47 个都道府县及市町村的招标信息，数据源为日本中小企业厅运营的官公需信息门户网站（Kankōju 公共采购门户）。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1882+ 个实时数据源的 MCP 网关。这是独立、非官方的集成，与上游提供方无关联、未获其认可，也非由其发布。

工具

• japan_tenders_search(query, …) — 在所有发布机构的公告中进行关键词搜索。支持日语或 ASCII，以及门户网站的运算符（AND / OR / ANDNOT / NOT、括号）。筛选条件：类别、都道府县、招标方式、机构、公告标题、公告日期范围。
• japan_tenders_by_prefecture(prefecture, …) — 不使用关键词，浏览某个都道府县的公告。接受 "Tokyo"、"東京都" 或 "13"；多个值以逗号分隔。
• japan_tenders_by_organization(organization_name, …) — 查看指定采购方发布的所有公告（"国土交通省"、"横浜市"），支持部分匹配。
• japan_tender_reference() — 查询可接受的类别、招标方式及全部 47 个 JIS X0401 都道府县代码。筛选值被拒绝时调用此工具。

每条公告都包含采购方、标题、公告日期、原始公告 URL、附件链接，以及发布方提供时的投标提交日期、开标日期、交付截止日期、履约地点和投标人所需资质。

身份验证

无需密钥。

数据源

• https://www.kkj.go.jp/api/ — 门户网站公开说明的搜索 API，采用 XML 格式。 规范文档：https://www.kkj.go.jp/doc/ja/api_guide.pdf（V1.1，2016-05-27）。

以下是容易被忽略、之后又不得不重新发现的事项：

• LG_Code 必须补零至两位数。 LG_Code=1 会返回 SearchHits=0——这是一个正常的 200 响应，却会让人误以为“北海道没有发布任何招标”。LG_Code=01 会返回约 50k 条。此工具包会自动补零；请勿撤销。
• Category 必须使用数字代码（1 物品 / 2 工事 / 3 役务）。 传入日语标签会返回 internal error: query error: syntax error。Procedure_Type（1–3）也一样。此工具包会将名称和标签映射为代码，并拒绝任何无法映射的值，同时列出有效取值，而不是直接转发。
• 不存在 offset 或 page 参数。 每次调用的 Count 上限为 1,000（超过上限的值会被静默按 1,000 处理）。如需遍历更大的结果集，请使用 CFT_Issue_Date 缩小范围——当 total_hits 超出返回结果数时，此工具包会在响应中提供 paging 字段。
• 必须至少提供 Query / Project_Name / Organization_Name / LG_Code 其中一项；如果都不提供，API 会返回 <Error>no searchword</Error>。因此，浏览工具要求指定都道府县或机构。
• ProjectDescription 是提取出的完整公告文本，通常长达数万字符（由关联 PDF 进行 OCR 和提取，可能包含完整的单价明细表）。此工具包会返回 600 字符的预览，并提供 description_truncated；设置 full_text: true 时，最多返回 20,000 个字符。
• 发布方未提供的可选字段会被省略，而不是返回空值——TenderSubmissionDeadline、OpeningTendersEvent、Location、Certification 和 ItemCode 经常缺失，尤其是市町村公告。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "japan-procurement": {
      "url": "https://gateway.pipeworx.io/japan-procurement/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/japan-procurement/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关级工具集中的其他工具。因此，你看到的工具数量会多于此表：单个工具包端点当前会列出大约 30 个共享工具，以及该工具包自身的工具。连接的 initialize 响应会说明其确切范围，并且是当天具体范围的权威答案。

这是有意设计的，并非意外的多路复用。元工具让限定范围的连接能够回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——而无需添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点；如果额外的模式占用的上下文超过了路由带来的收益，请连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1882+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/japan_tenders_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"橋梁","category":"works","prefecture":"Tokyo","limit":3}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/japan_tenders_search。查找工具：POST https://gateway.pipeworx.io/v1/tools/search_packs，并传入 {"query":"..."}。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "japan-procurement": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-japan-procurement"]
    }
  }
}

也可以直接运行它，确认服务能够启动：

npx -y @pipeworx/mcp-japan-procurement

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上述网关连接添加的任何共享元工具。源代码相同，工具相同，但没有 ask_pipeworx 路由。

与 ask_pipeworx 搭配使用

你可以用通俗英语提问，而不是直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Japan Procurement data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档与指南
• pipeworx.io

许可证

MIT