Skip to content

itarunnn/jp-lit-mcp / skills/jp-lit-research

jp-lit-research

Verified

日本語人文社会系文献調査スキル。jp-lit MCP サーバーを使って NDL・CiNii・J-STAGE・IRDB・JDCat・NIHU Bridge・国会会議録などを横断検索し、 書誌確認・所蔵調査・テーマ文献探索・古語表記ゆれ検索・デジコレ全文OCR・図版検索を行う。 「文献DBで調べて」「文献DBを始めます」など、文献DB という起動語を明示した文献調査依頼で使用する。 一度発火したらセッション中は継続して調査を進める。 SKIP: 「調べて」単体・API ドキュメント調査・Web 検索・一般的な質問への説明。

heuristics/source-selection.md

View on GitHub
# source 選択ルール

## 実検索の初動原則

レファ協・NDL リサーチ・ナビを参考に調査計画を立てた後、実検索の初動では、原則として `source` 未指定のラウンドロビン検索を使わない。`ndl_search` + `japan_search` を基礎候補にし、調査前情報収集で示唆された専門 DB / source と並べて計画する。NDL リサーチ・ナビは Web 検索で確認する調べ方案内であり、MCP source ではない。

レファ協・NDL リサーチ・ナビでは、最初の固有名詞 query が不発なら抽象度を上げる。リサーチ・ナビは `site:ndlsearch.ndl.go.jp/rnavi <固有名詞または主題語>` から始め、例: `作家 逸話 調べ方`、`文学者 回想 逸話 資料`、`近代文学 人物調査 年譜 索引` のように調査類型へ広げる。そこで示唆された DB / 参考図書 / 索引を、実検索初手の追加 source や次の確認先に反映する。

実検索に入るときは、次を既定セットにし、レファ協・リサーチ・ナビで示唆された source 候補を加える。レファ協・リサーチ・ナビで示唆された source 候補を加えて、初手の実検索 source を 2〜4 個に絞る。`ndl_search` / `japan_search` は専門 DB を押しのける固定順序ではない。

```text
既定セット:
- ndl_search    — NDL Search 参加機関を広く確認する
- japan_search  — 昭和館・地域/文化資源系・雑誌目次などの入口を確認する

追加候補:
- レファ協・リサーチ・ナビが示唆した専門 DB / source
- ドメイン判定で必要な個別 source
```

その後、見つかった媒体名・著者名・件名・巻号を使って `ndl_catalog` / `ndl_digital` / `ndl_articles` / `cinii_articles` / `cinii_books` などへ分解する。

`japan_search` は既定横断に含まれない。人物回想、雑誌目次、地域アーカイブ、昭和館、博物館・文化資源系の可能性がある調査では、必ず明示的に候補に入れる。
`ndl_search` / `japan_search` は新規テーマの初手に固定で含める。調査前情報収集で `nijl_articles`、`kokusho`、`ninjal_bibliography`、`nihu_bridge`、`irdb`、`jdcat`、`national_archives`、`jacar` などが強く示唆された場合は、既定セットに追加して初手計画に入れる。

## 横断検索の使い方

横断検索には **NDL モード(ndl_search)** と **ラウンドロビンモード(source 未指定)** の 2 つがある。ただし新規テーマの実検索初動は `ndl_search` + `japan_search` + 調査前情報収集で示唆された専門 DB / source とする。ラウンドロビンモードは補助的に使う。

### NDL モード: `jp_lit_search(source=ndl_search)`

NDL Search に参加する **100 機関以上**を 1 リクエストで横断する。存在確認・初動調査に向く。

カバー範囲(主なもの):
- NDL 系: `iss-ndl-opac`(蔵書) / `ndl-dl`(デジコレ) / `zassaku`(雑誌記事索引)
- `ciniir`(CiNii Research)/ `jstage`(J-STAGE)/ `irdb`(IRDB)
- 地方公共図書館・大学図書館デジタルアーカイブ(都道府県立・国立大学等)
- 青空文庫 / JPRO(出版情報)/ WARP / ADEAC など

