🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Stirling PDF
πŸ¦€ ClawHub

Stirling PDF

by @angusthefuzz

Self-hosted REST API for comprehensive PDF manipulation including merge, split, convert, OCR, compress, sign, redact, and secure PDFs.

Versionv1.0.4
Downloads1,053
Installs4
Stars⭐ 2
#api#legal
TERMINAL
clawhub install stirling-pdf

πŸ“– About This Skill

name: stirling-pdf description: PDF manipulation via Stirling-PDF API. Merge, split, convert, OCR, compress, sign, redact, and more. Self-hosted. metadata: openclaw: emoji: πŸ“„ requires: bins: [node, curl] env: { STIRLING_PDF_URL: "http://localhost:8080", STIRLING_API_KEY: "", }

Stirling-PDF Skill

Self-hosted PDF manipulation platform with 60+ tools via REST API.

Configuration

Set these environment variables:

  • STIRLING_PDF_URL β€” Your Stirling-PDF instance URL (default: http://localhost:8080)
  • STIRLING_API_KEY β€” API key if authentication is enabled

    • Docs

  • Official docs: https://docs.stirlingpdf.com
  • Swagger UI: /swagger-ui/index.html on your deployment

    • Quick Commands

    # Use the wrapper script
node ~/.openclaw/skills/stirling-pdf/scripts/pdf.js  [options]
    Examples:
    
node pdf.js merge file1.pdf file2.pdf -o merged.pdf
node pdf.js split input.pdf -o ./output-dir
node pdf.js compress input.pdf -o compressed.pdf
node pdf.js ocr input.pdf -o searchable.pdf
node pdf.js convert-to-pdf document.docx -o output.pdf
node pdf.js pdf-to-word input.pdf -o output.docx
node pdf.js add-watermark input.pdf "DRAFT" -o watermarked.pdf

    Available Operations

    Page Operations

  • merge - Combine multiple PDFs
  • split - Split PDF into parts
  • rotate - Rotate pages
  • extract-pages - Extract specific pages
  • reorder - Reorganize pages

    • Conversion

  • convert-to-pdf - Word, Excel, Images, HTML β†’ PDF
  • pdf-to-word - PDF β†’ Word
  • pdf-to-image - PDF β†’ Images
  • pdf-to-text - Extract text

    • Content

  • compress - Reduce file size
  • ocr - Make scanned PDFs searchable
  • add-watermark - Add text/image watermark
  • add-stamp - Add stamp
  • redact - Remove sensitive content
  • sign - Add signature

    • Security

  • add-password - Password protect
  • remove-password - Remove password
  • sanitize - Remove metadata/scripts

    • Direct API Usage

    For operations not covered by the script, call the API directly:

    curl -X POST "$STIRLING_PDF_URL/api/v1/general/merge-pdfs" \
  -H "X-API-KEY: $STIRLING_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "fileInput=@file1.pdf" \
  -F "fileInput=@file2.pdf" \
  -o merged.pdf

    Check Swagger UI at /swagger-ui/index.html for all endpoints.

    Common Endpoints

    | Operation | Endpoint | |-----------|----------| | Merge | /api/v1/general/merge-pdfs | | Split | /api/v1/general/split-pages | | Compress | /api/v1/misc/compress-pdf | | OCR | /api/v1/misc/ocr-pdf | | PDF to Image | /api/v1/convert/pdf/img | | Image to PDF | /api/v1/convert/img/pdf | | Add Watermark | /api/v1/security/add-watermark | | Add Password | /api/v1/security/add-password |

    Notes

  • Most endpoints use POST with multipart/form-data
  • File input parameter is usually fileInput
  • Response is the processed PDF file
  • Check Swagger UI for exact parameters per operation

    • βš™οΈ Configuration

    Set these environment variables:

  • STIRLING_PDF_URL β€” Your Stirling-PDF instance URL (default: http://localhost:8080)
  • STIRLING_API_KEY β€” API key if authentication is enabled

    • πŸ“‹ Tips & Best Practices

  • Most endpoints use POST with multipart/form-data
  • File input parameter is usually fileInput
  • Response is the processed PDF file
  • Check Swagger UI for exact parameters per operation