Japan Public Data (法人番号・登録支援機関・官公需入札)

io.github.takaratomita由 GitHub 帳號 takaratomita 發布v0.1.0更新於 Oct 27, 2026

Japan public data: corporate numbers, registered support organizations, government bid notices.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取商業與電商

概覽

AI 產生的概覽

提供日本公開資料的遠端 MCP 伺服器:法人編號查詢、登錄支援機構檢索、政府招標公告檢索。

可以做什麼
  • 依 13 碼法人編號或法人名稱查詢日本企業,回傳名稱、所在地與是否閉鎖
  • 依名稱、所在地(都道府縣/市區町村)與對應語言檢索特定技能「登錄支援機構」名冊
  • 依關鍵字、都道府縣、發布機關與公告日期檢索地方政府及國家機關的招標與公開徵求資訊,回傳標題、日期與公告連結
適用情境
適合需要核實日本企業資訊、尋找協助外國勞工的登錄支援機構,或掌握日本公部門近期招標機會的情境。三項工具皆為唯讀查詢。
執行需求
遠端 Streamable HTTP 端點,用戶端不需驗證或 API 金鑰。伺服器本身會存取國稅廳法人編號 API 與 KKJ 入口網站檢索 API。
安裝前請注意
工具為唯讀,但查詢內容會傳送至該伺服器並轉發至國稅廳與 KKJ 的 API,檢索詞對第三方可見。內附的支援機構資料為定期更新的快照,結果可能落後於官方名冊。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Japan Public Data (法人番号・登録支援機関・官公需入札),將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.takaratomita%2Fmcp-tools/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "japan-public-data": {
      "type": "http",
      "url": "https://mcp-tools.takara0408103123.workers.dev/mcp"
    }
  }
}

README

mcp-tools

日本の公開データを提供するリモートMCPサーバー(Streamable HTTP・Cloudflare Workers)。Claude Connectors Directory と ChatGPT Apps Directory への掲載を目的とする。

仕様・進捗は mcp-tools-spec.md を参照。

ツール

ツール内容状態
lookup_corporate_number国税庁 法人番号公表サイトAPI。法人番号(13桁)または法人名で検索実装済み
search_support_orgs出入国在留管理庁「登録支援機関登録簿」。名称・所在地・対応言語で検索(同梱データ。data/support-orgs.json)実装済み
search_local_govt_bids官公需情報ポータルサイト検索API(中小企業庁)。自治体・国の機関の入札・公募情報をキーワード・都道府県・機関名・公告日で検索実装済み

すべて読み取り専用(readOnlyHint: true)。外部通信は api.houjin-bangou.nta.go.jp と www.kkj.go.jp のみ。

登録支援機関データの更新

登録簿は随時更新される(2026-10 時点で月に複数回)。Worker から直接取得せず、生成済みJSONを同梱している。理由は2つ。(1) 配布元が既定のUAを403で拒否する (2) 2.6MBのExcelをリクエストごとに解析するのは Workers には重い。同梱JSONは約5.0MB・gzip後約0.86MBで、Workers 無料プランのスクリプト上限(圧縮後3MB)に収まる。

pip install openpyxlpython3 scripts/build_support_orgs.py   # 掲載ページから最新のExcelを取得し data/support-orgs.json を上書きnpm test

代表者氏名の列はツールの用途に不要なため取り込まない。名称・支援事務所名の欄は登録簿の記載のまま返す。

使い方(インストール)

公開エンドポイントは https://mcp-tools.takara0408103123.workers.dev/mcp。認証は不要。

Claude Code:

claude mcp add --transport http mcp-tools https://mcp-tools.takara0408103123.workers.dev/mcp

Claude Desktop・claude.ai:設定の「コネクタ」→「カスタムコネクタを追加」に上のURLを入力する。

その他のMCPクライアント(Cursor・VS Code 等):Streamable HTTP のリモートサーバーとして上のURLを登録する。

公式 MCP Registry の登録名は io.github.takaratomita/mcp-tools(定義は server.json)。

エンドポイント

パス内容
/mcpMCP(Streamable HTTP・ステートレス・JSON応答)
/privacyプライバシーポリシー(/ も同内容)
/healthヘルスチェック

開発