**制約:**
- CiNii・J-STAGE・IRDB はハーベスト済みメタデータ → 著者詳細・所蔵・PDF リンクが欠ける
- `nihu_bridge`(NIHU 独自 API)はカバーしない
- getRecord 結果は NDL detail API に依存(CiNii / J-STAGE 固有フィールドは取れない)

**使う場面:** 「ざっと存在確認したい」「どのくらいあるか把握したい」「地方アーカイブ・青空文庫も含めて広く見たい」。新規テーマの既定セットとして使う。

### ラウンドロビンモード: `jp_lit_search`(source 未指定)

ネイティブ API を持つ文献系 source を並列呼び出し(ラウンドロビン)。著者情報・所蔵・PDF リンクなどが充実する。

対象:
```
ndl_catalog / ndl_digital / ndl_articles / ndl_articles_online
/ cinii_articles / cinii_books / jstage_articles / nihu_bridge
```

**使う場面:** 8 source を同じ query で比較する強い理由があるとき。例: 文献系 source 全体に同時に当てて重複候補を見たい、`nihu_bridge` を含む文献系ミックス検索を明示的に行いたい、source 別に分解する前の補助スキャンをしたい。

**避ける場面:** 新規テーマの初手、人物名だけの探索、回想記事・雑誌目次・地域アーカイブ・文化資源が疑われる探索。これらは `ndl_search` + `japan_search` を既定セットにし、調査前情報収集で示唆された専門 DB / source を追加して計画する。

---

以下は横断検索に含まれない(source 指定が必要):
- `japan_search` — ポータル系、昭和館・地域資料・文化財・美術に特化して使う
- `irdb` — 機関リポジトリ、論文調査で明示的に追加(NDL モードでも薄いメタデータで含まれる)
- `jdcat` — 研究データカタログ
- `kokkai_minutes` / `teikoku_minutes` — 会議録
- `national_archives` — 国立公文書館DA。官庁資料、内閣・太政官・省庁、特定歴史公文書
- `jacar` — JACAR。外交、軍事、旧外地、植民地、朝鮮・台湾・関東州、戦前期官吏/軍人/外交官関係資料
- `nijl_articles` — 国文学論文・国文研論文・日本文学研究論文
- `kokusho` — 国書・古典籍・写本・版本の書誌、著作、所在
- `ninjal_bibliography` — 日本語研究・日本語教育文献・国語教育文献

---

## テーマのドメイン判定と推奨 source

テーマのドメインを判定して使う source を決める。
判定結果は Step 5(検索方針提示)でユーザーに示すこと。

| ドメイン | 判定の手がかり | 積極的に使う source |
|---------|--------------|-------------------|
| 国文学・日本語学・歴史・民俗 | 固有名詞が古典的、時代名・地域名が含まれる | `nihu_bridge`(必須)+ `ndl_digital` + `nijl_articles`(国文学論文)+ `kokusho`(古典籍)+ `ninjal_bibliography`(日本語研究)+ `japan_search`(物質文化・地域資料が含まれる場合)|
| 社会科学・統計・調査データ | 「調査」「統計」「データ」「アンケート」 | `jdcat` を追加 |
| 理工系・医学系 | 英語混じり、数値・実験の記述 | `jstage_articles` を優先 |
| 紀要・学位論文・報告書 | 「修士論文」「紀要」「研究報告」 | `irdb` を優先 |
| 美術・文化財・地域資料・博物館資料 | 「作品」「文化財」「地域」「コレクション」「博物館」「民具」「浮世絵」 | `japan_search`(主力)+ `jp_lit_search_illustrations` + `nihu_bridge`(民俗補完)|
| 発掘調査報告書・遺跡・埋蔵文化財・出土遺物 | 遺跡名、調査次数、自治体教育委員会、報告書集番号、土器・石器・遺構名 | `irdb` + `ndl_search`。本文・公式公開導線は `irdb` detail、NDL所蔵だけを確かめる場合は `ndl_catalog` |
| 参考図書・レファ本・事典・辞典・書誌・索引・年鑑 | 主題語、人物名、時代・地域、資料種別 | レファ協 / リサーチ・ナビ → `ndl_reference_books` → `jp_lit_get_record(s)` → `cinii_books` / カーリル / 各館 OPAC。紹介文・参考NDCで選び、候補一覧だけで所蔵・閲覧可否を判定しない |
| 議会・法令・官庁資料 | 「法律」「答弁」「審議」「議会」 | `kokkai_minutes` / `teikoku_minutes`。官庁原資料・特定歴史公文書なら `national_archives` |
| 公文書・アジア歴史資料 | 「内閣」「太政官」「省庁」「公文書」「外交」「軍事」「旧外地」「植民地」「朝鮮」「台湾」「関東州」「外務省外交史料館」「防衛研究所」 | 国内官庁・特定歴史公文書は `national_archives`、近現代アジア・外交・軍事・旧外地は `jacar` |
| 人物回想・雑誌目次・一般誌記事 | 人名単独、回想、追想、雑誌名、昭和戦後一般誌、掲載号探索 | `ndl_search` + `japan_search` → `ndl_articles` / `ndl_catalog` / `cinii_books` |
| 地方人物・地方紙・地方雑誌・郷土資料 | 出身地、在住地、発行地、旧地名、県史・市町村史、郷土人物、地域紙、ミニコミ誌 | `ndl_search` + `japan_search` + レファ協 / リサーチ・ナビで地域候補を作り、地方公共図書館ルートへ進む |
| 全般(判定できない) | — | `ndl_search` + `japan_search` を既定セットにし、レファ協・リサーチ・ナビで示唆された source を加える |

