補助・助成.jp

1つの補助金について自社が対象になりそうかを項目別に判定する（likely_eligible / needs_review / ineligible）。

    subsidy_id は recommend_subsidies の id。plan を省略するとプロフィールの plan を使う。
    各項目の根拠（公募要領のページ引用）、不足情報、補助額試算を返す。
    guideline に、公募要領を読めているか（available）と、公式サイトで見つけた要領のリンク（pdf_candidates）、
    公募要領で確かめる観点（viewpoints）がある。available が false のときは、リンクを開いて観点を確かめる。
    観点は合否ではない。確かめられなければ「未確認」と伝える。
    

【定期チェック用】前回このツールを呼んでから新しく現れた候補（new）と、締切が近い候補（closing_soon）を返す。

    初回（その利用者の既読が空のとき）は、今ある候補を新着として並べず次回からの基準にする（new は空、件数は baseline）。
    「新着なし」は「使える補助金がない」ではない。いまの候補の一覧は recommend_subsidies で見る。締切間近は初回も返る。
    2回目以降の new は国・J-Net21の新着・自治体の制度ごとに締切の近い順で上限件数まで（国12件・J-Net21 8件・自治体の制度8件）。
    載せきれなかった分の件数は new_omitted で、既読にしないので次回また出る。残りは recommend_subsidies で見る。
    new の上位は詳細を取得して一次判定する。要領の抽出・未確認範囲は review_scope を見る。
    local がある場合は自治体等の制度の new / closing_soon（出典表記を添える）。
    mark_seen=false にすると今回の結果を既読にしない。
    purposes を渡すとその目的の制度だけを返す（絞り込みで見せなかった候補は既読にならない）。
    

本店所在地だけを変えた場合に候補がどう変わるかを比較する。

    locations は都道府県から始まる所在地（例: ["東京都千代田区", "大阪府大阪市"]）。5か所まで。
    検索は 候補地 × キーワード × 2地域 で120回まで（超えるときはキーワードを絞る）。
    purposes を渡すとその目的の制度だけで比較する。
    各候補地の local_programs に、その地域の自治体の制度（企業立地補助金など進出する事業者向けを含む。対象規模・業種・概要つき）を返す。
    

申請案件1件（記入内容・様式・記入済みファイル・ダウンロードURL）を削除する。利用者がこの案件の削除を明示的に求めたときだけ使う。 曖昧な「やり直して」では使わない。ほかの案件・会社情報・ウォッチリスト・接続設定は残る。元に戻せない。 まず confirmation なしで呼ぶと、削除せずに対象（制度名・記入済みの欄の数）と削除範囲を返す。それを利用者に示して同意を得てから、 confirmation に「この申請書類を削除する」と正確に指定して呼ぶ。 status: needs_confirmation（未削除）・deleted・not_found（削除済み・IDの誤り。再試行しても安全）。 削除後も同じ制度の別案件は残る。別下書きの作成には削除せず start_application(new_draft=true) を使う。

会社プロフィール・ウォッチリスト・既読情報・申請書類（案件と記入内容）をすべて削除する。ユーザーが明示的に全データの削除を依頼した場合のみ使う。 申請案件1件だけを消したい・始め直したいときは使わず、delete_application を使う。

    実行前にユーザーへ削除内容を説明して確認し、confirmation に「すべて削除する」と正確に指定する。
    元に戻せない。APIキー（接続設定）は残るため、プロフィールを登録し直せば引き続き使える。
    

PDFの欄を足す・動かす・書式を変える・消す（1〜100件）。座標は pt、ページの左上が原点。 位置は box（矩形。近くの罫線に合わせる）・at（点を含むセルの空き）・anchor（原本の文言の右・下・周り）のどれか。 value で位置を決めたうえで記入できる。値が収まらなくなる変更と値のある欄の削除は、その欄だけ rejected。

