subsidy_ai_plugin

# 日本の補助金検索｜日本の公的支援情報をAIから使えるようにする

> 補助金を「知っている人だけが得をする仕組み」から、誰でも公正に調べ、判断できる仕組みへ。

本プロジェクトは、日本政府が公開している補助金情報と法人情報を、ChatGPTなどのAIから自然に利用できるようにするためのオープンソースプロジェクトです。

目指しているのは、単なる補助金検索ツールではありません。会社名と「これから実施したいこと」を伝えるだけで、法人を特定し、公的な企業情報を確認し、現在公開されている支援制度を探し、企業と制度の適合性を検討できる基盤を目指します。

> [!IMPORTANT]
> 本プロジェクトは開発中の民間プロジェクトであり、行政機関の公式サービスではありません。検索結果や評価は申請資格・採択・法令適合性を保証しません。

## 現在地

- Cloudflare Workersで動作するMCPサーバーと13のツールを実装済みです
- Jグランツ、経済産業省の法人情報データベース、EDINETの公開情報を扱います
- 自動テストでは、正常系だけでなく曖昧な企業名、情報不足、外部API障害、誤った断定の防止も検証します
- OpenAIの公開プラグイン審査に向けて、ポリシー、ツール注釈、再現可能な審査シナリオを整備しています

公開文書: [プライバシーポリシー](PRIVACY.md)・[利用規約](TERMS.md)・[セキュリティポリシー](SECURITY.md)・[コントリビューションガイド](CONTRIBUTING.md)・[行動規範](CODE_OF_CONDUCT.md)

## このプロジェクトが解決したい問題

日本には多くの補助金、助成金、公的支援制度があります。一方で、制度を利用したい企業や担当者は、次のような問題に直面しています。

- どの制度が存在するのか分からない
- 自社が対象になるのか判断しにくい
- 制度情報が複数のWebサイトに分散している
- 過去年度や受付終了後の情報が検索結果に混在している
- 出典が不明な解説や、不正確な情報を見分けにくい
- 公募要領が難しく、専門家に依存しなければ調査を始めにくい
- 制度を探したい開発・製造・営業担当者が、法人情報を毎回入力しなければならない

公的データはすでに公開されています。問題は、データが存在しないことではなく、一般の企業担当者が実際に使いやすい形になっていないことです。

本プロジェクトは、公的データをAIから扱える形につなぎ、情報格差を小さくすることを目的としています。

## 基本理念

### 公的情報を優先する

モデルが記憶している知識や出典不明のまとめ情報より、政府・自治体などが現在公開している情報を優先します。

### 事実と推測を分ける

APIや公募資料から確認できた事実と、AIによる整理・推論・適合度評価を明確に区別します。確認できない情報を推測で補わず、不足している項目は不足していると示します。

### 過度な期待を生まない

検索結果や適合度評価は、採択、受給資格、申請の適法性を保証するものではありません。最終判断では、必ず最新の公募要領と実施機関の案内を確認します。

### 不適切な補助金ビジネスへの依存を減らす

補助金申請の支援には専門知識が必要な場面があります。一方で、制度の複雑さや情報格差を利用し、対象外の制度を過度に勧めたり、採択可能性を不当に高く見せたり、不適切な申請を促したりする余地もあります。

本プロジェクトは、特定の職種や適正な専門サービスを否定するものではありません。「誰が言ったか」ではなく「公的情報で何が確認できるか」を判断の基準にし、企業自身が候補と根拠を検証できる環境をつくります。

### 誰でも同じスタートラインから探せるようにする

経営者や総務担当者だけでなく、開発、製造、営業、情報システム、新規事業など、実際に新しい取り組みを考えた人が、その場で支援制度の調査を始められることを重視します。

## 社会的ミッション

補助金は税金などの公的資源を原資としながら、制度を発見し、要件を読み解き、申請準備へ進むまでの情報コストには大きな差があります。本プロジェクトは、その差を小さくするための公共的なデジタル基盤を目指します。

私たちが増やしたいのは、申請件数そのものではありません。次の状態を増やすことが社会への貢献だと考えています。

