NextPDF Connect で構造的アクセシビリティをチェックする（Pro）

概要

NextPDF Connect で構造的アクセシビリティ解析を実行します。このツールは check_accessibility で、Pro ツールプロバイダーに対して再確認済みです。このプロバイダーは、プロトコル名 check_accessibility のもとで new CheckAccessibilityTool() を登録します。ツール自身の説明が対象範囲を定めています。つまり、PDF の構造的アクセシビリティ（見出し、表、画像、読み上げ順序の指標）を解析する ものです。指標と是正のヒントを提示します。PDF/UA や WCAG への適合性を証明するものでは ありません。その判定は適合性チェッカー（たとえば veraPDF や PDF/UA テストツール）が行うものであり、このツールが行うものではありません。check_accessibility は Pro ティアのツールです。 NextPDF は起動時に class_exists() でこのツールをプローブし、Pro パッケージがインストールされている場合にのみ登録します。

インストール

composer require nextpdf/server
composer require nextpdf/pro

トランスポートをバインドします。diagnostic.capabilities でツールを確認します。

概念の概要

アクセシブルな構造は、構造要素から成る論理構造ツリー（ISO 32000-2 §14.7）と、カタログの Lang エントリで設定する宣言済みの文書言語（ISO 32000-2 §14.9、PDF/UA-2 §8.4.4）という 2 つに支えられています。check_accessibility はこれらの構造的指標を検査し、それぞれに深刻度と是正ガイダンスを付けた所見レポートを返します。レポート内の数値スコアや pass/fail は 指標の要約であり、認証ではありません。トリアージのシグナルとして読んでください。

API サーフェス

ツール	ティア	役割	リスクティア
`create_pdf`, `add_text`	Core	検査対象のコンテンツを構築	Safe / Caution
`check_accessibility`	Pro	構造的アクセシビリティ解析	Safe
`output_pdf`	Core	PDF をレンダリングして返却	Approval Required / Review（base64）

ツール名はレジストリ上のプロトコル名です。ツールカタログが正式なカタログです。どのツールを利用できるかは、インストールされているティアに依存します。

コードサンプル — クイックスタート

create_pdf → add_text でコンテンツを追加します。
document_id を指定して check_accessibility を実行します。
所見を読み取ります。内容は、深刻度、指標、該当ページ、是正のヒントです。
レポートと併せて手動レビューを行う場合は、必要に応じて output_pdf（base64）を実行します。

コードサンプル — 本番

レポートは判定ではなく、トリアージへの入力として扱ってください。各所見を具体的な修正に対応づけます。たとえば、タグ付き出力を有効化する、文書言語を設定する、見出し構造を追加する、といった修正です。適合性ゲートでは外部チェッカーを実行し、このツールのスコアではなく、そのチェッカーの判定を信頼できる結果として扱ってください。チェックは destroy: true を指定した output_pdf より前に実行してください。そうしないと、文書を参照できません。

エッジケースと落とし穴

コンテンツなし。 空白の文書では、認証ではなくコンテンツなしの所見が返されます。
大きな文書。 解析はタイムアウトで制限されます。大きな入力は分割するか、範囲を指定してください。
破棄されたセッション。 出力でセッションが破棄される前にチェックを実行してください。
暗号化されたソース。 パスワードを指定してください。
Pro が存在しない。 Core のみの場合、check_accessibility は登録されません。

パフォーマンス

バジェット内のタイムアウトにより解析が制限されます。プロファイルは semantic です。レポートは構造解析の出力であるため、公正に比較するには、バイト出力ではなく所見を対象にします。

セキュリティに関する注意

レポートが記述するのは構造であり、コンテンツの機密情報ではありません。とはいえ、解析対象の文書自体は機密である可能性があるため、信頼境界の内側に保ってください。解析パスはファイルシステムに何も書き込みません。

適合性

記述	仕様	条項
論理構造は構造要素のツリーです。	ISO 32000-2	§14.7
文書言語は `Lang` エントリで宣言します。	ISO 32000-2	§14.9
アクセシブルなオーサリングでは自然言語の指定が必要です。	PDF/UA-2	§8.4.4

check_accessibility は、アクセシブルなオーサリングを 支援する 構造的指標を報告します。PDF/UA や WCAG への適合性を主張するものではありません。それを判定するのは独立したチェッカーです。

商用コンテキスト

check_accessibility は Pro ティアのツールであり、サーバー起動時に Pro パッケージが解決された場合にのみ登録されます。

PDF/UA-2 のマッピング

ツールが検査する構造的指標は、PDF/UA-2 のオーサリング要件に対応しています。具体的には、タグ付き構造ツリー（ISO 32000-2 §14.7）と、宣言済みの文書言語（PDF/UA-2 §8.4.4）です。ツールは、これらの指標が存在するか、または欠落しているかを報告します。PDF/UA-2 への適合性を判定するのは PDF/UA チェッカーであり、ツールのレポートではありません。

タグ → ISO 32000-2 §14 相互参照

見出しと表の所見は、ISO 32000-2 §14.7 の構造ツリー内にある論理構造要素に対応します。言語の所見は §14.9 の Lang エントリに対応します。ツールは、これらの構造アンカーの有無を提示します。§14 のすべてのタグ規則を検証するものではありません。それはチェッカーの役割です。

WCAG 2.2 のマッピング

コントラストと読み上げ順序の所見は、WCAG の達成基準（たとえばコントラストや意味のあるシーケンス）に関連します。ツールは、測定されたコントラスト比などの指標値を報告します。WCAG 適合性を主張するには完全な WCAG 評価が必要ですが、このツールはそれを実施せず、主張もしません。

トランスポートの利用可否

トランスポート	利用可否	備考
MCP（stdio）	対応（Pro）	レポートはツール結果です。
REST	対応（Pro）	レポートはレスポンスボディです。
gRPC	対応（Pro）	ユナリー。レポートはレスポンスメッセージ内。

HITL リスクティア

check_accessibility は Safe（読み取り専用の解析）であり、ゲートは行いません。ファイルへの output_pdf は Approval Required、base64 モードは Review です（HITL リスクティア）。

確認ゲートの JSON エンベロープ

解析はゲートを行いません。

{ "allowed": true }