会社名から法人を探す
bango_find_companyFind Japanese companies by name and return candidate corporate numbers for selection. Use it when you have a company name instead of a 13-digit corporate number; optionally narrow by prefecture.
Instructions
Find Japanese companies (法人) by name and return candidate corporate numbers (法人番号). Use this when the user gives a company name instead of a number, e.g. 「トヨタ自動車」「㈱サンプル 大阪」「sample shoji」. Name variants are absorbed automatically (株式会社/㈱/(株), full-width/half-width, spaces), so pass the name as the user wrote it; do not guess a 13-digit number. Narrow with prefecture when the user mentions a place. Results are ranked by score (0-1). If several candidates look plausible, ask the user which one they mean (show name and prefecture) instead of picking one. Then call bango_get_company with the chosen corporate_number for address and invoice status. Each call uses 1 API request from the user's Bango API quota.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| exact | No | true にすると表記ゆれを吸収したうえでの完全一致だけを返す。既定は部分一致（false） | |
| limit | No | 返す候補の数（1〜20、既定5） | |
| post_code | No | 郵便番号（7桁、ハイフン可）で絞り込む | |
| prefecture | No | 都道府県で絞り込む。「大阪」「大阪府」「27」「osaka」のどれでも可 | |
| company_name | Yes | 会社名（一部でも可）。例: 「サンプル商事」「株式会社サンプル」 |