オンライン PDF 修復と「Recovery Toolbox」検索：PDF123 が実際にすること

PDF が開かないとき、検索結果は二つの異なる話を混ぜることが多い。壊れたファイルの構造を修復することと、ブランド化されたデスクトップの「リカバリ」ソフトだ。PDF Toolbox として公開している PDF123（pdf123.xyz）が提供するのは前者で、無料のオンラインツールと PDF 修復 API という形を取る。Recovery Toolbox for PDF という名前で売られている Windows 製品ではない。

壊れた PDF にとって「修復」とは何か

「ファイルが壊れています」と表示されたり、開くのを拒否されたりする PDF は、たいてい内部の地図（相互参照表やオブジェクトストリーム）が壊れている。手で描き直せるページ画像が欠けているわけではない。PDF の修復（POST /api/v1/misc/repair）は、まだ有効なバイトを使って qpdf でファイルを書き換え、その構造を組み直す。復旧が成功すれば、意図したページ内容を変えずにビューアが再び開けるようになる。

これは次のものとは違う。

• OCR／スキャンの整形 — ファイルは開くが、テキストが画像にしかなっていない場合（本サイトの OCR は Markdown を返し、隠しテキスト層は作らない）
• パスワード解除 — ファイルが暗号化されていて、パスワードをすでに知っている場合（パスワード解除）
• デスクトップのリカバリスイート — ローカルマシンでの深いフォレンジック復旧を狙ったインストール型アプリ
• 圧縮／変換 — まずパースできる PDF が必要になる、サイズと形式のツール

オンラインツールボックスとデスクトップの「Recovery Toolbox」検索

Recovery Toolbox for PDF との機能の同等性、価格、バージョンの詳細は主張しない。あれは別の製品だ。この表が明確にするのは経路と目的だけである。オンライン API による修復と、人が Google に打ち込んだかもしれないデスクトップのリカバリブランドの違いだ。

修復する前のプリフライト

情報取得 は JSON のプリフライトを返す（FileSize、PageCount、Encrypted、Info フィールド、バージョン）。パーサがファイルを読み込めるか、暗号化が他の編集を妨げているかを見るために使う。修復はパスワードを外さない。「ファイルが開かない」ための判断手順は ファイルが開かない：まず情報取得、次に修復、そして推測をやめる にある。

修復と OCR の使い分け

1. ビューアがファイルをまったく開けない → まず PDF の修復 を試す。
2. 開くがスキャン上でテキストを選択・検索できない → OCR／スキャンの整形 で Markdown テキストを得る。サイズが問題なら別途圧縮する（スキャン束のワークフロー）。
3. 同じ修復をスクリプトやエージェントから行う → 修復 API を呼ぶ。キーと OpenAPI は 開発者向け にある。再試行では Idempotency-Key を使う（Idempotency-Key）。

成功した状態とは

修復後は、十分なオブジェクトが残っていれば、ビューアは「壊れた PDF」エラーなしでファイルを開けるはずだ。情報取得 のページ数は、構造がきれいに復旧していれば原本から期待される数と一致する。それでも開かないなら、追加の圧縮／OCR／変換では欠けたバイトを生み出せない。手を止め、方針上必要ならカタログ外のフォレンジックツールのために原本を残す。

試す

PDF の修復 で壊れたファイルをアップロードするか、API Key を付けて POST /api/v1/misc/repair を呼ぶ。修復した派生物の隣に、壊れた原本を残しておく。エージェント向けのアクセス（MCP、pipeline、OpenAPI）は 開発者向け から始めるとよい。