OpenHeritage Public Search

OpenHeritage エージェントツール

OpenHeritage 用の、エージェント間で共通利用できる公開インテグレーションファイルです。OpenHeritage は、系譜と文化遺産を扱う共同プラットフォームです。

OpenHeritage は、ウクライナ最大の公開記念碑・墓地・アーカイブ文書データコレクションを集約しています。

このリポジトリでは、次の3つの方法を組み合わせて、互換性のある AI エージェントを OpenHeritage に接続します。

• 公開記録をリアルタイムで検索する、リモートの匿名読み取り専用 MCP サーバー。
• 専門分野のガイダンス、安全な REST フォールバック、標準的な OpenHeritage リンクを備えた、ポータブルな Agent Skills 7つ。
• スコープ付きベアラートークンを使って、ユーザーの承認を得た投稿を行うための、ドキュメント化された Personal API。

公開検索に API キーは不要です。

大規模なウクライナの遺産データ

• 記念碑と墓地： 記念碑のプロフィール、墓地、墓地の記録、墓地の写真、地図上の場所、書き起こしを見つけられます。
• アーカイブ文書： 保管機関や資料を検索し、ページ単位またはオリジナルファイルでデジタル化文書を取得できます。また、XML、書き起こし、解析、OCRを利用して、出典情報を添えて質問に回答できます。

これらの記録は標準的な OpenHeritage ページを通じて相互に結び付けられているため、エージェントは検索結果を証拠として扱うことなく、手がかりの発見から関連する墓地、記念碑、資料、文書へとたどれます。

MCP エンドポイント

https://openheritage.online/mcp

このエンドポイントは MCP Streamable HTTP を使用し、次の機能を提供します。

• search_records
• search_memorials
• search_cemeteries
• search_sources
• search_documents
• search_repositories
• search_places
• search_authors
• search_collections

MCP サーバーは、選定された公開資料、文書とファイル、保管機関、コレクション、標準的な場所、記念碑、墓地、および Source 分類タグに対する、匿名読み取り専用リソースも提供します。MCP は Personal API トークンを受け付けません。

プロジェクトまたはプラグインの MCP 設定に対応しているクライアントでは、ルートの .mcp.json を使用してください。

Personal API とインポート

Personal API は、ユーザーの承認を得た投稿に限って使用してください。

• インタラクティブリファレンス：https://openheritage.online/api-docs
• OpenAPI 3 ドキュメント：https://openheritage.online/api/openapi/v1.json

Personal API トークンはベアラートークンで、常に api:read が含まれます。カタログのみの汎用 Source インポートには api:sources を使用します。SourceDocuments、オリジナルファイル、ページ画像、または PAGE XML を追加する場合は、api:documents も使用します。デジタル表現が利用できない場合、Source は文書がなくても有効です。openheritage-source-import スキルでは、保管機関の参照、Authors、分類タグ、対象期間と場所、および任意の文書取り込みについて説明しています。

分類済みの新聞のインポートでは、正規の新聞組織オーソリティの作成または更新に api:authors、号の Source の作成と自動 Collection の設定に api:sources、号の文書作成と順序付きページ画像および PAGE XML のアップロードに api:documents も使用します。トークンは Authorization: Bearer ... ヘッダーでのみ送信し、MCP に渡したり URL に含めたりしないでください。

openheritage-newspaper-import スキルでは、号のワークフロー全体を説明しています。環境ごとに異なるUUIDを、安定した Source 分類コード record-kind-newspaper に対応付け、新聞組織の Author を作成または再利用し、出版年でグループ化された Author 駆動型 Collection を設定します。判明している場合は、所蔵保管機関と出版地を記録し、各号を publication として作成して、順序付きの文書ページと PAGE XML をアップロードします。単独の新聞切り抜き PhotoAssets は、引き続き openheritage-photos の対象です。

エージェントに OpenHeritage を追加する / エージェントに OpenHeritage を追加する

English

ライブの公開 OpenHeritage 検索には、MCP 接続を使用します。記念碑、墓、アーカイブ文書、歴史的写真、系譜調査に関する重点的なガイダンスをエージェントに提供したい場合は、スキルも追加してください。

Codex

codex mcp add openheritage --url https://openheritage.online/mcp
npx skills add OpenHeritageOnline/agent-tooling

Gemini CLI

gemini mcp add --scope user --transport http openheritage https://openheritage.online/mcp
gemini skills install https://github.com/OpenHeritageOnline/agent-tooling

Claude Code — MCP サーバーとスキルの両方を含む完全なプラグインをインストールします。

claude plugin marketplace add OpenHeritageOnline/agent-tooling
claude plugin install agent-tooling@openheritage

Claude Code でライブ検索のみが必要な場合は、代わりにこちらを使用します。

claude mcp add --transport http --scope user openheritage https://openheritage.online/mcp

インストール後、新しいチャットを開始してください。Claude Code のセッションを開いている場合は、プラグインのインストール後に /reload-plugins を実行します。設定を意図的に重複させたい場合を除き、Claude プラグインと個別の MCP エントリの両方をインストールしないでください。

Українською