発掘調査報告書では、次の query rule を使う。

- 最初は `irdb` で「遺跡名 + 報告書」「地域名 + 遺物名」を検索する。
- `summary` / `subjects` に遺物語が入る場合があるが、遺物種別の構造化 field ではない。
- `source_metadata.sitereports` があれば全国文化財総覧由来と確認できる。
- `ndl_search` は所蔵・IRDB・公共図書館由来の重複を含むので、件数を報告書実数として扱わない。

---

## 目的別 source 優先順位

### 図書・雑誌の所蔵確認

```
1. ndl_catalog   — NDL + 都道府県立・政令市立図書館
2. cinii_books   — 大学図書館(holdings に所蔵館リスト)
3. ndl_digital   — デジタル公開状況確認
```

### 雑誌論文・紀要

```
1. cinii_articles    — 人文社会系が充実
2. jstage_articles   — 理工系・医学系 + PDF直リンク
3. ndl_articles      — 古い記事・雑誌記事索引
4. nijl_articles     — 国文学論文・日本文学研究論文
5. ninjal_bibliography — 日本語研究・日本語教育文献・国語教育文献
6. irdb              — 機関リポジトリ(紀要・学位論文・報告書)
```

### 戦後以降の一般誌・新聞・論壇記事

```
1. ndl_articles / ndl_articles_online  — オープンに使える雑誌記事索引の入口
2. ndl_search / ndl_catalog            — 誌名・巻号・所蔵の手がかり
3. cinii_articles / irdb                — 学術論文・紀要側の周辺研究
4. kokkai_minutes                       — 政治・制度・事件名が絡む場合の補助
```

### 参考書誌・索引・有料DBでの追加確認

人文系調査は無料オンライン資料だけで完結しないことが多い。次に当てはまる場合、特にレファ協・NDL リサーチ・ナビが参考図書・専門索引・契約 DB を示唆している場合は、回答の `参考書誌・有料DBの次アクション` に `参考書誌確認` または `要有料DB確認` を積極的に残す。

- 週刊誌、月刊誌、総合雑誌、論壇誌、文芸誌、サブカルチャー誌、業界誌などの一般誌記事が主対象
- 新聞記事、広告、事件報道、人物インタビュー、書評欄、雑誌の特集記事を探している
- 戦後以降、特に 1950 年代以降の世論・受容・流行・メディア言説を追う調査
- NDL / CiNii / J-STAGE / IRDB では周辺情報しか出ず、一般誌・新聞側の欠落がありそう
- リサーチ・ナビやレファ協が、参考書誌、専門索引、年鑑、目録、事典、契約 DB、館内限定 DB を勧めている

候補は、調査内容に応じて参考書誌・専門索引・年鑑・目録・事典、または `ざっさくプラス`、`大宅壮一文庫`、新聞系 DB(朝日クロスサーチ、ヨミダス、毎索、日経テレコン等)を挙げる。MCP から直接接続できないものは、確定結果ではなく「人間が次に確認する場所」として扱う。