- 小規模な事業者や地域企業も、公的情報へ同じ入口から到達できる
- 候補を勧めた理由と参照した出典を、利用者自身が検証できる
- 対象外や未確認の可能性を隠さず、無理な申請や過大な期待を減らす
- 専門家へ相談するとき、論点と必要資料が整理され、本来の専門判断に時間を使える
- API仕様変更や誤判定の知見をオープンソースへ還元し、同じ失敗の繰り返しを減らす

### 守る原則

- 特定の制度や支援事業者を、対価を理由に優先表示しません
- 採択可能性を断定したり、申請資格があるように誤認させたりしません
- 公開情報、利用者の申告、コードによる計算、AIの推論を区別します
- 必要以上の個人情報や企業の機密情報を求めません
- AIを最終決定者にせず、申請者、専門家、実施機関による確認につなげます
- 誤りを再現できるテストと変更履歴を残し、改善を公共の知見にします

## 目指す利用体験

例えば、利用者が次のように相談します。

> 株式会社○○で、製造ラインにAIカメラを導入したい。利用できそうな補助金はありますか？

システムは、最終的に次の流れを実現します。

```text
会社名と実施したい事業
        ↓
国税庁 法人番号システムWeb-API
法人候補・法人番号・正式名称・所在地を確認
        ↓
候補が複数の場合は利用者に確認
        ↓
gBizINFO
法人の公開情報・認定・過去の補助金情報などを取得
        ↓
Jグランツ
現在公開されている補助金候補を検索
        ↓
AI
一致する条件、未確認事項、公式情報へのリンクを整理
        ↓
利用者
最新の公募要領を確認して申請可否を判断
```

大量の入力フォームを最初に要求せず、公的情報から確認できない項目だけを追加で質問する体験を目指します。

## 利用する公的データ

### Jグランツ

補助金制度側の情報を取得します。

- 補助金候補の検索
- 対象地域や利用目的による絞り込み
- 受付状況と申請期間の確認
- 制度詳細と公式ページの取得

### 経済産業省の法人情報データベース（gBizINFO）

企業側の公開情報を取得します。

- 法人基本情報
- 所在地などの企業属性
- 認定情報
- 過去の補助金情報
- 調達情報などの法人活動情報

### EDINET

利用者から申告された親会社候補を、金融庁へ提出された有価証券報告書で検証します。

- EDINETコード一覧から親会社候補を特定
- 最新の有価証券報告書にある関係会社情報を確認
- 対象会社名、関係を示す文脈、比率表記、書類管理番号を根拠として返却
- 未検出の場合も「資本関係なし」と断定しない
- 補助金ごとの「みなし大企業」規定の確認を促す
- 対象会社の行に属する比率だけを抽出し、重要な根拠を最大2件に限定

EDINETを未知の親会社を自動発見するデータベースとしては使用しません。全国の企業関係データを複製・蓄積せず、利用者が示した候補について各省庁の最新版を照会する方針です。

### 国税庁 法人番号システムWeb-API

法人を正確に特定するための基礎情報を取得します。

- 会社名から法人候補を検索
- 法人番号、正式な商号・名称、本店所在地を確認
- 同名法人を所在地などで識別
- 名称・所在地の変更や法人状態を確認

法人名検索で複数候補が見つかった場合、システムが一社を推測で選ぶことはせず、候補を提示して利用者に確認します。

## 開発状況

本プロジェクトは開発中です。完成している機能と構想段階の機能を区別して公開します。

### 実装済み

- Cloudflare Workers上で動作するMCPサーバー
- Jグランツ公開情報を利用した補助金検索
- 補助金詳細の取得
- 受付中制度、対象地域、業種、利用目的などによる候補整理
- gBizINFO連携の基本実装
- 法人情報と補助金情報を用いた適合度評価の基本実装
- gBizINFOによる法人名・都道府県・市区町村検索
- 同名法人の候補提示と、曖昧な場合に自動決定しない制御
- 公開情報が不足する法人を利用者入力で補完し、項目ごとの出典と矛盾を表示
- 所在地の完全一致・包含関係・行政区域不一致を区別し、詳細住所の省略を矛盾扱いしない
- 法人状態が未提供の場合の断定防止と、法人検索の次ページ候補の可能性を表示
- 業種大分類コード、未登録記号、資格等級などの正規化
- gBizINFOの8種類の活動別APIから、認定、表彰、事業所、財務、特許、調達、補助金、職場情報を取得
- 法人検索の活動件数と専用APIの取得件数を比較し、未取得・部分障害を明示
- ChatGPT Workspaceでの限定配布と動作確認
- 利用者が申告した親会社候補をEDINETの有価証券報告書で検証
- EDINETで未検出の場合に、資本関係なしと誤って断定しない制御

