本文へ移動

はじめに

Japan Business Tools は、日本のビジネス情報(祝日・営業日、和暦、郵便番号、住所の正規化、法人番号)を、AIエージェントと開発者に、MCPの13ツールとRESTの13エンドポイントで提供します。どちらも同じ処理を使い、答えの形も同じです。

やりたいこと 見るページ
AIエージェントをつなぐ MCPの接続ガイド
プログラムからHTTPSで呼ぶ RESTのガイド
すべてのツールと入力を見る ツール一覧
OpenAPIの定義を見る APIリファレンス
ブラウザで試す Playground

アカウント、APIキー、ログインは要りません。13ツールはすべて読み取り専用です。

ターミナルウィンドウ
curl -fsS 'https://biz.ossalt.jp/v1/holidays?year=2026'

成功した答えは、MCPでもRESTでも、同じ5つの項目を持ちます。

{
"result": {},
"source": {},
"as_of": "YYYY-MM-DD",
"notes": [],
"flags": []
}
項目 意味
result 答えそのもの。中身はツールごとに違います(ツール一覧)。
source 答えの出どころ:データの名前、版や更新日、利用条件、確認のしかた。
as_of 基準日(日本時間、YYYY-MM-DD)。
notes 人が読む注意書き(日本語):前提、推定、ヒント。
flags 見落としてはいけないことを表す、機械が読める印。いつも配列です。

答えを事実として扱う前に、flags を確かめてください。「利用者に伝える」とある印は、そのまま利用者に伝えます。

印 意味
estimated 値が見込みです(例:将来の春分・秋分の日)。利用者に伝える。
unverified その年は、まだ内閣府のデータと照合していません。利用者に伝える。
assumes_current_era 将来の日付の和暦は、元号が変わらないと仮定した書き方です。利用者に伝える(to_japanese_era のみ)。
outside_era 指定した和暦の日付が、その元号の範囲の外です。正しい和暦は actual に返ります。
weekday_mismatch 入力に書かれた曜日が、その日付の曜日と違います。
closed 法人の登記の記録が閉鎖されています。利用者に伝える。
excluded_from_search 国税庁のデータで「検索対象から除外」とされた記録です。名前の検索には出ず、番号の照会では返ります。
truncated 返した件数より多く該当があります。total と returned を比べてください。
not_found 該当がありませんでした。エラーではなく、正しい答えです。
exact_match_only 名前が一般的すぎて前方一致で探せないため、名前がちょうど同じものだけを探しました。もう少し長く入れてください。
partial 住所が、町域ではなく、都道府県または市区町村までしか合いませんでした(level が3より小さい)。
ambiguous 当てはまる市区町村または郵便番号の候補が複数あります。
city_not_found search_postal_code:市区町村名がどの自治体にも合いませんでした。
ambiguous_city search_postal_code:市区町村名が複数の自治体に合います。
  • 日付は、日本時間の YYYY-MM-DD です。祝日は1980〜2099年、和暦への変換は1873-01-01以降に対応します。
  • 入力の文字列は、1項目あたり200文字までです。
  • 制限とエラーの扱いは、MCPの接続ガイドとRESTのガイドに書いています。出典・新しさ・既知の制限は信頼性と透明性へ。

運営:Momonga