Citation Dialogue

文献対話 · Citation Dialogue

Zotero で引用関係をたどって論文を見つけ、累積被引用数でまだ入手していない文献を探し、出典付きの研究ノートを Obsidian または Notion に保存して、Claude / Codex から同じグラフを操作できます。

Zotero 9.0.x · MIT オープンソース · ローカル MCP · 本プロジェクトの有料サブスクリプションは不要です。 macOS Zotero 9.0.6 で実機テスト済みです。その他の OS ではまだ実機検証していません。

インストーラーをダウンロード · 接続と共有ガイド · プライバシーに関する説明 · 問題を報告

インストールと起動

1. Releases から citation-dialogue-0.3.1.xpi をダウンロードします。
2. Zotero → ツール → プラグイン → 歯車 → プラグインをファイルからインストールを選択し、XPI を指定します。旧バージョンがある場合は、そのまま更新できます。
3. 論文を選択し、右クリック → 文献対話 · 選択した論文のノードグラフを選びます。コレクションを右クリックして、コレクション全体（サブコレクションを含む）を開くこともできます。
4. ノードをクリックして詳細を確認し、「引用している文献」と「引用されている文献」を展開します。ツールメニューからも開けます。

主な機能

• 20 種類の UI 言語：右上の 🌐 からすぐに切り替えられ、選択内容は保存されます。システム設定に合わせることもできます。簡体字中国語、繁体字中国語、英語、日本語、韓国語、ドイツ語、フランス語、スペイン語、ブラジルポルトガル語、イタリア語、オランダ語、ポーランド語、ロシア語、アラビア語、ヒンディー語、ベンガル語、インドネシア語、トルコ語、ベトナム語、タイ語に対応しています。アラビア語では右から左へのレイアウトを使用します。論文の内容は原文のままです。一部の低レベル診断メッセージは英語にフォールバックします。翻訳はまだネイティブスピーカーによる全面的な校正を受けていません。
• 被引用数を確認できます：既定ではノードのサイズが OpenAlex の累積被引用数を表し、読みやすさを保つため対数スケールで表示されます。詳細、ホバーヒント、候補リストには具体的な件数が表示されます。不明な値は「不明」のまま表示されます。現在のグラフ内の接続数に切り替えることもできます。
• まだ入手していない論文を探せます：右側の「未入手文献を探す」では、「ライブラリ外の論文」「ライブラリ内にローカル PDF がない論文」「両方」を選べます。累積被引用数、出版年、現在のグラフ内の接続数で並べ替えられます。重要な候補を確認してから、全文を入手するかどうかを決められます。プラグインが論文を自動でダウンロードまたはインポートすることはありません。
• 前向き・後ろ向きの引用を色分け：現在選択中の論文を中心として、青はその論文が引用している文献（後ろ向き）、オレンジはその論文を引用している論文（前向き）、紫は双方向の関係を表します。破線の枠はライブラリ外の論文を示します。矢印 A → B は常に A が B を引用していることを表します。
• ノートの保存先をプラグイン内で設定できます：「ノートと AI」をクリックし、Obsidian の保管庫を選択するか、Notion の親ページに接続してから、個別の論文またはグラフの要約を保存します。Obsidian では生成領域を更新し、手書きのノートを保持します。Notion では初回作成後に元のページを保持し、再保存時に上書きしたり、ページを重複作成したりしません。
• Claude / Codex から同じグラフを利用：ローカル AI 接続を有効にすると、グラフの表示、候補の読み取り、文献の展開ができます。AI によるノート書き込みを個別に許可すると、現在のグラフを出典として示す研究ドラフトを、設定済みの保存先に保存できます。
• ネイティブ形式でエクスポート：グラフデータをエクスポートすると Zotero の保存ダイアログが開き、ノードと引用関係を含む JSON を保存できます。PDF、キー、ノート、グラフ上の座標は含まれません。このバージョンでは JSON のインポート機能はありません。

AI に接続する

まず Zotero でグラフを開き、ノートと AI → ローカル AI 接続を有効にするをクリックします。

• Claude Desktop：付属のローカル .mcpb 拡張機能をダウンロードし、インストール時にプラグインに表示される mcp-connection.json ファイルを選択します。または、プラグイン内の「Claude の設定をコピー」を使用します。
• Codex：プラグイン内の「Codex の設定をコピー」を使用し、Codex の MCP 設定に追加します。ローカルに Node.js 20 以降が必要です。
• AI によるノートの書き込みは既定で無効です。AI にグラフの読み取りだけを許可できます。作業中は Zotero を起動したままにしておく必要があります。Web 版 Claude のリモートコネクターからローカルサービスに直接アクセスすることはできません。