### 検証中

- 複数の業種・規模・地域の法人を用いた実データ検証
- 利用者入力と公的データが矛盾した場合の対話設計

### 今後の予定

- 国税庁法人番号システムWeb-APIとの統合
- 法人の正式情報とgBizINFO情報の統合
- 国税庁データとgBizINFOの情報差分の明示
- 補助金情報の変更検知と定期通知
- ChatGPTのスケジュールやWorkを利用した継続的な案件管理
- 自治体独自制度、雇用関係助成金、公的融資、税制優遇などへの対象拡大

## MCPツール

現在のMCPサーバーでは、次のツールを中心に提供します。

| ツール | 役割 | 状況 |
|---|---|---|
| `search_subsidies` | Jグランツから補助金候補を検索する | 実装済み |
| `get_subsidy_detail` | 選択した補助金の詳細を取得する | 実装済み |
| `search_companies` | 経済産業省の法人情報データベースで会社名・所在地から法人候補を検索する | 実装済み |
| `get_company_profile` | 法人番号から同データベースの企業情報を取得する | 実装済み・実API検証済み |
| `get_company_activities` | 法人番号から同データベースの活動情報を取得し、種類別件数と取得状況を返す | 実装済み |
| `evaluate_subsidy_fit_for_company` | 公開法人情報と利用者の補完情報を基に一致点・不足・出典・矛盾を整理する | 実装済み・実API検証済み |
| `verify_corporate_relationship` | 利用者が申告した親会社候補をEDINET提出書類で検証し、みなし大企業規定の確認につなげる | 実装済み |
| `assess_deemed_large_enterprise_eligibility` | 制度別の公式要件と確認済み資本関係を照合し、みなし大企業の扱いを整理する | 実装済み |
| `prepare_professional_consultation` | 未確認論点を、専門家への質問・準備資料・相談期限を含む引き継ぎメモにする | 実装済み |
| `record_official_selection_statistics` | 公募回別の申請件数・採択件数を公的出典とともに保存し、比較可能な場合だけ公式採択率を計算する | 実装済み |
| `get_official_selection_statistics` | JグランツIDから過去の公式採択実績と出典を参照する | 実装済み |
| `estimate_program_selection_outlook` | 過去最大3回の公式実績から制度全体の参考範囲をルール算定する | 実装済み |
| `get_corporate_identity` | 法人番号から正式名称・所在地・法人状態を取得する | 計画中 |

ツールの返却結果は候補選定や確認作業を支援するものであり、採択や受給資格を保証しません。みなし大企業については、100%子会社という事実だけで全制度から除外せず、候補制度の最新の公募要領や公式FAQにある扱いと照合します。課税所得や役員兼務など、公開情報で確認できない事項は推定しません。

適合判定で未確認事項が残る場合は、単に「専門家へ相談してください」と案内するのではなく、相談理由、具体的な質問、準備資料、相談期限を含む専門家相談メモを返します。顧問の社会保険労務士などを一次相談窓口とし、雇用・賃金は社会保険労務士、決算・研究開発費・資本関係は税理士または公認会計士、制度固有の解釈は実施機関へ振り分けます。AIは可能性と論点を提示し、申請者と人間の専門家が最終判断と責任を担います。非公開資料の内容はMCPやD1へ保存しません。

## 構成

```text
ChatGPTなどのMCPクライアント
        ↓ Streamable HTTP
Cloudflare Workers上のMCPサーバー
        ├─ Jグランツ
        ├─ gBizINFO
        ├─ Cloudflare D1（Jグランツ公開情報のキャッシュ、任意）
        ├─ EDINET
        └─ 国税庁 法人番号システムWeb-API（計画中）
```