npm installnpm test            # vitestnpm run typecheckcp .env.example .dev.vars   # HOUJIN_APP_ID を記入npm run dev         # http://localhost:8787/mcp

動作確認例:

curl -s -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \  localhost:8787/mcp -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

デプロイ(Cloudflare Workers)

  1. npx wrangler secret put HOUJIN_APP_ID(lookup_corporate_number に必要。未登録でも他の2ツールは動く)
  2. npm run deploy(既定は workers.dev。独自ドメインは任意で、wrangler.toml の routes を有効化する)
  3. https://<host>/health と https://<host>/privacy が200を返すことを確認する

2026-10-19 に https://mcp-tools.takara0408103123.workers.dev へデプロイ済み。ディレクトリ側の要件に独自ドメインは含まれないため、workers.dev のまま掲載する(根拠は仕様書の章5)。

掲載チェックリスト

Claude Directory 掲載用

  • 公開HTTPSでデプロイ済み(workers.dev。/mcp 到達確認済み)
  • 有料 Claude プランに加入済み(Max。2026-10-19 に提出画面で確認)
  • 法人番号APIの appId を発行し、wrangler secret に登録済み(審査員が全ツールを試すため提出前に必須)
  • tools/list の3ツールすべてに readOnlyHint 等のannotationがある
  • プライバシーポリシーURL(/privacy)を用意
  • サポート連絡先(GitHub Issues)を記載
  • https://claude.ai/directory/manage の「MCPコネクタ」から提出(文面は docs/listings.md)

ChatGPT Apps 掲載用

  • 公開HTTPSでデプロイ済み(workers.dev)
  • ChatGPT Platform(https://platform.openai.com/plugins)にログインし、individual または business の本人確認を完了
  • 法人番号APIの appId を発行・登録済み
  • プライバシーポリシーURLを用意(/privacy)
  • CSP定義(接続先ドメインの宣言。外部通信は api.houjin-bangou.nta.go.jp と www.kkj.go.jp)を提出時に入力
  • 審査用のテストプロンプトと期待結果を用意
    • 「法人番号7000012050002の会社を調べて」→ 国税庁(東京都千代田区)
    • 「横浜市でネパール語に対応している登録支援機関を探して」→ 登録簿の該当機関一覧と出典
    • 「東京都の清掃業務の入札情報を探して」→ 直近30日の公告一覧と出典
  • 提出時点の最新要件を公式ガイドで再確認

ライセンス

MIT。データの出典は次のとおり。

  • 法人情報:国税庁法人番号公表サイト
  • 登録支援機関:出入国在留管理庁「登録支援機関登録簿」(公共データ利用規約 第1.0版(PDL1.0)。加工して利用)
  • 入札・公募情報:官公需情報ポータルサイト(https://www.kkj.go.jp/s/)の検索APIを利用

來源:README.md,提交 7bb111f

工具

3

lookup_corporate_number

Lookup Japanese corporate number

Look up Japanese companies in the National Tax Agency Corporate Number Publication Site. Search by 13-digit corporate number, or by company name. Returns name, address and status. 国税庁 法人番号公表サイトから、法人番号(13桁)または法人名で法人情報(名称・所在地・閉鎖有無)を検索します。

輸入參數namenumber

search_support_orgs

Search Japanese registered support organizations (SSW)

Search the Immigration Services Agency of Japan registry of Registered Support Organizations for Specified Skilled Workers. Filter by name, location (prefecture/city in head office or support office address) and supported language. Organizations that reported suspension are excluded unless includeSuspended is true. 出入国在留管理庁「登録支援機関登録簿」から、特定技能外国人の登録支援機関を名称・所在地・対応言語で検索します(同梱データ・基準日あり)。

輸入參數namelimitlanguagelocationincludeSuspended

search_local_govt_bids

Search Japanese public procurement notices

Search bid and tender notices from Japanese local governments and national agencies via the KKJ (官公需情報ポータルサイト) search API by the Small and Medium Enterprise Agency. Filter by keywords (AND), prefecture, issuing organization and notice date. Returns title, organization, dates and the notice URL. 官公需情報ポータルサイトの検索APIで、自治体・国の機関の入札・公募情報をキーワード・都道府県・機関名・公告日で検索します。

輸入參數limitquerysinceprefectureorganization

版本歷史

1
  1. v0.1.0最新Oct 22, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分