pdf-spec の出力の読み方

pdf-spec-mcp の出力は大きく 仕様条文・要件・定義 の 3 種類に分かれます。このページは、その 3 つの JSON がどういう形で返り、どこを読み違えやすいかを説明します。引数と型の一覧はツールリファレンス（自動生成）へ。

どれも「規格が何と書いているか」の構造化であり、あなたのファイルについて何かを言うものではありません。

前提知識: ISO 規格の文書規約

NOTE は規範ではない・shall だけが適合の必要条件・定義は日常語を上書きする — といった ISO 共通の読み方を知らないと出力を誤読しやすいため、先に ISO 仕様書の読み方（入門） に目を通すことをお勧めします。

仕様条文（get_section の出力）

節の本文を、原文の見た目ではなく要素の列として返します。

// get_section({ section: "14.9.4" }) — 実測 pdf-spec-mcp v0.8.0
{
  "sectionNumber": "14.9.4",
  "title": "Replacement text",
  "pageRange": { "start": 815, "end": 816 },
  "boundary": { "start": "heading", "end": "heading" },   // 両端をどこで切ったか — 下で説明
  "content": [
    { "type": "heading",   "level": 3, "text": "14.9.4 Replacement text" },
    { "type": "paragraph", "text": "Replacement text may be specified for the following items:" },
    { "type": "list",      "items": ["• A structure element …", "• (PDF 1.5) A marked-content sequence …"] },
    { "type": "note",      "label": "NOTE 1",  "text": "Just as alternate descriptions can be provided …" },
    { "type": "paragraph", "text": "The ActualText value shall be used as a replacement, not a description, …" },
    { "type": "note",      "label": "NOTE 2",  "text": "The treatment of ActualText as a character replacement …" },
    { "type": "note",      "label": "EXAMPLE", "text": "This example shows the use of replacement text …" }
    // `table` / `code` 要素は、それを持つ節で現れる
  ]
}

heading.level は規格自身の節番号の深さ（14.9.4 なら 3）で、Markdown の見出しレベルではありません。

読み方のポイント: content は文書順です。NOTE / EXAMPLE は note 要素として本文（paragraph）と区別されます。 ISO では NOTE は参考情報であって規範的要求ではないため、根拠として引用するときはこの区別が必要になります。表は table 要素として構造のまま返るので、値の対応（キー・型・意味）を LLM が読み違えにくくなっています。

boundary は、内容をどこで切ったかを示します（v0.8.0）。サーバーは見出しが見つかればそこで切りますが、見つからないときはページの端で切るため、隣の節の文を含んだり、自分の末尾を欠いたりすることがあります。それは content や pageRange を見ても分かりません。

boundary.start	意味
heading	自節の見出しが見つかり、先頭ページのそれより前の文字を捨てた
page	見出しが見つからず、先頭ページの先頭から返している。前の節の末尾を含む可能性がある

boundary.end	意味
heading	次の節の見出しで切った
page	最終ページの末尾で終わり、次の節はそれより後のページから始まる
page_shared	次の節が最終ページで始まるが、その見出しが見つからなかった。次の節の文を含む可能性がある
next_page_unclaimed	次の節が翌ページで始まるが、その見出しが翌ページで見つからなかった。この節の末尾が翌ページにあっても含まれていない
document	文書の最後の節

heading / heading、heading / page、heading / document は見出しで切れた正確な範囲です。それ以外はページの端で切れているので、引用する前に隣の節も読んでください。コーパスでこれが起きるのは前付・後付（表紙・目次・正誤表・参考文献の項目）だけで、ISO 32000-1 と ISO 32000-2 の本文の節はすべて見出しで切れています。親節では start が親自身の値、end が最後の子孫の値です。get_tables にも同じ boundary と pageRange が付きます。totalTables: 0 は「そのページに Table 要素が無かった」という意味で、boundary がページ切りのときは「その節に表が無い」とは限りません。

表（get_tables の出力）

get_tables は節（とその下位節）の table 要素を headers / rows で返し、それぞれに規格が表の上に刷っている「Table N — 題名」の行を caption として付けます。引用するときに指すのはこの行なので、これが無い表は指しにくくなります。

// get_tables({ section: "Annex F", spec: "pdf17" }) — 実測 pdf-spec-mcp v0.9.0
{
  "section": "Annex F",
  "sectionTitle": "Linearized PDF",
  "pageRange": { "start": 683, "end": 702 },
  "boundary": { "start": "heading", "end": "page" },
  "totalTables": 12,
  "tables": [
    {
      "index": 0,
      "caption": "Table F.1 – Entries in the linearization parameter dictionary",
      "headers": ["Parameter", "Type", "Value"],
      "rows": [
        ["Linearized", "number", "(Required) A version identification for the linearized format."],
        // …
      ]
    },
    // … Table F.2 〜 Table F.12
  ]
}

