jp_lit_search_fulltext
Need to locate specific terms within digitized Japanese texts? Search OCR full-text and metadata across NDL Digital Collections, then use returned pids to pinpoint pages.
Instructions
external read / local bookkeeping write（非破壊）。次世代デジタルライブラリー収録資料を対象に OCR 全文テキストからキーワード検索する。デジコレ本体の全文検索画面/APIではなく、デジコレ本体の「ログインなしで閲覧可能」資料全体も対象ではない。館内限定・送信サービス限定資料を含め、公式検索画面の全文ヒットは網羅しない。網羅性が必要な調査では、この結果だけで「デジコレ全文にヒットなし」と断定せず、公式画面でのブラウザ検索・手動確認を併用する。searchfield=contentonly で本文のみ、metaonly でメタデータのみ、all で両方を検索。結果には pid が含まれ、特定資料内のページ特定は jp_lit_search_pages、ページ画像と OCR 座標確認は jp_lit_get_text_coordinates で行う 外部sourceは変更しない。cache hitでもlocal session履歴を更新し、cache missまたはforce_refreshではlocal cacheを作成・置換する。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | 検索結果の offset。0 始まり。 | |
| size | No | 返す資料候補の最大件数。最大 100。 | |
| f_ndc | No | 次世代デジタルライブラリー Book API の f-ndc filter。上位分類は 9* のような前方一致で指定する。9 のような1-2桁の数字だけを渡した場合は 9* に正規化する。空文字・空白だけの値は未指定扱いにする。 | |
| keyword | Yes | NDL デジタルコレクション公開範囲の OCR / メタデータから探す語。 | |
| session_id | Yes | 調査案件を識別する application state handle。jp_lit_start_session が返した値を渡す。形式は YYYY-MM-DD-HHMMSS-8桁hex（旧形式 YYYY-MM-DD-HHMMSS も可）。MCP transport の接続IDや cache_key とは別物。 | |
| searchfield | No | 検索対象。contentonly は本文 OCR、metaonly はメタデータ、all は両方。 | contentonly |
| fc_is_classic | No | 古典籍フラグで絞る場合に指定する。 | |
| force_refresh | No | true の場合はローカル cache を使わず upstream API から再取得する。false の場合は保存済み cache を優先する。 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | Yes | ||
| from | Yes | ||
| cache | No | ||
| items | Yes | ||
| total | Yes | ||
| keyword | Yes | ||
| searchfield | Yes |