The Complete Production SOP: How to Deploy and Run PyMuPDF High-Speed Document Rasterizer in Autonomous AI Agents

---
name: "pymupdf-highspeed-rasterizer"
description: "Rasterize PDF pages into high-res images and extract vector graphics at microsecond speeds."
metadata:
  author: "Artifex"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "rasterize pdf page to image pymupdf"
  - "search keyword in pdf pymupdf"
  - "highlight text in pdf"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

import fitz  # PyMuPDF bindings
from pathlib import Path
from typing import List

def render_pdf_to_images(pdf_path: str, output_dir: str, dpi: int = 300) -> List[str]:
    """Rasterizes each PDF page to high-res PNG using PyMuPDF."""
    out_path = Path(output_dir)
    out_path.mkdir(parents=True, exist_ok=True)
    
    saved_images = []
    with fitz.open(pdf_path) as doc:
        for page_index in range(len(doc)):
            page = doc[page_index]
            pix = page.get_pixmap(dpi=dpi, alpha=False)
            target_file = out_path / f"page_{page_index + 1:04d}.png"
            pix.save(str(target_file))
            saved_images.append(str(target_file))
            
    return saved_images

def highlight_keywords(pdf_path: str, output_pdf: str, keyword: str) -> int:
    """Searches for keywords and applies visual highlight annotations."""
    match_count = 0
    with fitz.open(pdf_path) as doc:
        for page in doc:
            quads = page.search_for(keyword, quads=True)
            for q in quads:
                annot = page.add_highlight_annot(q)
                annot.set_colors(stroke=(1.0, 0.9, 0.0))  # Bright yellow
                annot.update()
                match_count += 1
        doc.save(output_pdf, garbage=4, deflate=True)
    return match_count

# Execute prompt triggering the skill in Claude Code or Codex CLI
claude "Execute rasterize pdf page to image pymupdf for sample invoices in ./inputs and generate 300 DPI renders in ./dist/renders"

#!/usr/bin/env bash
set -euo pipefail
echo "[Quality Gate] Running flake8 and tests..."
python -m flake8 --max-line-length=120 rasterizer_service.py
python -m unittest tests/test_rasterizer.py
echo "[Quality Gate] Validating PDF integrity with fitz..."
python -c "import fitz; doc = fitz.open('highlighted.pdf'); assert doc.page_count > 0; doc.close()"
echo "[Quality Gate] All checks passed cleanly."