記入済みの様式を元の書式のまま出力し、個別のダウンロードURLを返す。

    Excelを含む場合は note の開き直し・再計算後の表紙・集計値の確認手順を利用者に案内する。
    入力値からの検算とExcelで開いた表示確認は別であり、未確認の反映を確認済みと伝えない。

    Args:
        case_id: 出力する案件ID。
        form_ids: 出力する様式ID。省略時は記入済みの全様式。
        include_zip: 一括取得などを利用者が希望した場合だけtrue。既定ではZIPを作らない。

    Returns:
        files（少数Wordはdocx直接添付、添付不可なら個別URLを案内）、zip、delivery_note。
        Word→確認用PDF変換は非対応。要求時はBot側の変換手段かWordのPDF保存を案内し、Wordも残す。
        提出前に内容（書式の崩れ・記入漏れ・添付書類）を確認するよう伝える。提出は利用者が行う。
    

欄ID→文字列を保存（置き換え）。clear は取消。Excel は sheet と番地、またはシート名!番地。PDF は p1.f12 の形。 from_profile=true はプロフィール候補の未記入欄をまとめて記入する。 rejected は未保存、その欄だけ修正する。warnings は保存済みなので見出しを確かめる。 ラベル・記入例を残す場合はそれを含む全文を指定する。金額・数量は円単位等の半角数字。 日付は利用者が伝えた値を書く（推奨日程への変更は利用者が認めてから）。 progress は入力候補の記入済み・残り。複数様式は fill_forms を使う。

複数様式を1回で記入する（1〜50件）。同じ様式は配列順にマージして1回保存。 各項目は fill_form と同じ引数。欄ごとの rejected は未保存、warnings は保存済み。 様式間の保存は順次行うため、通信失敗時は一覧で保存状態を確認する。

保存済みの会社プロフィールを返す。

公募要領の指定ページ（1始まり）の全文を返す。search_guideline で見つけたページの前後を読むときに使う。

    文書が複数ある場合は document にファイル名を指定する（get_subsidy の attachments に一覧がある）。
    

概要本文（detail_text）、公募回次・締切・金額・公式リンク・添付名とページ数を返す。

    添付そのものや要領のページ本文は含まない。要領は search_guideline / get_guideline_pages で読む。
    document_handoff に形式制約と、利用可能な場合の書類作成操作がある。用途・必須性は未分類。
    作成希望を確認してから next_action を使い、閲覧だけで案件作成しない。
    

利用者が求めたときに、自治体の制度ページの様式を1件取り込み、利用者の申請案件に加える。 url は start_application の official_forms の url（それ以外は受け付けない）。.docx/.xlsx/.xlsm/.rtf/.pptx/.pdf のみ。 返り値の forms の form_id を inspect_form→fill_form で記入する。取り込めないときは利用者に upload_url を案内する。

欄の一覧。Excel は指定なしであらすじ、sheet で1シート、sheets で複数をまとめて読む。 PDF は指定なしでページごとの欄の数、page（1始まり）でそのページの欄。欄は空いた場所の候補で、view_form で画像を確かめる。 Word・RTF は本文と表。table は0始まりの表番号。PowerPointは既存テキストと表（targetsで欄IDを指定できる）。 only_empty は未記入候補（必須欄の判定ではない）。xlsmのマクロは保持するが実行しない。 targets は欄IDの指定取得（Excel はシート名!番地）。sheet・sheets・targets・table は排他。 次は next_cursor を cursor に、または next_offset を offset に渡す。取得条件は同じにする。 max_bytes はUTF-8 JSON本体の予算4096〜262144。複数シートの既定は32768。MCPの外枠・複製分は別。 how_to と profile_candidates は初回だけ。入力規則・行列の見出しを確認して記入する。

作成中の申請案件と、様式ごとの記入済み欄の数を返す（前回の続きから再開するときに使う）。 同制度の複数案件は作成日時・case_id で識別し、再開は start_application(subsidy_id, case_id)。 既存を残して別下書きを作る明示要求では new_draft=true。削除せず作れる。1件の削除は delete_application。web があれば申請書類画面を案内できる。

ウォッチ中の補助金の一覧。締切・残り日数・状態と、前回確認時からの変更（changes）を返す。

    acknowledge_changes=true で表示した変更を確認済みにする（次回から changes に出ない）。
    

