360 Secure SkillHub
360 安全技能中心

Stirling PDF

该 Skill 提供 Node 包装脚本，通过自托管 Stirling-PDF 实例的 REST API 执行 PDF 合并、拆分、旋转、页面提取与重排、格式互转、文本提取、压缩、OCR、水印/图章、脱敏、签名及加解密等操作，也允许直接调用 API；需配置实例地址与可选 API Key，运行时依赖 node 与 curl。

angusthefuzz
angusthefuzz
热度 86.97
最近更新 2026-05-11 12:00:17
分类：效率依赖：代码执行 / 第三方 API / 读写文件应用场景：文件转换 / 数据处理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add stirling-pdf
Metadata
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

Quick Commands

# Use the wrapper script
node ~/.openclaw/skills/stirling-pdf/scripts/pdf.js <operation> [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 <your-instance>/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