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 検索・一般的な質問への説明。

reference/02-source-and-query.md

View on GitHub
# jp-lit-research source and query

## source 選択の要点

- 存在確認・初動調査(広域): `ndl_search`
- ポータル系・昭和館・地域資料・文化資源・雑誌目次の入口確認: `japan_search`
- 近代以降の図書・雑誌(詳細): `ndl_catalog` → `ndl_digital` → `cinii_books`
- 論文・紀要: `cinii_articles` → `jstage_articles` → `ndl_articles` → `irdb`
- デジコレ本文中の語を探す: `jp_lit_search_fulltext` → `jp_lit_search_pages`
- 国書DB収録本文中の語を探す: `jp_lit_search_kokusho_fulltext`
- デジコレ図版・挿絵: `jp_lit_search_illustrations` → `japan_search`
- 国書DBの画像タグ・古典籍図像タグ: `jp_lit_search_kokusho_image_tags`
- 所蔵確認: `ndl_catalog` → `cinii_books`
- 再録・改稿・最終版候補: `ndl_catalog` → `cinii_books` → `ndl_digital`
- 人文専門 DB 横断: `nihu_bridge`
- 日本文学論文: `nijl_articles`
- 古典籍・国書・写本・版本: `kokusho`
- 日本語研究・日本語教育文献・国語教育文献: `ninjal_bibliography`
- 研究データ: `jdcat`
- 会議録: `kokkai_minutes` / `teikoku_minutes`
- 調べ方・類似事例: `jp_lit_search_guides_manuals` / `jp_lit_search_guides_cases`
- 地方人物・地方紙・地方雑誌・郷土資料: 地域候補を優先づけ、カーリル MCP の `search_libraries` で地域名・館種・ネットワーク名を検索してから地域公共図書館 OPAC / `search_books`

考古学:

- 書誌: `遺跡名 + 発掘調査報告書`
- 地域: `自治体名 + 遺跡`
- 時代・遺構: `遺跡名 + 縄文 + 竪穴建物`
- 遺物: `地域名 + 土器 + 石器`
- 取得順: `irdb` → `jp_lit_get_record(source=irdb)` → `ndl_search` → 所蔵が必要なら `ndl_catalog`

## 実検索の初動原則

新規テーマでは、レファ協・NDL リサーチ・ナビを参考に調査計画を立ててから実検索へ進む。NDL リサーチ・ナビは API / MCP source ではなく Web 上の調べ方案内なので、Web 検索で `site:ndlsearch.ndl.go.jp/rnavi <固有名詞または主題語>` を試す。固有名詞 query が不発なら、そこで止めずに抽象度を上げた調べ方 query へ切り替える。

実検索では、原則として `source` 未指定の `jp_lit_search(query=...)` から始めない。`ndl_search` と `japan_search` を基礎候補にし、レファ協・リサーチ・ナビで示唆された source 候補と組み合わせ、初手は 2〜4 source に絞る。レファ協・NDL リサーチ・ナビ、またはドメイン判定で有効な DB / source が示唆された場合は、その source も初手に加える。

```text
既定セット:
- jp_lit_search(source=ndl_search, query=...)
- jp_lit_search(source=japan_search, query=...)

追加候補:
- jp_lit_search(source=<調査前情報収集で示唆された専門 DB / source>, query=...)
```

理由:

- `ndl_search` は NDL Search 参加機関を広く見る初動向き source
- `japan_search` は昭和館・地域/文化資源系・雑誌目次など、既定横断から漏れる入口を拾う
- リサーチ・ナビやレファ協が示す専門 DB は、当該分野では基礎候補より有効な入口になりうる。参考図書 / 索引が示唆された場合は、下の参考図書導線を追加する
- `source` 未指定の既定横断は `japan_search` と `ndl_search` を含まない

`source` 未指定のラウンドロビン検索は、8 source を同じ query で比較する強い理由があるときだけ使う。例: 文献系 source の同時スキャン、`nihu_bridge` を含む文献系ミックス検索、個別 source 分解前の補助確認。

人物名単独、回想記事、雑誌目次、一般誌、地域アーカイブ、昭和館、文化資源の可能性がある場合は、ラウンドロビンより先に `ndl_search` と `japan_search` を明示指定する。

### 参考図書・レファ本の導線

レファ協・NDL リサーチ・ナビで、参考図書・レファ本・事典・辞典・書誌・索引・年鑑が有効と示唆された場合は、基礎候補の `ndl_search` + `japan_search` を維持したうえで、次の順に進める。

```text
レファ協 / リサーチ・ナビ
  → jp_lit_search(source=ndl_reference_books, query=主題語)
  → source_metadata.reference_ndc / introduction / has_introduction で候補を選別
  → jp_lit_get_record または jp_lit_get_records で詳細確認
  → cinii_books / カーリル / 各館 OPAC で所蔵・閲覧条件を別確認
```

`ndl_reference_books` は既定横断外の明示指定 source である。候補一覧の `availability` や紹介文だけから本文、デジタル画像、所蔵、閲覧可否を推定しない。`sort_by`、`sort_order`、`issued_from`、`issued_to`、`filters.ndl` はこの source では未対応であり、紹介文がないレコードもある。参考図書紹介の候補探索であって、NDL オープンデータセットを runtime に一括取り込みする導線ではない。