Annex の表は Annex の英字で番号が付きます（Table F.5。ISO 32000-2 の Annex L / O は Table Annex O.3 と書きます）。v0.8.0 までサーバーは Table 182 の形の番号しか見ていなかったので、Annex の表はすべて caption: null になり、さらにヘッダ行が同じ表が続くと 1 つに連結されていました（ISO 32000-1 の Annex F は 12 表あるのに 7 表で返っていました）。v0.9.0 からはキャプションが付き、表は別々のまま返ります。それでも残る caption: null は、規格自体がキャプション無しで刷っている表です（Annex B の演算子一覧・正誤表のページ・8.7.4.5 のメッシュとパッチの図）。

要件（get_requirements の出力）

条文の中から shall / shall not / should / should not / may を含む規範文だけを抽出し、1 文 = 1 要件で返します。

// get_requirements({ section: "12.5.6.10" }) — 実測 pdf-spec-mcp v0.8.0
{
  "filter": { "section": "12.5.6.10", "level": "all" },
  "totalRequirements": 6,
  "statistics": { "shall": 6 },            // レベル別の件数。0 件のレベルはキー自体が出ない
  "sectionsCutByPage": [],                 // 対象範囲のうちページの端で切れた節（上の `boundary` を参照）。空ならすべて見出しで切れている
  "requirements": [
    {
      "id": "R-12.5.6.10-1",                // R-<節番号>-<連番>。引用・追跡用の安定 ID
      "level": "shall",                     // ISO/IEC Directives Part 2 準拠の 5 段階
      "text": "Text markup annotations shall appear as highlights, underlines, …",  // 原文そのまま（引用可能）
      "section": "12.5.6.10",
      "sectionTitle": "Text markup annotations"
    },
    {
      "id": "R-12.5.6.10-3",
      "level": "shall",
      "text": "(Required) The type of annotation that this dictionary describes;\nshall be Highlight, Underline, Squiggly, or StrikeOut …",
      "section": "12.5.6.10",
      "sectionTitle": "Text markup annotations",
      "source": "table",                    // 表由来の要件のみ付く。無ければ地の文由来
      "table": "Table 182 — Additional entries specific to text markup annotations",
      "key": "Subtype"                      // その表のどのエントリを縛る文か
    }
  ]
}

読み方のポイント: level の 5 段階は義務（shall）・禁止（shall not）・推奨（should）・非推奨（should not）・許容（may）で、shall だけが適合の必要条件です。text は原文のまま返るのでそのまま引用できます（改行は規格の組版由来です）。source: "table" 付きの要件は表のセルから持ち上げた文で、単独では意味が取れないため table / key（どの表のどのエントリを縛る要件か）が併記されます — 引用時はこの文脈ごと示してください。statistics は出現したレベルだけを数えるので、キーが無いのは 0 件であってエラーではありません。sectionsCutByPage は、対象範囲のうちページの端で切れた節を boundary 付きで列挙します。その節の要件は隣の節の文を含むか末尾を欠いている可能性があるので、引用する前に get_section でその節を確かめてください。

要件 ≠ 判定

要件は「規格の要求」であって、特定の PDF がそれを満たすかは別問題です。ファイルの検査は pdf-verify へ。また、抽出は ISO 32000-2 等のコーパス内に限られます — PDF/A の要件がここに出ないのは「存在しない」からではありません。

定義（get_definitions の出力）

規格の第 3 節（Terms and definitions）から用語定義を返します。

// get_definitions({ term: "glyph" }) — 実測 pdf-spec-mcp v0.6.0
{
  "totalDefinitions": 1,
  "searchTerm": "glyph",
  "definitions": [
    {
      "term": "glyph",
      "definition": "recognizable abstract graphic symbol that is independent of any specific design …",
      "section": "3.29",                      // 定義の節番号（引用用）
      "source": "ISO/IEC 9541-1:2012, 3.12"   // 規格自身が示す SOURCE 引用（ある項目のみ）
      // "notes": ["Note 1: to entry: …"]     // 定義に付随する注記（ある項目のみ）
    }
  ]
}

term を省くと Clause 3 が丸ごと返ります — **ISO 32000-2 では 71 件（3.1〜3.71）**です。

読み方のポイント: ISO の定義はその規格の中での用語の意味を確定させる規範的な文です。規格上の意味が日常語と違う用語（PDF processor 3.49・running text 3.59・object 3.44・deprecated 3.15 など）は、議論の前にここで確定させてください。source は他規格から借りた定義に規格自身が付けている SOURCE 引用で、答えが返ってきたコーパス文書のことではありません。notes は定義への補足（Note to entry）で、定義本文とは区別されます。

0 件は「Clause 3 に無い」という意味

PDF の語彙には Clause 3 ではなく本文側で定義されているものが少なくありません。artifact（§14.8.2.2）や annotation（§12.5）がそれで、get_definitions では 0 件になります。その場合は search_spec / get_section から入ってください。定義 0 件を「規格が定義していない」と読まないこと。

関連ページ

• pdf-spec-mcp — 責務と使いどころ
• ツールリファレンス — 全 8 ツールの引数・型・既定値
• ISO 仕様書の読み方（入門）