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 検索・一般的な質問への説明。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 19.6 KB |
| heuristics/advisory-consultation.md | markdown | 8.7 KB |
| heuristics/clarifying-questions.md | markdown | 3.5 KB |
| heuristics/db-characteristics.md | markdown | 7.2 KB |
| heuristics/evidence-grading.md | markdown | 7.9 KB |
| heuristics/failure-modes.md | markdown | 13.7 KB |
| heuristics/query-expansion.md | markdown | 4.6 KB |
| heuristics/source-selection.md | markdown | 20.0 KB |
| reference/01-core-workflow.md | markdown | 10.9 KB |
| reference/02-source-and-query.md | markdown | 14.8 KB |
| reference/03-evidence-and-output.md | markdown | 29.6 KB |
| reference/04-ephemeral-web-discovery.md | markdown | 4.0 KB |
| reference/regional-public-library-research.md | markdown | 11.7 KB |
| scripts/plan-regional-library-search.mjs | script | 16.0 KB |
| workflows/bibliography-lookup.md | markdown | 5.7 KB |
| workflows/field-orientation.md | markdown | 8.3 KB |
| workflows/fulltext-page-lookup.md | markdown | 16.0 KB |
| workflows/historical-term-search.md | markdown | 4.8 KB |
| workflows/image-illustration-search.md | markdown | 3.9 KB |
| workflows/research-guide-lookup.md | markdown | 8.7 KB |
| workflows/topic-literature-review.md | markdown | 8.1 KB |
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)
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |