jp_lit_get_fulltext
Retrieve full-text OCR JSON from NDL Digital Collection for internet-public materials. Use pid from search results or source_id after verifying availability.
Instructions
external read / local bookkeeping write（非破壊）。NDL デジタルコレクション資料の全文 OCR JSON を取得する（インターネット公開資料のみ）。source_id を使う場合は事前に jp_lit_get_record で next_digital_library.available=true を確認すること。特定ページだけ確認する場合は jp_lit_get_text_coordinates、資料内検索でページを探す場合は jp_lit_search_pages を使う。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 の結果から直接渡せる。 | |
| source | Yes | 通常は ndl_digital。source_id を使う場合は jp_lit_get_record で 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 | ||
| cache | No | ||
| pages | No |