毎回の定型注意にはしない。ただしレファ協・リサーチ・ナビで示唆された場合、または参考書誌・索引・雑誌記事・新聞記事・戦後以降の一般言説が調査目的に効く場合は、確認先と検索語案を出す。無料オンラインで確認できた範囲と、未確認だが重要なオフライン/契約 DB 導線を分けて書く。

### 地方公共図書館ルート

地方人物、地方紙、地方雑誌、郷土資料、地域団体資料、市町村史、県史、地方行政資料が絡む場合は、地域資料サービスとして扱う。まず人物名だけでなく、地名、旧地名、出身地、在住地、活動地、発行地、媒体名、団体名を分けて地域候補を作る。

カーリル図書館MCPが使える環境では、まず `search_libraries` で地域名、館種、ネットワーク名、専門資料機関名を検索し、該当都道府県立図書館、市区町村中央館、県内/広域の図書館ネットワーク、発行地・活動地に対応する中央館、郷土資料室・分館、隣接自治体や旧郡域の館、専門図書館・資料室の `systemid` を確認する。人名はまず出身地・居住地・活動地・郷土人物としての地域を割り、地域から図書館へ進める。Web 検索は、カーリルで見つからない文学館・記念館・資料館・資料室、地域パスファインダー、新聞・雑誌所蔵一覧、郷土資料ページ、閲覧条件の補助確認に使う。その後 `search_books` へ進む。カーリル図書館MCPの `search_books` は最大15館までなので、全国総当たりではなく、地域推定後に候補館を優先づけて使う。Cursor / Claude Code / Codex ではユーザーがカーリル図書館MCPを登録し初回 OAuth 認可済みなら同一エージェントから実行できる。接続できない場合は MCP / OAuth 設定を直し、必要に応じて各館 OPAC、新聞・雑誌所蔵一覧、図書館レファレンス相談を次アクションに残す。

REST API は ISBN 既知の所蔵確認に限る。人物名・地名・地方紙名・地方雑誌名から資料を発見するキーワード蔵書検索には使わない。カーリル MCP が使えない場合は、地域パスファインダー、各館 OPAC、新聞所蔵一覧、レファレンス相談を次アクションに残す。

詳細は `reference/regional-public-library-research.md` を参照する。

### デジタル化一次資料・古典籍

```
1. ndl_digital               — 主力
2. kokusho                   — 国書・古典籍・写本・版本の同定
3. jp_lit_search_fulltext    — デジコレ OCR 全文横断
4. jp_lit_search_kokusho_fulltext — 国書DB収録本文スニペット
5. jp_lit_search_kokusho_image_tags — 国書DB画像タグ
6. nihu_bridge               — 人文学専門 DB(国文研・国民博・etc.)
```

### 専門 DB の自然言語読み替え

- 国文学論文、国文研論文、日本文学研究論文: `nijl_articles`
- 国書・古典籍、写本・版本: `kokusho`
- 国書DBで本文検索、古典籍本文中の語: `jp_lit_search_kokusho_fulltext`
- 国書DBの画像タグ、古典籍の挿絵タグ、図像タグ: `jp_lit_search_kokusho_image_tags`
- 日本語研究・日本語教育文献・国語教育文献: `ninjal_bibliography`

これらはすべて既定横断外。ユーザーの依頼文が上の語を含む場合だけ、追加 source として明示指定する。

有料 DB、文化資源 DB、地域アーカイブ DB は固定 source 化しない。契約 DB は `要有料DB確認`、文化資源・地域アーカイブは `japan_search` / `nihu_bridge` / リサーチ・ナビ / レファ協で入口を作る。

### 人文学専門調査

```
nihu_bridge  — NIHU 7機関 100+ DB
  → normalize=true(デフォルト)で異体字同定
  → filters.nihu_bridge.institute で機関絞り込み可
```

### 研究データ・統計・アンケート

```
jdcat  — 人文学・社会科学総合データカタログ
  → availability.online=true が配布元 URI あり(公開保証ではない)
```

### 会議録・議会資料