AI には次のように指示できます。

現在のグラフから、まだライブラリに登録されておらず、被引用数の多い論文を 10 件見つけてください。実際に確認できた引用関係とあなたの解釈を区別し、DOI を保持してください。そのうち 3 件を選んで後続研究を展開し、出典付きの Obsidian 研究メモを作成してください。

詳しくは接続ガイドをご覧ください。各ユーザーは自身の Zotero で保存先を設定します。インストーラーは共有できますが、個人用の接続ファイル、トークン、Zotero の設定ディレクトリは共有しないでください。

データの範囲と解釈

これは必要に応じて拡張する部分ネットワークです。候補の並べ替え対象は現在読み込まれているノードのみであり、OpenAlex 全体を検索したり、Zotero の文献ライブラリ全体をスキャンしたりした結果ではありません。1 つのグラフにつき、シードは最大 200 件、ノードは最大 600 件です。既定では、最初の 12 件のシードについて、それぞれ少数の前向き・後ろ向き文献を取得します。手動または AI でさらに展開できます。

累積被引用数は OpenAlex から取得されるため、反映が遅れたり、欠落したり、統合に誤りがあったりする場合があります。累積的な注目度を示すものであり、論文の出版年や分野の影響も受けるため、論文の質を直接表すものではありません。引用関係は、支持、批判、理論の継承を意味するものではありません。こうした判断には原文を確認する必要があります。「ライブラリ内にローカル PDF がない」とは、現在のマシンでローカル PDF が見つからなかったことを示します。他のデバイスやクラウドにファイルがないとは限りません。

DOI を優先して照合します。タイトルによる代替照合では、正規化したタイトルと出版年の一致を要件とし、曖昧な一致は未解決のままにします。OpenAlex の応答は 24 時間キャッシュされます。「引用を更新」から再取得できます。プラグインが Zotero の書誌情報や添付ファイルを編集、インポート、削除することはありません。

開発と検証

Node.js 20+ とシステムの zip があれば動作し、プロジェクトの依存関係をインストールする必要はありません。

npm run check
npm test
npm run build

ビルドでは、Zotero XPI、Claude MCPB、実際のパッケージハッシュを含む Registry server.json、およびチェックサムファイルが生成されます。GitHub のバージョンタグをトリガーに、無料の公開リポジトリ CI が実行されます。テスト → Release → 公式 MCP Registry への登録まで行います（GitHub OIDC を使用し、個人用トークンをリポジトリに保存する必要はありません）。

テストでは、グラフの重複排除、引用方向、ページネーションとキャッシュ、ネイティブエクスポート、カウントと並べ替え、ノートの保持、Notion のリクエストと重複排除、ローカル認証、MCP stdio を対象としています。独立した Zotero テスト用ライブラリで行った 36 項目のチェックでは、すべての言語切り替え後にノードが保持されること、実際の OpenAlex データ、UI、Obsidian への書き込み、実際の MCP → Zotero 呼び出しを確認済みです。Notion は API 契約テストに合格していますが、ユーザーアカウントで実際に初回保存する必要があります。

概要（英語）

Citation Dialogue は、インタラクティブな OpenAlex 引用グラフを備えた Zotero 9 プラグインです。ノードのサイズはグローバルな被引用数を表します。ランキング付きの発見パネルでは、外部の論文と、ローカル PDF のないライブラリアイテムを区別できます。選択中の論文を基準に、被引用関係を異なる色で表示します。Obsidian / Notion への組み込み保存先と、ローカル認証済み stdio MCP ブリッジにより、Claude Desktop または Codex が同じアクティブなグラフを探索し、出典付きドラフトを保存できます。本プロジェクトではモデル API キーやホストされた中継サービスは必要ありません。外部サービスおよび AI クライアントには、それぞれ独自の利用上限と利用規約があります。

グラフは上限付きで、段階的に読み込まれます。被引用数は質を評価するスコアではなく、メタデータは全文を読んだ証拠ではありません。プライバシーに関する説明とセットアップガイドをご覧ください。

謝辞

Julian Schelb による MIT ライセンスの Citation Graph を基に、起動処理、リソースページ、タブ形式の表示、アイコンを開発し、元の作者のライセンスを保持しています。インタラクティブな UI、OpenAlex グラフモデル、発見ランキング、ノート連携、MCP は本プロジェクトで拡張したものです。D3 は ISC ライセンスに基づきパッケージに含まれています。LICENSE とサードパーティに関する通知をご覧ください。