### 公開情報キャッシュ

専門家への相談に進む場合、`prepare_professional_consultation`は`readyToSendMessage`（件名・本文）と`nextAction`を返します。Web検索で確認した情報からも利用でき、制度名、参照URL、確認済み事項、未確認論点、準備資料、既知の期限を相談文に引き継ぎます。本文では対応可否、専門外の場合の紹介、必要資料の共有方法、初期相談の費用と進め方を尋ねます。任意の`company_name`と`public_business_summary`には公開情報のみを指定し、不明な値は省略します。既存の適合判定が返す`professionalConsultation`にも同じ相談文が含まれます。`presentationGuidance`に従い、検討・相談に進む場面でコピーできる文面を提示します。候補探索のたびに長文を表示する必要はなく、相談論点がない場合の文面は`null`です。相談文の保存・自動送信は行いません。

Jグランツの検索結果と補助金詳細は、Cloudflare D1へ読み取りキャッシュとして保存できます。`public_api_cache`には、正規化された公開補助金情報、取得日時、内容ハッシュ、通常の有効期限、および公式API障害時に限って使用できる失効猶予期限を保存します。

Jグランツ検索キャッシュには、検索対象となった会社名、法人番号、企業プロフィール、事業計画、会話履歴、利用者識別情報、企業ごとの評価結果を保存しません。ただし、EDINETで検証した公開企業情報と資本関係については、根拠文書とともに`companies`、`company_relations`、`edinet_documents`へ保存します。これはJグランツ検索キャッシュとは別の、公開情報に基づく証拠層です。

検索条件はキャッシュ本文へ保存せず、`CACHE_KEY_SECRET`を使ったHMAC-SHA256のキャッシュキーへ変換します。HMACは検索条件を暗号化するものではなく、元の条件を保存せずに同一条件のキャッシュを参照するための索引です。`CACHE_KEY_SECRET`が未設定の場合、検索結果のD1キャッシュは安全のため使用しません。補助金詳細は、公開されたJグランツ補助金ID単位でキャッシュします。

D1を有効にする場合は、`migrations/0002_public_api_cache.sql`を適用したデータベースを`PUBLIC_CACHE`としてWorkerへバインドしてください。既存の`subsidy_ai_relations`バインディングがある環境では、同じ公開情報用D1を利用できます。検索キャッシュには`CACHE_KEY_SECRET`をCloudflare Secretとして設定します。

D1またはキャッシュ用Secretが未設定の場合や、キャッシュの読み書きに失敗した場合でも、MCPはJグランツ公式APIから直接取得して動作します。期限切れキャッシュは通常時には使用せず、公式APIのタイムアウトや一時的な障害時に限り、古い情報であることを明示して失効猶予期限まで利用します。`content_hash`は取得内容の比較や将来の変更検知に使用するメタデータであり、現時点ではデータの真正性や改ざん防止を保証するものではありません。

### 採択実績エビデンス層

`migrations/0003_subsidy_research_schema.sql`を適用すると、公募回別の申請件数、採択件数、公式採択率、出典URL、取得日、内容ハッシュ、計算根拠をD1へ保存できます。公的資料の本文やPDF、企業情報、利用者情報は保存しません。同じ公募回・同じ対象範囲の申請件数と採択件数が揃う場合だけ公式採択率をコードで計算します。公開MCPからの誤情報混入を抑えるため、公的機関ドメインの公式HTML・テキスト・JSONをWorker自身が取得し、根拠文の一致を確認できた場合だけ保存します。PDFは現段階では自動照合せず、保存を停止します。

見通し機能は過去最大3回の公式実績の加重平均を基準に、公式に確認できた予算、補助上限、対象範囲の変化だけを限定的に補正します。これは制度全体の参考範囲であり、個別企業の採択確率ではありません。申請資格が未確定、条件付き、対象外可能性ありの場合は計算しません。

本プロジェクトは、特定のAI製品だけに閉じた実装ではなく、MCPに対応する他のクライアントからも利用できる構造を目指します。

## 開発環境

### 必要なもの

- Node.js
- npm
- Cloudflare Workers / Wrangler
- gBizINFO APIトークン（gBizINFO機能の実行時）
- EDINET APIキー（資本関係検証の実行時）
- 国税庁法人番号システムWeb-APIのアプリケーションID（統合後）

