mcpField
P
pdf-to-image-preview

pdf-to-image-preview

github.com/wuchubuzai2018Documents4357 installsUpdated 8w ago
Repository

About pdf-to-image-preview

pdf-to-image-preview is a skill for turning each page of a PDF into a separate PNG or JPG image. It is intended for users who need page previews or image files, with adjustable resolution and optional ZIP output.

Key features

  1. 01Convert PDF pages to PNG or JPG
  2. 02Set output resolution with DPI
  3. 03Save images in a chosen directory
  4. 04Optionally package results as ZIP
  5. 05Supports PDFs of up to 100 pages

Use cases

  1. 01Create image previews of a PDF
  2. 02Extract PDF pages as image files
  3. 03Choose JPG output for a document
  4. 04Bundle converted pages into a ZIP

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wuchubuzai2018/expert-skills-hub --skill pdf-to-image-preview

After installing, type/pdf-to-image-previewin Claude Code to confirm it loaded.

Bundled filesreferences/usage-guide.mdscripts/convert_pdf_to_images.py

Details

From the project README

PDF转图片Skill

任务目标

  • 本Skill用于：将PDF文件的每一页转换为独立的图片文件
  • 能力包含：PDF文件解析、图片格式转换（PNG/JPG）、可调分辨率输出
  • 触发条件：用户需要将PDF转换为图片、提取PDF页面、图片化PDF内容等场景

前置准备

  • 依赖说明：scripts脚本所需的依赖包及版本 
    pymupdf>=1.23.0

操作步骤

  • 标准流程：

    1. 准备PDF文件

      • 确认PDF文件路径（使用 ./ 表示当前工作目录）
      • 例如：./document.pdf

    2. 执行转换

      • 调用脚本将PDF文件的每一页转换为图片
      • 命令示例： 
        python scripts/convert_pdf_to_images.py \
  --input ./document.pdf \
  --output-dir ./images
      • 可选参数：
        • --image-format: 图片格式，支持 png 或 jpg，默认为 png
        • --dpi: 图片分辨率（DPI），默认为 200
        • --zip: 生成ZIP压缩包
        • --zip-output: ZIP压缩包输出路径（默认：images.zip）

    3. 查看输出

      • 图片文件保存在指定的输出目录中
      • 文件命名格式：page_001.png、page_002.png...
      • 可选择是否生成ZIP压缩包

资源索引

注意事项

  • 输入PDF文件必须存在且可读
  • 输出目录必须具有写入权限
  • PDF页数限制：暂支持100页以内的PDF文件，超过100页请拆分后转换
  • 大型PDF文件转换可能需要较长时间，请耐心等待

故障排查

  • 脚本找不到错误：确保在Skill目录下执行，或使用相对路径 scripts/xxx.py
  • Python版本问题：确保使用Python 3.6或更高版本
  • 依赖缺失：执行 pip install pymupdf>=1.23.0 安装依赖
  • 页数超限错误：PDF文件超过100页，请使用PDF工具拆分为多个小文件

使用示例

示例1：基本转换（PNG格式）
python scripts/convert_pdf_to_images.py \
  --input ./report.pdf \
  --output-dir ./images
示例2：使用JPG格式
python scripts/convert_pdf_to_images.py \
  --input ./document.pdf \
  --output-dir ./images \
  --image-format jpg
示例3：高分辨率输出
python scripts/convert_pdf_to_images.py \
  --input ./document.pdf \
  --output-dir ./images \
  --dpi 300
示例4：生成ZIP压缩包
python scripts/convert_pdf_to_images.py \
  --input ./document.pdf \
  --output-dir ./images \
  --zip \
  --zip-output ./images.zip
示例5：完整配置
python scripts/convert_pdf_to_images.py \
  --input ./report.pdf \
  --output-dir ./images \
  --image-format jpg \
  --dpi 200 \
  --zip

Comments

Markdown supported