法人番号または会社名から、gBizINFO（経済産業省の法人情報サイト）の会社情報を読み込む。保存はしない。

    会社情報を聞き取る前に使うと、利用者は「確認するだけ」で済む。
    name（会社名。prefecture に都道府県名を添えると絞れる）では候補の一覧（法人番号・名称・所在地）を返す。
    どの会社かを利用者に確かめてから、corporate_number（13桁）で呼ぶ。
    corporate_number では次を返す。proposed は save_company_profile の company にそのまま足せる項目と値。
    differences は今の会社情報と違う項目（今の値・gBizINFO の値）で、今の値がある項目は、利用者がどちらにするか選ぶまで上書きしない。
    unknown は gBizINFO が空だった項目で、「なし」ではなく不明なので利用者に聞く。
    warnings は更新日が古い・代表者や従業員数の確認・業種が複数などの注意で、利用者に伝える。
    certifications（持っている認定）は前提の認定がある補助金の判定に使う。past_subsidies（過去の交付）は記録がないことを
    「交付を受けていない」と言わない。
    proposed・differences・unknown を利用者に見せ、確認を得てから get_company_profile の内容に足して save_company_profile で保存する。
    報告には attribution の出典の文言を必ず添える。法人番号がない個人事業主は対象外。
    

選択した様式の入力候補とプロフィール・保存値を照合し、質問と転記候補をまとめる。 保存・中間ファイル生成はしない。必須/任意・該当なしは用途を確認する。PDF等は未確認として返す。 回答済み情報は再利用し、回答前の一式作成は利用者が途中版を求める場合だけ行う。

【最初に使う】自社に合う補助金候補を探し、判定済みの一覧を返す。通常は引数なしで呼ぶ。

    プロフィールの search_keywords で検索し、地域・募集期間・従業員数で足切りした上で、
    上位 detail_top_n 件は詳細を取得して一次判定する（初回は数十秒かかる）。
    review_scope は要領の抽出範囲と未確認項目、checks は省略していない根拠。抽出済みは全要件確認済みではない。
    各候補: status（likely_eligible / needs_review）、acceptance_phase、deadline、days_left、estimated_yen（補助額試算）、
    acceptance_phase が unknown の候補は、Jグランツの受付期間が新規応募のものか確かめられていない（deadline は null）。
    新規応募の締切を公式サイトで確認してから案内する。
    concerns（要確認点。「要領 p.N」は根拠ページ）、url。
    local がある場合は所在地に該当する自治体・支援機関の制度（内容と要件はリンク先で確認）。報告時は source の出典表記を添える。
    keywords を渡すとプロフィールのキーワードの代わりに使う（2文字以上の短い語。40個・1語30文字まで）。
    detail_top_n は10まで。
    無料プランの利用者には、公募要領・詳細は読まない一覧だけを返す（detail_top_n は使わない）。結果の plan に残りの回数と案内がある。
    purposes を渡すと、その目的（どれか）の制度に絞る（例: 「IT導入の支援を探して」→ ["IT・DX"]）。
    国・自治体の制度・新着で同じ分類を使う。絞った場合は purpose_note の注意を添えて報告する。
    

会社プロフィールを保存する（上書き）。以降のツールはこのプロフィールで判定する。

    必須の項目はない。わからない項目は省略する（判定では要確認として扱い、足りない情報として返す）。
    既存のプロフィールに足すときは get_company_profile の内容に足して保存する。
    search_keywords は事業内容から考えた2文字以上の短い語を5〜10個（例: ["設備投資", "IT導入", "DX", "販路開拓", "人材育成"]）。
    purposes は利用者の「やりたいこと」（Webのフォームで選ぶもの）。get_company_profile にあれば引き継ぐ。
    company_name・representative・address（番地まで）・corporate_number は申請書類への記入に使う（Webでは入力しない）。
    様式に欄が出てきたとき（inspect_form の profile_candidates で value が null）に利用者に聞いて足す。
    plan の order_status・planned_start・planned_end・vendor は、利用者が言ったときだけ入れる。
    言っていない発注状況を「未着手」などと推測で入れない（空のままにすると、判定が発注状況を要確認として返し、利用者に聞ける）。
    planned_start・planned_end は事業の開始・完了予定日で、発注日ではない。利用者が言った日付をそのまま入れ、推奨日程に置き換えない。
    利用者の確認を得てから保存する。「サーバーに保存しない」設定の利用者では保存せず、設定の手順を返すので、それを伝える。
    