地方人物・地方紙・地方雑誌・郷土資料が主題の場合は、`ndl_search` / `japan_search` / レファ協 / リサーチ・ナビで地域候補を作り、カーリル MCP の `search_libraries` で地域名・館種・ネットワーク名・専門資料機関名を検索して候補館の `systemid` を得てから、`search_books` / 地域公共図書館 OPAC へ進む。人名はまず出身地・居住地・活動地・郷土人物としての地域を割り、地域から図書館へ進める。県立図書館を基準点として外さない。優先する館は、該当都道府県立図書館、該当市区町村中央館、県内/広域の図書館ネットワーク、発行地・活動地に対応する中央館、郷土資料室・分館、隣接自治体や旧郡域の館、専門図書館・資料室。Web 検索はパスファインダー、新聞・雑誌所蔵一覧、郷土資料ページ、カーリルで見つからない文学館・記念館・資料館・資料室、閲覧条件の補助確認に使う。地方紙・地方雑誌は記事名ではなく媒体名・巻号で OPAC 所蔵を確認する。

## 調査前情報収集の query 抽象化

レファ協・NDL リサーチ・ナビでは、最初に主題固有の query を試す。リサーチ・ナビは Web 検索で探し、0 件または明らかに不発の場合は、人物名・作品名に固執せず、調査課題の型へ抽象化して再検索する。

例:

```text
永井荷風 関根歌 歯 抜歯
→ site:ndlsearch.ndl.go.jp/rnavi 永井荷風 関根歌 歯 抜歯
→ site:ndlsearch.ndl.go.jp/rnavi 作家 逸話 調べ方
→ site:ndlsearch.ndl.go.jp/rnavi 文学者 回想 逸話 資料
→ site:ndlsearch.ndl.go.jp/rnavi 近代文学 人物調査 年譜 索引
→ site:ndlsearch.ndl.go.jp/rnavi 雑誌記事 探し方 / 人物文献 伝記 探す
```

抽象 query で得た「この DB / 索引 / 参考図書が有効」という示唆は、実検索初手の追加 source や次の人間確認先に反映する。リサーチ・ナビで対応ページが見つからない場合も、試した Web 検索 query と不発理由を trace / 調査ログに残す。抽象 query が不発でも、実検索初手の既定セットは `ndl_search` + `japan_search` とする。

リサーチ・ナビの曖昧検索は、表記揺れ・誤字・脱字・類似表現の再確認に使える。ただし API / MCP source ではないため、`jp_lit_search` の source としては扱わない。使う場合は `https://ndlsearch.ndl.go.jp/rnavi/search?keyword=<URL encoded query>&isFuzzy=true` を調査ログまたは次アクションに残し、ページ内容を確認できた場合だけ調査順序や検索語候補へ反映する。

## researchmap 個人ページの扱い

researchmap は API tool 化しない。通常の文献検索ではまず CiNii / J-STAGE / IRDB / NDL / NIHU 系を使い、研究者名だけを入口にした探索は常用しない。

ただし、文献 DB 調査の途中で次の必要が出た場合は、ユーザー確認後の補助手段として Web 検索で researchmap 個人ページを確認してよい。

- 講演・口頭発表を探している
- 雑誌・一般媒体への寄稿を探している
- 書籍の分担執筆、編著、MISC が他 DB で拾いにくい
- 文献探索の途中で、特定の著者がそのテーマの重要人物らしいと分かった
- 特定研究者の活動履歴から、追加の検索語・イベント名・掲載媒体名を得たい

検索例:

```text
researchmap "研究者名" "口頭発表"
researchmap "研究者名" "書籍等出版物"
site:researchmap.jp "研究者名" "講演"
```

動線は「文献探索で候補を見る → 重要そうな著者名を拾う → researchmap 個人ページで講演・寄稿・書籍等出版物・MISC を確認する → そこで得たタイトル、会議名・イベント名、媒体名、共著者名、出版社名を使って CiNii / J-STAGE / IRDB / NDL / DOI / ISBN で再検索する」とする。

researchmap で見つけた項目は、文献確定ではなく追加探索の手がかりとして扱う。ページや業績一覧の更新日・最終更新状態も確認し、更新が古い場合は「最近の成果は未反映の可能性がある」と見なして他 DB や Web 検索を優先する。

## 検索語展開

最低限やること:

1. 表記ゆれを 2〜3 種追加
2. 旧字・異体字を確認
3. 関連する上位語・下位語を 1 つずつ加える

## 典拠・分類からの検索語展開

人名・団体名・件名・著作名・ジャンルが調査の鍵になる場合は、検索前または 0 件後に `jp_lit_resolve_authority` を使う。

- 人名・団体名:
  - `variant_terms` と `same_identity_terms` は検索語候補にしてよい。
  - 筆名・別名義は、名義別に探すか、まとめて探すかを報告で分ける。