### セットアップ

```bash
npm install
npm run typecheck
```

利用可能な起動・テスト・デプロイ用コマンドは、`package.json` の `scripts` を確認してください。

### 秘密情報

APIトークンやアプリケーションIDは、ソースコードやGit履歴に保存しないでください。

- ローカル環境では、Git管理対象外の環境変数ファイルを使用する
- CloudflareではSecretsとして登録する
- ログ、エラーメッセージ、MCPレスポンスへ秘密情報を出力しない
- 漏えいが疑われる場合は、直ちに失効・再発行する

現在使用する環境変数は次のとおりです。

```text
GBIZINFO_API_TOKEN
CACHE_KEY_SECRET
EDINET_API_KEY
OPENAI_APPS_CHALLENGE_TOKEN
```

`OPENAI_APPS_CHALLENGE_TOKEN`は、OpenAI PlatformでMCPサーバーのドメイン所有を確認する際に表示された値を設定します。値はリポジトリへ保存せず、Cloudflare Secretとして登録してください。

```bash
npx wrangler secret put OPENAI_APPS_CHALLENGE_TOKEN
npm run deploy
```

デプロイ後、`https://<MCPサーバーのホスト>/.well-known/openai-apps-challenge`が検証トークンだけをプレーンテキストで返すことを確認してから、OpenAI Platformで検証を実行します。未設定時、このURLは404を返します。

国税庁法人番号システムWeb-APIとの統合時には、専用のアプリケーションID用環境変数を追加します。

## テスト方針

正常に結果が返ることだけでなく、誤った企業や制度を選ばないことを重視します。

- 受付中と受付終了の制度
- 全国対象制度と地域限定制度
- 大企業と中小企業
- 同名法人が複数存在するケース
- 公開情報が少ない法人
- 存在しない法人番号
- APIトークンの未設定・不正・失効
- 外部APIの停止、タイムアウト、仕様変更
- 条件を確認できない場合に断定しないこと
- 同名の親会社候補を自動決定しないこと
- EDINET提出書類で未検出でも、資本関係なしと断定しないこと
- EDINET APIキーをレスポンスやログに含めないこと
- Web検索など、プラグインを呼ぶべきでない依頼

## 正確性と免責事項

本プロジェクトは、デジタル庁、経済産業省、国税庁その他の行政機関が提供・認定・保証する公式サービスではありません。民間のオープンソースプロジェクトとして、公的機関が公開する情報を利用します。

補助金情報は変更される可能性があります。検索結果、企業情報、適合度評価、AIによる説明は参考情報であり、申請資格、採択、補助額、法令適合性などを保証しません。申請前に、必ず実施機関が公開する最新の公募要領、交付要綱、FAQなどを確認してください。

各データソースの利用条件、出典表示、非保証表示に従ってください。特に国税庁法人番号システムWeb-APIの利用時は、国税庁が指定する出典・非保証表示を実装します。

## なぜオープンソースなのか

政府が公開したデータは、特定の企業や専門家だけでなく、社会全体が検証・活用できるものであるべきだと考えています。そのデータをAIから利用するための接続方法、エラー処理、出典管理、適合度判定の基本思想も、可能な限り公開します。

本リポジトリは、単なるサンプルではなく、**日本の公的支援情報をAIから利用するためのリファレンス実装**となることを目指します。

自治体、企業、士業、研究機関、開発者など、立場を問わず利用・検証・改善に参加できる基盤を目指します。

## 運営とガバナンス

- ソースコードと変更履歴を公開します
- IssueとPull Requestを通じて改善提案を受け付けます
- 公的データの仕様変更に追随できるテストと記録を整備します
- 本番環境、API認証情報、リリース権限はプロジェクト運営者が管理します
- 事実、推論、未確認事項を区別する設計を守ります
- 外部組織との提携や公式性を、許諾なく示唆しません

コア実装を誰でも検証・利用できる状態にしつつ、公式ホスティング、企業向け運用、SLA、監査ログ、SSO、独自データ連携などは、将来的に別サービスとして提供する可能性があります。

### オープ