はじめに
Japan Business Tools は、日本のビジネス情報(祝日・営業日、和暦、郵便番号、住所の正規化、法人番号)を、AIエージェントと開発者に、MCPの13ツールとRESTの13エンドポイントで提供します。どちらも同じ処理を使い、答えの形も同じです。
接続のしかたを選ぶ
Section titled “接続のしかたを選ぶ”| やりたいこと | 見るページ |
|---|---|
| AIエージェントをつなぐ | MCPの接続ガイド |
| プログラムからHTTPSで呼ぶ | RESTのガイド |
| すべてのツールと入力を見る | ツール一覧 |
| OpenAPIの定義を見る | APIリファレンス |
| ブラウザで試す | Playground |
アカウント、APIキー、ログインは要りません。13ツールはすべて読み取り専用です。
最初の呼び出し
Section titled “最初の呼び出し”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(印)
Section titled “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:市区町村名が複数の自治体に合います。 |
運営:Momonga