纳米
- 作者仓库星标 39
- 作者仓库 awesome-omni-skill
- 领域
- 数据
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 94 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @diegosouzapw · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需手动接入
- 是否需要外部接口密钥
- 需要 · Vendor-specific
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- Node.js · Python
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 读取环境变量
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
# nano-pdf
## Purpose
This skill provides tools for PDF processing, including text extraction, mining, form filling, manipulation, and OCR integration, to handle document workflows efficiently.
## When to Use
Use this skill for tasks involving PDF data extraction (e.g., from scanned documents), text analysis in reports, automating form submissions, merging/splitting files, or applying OCR to non-text PDFs. Apply it in data pipelines, document automation scripts, or when integrating with OCR services for unstructured data.
## Key Capabilities
- Text extraction: Pulls plain text or structured data from PDFs, supporting encrypted files with passwords; uses OCR via Tesseract integration for image-based PDFs.
- Text mining: Analyzes extracted text for keywords, sentiment, or patterns; e.g., counts occurrences of phrases in a document.
- Form filling: Populates interactive PDF forms with JSON data; supports flattening forms to static PDFs.
- Manipulation: Merges, splits, rotates, or watermarks PDFs; handles up to 500-page documents efficiently.
- OCR integration: Converts scanned PDFs to searchable text using external APIs; requires Tesseract or similar engine configuration.
## Usage Patterns
Invoke via CLI for quick scripts or API for server-side integration. For batch processing, chain commands in a shell script; for web apps, use API calls in loops. Always specify input/output paths explicitly. Pattern: Extract text first, then mine or manipulate as needed. For OCR-heavy tasks, preprocess images before PDF operations.
## Common Commands/API
CLI commands use `nano-pdf` binary; API endpoints are under `https://api.opencclaw.com/nano-pdf/`. Authentication requires `$NANO_PDF_API_KEY` environment variable.
- Extract text: `nano-pdf extract --file input.pdf --output text.txt --ocr true` (adds OCR if text is not selectable).
- Mine text: `nano-pdf mine --input text.txt --keywords "AI,robot" --output results.json` (outputs keyword frequencies).
- Fill form: `nano-pdf fill --template form.pdf --data '{"field1": "value"}' --output filled.pdf`.
- Manipulate PDF: `nano-pdf merge --files file1.pdf file2.pdf --output combined.pdf`.
- API endpoint for extraction: POST /extract with body `{"file": "base64encoded_content", "ocr": true}` and header `Authorization: Bearer $NANO_PDF_API_KEY`.
- Code snippet (Python):
```
import requests
response = requests.post('https://api.opencclaw.com/nano-pdf/extract', headers={'Authorization': f'Bearer {os.environ["NANO_PDF_API_KEY"]}'}, json={'file': 'base64data'})
print(response.json()['text'])
```
- Config format: JSON for API bodies, e.g., `{"file": "path", "options": {"ocr_engine": "tesseract", "language": "en"}}`; CLI uses flag-based configs like `--config config.json`.
## Integration Notes
Integrate by setting `$NANO_PDF_API_KEY` for authenticated requests; for local use, install via `pip install nano-pdf` and import as a module. Combine with other tools: pipe CLI output to NLP libraries for mining, or use in Node.js via HTTP requests. For OCR, ensure Tesseract is installed and configured in your environment path. Test integrations in a sandbox to verify API rate limits (e.g., 100 requests/min).
## Error Handling
Check for common errors like file not found (exit code 404), invalid API keys (401), or OCR failures (e.g., no Tesseract installed). Use try-except in code:
```
try:
result = nano_pdf.extract('input.pdf')
except FileNotFoundError:
print("Error: File does not exist.")
except Exception as e:
print(f"API Error: {e} - Check $NANO_PDF_API_KEY.")
```
For CLI, parse stderr output; retry transient errors (e.g., network issues) with exponential backoff. Always validate inputs, like ensuring PDFs are not corrupted before processing.
## Example 1: Extract and Mine Text from a PDF
To extract text from a scanned invoice PDF and mine for product names:
1. Run: `nano-pdf extract --file invoice.pdf --output invoice_text.txt --ocr true`
2. Then: `nano-pdf mine --input invoice_text.txt --keywords "product" --output analysis.json`
This produces a JSON with keyword occurrences for further processing.
## Example 2: Fill and Manipulate a Form PDF
To fill a job application form and merge it with a cover letter:
1. Prepare data in JSON: `{"name": "John Doe", "position": "Engineer"}`
2. Execute: `nano-pdf fill --template application.pdf --data application_data.json --output filled_app.pdf`
3. Merge: `nano-pdf merge --files filled_app.pdf cover_letter.pdf --output final_packet.pdf`
Output is a single PDF ready for submission.
## Graph Relationships
- Related to: "ocr-tool" (for enhanced OCR capabilities), "document-parser" (for broader file type support), "text-analyzer" (for advanced mining integrations).
- Clusters: Connected via "community" cluster to skills like "data-extraction" and "automation-utils".
章节与文件索引
按说明文件中的顺序排列。
何时使用
关键能力
使用模式
常用命令/API
集成说明
文件/命令 -> nano-pdf · https://api.opencclaw.com/nano-pdf/ · $NANO_PDF_API_KEY · nano-pdf extract --file input.pdf --output text.txt --ocr true · nano-pdf mine --input text.txt --keywords "AI,robot" --output results.json · nano-pdf fill --template form.pdf --data '{"field1": "value"}' --output filled.pdf · nano-pdf merge --files file1.pdf file2.pdf --output combined.pdf · {"file": "base64encoded_content", "ocr": true}
内容校验值 -> 18ecf1818479
当前原文的自动摘译,尚未人工审校。
何时使用
使用此技能来执行涉及 PDF 数据提取(例如,从扫描文档中)、报告中的文本分析、自动化表单提交、合并/拆分文件或将 OCR 应用到非文本 PDF 的任务。将其应用在数据管道、文档自动化脚本中,或者与非结构化数据的 OCR 服务集成时。
关键能力
文本提取:从PDF中提取纯文本或结构化数据,支持带密码的加密文件;通过 Tesseract 集成使用 OCR 来处理基于图像的 PDF。文本挖掘:分析提取的文本中的关键词、情绪或模式;例如,计算文档中短语的出现次数。表单填写:使用 JSON 数据填充交互式 PDF 表单;支持将表单展平为静态 PDF。操作:合并、分割、旋转 PDF 或添加水印;有效处理多达 500 页的文档。
使用模式
通过 CLI 调用快速脚本或 API 进行服务器端集成。对于批处理,在 shell 脚本中链接命令;对于 Web 应用程序,请在循环中使用 API 调用。始终明确指定输入/输出路径。模式:首先提取文本,然后根据需要进行挖掘或操作。对于 OCR 繁重的任务,请在 PDF 操作之前对图像进行预处理。
常用命令/API
CLI 命令使用
nano-pdf二进制; API端点位于https://api.opencclaw.com/nano-pdf/下。身份验证需要$NANO_PDF_API_KEY环境变量。提取文本:nano-pdf extract --file input.pdf --output text.txt --ocr true(如果文本不可选择,则添加 OCR)。我的文本:nano-pdf mine --input text.txt --keywords "AI,robot" --output results.json(输出关键词频率)。集成说明
通过为经过身份验证的请求设置
$NANO_PDF_API_KEY进行集成;对于本地使用,通过pip install nano-pdf安装并作为模块导入。与其他工具结合:将 CLI 输出传送到 NLP 库进行挖掘,或通过 HTTP 请求在 Node.js 中使用。对于 OCR,请确保在您的环境路径中安装并配置 Tesseract。在沙箱中测试集成以验证 API 速率限制(例如,100 个请求/分钟)。