Coded Chords - PDF

スキャンPDFの処理を自動化するClaude Codeプラグインを作った

2026-01-02T00:00:00+00:00

はじめに</h2>
書籍をスキャナーで読み取ってPDF化すると、複数のファイルに分かれてしまったり、テキスト検索ができなかったりします。また、目次がないため、そのままでは使いにくい状態になります。これらを手作業で処理するのは非常に面倒です。</p>
そこで、スキャンしたPDFの処理を自動化するClaude Codeプラグイン「pdf-processor」を開発しました。このプラグインを使えば、複数のPDFファイルのマージ、OCR処理、目次の追加を簡単に実行でます。</p>
プラグインのソースコードはGitHub</a>で公開しています。</p>

pdf-processorプラグインの機能</h2>
このプラグインは、スキャンされたPDFファイルを実用的なデジタル書籍に変換するためのツールです。主な機能は以下の通りです。</p>

複数PDFファイルのマージ</strong>: バラバラのPDFファイルを1つに統合</li>
OCR処理</strong>: 日本語に対応したOCR処理により、画像PDFをテキスト検索可能に変換</li>
ファイルサイズ最適化</strong>: 画像の圧縮により、ファイルサイズを削減</li>
目次（ブックマーク）の追加</strong>: PDFビューアで使える目次を自動生成</li>
メタデータ編集</strong>: PDFのタイトル、著者などのメタデータを設定</li> </ul>
使い方</h2>
pdf-processorプラグインは、3つのステップで処理を行います。</p>
ステップ1: 前処理の実行</h3>
まず、`/pdf-processor:preprocess</code> コマンドを実行して、複数のPDFファイルをマージし、OCR処理を行います。</p>`
`/pdf-processor:preprocess</span></span></code></pre> Claudeが以下の処理を自動で実行します。</p>`対象となるPDFファイルの確認</li> PDFのマージ</li> OCR処理の実行</li> 画像の最適化</li> 目次テンプレートファイルの生成</li> </ul> 処理が完了すると、OCR処理済みのPDFファイルと、メタデータをダンプしたファイルが生成されます。</p> ステップ2: 目次情報の編集</h3> ダンプされたメタデータファイルをエディタで開き、目次情報を追加します。目次は以下の形式で記述します。</p> 各目次項目は BookmarkBegin</code> で始まり、以下の3つのフィールドで構成されます。</p> BookmarkTitle</code>: 目次のタイトル（章名など）</li> BookmarkLevel</code>: 目次の階層レベル（1が最上位、2が第2階層）</li> BookmarkPageNumber</code>: 目次項目が指すページ番号</li> </ul> 例として、以下のように追加します。</p> BookmarkBegin</span></span> BookmarkTitle: 第1章はじめに</span></span> BookmarkLevel: 1</span></span> BookmarkPageNumber: 1</span></span> </span> BookmarkBegin</span></span> BookmarkTitle: 1.1 背景</span></span> BookmarkLevel: 2</span></span> BookmarkPageNumber: 2</span></span> </span> BookmarkBegin</span></span> BookmarkTitle: 1.2 目的</span></span> BookmarkLevel: 2</span></span> BookmarkPageNumber: 5</span></span> </span> BookmarkBegin</span></span> BookmarkTitle: 第2章実装</span></span> BookmarkLevel: 1</span></span> BookmarkPageNumber: 10</span></span></code></pre>ステップ3: 目次の適用</h3> 目次情報を編集したら、/pdf-processor:apply-toc</code> コマンドを実行して、最終的なPDFファイルを生成します。</p> /pdf-processor:apply-toc</span></span></code></pre> このコマンドを実行すると、OCR処理済みのPDFに目次が追加され、完成版のPDFファイルが作成されます。</p> 技術的な詳細</h2> pdf-processorプラグインは、以下のツールを組み合わせて実装しています。</p> OCRmyPDF</strong>: PythonベースのOCRツールで、Tesseract OCRエンジンを使用してPDFにテキストレイヤーを追加</li> PDFtk</strong>: PDFの操作に特化したコマンドラインツールで、マージやメタデータの編集に使用</li> Ghostscript</strong>: PDFの最適化と圧縮に使用</li> </ul> これらのツールのインストールや設定は、プラグインのREADMEに詳しく記載されています。</p> まとめ</h2> pdf-processorプラグインを使うことで、スキャンしたPDFの処理を大幅に効率化できます。複数ファイルのマージ、OCR処理、目次の追加といった面倒な作業を、Claude Codeとの対話だけで完了できるようになりました。</p> スキャンした書籍や資料をデジタル化する際に、ぜひ活用してみてください。プラグインのソースコードはGitHub</a>で公開しているので、カスタマイズや改善の提案も歓迎します。</p>



