jp_lit_search
Search Japanese literature databases across NDL, CiNii, J-STAGE, and more. Cross-search eight sources or specify a single source for targeted results.
Instructions
external read / local bookkeeping write（非破壊）。日本語文献ポータルを検索する。source 未指定で8ソース横断。cinii_dissertations / national_archives / jacar / nijl_articles / kokusho / ninjal_bibliography は既定横断に含めず、博士論文・学位論文、公文書・外交・軍事・旧外地資料、国文学論文、古典籍、日本語研究文献などで明示指定された場合のみ使う。ユーザーの言い回しから source を読み替える: 「NDL/国会図書館」→ndl_catalog、「デジコレ/NDLデジタル」→ndl_digital、「CiNii論文」→cinii_articles、「博士論文/学位論文/CiNii Dissertations」→cinii_dissertations、「CiNii図書/大学図書館」→cinii_books、「J-STAGE」→jstage_articles、「機関リポジトリ/IRDB」→irdb、「国会会議録」→kokkai_minutes、「帝国議会」→teikoku_minutes、「人文専門DB/nihu_bridge」→nihu_bridge、「Japan Search/ジャパンサーチ」→japan_search、「国立公文書館/特定歴史公文書/太政官/省庁資料」→national_archives、「JACAR/アジア歴史資料/外交/軍事/旧外地/植民地/朝鮮/台湾/関東州」→jacar、「国文学論文/国文研論文/日本文学研究論文」→nijl_articles、「国書/古典籍/写本/版本」→kokusho、「日本語研究/日本語教育文献/国語教育文献」→ninjal_bibliography。total / limit / page はこの 1 回の検索呼び出し単位の値であり、Skill が複数回検索して要約する場合は各回ごとに読む。source=cinii_books では filters.cinii.category に NDC/NDLC notation を半角スペース区切りで渡せる。CiNii 系の 0 件・ローマ字 query・広すぎる結果では interpretation / diagnostics を読む。source=ndl_digital の結果にはインターネット非公開（館内限定・図書館送信）資料のメタデータも含まれる。OCR 系ツールを使う前に jp_lit_get_record で source_metadata.next_digital_library.available を確認すること 外部sourceは変更しない。cache hitでもlocal session履歴を更新し、cache missまたはforce_refreshではlocal cacheを作成・置換する。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 検索結果ページ番号。1 始まり。 | |
| limit | No | 1 回の検索で返す最大件数。最大 100。未指定時は source ごとの既定値を使う。 | |
| query | Yes | 検索語。資料名、著者名、主題語、機関名などを指定する。 | |
| source | No | 検索対象 source。未指定なら既定の 8 source 横断検索になるが、新規テーマの初手では通常 ndl_search と japan_search などを明示指定する。 | |
| filters | No | source 固有の追加 filter。対象 source と一致しない filter は validation error になる。 | |
| sort_by | No | source が対応する場合の並び替え項目。未対応 source では無視されることがある。 | |
| issued_to | No | 刊行年・日付の上限。issued_from と組み合わせて範囲指定する。 | |
| sort_order | No | sort_by 指定時の昇順 asc / 降順 desc。 | |
| issued_from | No | 刊行年・日付の下限。年だけの '1900' など source が扱う文字列表現で指定する。 | |
| force_refresh | No | true の場合はローカル cache を使わず upstream API から再取得する。false の場合は保存済み cache を優先する。 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| cache | No | ||
| items | Yes | ||
| limit | Yes | ||
| query | Yes | ||
| total | Yes | ||
| facets | No | ||
| source | Yes | ||
| diagnostics | No | ||
| source_errors | No | ||
| interpretation | No |