Guide / Agents
AIエージェントに
日本の公的データを渡す方法
MCP、x402、OpenAPIの役割を分けて、最小構成を整理します。
3つのレイヤー
| レイヤー | 役割 | 当サービスの対応 |
|---|---|---|
| OpenAPI | APIの形をエージェントに伝える | /openapi.json |
| MCP | ツールとして直接呼ぶ | /mcp |
| x402 | 1コールごとに支払う | /.well-known/x402 |
MCPで使う
MCPクライアントから https://japan-data-api-x402.fly.dev/mcp に接続すると、企業検索・決算・補助金・入札・法令・リスクプロファイルをツールとして呼べます。
https://japan-data-api-x402.fly.dev/mcp認証は不要です。有料エンドポイントはx402の402応答を返します。
x402で支払う
x402対応クライアントは、402応答の accepts を見てUSDCを送金し、PAYMENT-SIGNATURE を付けて再送します。Base mainnetのUSDCに対応しています。
curl -i https://japan-data-api-x402.fly.dev/v1/companies/search?q=サンプル最小構成の例
- エージェントが
/openapi.jsonを読む - 必要なエンドポイントを選ぶ
- 402ならx402で支払う
- 200のJSONを次の推論に渡す
まずは無料の /v1/public/companies/:corporate_number/basic で接続確認するのがおすすめです。