纳米

数据 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用

使用此技能来执行涉及 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 个请求/分钟)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
数据
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@diegosouzapw · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
需要 · Vendor-specific
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js · Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)
作者说明文件(原文) SKILL.md

# 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".

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。