otwarteAPI.pl について
otwarteAPI.plは、人やAIエージェント向けの公式公共APIカタログです。40の管轄区域を対象とする機械可読なARDファイルに、例となるクエリや認証情報をまとめています。
主な機能
- 01機械可読なARDカタログ
- 0240の管轄区域を収録
- 03エンドポイントと認証情報
- 04自然言語のクエリ例
活用シーン
- 01公共機関のAPIを探す
- 02APIのエンドポイントや認証要件を確認
MCP 対応
AIエージェントがAPIを発見して呼び出すためのARDカタログを提供します。入力ではMCPサーバーとは説明されていません。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://otwarteapi.pl/mcpclaude mcp add --transport http bartosz-kuc-otwarteapi https://otwarteapi.pl/mcp{"mcpServers":{"bartosz-kuc-otwarteapi":{"type":"http","url":"https://otwarteapi.pl/mcp"}}}Cursor で開く{"servers":{"bartosz-kuc-otwarteapi":{"type":"http","url":"https://otwarteapi.pl/mcp"}}}VS Code で開く{"mcpServers":{"bartosz-kuc-otwarteapi":{"type":"http","url":"https://otwarteapi.pl/mcp"}}}{"mcpServers":{"bartosz-kuc-otwarteapi":{"serverUrl":"https://otwarteapi.pl/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
1| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| limit | integer | いいえ | 結果の最大数（1～92、デフォルトは 8）。 |
| temat | string | いいえ | 絞り込み用のタグ。例：「firmy」、「dane-statystyczne」、「bez-klucza」。任意。 |
| zasieg | string | いいえ | 絞り込み用の管轄区域コード。例：PL、EU、DE、GB、US。任意。 |
| zapytanie | string | いいえ | 自然言語によるクエリ（PL または EN）。例：「sprawdź VAT firmy w Estonii」または「company register Germany」。任意。 |
詳細
otwarteapi-catalog
otwarteAPI.pl を支える、公開カタログデータです。 世界各地（ポーランド、欧州連合、6大陸の国々、計40の管轄区域）の政府機関が提供する公開 API のカタログで、AI エージェントと人間が API を見つけて呼び出せるように記述されています。
これは何ですか
ARD（Agent Resource Directory） 形式の ai-catalog.json です。各 API の名前、説明、エンドポイント、必要なキー／認証、管轄区域（国コード、EU、または INT）、タグ、クエリ例を記述した、機械可読な単一ファイルです。同じファイルは、サイト上の otwarteapi.pl/.well-known/ai-catalog.json でも配信されています。
運営者
Bartosz Kuć（skanfirmy.pl と同じ作者）が運営する、非営利の個人プロジェクトです。連絡先：[email protected]。詳しくは otwarteapi.pl/o-projekcie をご覧ください。
これはミラーであり、正規の情報源ではありません
このリポジトリは、本番環境の状態を手動で更新しているコピーです。承認された PR と issue は、まずここで確認され、その後に、本番サイトへ実際にデータを供給しているプライベートリポジトリへ手動で移されます。どちらの方向にも自動同期はありません。
新しい API や修正を提案する方法
- 新しい API：issue を作成するか、
ai-catalog.jsonのentries[]にエントリーを追加する PR を開いてください。必須フィールドは、identifier（URN。例：urn:air:otwarteapi.pl:api:twoj-slug）、displayName、description、url（技術ドキュメント）、type、jurisdiction（PL／EU／国コード）、tags、metadata.auth（キー不要の場合はbrak）、およびrepresentativeQueries（自然な言葉による質問例を2～3件）です。API は公開されている公式のもの（政府、地方自治体、または国際的な公的機関が提供）であり、閲覧可能で有効なドキュメントが必要です。 - 既存エントリーの修正（変更されたエンドポイント、古い説明、誤った管轄区域など）：該当するエントリーを編集する PR を開き、PR の説明に簡潔な理由を記載してください。
- すべての PR は、正確性と API が実際に動作すること（有効な
curl／テスト）を手動でレビューしてから、本番環境のバージョンに反映されます。
ライセンス
MIT — LICENSE をご覧ください。API データ自体は、元の提供元（政府／EU 機関）の所有物であり、そのライセンスが適用されます。このファイルはデータをカタログ化し、公式ドキュメントへのリンクを掲載するだけです。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。