使用する tool
検索条件
| 項目 | 意味 | 例 |
|---|---|---|
q |
法人名などの検索語 | サンプル株式会社 |
corporateNumber |
13 桁の法人番号。指定時は完全一致を優先します。 | 1234567890123 |
prefecture |
都道府県名で絞り込みます。 | 東京都 |
city |
市区町村名で絞り込みます。 | 千代田区 |
limit |
取得件数。1 から 50 件まで指定できます。 | 5 |
依頼例
MCP クライアントでは、自然文で次のように依頼できます。
AISFA の企業マスターで「サンプル株式会社」を検索してください。
東京都で絞り込み、候補は5件まで表示してください。tool call として明示する場合は次の入力になります。
{
"q": "サンプル株式会社",
"prefecture": "東京都",
"limit": 5
}法人番号が分かっている場合は、法人番号だけで検索するのが最も確実です。
{
"corporateNumber": "1234567890123",
"limit": 1
}候補の見方
候補には id、corporateNumber、name、住所項目、score が含まれます。
企業登録では
id を masterCompanyId として渡すか、corporateNumber をそのまま渡します。法人名だけで登録する tool ではありません。
登録前の確認
登録 tool は法人番号や名称・住所で既存 Companies を探し、一致した場合は新規作成せず既存 record を返します。それでも検索段階で法人番号と住所を確認してから登録する運用にしてください。