公募要領の本文を検索し、ページ番号付きの抜粋を返す。concerns の項目の根拠確認に使う。

    query は空白区切りでOR検索（例: "補助対象経費 対象外経費"、"補助対象者"、"中小企業者"）。
    

Jグランツを1キーワードで生検索する（会社条件での判定はしない）。通常は recommend_subsidies を使う。

    prefecture を指定するとその都道府県対象の制度だけが返り、「全国」対象は含まれない（全国は prefecture="全国"）。
    purposes を渡すと国の利用目的の分類で絞る（設備投資と IT・DX、販路開拓と海外展開は区別されない）。
    

制度IDから開始・再開する。既定は既存の1件を再開。複数なら needs_selection の候補を利用者に示し case_id で選ぶ。 既存を残して空の原本から別下書きを作ると明示された場合だけ new_draft=true（case_id は原本のある案件）。記入値・PDF配置は継承しない。 曖昧なやり直しでは新規作成・削除をしない。forms の writable=true は inspect_form→fill_form で記入できる。 自治体は official_forms を示し、利用者が求めたら import_official_form で取り込む（.doc/.xls 等は upload_url）。 case_id=null は様式なし・取得失敗等。reason・next_steps に従い、同じ要求を繰り返さない。 preparation があれば公募要領の根拠ページを読む。writable=false（旧形式・暗号化や入力欄つきのPDF等）は original_url で原本を案内する。

補助金をウォッチリストから外す。

同じ記入内容を検査し、pass なら出力。fail は出力しない。 warning・unknown は指摘を利用者と確認した後だけ allow_warnings=true で出力する。 expected は validate_application と同じ。表の金額には元の値・行列見出しを渡す。 必須欄・補助額の正しさ・書式は検証しきれないので、提出前に実ファイルを確認する。 Excelを含む場合は export.note の開き直し・再計算後の表紙・集計値の確認手順を利用者に案内する。 passでも入力値からの検算とExcelで開いた表示確認は別であり、未確認の反映を確認済みと伝えない。 出力は個別URL。少数Wordはdocx直接添付を優先し、添付不可なら個別URLを案内する。 ZIPは利用者が希望した場合だけ include_zip=true。Word→確認用PDF変換は非対応。 PDF要求時はBot側の変換手段かWordのPDF保存を案内し、編集可能なWordも残す。

読み取り検査。expected で元の値・行列見出しと保存値を照合する（表の金額は必ず渡す）。 status は技術検査の fail・warning・unknown・pass で、提出準備完了ではない。completion と remaining_actions を報告する。 review は今回の回答待ち・本人確認・意図空欄・対象外の宣言（理由必須、保存しない）。clear の原本復元とは別。 入力規則・数式参照も検査するが、必須欄・補助額計算・様式間の意味的整合性は未検証。 指摘欄は inspect_form(targets=[欄ID]) で確認する。検査と出力をまとめるなら validate_and_export_application。

PDFの様式のページ画像。boxes=true で欄の枠（赤=未記入・緑=記入済み）と番号（f番号）を重ねる。 region=[left,top,right,bottom]（pt）で部分を拡大。grid=true で 50pt ごとの目盛り（位置を直すときに）。 記入後は boxes=false で提出物と同じ見た目を確かめる（検査はこの確認を記録で見る）。

補助金をウォッチリストに登録する（登録済みなら状態とメモを更新）。

    status: 未確認 / 検討中 / 申請予定 / 申請準備中 / 申請済 / 採択 / 不採択 / 辞退 / 実績報告中 / 完了。
    登録時点の締切・補助上限・補助率・対象地域を記録し、以後の変更を検知する。