Japan Procurement

@pipeworx/japan-procurement

日本の政府調達公告 — 国の省庁、47都道府県および市区町村の入札公告を、独立行政法人中小企業基盤整備機構が運営する官公需情報ポータルサイトから取得します。

Pipeworx の一部です — AI エージェントを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 は2桁になるようゼロ埋めする必要があります。 LG_Code=1 では SearchHits=0 が返されます — 「北海道の入札公告はありません」と読めてしまう、正常な200応答です。 LG_Code=01 では約5万件が返されます。このパックでは自動的にゼロ埋めするため、元に戻さないでください。
• Category には数値コード（1 物品 / 2 工事 / 3 役務）を指定する必要があります。 日本語のラベルを渡すと、 internal error: query error: syntax error が返されます。Procedure_Type（1–3）も同様です。 このパックでは名称とラベルをコードに変換し、変換できない値はそのまま転送せず、有効な値の一覧を示して拒否します。
• オフセットやページのパラメーターはありません。 Count は1回の呼び出しにつき最大1,000件です （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 を通じて回答できるのが、これらのメタツールの役割です。そのため、2 つ目の 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 を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの 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