jp_lit_search_pages
Search inside Japanese digital library pages by keyword to retrieve page images and OCR text. Supports NDL, CiNii, and other academic databases.
Instructions
external read / local bookkeeping write（非破壊）。NDL デジタルコレクション資料内のページをキーワードで全文検索する（インターネット公開資料のみ）。source_id を使う場合は事前に jp_lit_get_record で next_digital_library.available=true を確認すること。全資料から候補 pid を探す段階では jp_lit_search_fulltext、特定ページの OCR テキストと画像 URL 確認は jp_lit_get_text_coordinates を使う。jp_lit_search_fulltext の結果の pid はそのまま渡してよい 外部sourceは変更しない。cache hitでもlocal session履歴を更新し、cache missまたはforce_refreshではlocal cacheを作成・置換する。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pid | No | 次世代デジタルライブラリーの pid。jp_lit_search_fulltext の結果から直接渡せる。 | |
| from | No | 検索結果の offset。0 始まり。 | |
| size | No | 返すページ一致の最大件数。最大 100。 | |
| source | Yes | 通常は ndl_digital。source_id を使う場合は jp_lit_get_record で OCR 利用可否を確認してから指定する。 | |
| keyword | Yes | 資料内 OCR テキストから探す語。 | |
| source_id | No | NDL デジタルコレクションの source_id。pid が分かる場合は pid を優先できる。 | |
| force_refresh | No | true の場合はローカル cache を使わず upstream API から再取得する。false の場合は保存済み cache を優先する。 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pid | Yes | ||
| raw | Yes | ||
| from | Yes | ||
| cache | No | ||
| items | No | ||
| total | Yes | ||
| keyword | Yes |