How to Merge and Optimize Your PDF Files
2025-01-10T00:00:00+00:00
Bypassing PDF Password Protection</h2>
While the DJI Neo user manual is provided in PDF format, it's password-protected, preventing any modifications or merging. Here's how to bypass the password protection on a Mac:</p>

Open the PDF in the Preview app</li>
Select "Print" from the File menu (note: not "Export")</li>
Choose "Save as PDF" and specify the destination</li>
</ol>
This process will create a new PDF without password protection.</p>
Merging PDFs</h2>
While this can be done with Ghostscript</code> (mentioned later), we'll use pdftk</code> for its advantages:</p>

Preserves PDF internal structure (table of contents, bookmarks, links, etc.)</li>
Operates at the binary level, preventing quality degradation</li>
(Although not relevant for this case) Offers flexible operations like page rotation and reordering</li>
</ul>
Here's how to merge PDFs:</p>
# Install pdftk (on Mac)</span></span>
brew</span> install pdftk-java</span></span>
</span>
</span>
# Merge PDFs</span></span>
pdftk</span> input1.pdf input2.pdf cat output merged.pdf</span></span></code></pre>PDF Optimization</h2>
After merging, I found that the file size exceeded 40MB, which was too large to upload to MLIT's DIPS2.0 (Drone/UAS Information Platform System).</p>
To resolve this, I used Ghostscript for optimization:</p>
# Install Ghostscript (on Mac)</span></span>
brew</span> install ghostscript</span></span>
</span>
</span>
# Optimize PDF</span></span>
gs</span> -sDEVICE=pdfwrite -dCompatibilityLevel=1.4 -dPDFSETTINGS=/screen -dNOPAUSE -dQUIET -dBATCH -sOutputFile=output.pdf input.pdf</span></span></code></pre>
The -dPDFSETTINGS</code> option allows you to adjust the compression level:</p>

/screen</code>: For screen display (72dpi) - smallest file size</li>
/ebook</code>: For e-books (150dpi) - balanced compression</li>
/printer</code>: For printing (300dpi)</li>
/prepress</code>: For high-quality printing (highest quality)</li>
</ul>
Making PDF Searchable</h2>
Scanned PDFs aren't searchable. Use these Linux/Mac commands for OCR instead of expensive software:</p>
brew</span> install ocrmypdf</span></span>
brew</span> install tesseract-lang</span></span>
# OCR with image optimization</span></span>
ocrmypdf</span> -l jpn --optimize</span> 3</span> input.pdf output.pdf</span></span></code></pre>Creating Table of contents</h2>
Scanned PDFs often lack a table of contents. Instead of buying expensive PDF software, use these Linux/Mac commands:</p>
# Install pdftk (on Mac)</span></span>
brew</span> install pdftk-java</span></span>
# Extract metadata</span></span>
pdftk</span> input.pdf dump_data_utf8</span> ></span> metadata.txt</span></span></code></pre>
Open metadata.txt in your editor and add bookmark locations in this format:</p>
BookmarkBegin</span></span>
BookmarkTitle: Chapter 1</span></span>
BookmarkLevel: 1</span></span>
BookmarkPageNumber: 1</span></span>
BookmarkBegin</span></span>
BookmarkTitle: Chapter 2</span></span>
BookmarkLevel: 1</span></span>
BookmarkPageNumber: 10</span></span></code></pre>
Then apply the metadata to create a PDF with a table of contents:</p>
# Apply edited metadata</span></span>
pdftk</span> input.pdf update_info_utf8 metadata.txt output output.pdf</span></span></code></pre>Conclusion</h2>
With these steps, I successfully optimized the PDF and completed the drone registration.</p>
However, it seems rather inefficient to require individual manual submissions for DJI drones, which are widely used. This feels like typical bureaucratic red tape.</p>
Finally, while this may only be relevant for Japanese users, I'm sharing the prepared DJI Neo manual that meets DIPS2.0 requirements here: Download</a></p>