ライブで公開 OpenHeritage の記録を検索できるように、MCP を接続します。記念碑、墓、アーカイブ文書、歴史的写真、系譜調査に関する特別なガイダンスをエージェントに提供したい場合は、スキルも追加してください。

Codex

codex mcp add openheritage --url https://openheritage.online/mcp
npx skills add OpenHeritageOnline/agent-tooling

Gemini CLI

gemini mcp add --scope user --transport http openheritage https://openheritage.online/mcp
gemini skills install https://github.com/OpenHeritageOnline/agent-tooling

Claude Code — MCP サーバーとスキルの両方を含む完全なプラグインをインストールします。

claude plugin marketplace add OpenHeritageOnline/agent-tooling
claude plugin install agent-tooling@openheritage

Claude Code で検索のみが必要な場合は、代わりにこちらを使用します。

claude mcp add --transport http --scope user openheritage https://openheritage.online/mcp

インストール後、新しいチャットを開始してください。すでに開いている Claude Code セッションにプラグインをインストールした場合は、/reload-plugins を実行します。設定を意図的に重複させたい場合を除き、Claude プラグインと個別の MCP エントリを同時にインストールしないでください。

Claude Code

公開 OpenHeritage マーケットプレイスを追加してから、完全なプラグインをインストールします。

claude plugin marketplace add OpenHeritageOnline/agent-tooling
claude plugin install agent-tooling@openheritage

MCP サーバーのみを接続します。

claude mcp add --transport http --scope user openheritage https://openheritage.online/mcp

チェックアウトから完全なプラグインを読み込むには、次のようにします。

claude --plugin-dir /path/to/agent-tooling

リポジトリには、.claude-plugin/plugin.json に Claude Code マニフェストが含まれています。

Codex and other Agent Skills clients

互換性のある Agent Skills インストーラーを使って、GitHub からポータブルスキルをインストールします。

npx skills add OpenHeritageOnline/agent-tooling

リポジトリには、.codex-plugin/plugin.json に Codex マニフェストも含まれています。プラグインに対応したホストは、リポジトリのチェックアウトを直接読み込み、バンドルされた .mcp.json を使用できます。

Agent Skills に対応するすべてのホストは、OpenHeritage Agent Skills index から公開済みの7つのスキルを検出することもできます。プラグインに対応していない MCP ホストでは、.mcp.json の openheritage エントリを、ユーザーまたはプロジェクトの MCP 設定に追加してください。

スキル

スキル	最適な用途
openheritage	公開 OpenHeritage ドメイン全体の幅広い検索
openheritage-archives	ソース、文書、リポジトリ、コレクション、ページ、ファイル、エントリ、エクスポート
openheritage-source-import	カタログのみのソース、およびリポジトリ、Author、タグ、日付、場所の来歴情報を付与した任意の SourceDocument 取り込み
openheritage-newspaper-import	新聞の号全体の準備、組織の Author、年ごとの自動コレクション、リポジトリと発行場所の来歴情報、順序付けされたページのアップロード、PAGE XML、検証、修復
openheritage-photos	歴史的写真、メディアのバリエーション、写真マップ、修正、写真に写っている人々
openheritage-memorials	記念碑、墓地、墓地の写真、地図、統計、エクスポート
openheritage-researches	公開系譜調査プロジェクト、質問、仮説、場所、証拠

同じバージョンのスキル文書は、OpenHeritage のウェブサイトからも公開されています。

• Agent Skills discovery index
• Umbrella OpenHeritage skill

MCP レジストリ

server.json は、公式 MCP レジストリにリモートサーバーを io.github.OpenHeritageOnline/public-search として公開します。GitHub Actions ワークフローは、mcp-v* タグがプッシュされたときに公開します。

git tag mcp-v2.11.3
git push origin mcp-v2.11.3

このワークフローでは GitHub OIDC を使用するため、保存済みトークンやドメイン検証用の秘密鍵は必要ありません。レジストリのバージョンは変更できないため、次のタグを作成する前に server.json のバージョンを上げてください。

公開は、保護されたリリース参照と mcp-registry-production GitHub Environment に制限されています。公開ツールは 特定のリリースからダウンロードされ、SHA256 と Sigstore ID を検証し、 OIDC を利用できるジョブが実行される前に、想定されるバージョンとソースコミットが 確認されます。リリースタグを作成する前に、 必須のリポジトリ管理設定を確認してください。

安全性

• 検索結果は、本人や家族関係を証明するものではなく、調査の手がかりとして扱ってください。
• 記録の公開範囲と著作権上の制限を尊重してください。
• クロール、一括列挙、プロフィールや連絡先データの収集は行わないでください。
• ユーザーと結果を共有する際は、正規の OpenHeritage ページを優先してください。
• ユーザーから明示的に依頼された場合に限り、認証が必要な REST ワークフローやデータを変更する REST ワークフローを使用してください。
• Personal API トークンを表示、保存、転送しないでください。許可された操作に必要なスコープのみを要求してください。

信頼できる情報源

本番環境のスキル文書は、OpenHeritage アプリケーションのメインリポジトリにある sources/FrontendServer/AgentSkills/ で管理されています。新しいバージョンをリリースする際は、skills/ 内のコピーをバイト単位で同期させてください。