落札結果を探す・数える
search_awardsUse this when the user asks who won, or how often, in Japanese public procurement: award and contract results from 2004 onward for national agencies and local governments. Filter by keyword, buyer, supplier, area, category and period; set group_by to get counts instead of rows. At least one of keyword, buyer, supplier or a non-default status is required. Counts include only results that reached an award or contract; unsuccessful (不調), cancelled (中止) and unresolved (結果未確定) records are counted separately in not_awarded, or listed with status. Amounts are shown as bands. 落札結果・契約結果・落札者・随意契約
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_awards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | No | Prefecture of the buyer. Accepts 福岡県, 福岡, Fukuoka, 40 (JIS code), national (国の機関) | |
| buyer | No | Procuring entity: name, abbreviation (国交省) or buyer_id | |
| limit | No | Rows per page, 1-10 (default 10) | |
| cursor | No | next_cursor from the previous result, with the same other arguments. Up to 3 pages. | |
| status | No | awarded (default): only results that reached an award or contract (落札・契約). unsuccessful = 不調 (no valid bid), cancelled = 中止, unresolved = 結果未確定 (published without a winner), not_awarded = those three together, all = every record. Counts and rankings use only awarded results unless you set this. | |
| date_to | No | Result date on or before, YYYY-MM-DD | |
| keyword | No | Words in the contract title. Space = AND. Example: 庁舎 清掃 | |
| category | No | 物品=goods/supplies, 工事=construction works, 役務=services/outsourcing (業務委託), 保守=maintenance, 設計・調査=design/survey/consulting, IT=systems/software/IT equipment, 賃貸借=lease/rental, イベント=events, その他=other | |
| group_by | No | none (default): rows, newest first. Otherwise counts per group: all years, the top 10 buyers/suppliers/categories, or all amount bands (amount_band: number of records in each published-amount band, plus records without an amount). | |
| supplier | No | Winning company: name as the user wrote it, 13-digit corporate number (法人番号) or supplier_id. A name matching several companies returns candidates | |
| date_from | No | Result date on or after, YYYY-MM-DD | |
| fiscal_year | No | Japanese fiscal year (April to March). 2024 = 2024-04-01 to 2025-03-31 = 令和6年度. 令和N年度 = 2018+N. | |
| response_format | No | concise (default): fewer fields per row. detailed: adds IDs, method, original URL and retrieval date per row. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| note | Yes | ||
| hints | No | ||
| total | No | ||
| access | No | Whether this result is shown in full through this server: public = yes; not_public_now = the item exists but this server does not return it at present (e.g. a notice whose deadline has passed); login_required / plan_required = the item exists but is available only under other access conditions of the site (sign-in, or a plan) | |
| groups | No | ||
| source | Yes | ||
| applied | Yes | ||
| cite_as | No | One-line source citation for this result: the page title on 入札案件観測所, the data date, and the URL of that page (same as `url`). | |
| message | No | ||
| related | No | Facts related to this result (counts) and the tool call that returns them | |
| results | No | ||
| returned | Yes | ||
| retrieved | Yes | ||
| candidates | No | ||
| data_as_of | Yes | ||
| restricted | No | Items that exist but are not returned here, with their access value. An item listed here is not missing from the data. | |
| next_cursor | No | ||
| period_note | No | ||
| total_all_periods | No | When a period (date_from, date_to or fiscal_year) is given: the count for the same conditions without the period |