```
kokkai_minutes   — 第1回国会〜現在(speech 単位で検索)
teikoku_minutes  — 第1〜90回帝国議会(1890〜1947年)
```

### 公文書・アジア歴史資料

```
national_archives — 国立公文書館DA。官庁資料・内閣・太政官・省庁・特定歴史公文書・国立公文書館所蔵資料
jacar             — JACAR。外交・軍事・旧外地・植民地・朝鮮・台湾・関東州・外務省外交史料館・防衛研究所・戦前期官吏/軍人/外交官
```

リサーチ・ナビ/レファ協が国立公文書館DAまたはJACARを推奨している場合も、追加 source 候補にする。どちらも通常の文献探索の主力ではなく下位導線。画像本体・IIIF・OCR は取得せず、公式レコード URL と目録メタデータで同定する。

---

## source 別の制約

| source | 制約 |
|--------|------|
| `ndl_articles_online` | 検索のみ、getRecord は常に null |
| `ndl_search` | NDL モード。CiNii/J-STAGE はハーベスト済みで情報が薄い。nihu_bridge はカバーしない |
| `jstage_articles` | sort 未対応、summary 常に null |
| `irdb` | limit は 20/50/100 のみ有効(adapter が補正)|
| `jdcat` | detail は JSON API、availability.online は公開保証ではない |
| `nihu_bridge` | sort 未対応 |
| `nijl_articles` | 既定横断外。HTML best-effort。本文・PDF・OPAC 詳細追跡は対象外 |
| `kokusho` | 既定横断外。manifest URL は保持するが、manifest 本体・画像・本文一括取得は対象外 |
| `ninjal_bibliography` | 既定横断外。本文リンク URL は保持するが、本文 PDF・外部本文は対象外 |
| `ndl_reference_books` | 既定横断外。sort / 期間 / `filters.ndl` は未対応。`reference_ndc` と紹介文で候補を選ぶが、紹介文なしのレコードもある。所蔵・閲覧可否は detail 後に別確認 |
| `national_archives` | 既定横断外。画像本体・IIIF・OCR・contentDownload は対象外。403 は VPN・ネットワーク制限の可能性 |
| `jacar` | 既定横断外。画像本体・IIIF・OCR・aj/contentDownload は対象外。403 は VPN・ネットワーク制限の可能性 |

---

## 複数調査線の分担例

独立した調査線が 2 本以上あり、source、時代、表記群、媒体、地域、言語などで担当範囲を分けられる場合は、サブエージェント分担または sequential 担当単位を検討する。

分担例:

- `戦前デジコレ OCR 担当`: 旧字・旧仮名・カナ表記ゆれを単独語で検索し、OCR ヒット、ページ、画像確認の状態を整理する
- `J-STAGE / CiNii 現代研究担当`: 現代研究、書評、引用、PDF / DOI の有無を確認する
- `館内確認・雑誌号所蔵担当`: 巻号、所蔵館、閲覧条件、複写可否を整理する
- `表記ゆれ・ノイズ語調査担当`: 有効な表記群、ノイズ語、除外理由を整理する

片方の結果を見ないともう片方の検索語が決まらない場合は、先に依存する調査線を主エージェントが処理する。主エージェントが統合判断を持ち続ける。

---

## source 組み合わせパターン

### 「本文が読みたい」

```
ndl_digital(メタ) → available=true → jp_lit_search_fulltext / jp_lit_search_pages
kokusho(書誌) → 国書DB収録本文の語なら jp_lit_search_kokusho_fulltext
```

### 「論文を網羅したい」

```
cinii_articles + jstage_articles + ndl_articles + nijl_articles + ninjal_bibliography + irdb
```

### 「古い語で探したい」

```
ndl_digital + jp_lit_search_fulltext + nihu_bridge(normalize=true)
```

### 「画像・図版を探したい」

```
jp_lit_search_illustrations → japan_search(美術・文化財)
国書DBの古典籍画像タグなら jp_lit_search_kokusho_image_tags
```

### 「文献と現物(美術品・文化財)の両方を調べたい」

```
cinii_articles / ndl_catalog(文献)
+ japan_search(現物・資料)
+ nihu_bridge(民俗・考古の専門 DB)
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall