智能文档OCR识别

技能简介

DeepRead 是一款生产级文档处理 API，通过 AI 驱动的置信度评分机制，将人工复核比例从 100% 降至约 10%。该服务支持 PDF 转 Markdown、JSON 字段提取，并自动标记需要人工确认的字段。

能做什么

• 将 PDF 转换为干净的 Markdown 格式文本
• 按自定义 Schema 提取结构化 JSON 数据
• 为每个字段生成置信度分数和复核标记（hil_flag）
• 多轮处理与多模型交叉验证，减少漏检
• 免费额度：每月 2,000 页（无需绑定信用卡）

使用说明

1. 获取 API Key

访问 https://www.deepread.tech/dashboard 注册账号并创建 API Key。

export DEEPREAD_API_KEY="sk_live_your_key_here"

2. 可选：Clawdbot 配置

在 clawdbot.config.json5 中添加：

{
  skills: {
    entries: {
      "deepread": {
        enabled: true,
        apiKey: "sk_live_your_key_here"
      }
    }
  }
}

3. 处理文档（Webhook 方式，推荐）

curl -X POST https://api.deepread.tech/v1/process \
  -H "X-API-Key: $DEEPREAD_API_KEY" \
  -F "file=@document.pdf" \
  -F "webhook_url=https://your-app.com/webhooks/deepread"

返回任务 ID 后立即响应，处理完成后（约 2-5 分钟）结果推送至指定 Webhook。

4. 处理文档（轮询方式）

# 上传文件
curl -X POST https://api.deepread.tech/v1/process \
  -H "X-API-Key: $DEEPREAD_API_KEY" \
  -F "file=@document.pdf"

# 轮询结果
curl https://api.deepread.tech/v1/jobs/JOB_ID \
  -H "X-API-Key: $DEEPREAD_API_KEY"

5. 结构化数据提取（带 Schema）

curl -X POST https://api.deepread.tech/v1/process \
  -H "X-API-Key: $DEEPREAD_API_KEY" \
  -F "file=@invoice.pdf" \
  -F 'schema={
    "type": "object",
    "properties": {
      "vendor": {"type": "string"},
      "total": {"type": "number"},
      "invoice_date": {"type": "string"}
    }
  }'

输入与输出

见下方输入与输出表格。

风险提示

• 部分模糊或遮挡字段可能标记为需人工复核（hil_flag: true）
• 复杂版式文档的提取准确率可能下降
• 免费 tier 超出后需付费，建议监控用量
• Webhook 接收端需做好幂等处理，避免重复消费
• API Key 泄露可能导致额度被盗用，请妥善保管

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/uday390/deepread/SKILL.md
来源类型：GitHub 仓库