Nanonets OCR_办公效率 skill-PHP中文网

Nanonets OCR

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

Nanonets 文档提取 API。可将 PDF 和图像转换为 Markdown、JSON 或 CSV，并提供置信度评分。适用于文档 OCR、发票字段提取、收据解析或表格转结构化数据。

DocStrange by Nanonets.

功能概述

DocStrange by Nanonets.是一项面向实际任务的技能，主要用于Document retrieved API – 转换PDF,图像和文档,以标记下,JSON,或CSV,并按每个字段打入信任分.；Get your API key: https://docstrang.nanonets.。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

DocStrange（由 Nanonets 提供）

文档提取 API —— 将 PDF、图像及各类文档转换为 Markdown、JSON 或 CSV 格式，并为每个字段提供置信度评分。

获取您的 API 密钥： https://docstrange.nanonets.com/app

快速开始

curl -X POST "https://extraction-api.nanonets.com/api/v1/extract/sync" 
  -H "Authorization: Bearer $DOCSTRANGE_API_KEY" 
  -F "file=@document.pdf" 
  -F "output_format=markdown"

响应示例：

{
  "success": true,
  "record_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "result": {
    "markdown": {
      "content": "# Invoice\n\n**Invoice Number:** INV-2024-001..."
    }
  }
}

配置

1. 获取您的 API 密钥

# 访问控制台
https://docstrange.nanonets.com/app

保存您的 API 密钥：

export DOCSTRANGE_API_KEY="your_api_key_here"

2. OpenClaw 配置（可选）

推荐方式：使用环境变量（最安全）：

{
  skills: {
    entries: {
      "docstrange": {
        enabled: true,
        // API 密钥从环境变量 DOCSTRANGE_API_KEY 中加载
      },
    },
  },
}

替代方式：存储于配置文件中（请谨慎使用）：

{
  skills: {
    entries: {
      "docstrange": {
        enabled: true,
        env: {
          DOCSTRANGE_API_KEY: "your_api_key_here",
        },
      },
    },
  },
}

安全提示： 若将 API 密钥存储在 ~/.openclaw/openclaw.json 中，请注意：

设置文件权限：chmod 600 ~/.openclaw/openclaw.json
切勿将该文件提交至版本控制系统
尽可能优先使用环境变量或代理自身的密钥存储服务（secret store）
定期轮换密钥，并在支持的情况下限制 API 密钥的权限范围

常见任务

提取为 Markdown

curl -X POST "https://extraction-api.nanonets.com/api/v1/extract/sync" 
  -H "Authorization: Bearer $DOCSTRANGE_API_KEY" 
  -F "file=@document.pdf" 
  -F "output_format=markdown"

访问内容字段：response["result"]["markdown"]["content"]

提取 JSON 字段

简单字段列表：

curl -X POST "https://extraction-api.nanonets.com/api/v1/extract/sync" 
  -H "Authorization: Bearer $DOCSTRANGE_API_KEY" 
  -F "file=@invoice.pdf" 
  -F "output_format=json" 
  -F 'json_options=["invoice_number", "date", "total_amount", "vendor"]' 
  -F "include_metadata=confidence_score"

使用 JSON Schema：

curl -X POST "https://extraction-api.nanonets.com/api/v1/extract/sync" 
  -H "Authorization: Bearer $DOCSTRANGE_API_KEY" 
  -F "file=@invoice.pdf" 
  -F "output_format=json" 
  -F '{"type": "object", "properties": {"invoice_number": {"type": "string"}, "total_amount": {"type": "number"}}}'

带置信度评分的响应示例：

{
  "result": {
    "json": {
      "content": {
        "invoice_number": "INV-2024-001",
        "total_amount": 500.00
      },
      "metadata": {
        "confidence_score": {
          "invoice_number": 98,
          "total_amount": 99
        }
      }
    }
  }
}

提取表格为 CSV

curl -X POST "https://extraction-api.nanonets.com/api/v1/extract/sync" 
  -H "Authorization: Bearer $DOCSTRANGE_API_KEY" 
  -F "file=@table.pdf" 
  -F "output_format=csv" 
  -F "csv_options=table"

异步提取（适用于大文档）

对于页数超过 5 页的文档，请使用异步接口并轮询结果：

提交文档至队列：

curl -X POST "https://extraction-api.nanonets.com/api/v1/extract/async" 
  -H "Authorization: Bearer $DOCSTRANGE_API_KEY" 
  -F "file=@large-document.pdf" 
  -F "output_format=markdown"

# 返回示例：{"record_id": "12345", "status": "processing"}

轮询提取结果：

curl -X GET "https://extraction-api.nanonets.com/api/v1/extract/results/12345" 
  -H "Authorization: Bearer $DOCSTRANGE_API_KEY"

# 返回示例：{"status": "completed", "result": {...}}

高级功能

边界框（Bounding Boxes）

获取元素坐标，用于版面分析：

-F "include_metadata=bounding_boxes"

层级结构输出（Hierarchy Output）

提取文档结构（章节、表格、键值对等）：

-F "json_options=hierarchy_output"

财务文档模式（Financial Documents Mode）

增强的表格识别与数字格式化能力：

-F "markdown_options=financial-docs"

自定义指令（Custom Instructions）

通过提示词引导提取行为：

-F "custom_instructions=Focus on financial data. Ignore headers."
-F "prompt_mode=append"

多格式输出

单次请求返回多种格式：

-F "output_format=markdown,json"

适用场景

建议使用 DocStrange 的场景：

发票与收据处理
合同文本提取
银行对账单解析
表单数字化
图像 OCR（扫描件）

不建议使用的场景：

同步接口不适用于页数超过 5 页的文档（请改用异步接口）
音视频转录
非文档类图像（如照片、插图等）

最佳实践

文档大小	接口路径	说明
≤5 页	`/extract/sync`	即时响应
>5 页	`/extract/async`	需轮询结果

JSON 提取方式：

字段列表：["field1", "field2"] —— 快速提取
JSON Schema：{"type": "object", ...} —— 支持强类型校验与嵌套结构

置信度评分：

添加参数：include_metadata=confidence_score
各字段评分为 0–100 区间整数
建议人工复核评分低于 80 的字段

Schema 模板

发票（Invoice）

{
  "type": "object",
  "properties": {
    "invoice_number": {"type": "string"},
    "date": {"type": "string"},
    "vendor": {"type": "string"},
    "total": {"type": "number"},
    "line_items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "description": {"type": "string"},
          "quantity": {"type": "number"},
          "price": {"type": "number"}
        }
      }
    }
  }
}

收据（Receipt）

{
  "type": "object",
  "properties": {
    "merchant": {"type": "string"},
    "date": {"type": "string"},
    "total": {"type": "number"},
    "items": {
      "type": "array",
      "items": {"type": "object", "properties": {"name": {"type": "string"}, "price": {"type": "number"}}}
    }
  }
}