- 件名:
  - `variant_terms` は検索語候補。
  - `reference_terms` は上位語・下位語・関連語を含むため、必要時のみ使う。
- 著作典拠:
  - 翻訳タイトル・別タイトルは `variant_terms` として試す。
- ジャンル:
  - 形式・ジャンルを探す語であり、主題としての検索とは分ける。

分類記号が分かる、または古い図書で件名が弱い場合は `jp_lit_find_authority_terms_by_classification` を使う。

- `NDC10` / `NDC9` / `NDC8` は現代以降の大まかな探索語候補作成に使う。
- 戦前・古い図書では `NDC6` も検討する。
- 分類から得た件名標目は「未知文献探索の入口」であり、正解リストではない。
- その後の実検索では、必要に応じて次へつなぐ。
  - `jp_lit_search(source=ndl_catalog, query=..., filters={ ndl: { subject, ndc } })`
  - `jp_lit_search(source=ndl_digital, query=..., filters={ ndl: { ndc } })`
  - `jp_lit_search_fulltext(keyword=..., f_ndc=...)`

件名語から未知の図書候補を広げる場合は、`jp_lit_suggest_classification_codes` で NDC / NDLC を取得し、返された `suggested_search.args.filters.cinii.category` を `jp_lit_search(source=cinii_books, ...)` に渡す。分類記号が既に分かっていて件名語を探す場合は `jp_lit_find_authority_terms_by_classification` を使う。分類記号は探索補助であり、候補の主題適合や所蔵は `jp_lit_get_record` と公式ページで確認する。

## 検索時の注意

- メタデータ検索が先。全文検索は後
- 並び替えや絞り込みの依頼は、まず `jp_lit_refine_results` で直近結果を再処理する
- `ndl_digital` で OCR 系へ進む前に `jp_lit_get_record` で `next_digital_library.available` を確認
- `jp_lit_search` は 1 回最大 100 件
- source 未指定の横断検索は `page=1` のみ対応。初手では原則使わず、強い理由がある場合に限る
- `nijl_articles` / `kokusho` / `ninjal_bibliography` は専門 DB の明示指定 source。既定横断には含めない
- `ndl_reference_books` は参考図書・レファ本・事典・辞典・書誌・索引・年鑑用の明示指定 source。候補一覧の所蔵・閲覧可否は detail と `cinii_books` / カーリル / 各館 OPAC で別確認する
- `kokusho` の書誌・所在は `jp_lit_search(source=kokusho)`、本文スニペットは `jp_lit_search_kokusho_fulltext`、画像タグは `jp_lit_search_kokusho_image_tags` に分ける
- 有料 DB、文化資源 DB、地域アーカイブ DB は固定 source 化せず、契約 DB は次の人間確認先、文化資源・地域アーカイブは `japan_search` / `nihu_bridge` / リサーチ・ナビ / レファ協の導線で扱う
- 結果報告には、可能なら `全N件中M件取得` を明記する
- `total` / `limit` / `page` は各ツール呼び出し単位の値であり、1 回の返答全体の件数ではない
- 1 回の返答の中で query や source を変えて複数回検索した場合は、その回数と各検索の役割を示す

`jp_lit_refine_results` の代表マッピング:

- 年代順: `sort_by="issued_at"` + `sort_order="asc"`
- 新しい順: `sort_by="issued_at"` + `sort_order="desc"`
- タイトル順: `sort_by="title"`
- 期間絞り込み: `filters.issued_from` / `filters.issued_to`
- 公開有無: `filters.online`, `filters.digital_collection`
- 文字列絞り込み: `filters.title_contains`, `filters.author_contains`

キャッシュ起点のショートカット:

- cache hit は保存済み結果の再利用であり、上流 API へは再検索していない。報告では `cache.saved_at` を添える
- 最新取得が必要なときだけ、対象 tool に `force_refresh=true` を指定する
- 今日の保存キャッシュ一覧: `jp_lit_list_cache(tool="jp_lit_search", saved_on="today")`
- 差分抽出: `jp_lit_refine_results(cache_keys=[A,B], combine="minus")`
- 共通集合抽出: `jp_lit_refine_results(cache_keys=[A,B,...], combine="intersection")`

## 検索後の分岐

- 0 件: 表記ゆれ、旧字、上位語、下位語を追加。source を変える
- 多すぎる: 年代、資料種別、主題で絞る
- 有力 1 件: `jp_lit_get_record` で詳細確認し、次 query を作る
- 初出論文や重要論文が見つかった:
  - 発行日を手がかりに、後年の研究書・論文集・著作集・全集への再録・改稿版を探す
  - `ndl_catalog` / `cinii_books` で著者名 + 論文タイトル、著者名 + 主題語を検索する
  - 目次・初出一覧・あとがき・版注記が見つからない場合は `要現物確認` とする
- `ndl_digital` で見つかった: OCR、ページ特定、図版検索へ進むか判断する

## 参照

- `01-core-workflow.md`
- `03-evidence-and-output.md`
- 旧詳細資料: `heuristics/source-selection.md`, `heuristics/query-expansion.md`, `heuristics/failure-modes.md`
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