Skavio PDF, OCR & Document Processing MCP

Skavio Processing API

发现 Skavio MCP 工具

Cursor / Claude Desktop / Claude Code 配置：远程 MCP 连接分步指南 · 可直接使用的 Cursor JSON · 可选的 Claude Desktop JSON。还可发现 Skavio USDC 微型 API 及其 MCP 客户端指南。

Skavio 远程 MCP 服务——为 AI Agent 提供发票 OCR 与信息提取、PDF 文本提取、文档自动化、图像与媒体处理、转录及会议工作流。可在官方 MCP 注册表中发现该服务，或将兼容的 MCP 客户端连接到 https://www.skavio.eu/processing/mcp 并完成 OAuth，也可使用明确签发的企业 MCP bearer 凭证。处理操作需要身份验证。

• MCP 设置和所有可用工具
• MCP 定价和预付 USDC 额度
• 官方 MCP 服务清单
• x402 付费 USDC 验证微型 API · 机器可读的 x402 发现信息

Processing MCP 使用企业范围的预付额度；独立的 x402 微型 API 会返回需要付款的响应。两者都不需要向 Skavio 暴露私钥。

一个企业级 API，涵盖文档提取、PDF 和图像工具、媒体处理、转录及会议。

• 产品和定价
• 实时开发者文档
• 企业工作区：注册并创建 API 密钥
• OpenAPI v1 · 开发者指南
• Python 快速入门 · Node.js 快速入门 · 批量处理指南
• Postman 公开文档 · Collection
• DEV.to 集成文章
• Webhook 验证

API 路由版本： /v1。**契约快照：**1.9.0 + Pricing V2，捕获于 2026-10-04。

API 1.7.0 的新增内容

• 按月计费／预留的用量以及独立的付款历史记录，支持有界 CSV 和密钥归属信息。
• 面向 API、batch、bulk 和付费 Web 入站请求的原子企业／密钥预算。
• 具备细粒度权限的到期 API 密钥，以及仅限管理员的策略写入权限。
• 队列可见性、持久化告警、取消尚未启动的独立任务，以及治理审计。
• 使用冻结的原始事件，对失败的 job／batch／bulk webhook 投递进行幂等重放。
• 结构化错误和 X-Request-Id 关联；仪表板新增捷克语／德语／英语支持。

请阅读用量、预算和恢复指南，了解授权、UTC 月份规则、限制和兼容性。

API 1.6.0 引入的 Storage Fabric

• 私有 S3 源文件／结果以及兼容的旧版本地文件。
• 经过验证的直接上传，以及从获准的客户云 URL 恢复导入。
• 企业范围的保留策略、归档、删除保留和选择加入的独立存储桶备份。
• 手动验证备份／恢复、签名结果下载及加密导入凭证。
• 继续支持现有的 Pricing V2、jobs、batches 和 bulk 契约。

请阅读 Storage Fabric 指南，了解端点、生产环境限制和浏览器上传处理方式。

API 1.5.0 引入的批量处理功能

• 批量清单最多支持 100,000 个项目，清单页不可变，每页包含 1–100 个项目，并支持有界的增量添加子项目。
• 基于存储的准入控制：通过 GET /v1/storage 获取信息，并声明输入、输出和暂存空间范围以及持久化存储预留。
• 恢复处理和重试失败项目：适用于大型工作负载，无需重新提交已成功处理的项目。
• 崩溃／重启恢复：恢复调度器状态、预留、检查点，并协调服务提供商意图。
• 在各公司之间公平调度，同时维持当前全局最多 4 个活跃平台作业的上限。
• 对于较简单的工作负载，仍可使用现有的 100 项批次。

请从批量处理指南或 Python 批量快速入门开始。 此仓库包含公开的开发者工具包。托管处理服务需要 Skavio 账户和额度。

获取第一个结果

1. 注册、创建公司资料，并在公司工作区生成读写密钥。密钥只会显示一次，请复制并妥善保存在服务器端。
2. 使用多部分表单字段 files 上传源文件。
3. 调用 POST /v1/estimate，但不要启动处理。
4. 将 max_credits 设为返回的 estimated_credits。
5. 使用稳定的 Idempotency-Key 提交 POST /v1/jobs。
6. 轮询返回的作业 ID，直到作业完成或失败；通过经过身份验证的结果路径下载。

随附的发票为合成数据，不包含客户数据，可用于测试提取功能。

Python 3.10+

python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
# Set SKAVIO_API_KEY securely in your local environment.
export SKAVIO_IDEMPOTENCY_KEY="your-persisted-invoice-request-001"
python quickstart.py

Node.js 22+

# Set SKAVIO_API_KEY securely in your local environment.
export SKAVIO_IDEMPOTENCY_KEY="your-persisted-invoice-request-002"
node quickstart.mjs

两个示例都使用 sample-invoice.txt；如需更换文件，请将 SKAVIO_SOURCE 设为 PDF、图像或文本源。示例会在提交前估算费用，并将 JSON 输出写入 results/。 若要有意处理不同的源文件或已更改的负载，请使用新的幂等键。 这些示例是服务器端入门示例。如需官方 Python 和 JavaScript SDK 客户端，请参阅 sdk/README.md；持久化工作流管道的文档见 workflow-guide.md。

Postman

导入集合，或复制其公开工作区副本。设置仅供自己使用的本地／私有环境变量 api_key；切勿将真实密钥保存在公开集合中。将 source_file 设为本地文件。依次运行 Upload → Estimate → Submit → Job status → Download。每隔 3–10 秒轮询一次，直到作业进入终态后再下载。 请求覆盖 API 密钥处理端点；管理、创建密钥、计费和注册 Webhook 则需在仪表板中使用公司的管理员交互式会话。 提交新的业务请求前，请清除私有环境中的 upload_id、job_id、download_path、max_credits 和 idempotency_key。重试同一提交时，请保留幂等键。

我可以处理什么？

工作流	操作
文档	flow-extract → XLSX、CSV、JSON；可指定字段、证据和审核标记
PDF	合并、拆分、提取／删除／旋转页面、压缩、添加水印、页码、使用你的密码保护／解锁、OCR
图像	调整大小／裁剪／旋转／翻转、压缩、格式转换、OCR
音频／视频	转换、剪辑、压缩；视频旋转／分辨率／静音
语音	transcribe、meeting

功能快照列出了准确的操作名称。调用 GET /v1/capabilities 查询当前价格和限制。 普通文件作业接受一个源文件；PDF 合并接受 2–20 个 PDF；Flow 可以处理多个文档源。Transcribe 和 Meeting 接受一个媒体源。批量处理最多支持 100 个项目。API 1.5.0 的批量清单最多支持 100,000 个项目，并支持增量分派；请参阅 bulk-guide.md。独立作业不支持任意操作链式调用。我们提供持久化的线性处理／审核／归档管道；请参阅工作流指南。

积分与价格控制

所有 Web 工具和 API 共用一个公司预付钱包。本套件未宣传无限处理权益。 服务会统计字节数、页数和媒体时长。提交时按报价金额冻结积分，成功后收取固定报价，失败时释放冻结积分。 使用 max_credits 拒绝费用意外过高的提交，并通过 GET /v1/wallet 跟踪余额和冻结积分。

操作	定价 V2
原始 OCR 文本（ocr-txt）	3 积分/页
OCR 文档输出（ocr-docx / ocr-pdf）	10 积分/页
流程提取与导出	25 积分/页
PDF/图像/Office/文本文件操作	每开始 25 MB 或 10 页收取 2 积分，按每个源文件中较大的计费基准计算
转录	每开始 1 分钟收取 8 积分
会议	每开始 1 分钟收取 15 积分
File Toolbox 音视频	每开始 1 分钟收取 4 积分

名义汇率为 1 EUR = 1,000 积分。充值：EUR10/10,000；EUR25/26,000；EUR50/53,000；EUR100/108,000；EUR250/280,000；EUR500/570,000。另有 EUR6.99/6,990 积分的零售套餐。

月度套餐：Starter EUR29/30,000 积分；Business EUR79/85,000；Pro EUR199/225,000；Enterprise EUR499/600,000。已购积分永不过期；月度积分可结转。当前套餐共用部署处理限额。

Web 工具和 API 共用一个钱包。提交时按测算报价冻结积分；成功后仅收取一次；永久失败时释放冻结积分。遇到临时服务商中断时，任务会在队列中保留，并保存持久检查点和冻结积分。已报价任务以及已购的结账/订阅优惠保留原金额。

规范的实时目录：GET /v1/pricing。提交前务必先估算，并使用 max_credits，而非将费率硬编码。

可靠性与集成规则

• queued → processing → completed | failed；提交会返回 HTTP 202。
• 使用相同幂等键重放完全相同的任务请求会返回同一任务。更改其负载会返回 409。
• 在你的系统中保存业务请求、确切负载、密钥和任务 ID。如果响应丢失，请使用原密钥重试。
• 失败任务会释放积分；有意进行的新尝试应使用新密钥。
• 服务商中断和服务重启不会影响持久化任务/检查点及冻结积分；永久失败时会释放冻结积分。
• Webhook 至少投递一次；请对原始字节验证 HMAC，并对事件 ID 去重。仍支持轮询。
• 结果/源文件默认保留 7 天。Storage Fabric 策略、归档和保留控制对象保留期限；请检查 retain_until，并在到期前保存结果。
• 提取结果可能有误。请检查依据和审核标记；在后续会计处理中使用明细项前，先对照源文件进行审核。

限额（当前部署）

每个密钥/会话每分钟 120 个请求；每次上传最多 100 个文件/500 MB；每家公司源文件存储空间 2 GB；每个 PDF 最多 100 页；每家公司最多 100 个排队任务；每家公司最多 4 个活动平台任务，全球最多 4 个。转录/会议输入最长可达 10 小时；File Toolbox 媒体最长可达 2 小时。 这些是上限，并非保证的吞吐量或 SLA。遇到 429 和暂时性 5xx 响应时，请退避重试。当前套餐共用处理限额。

错误

JSON 错误保留 detail，并添加 error_code、request_id 和 retryable；X-Request-Id 用于关联请求。请使用稳定的代码，而不要匹配错误文本。验证过程不会回显机密输入。

HTTP	含义
401 / 403	缺少/无效的身份验证、范围或权限
402	积分不足
404	对象不存在或属于其他公司
409	状态/幂等冲突或 max-credit 拒绝
410	结果已过期
413 / 422	上传/存储限额或源文件/参数无效
429	请求/队列限额
502 / 503 / 504	处理/服务商不可用或超时

安全与支持

通过 HTTPS 使用 Authorization: Bearer <your-key>。切勿在前端应用、URL、屏幕截图、提交内容或共享的 Postman 环境中暴露密钥。公司范围的对象 ID 无法访问其他公司的数据。 在控制面板中创建或撤销密钥并注册 Webhook。PDF 密码属于机密信息；请勿记录负载。 在处理受监管或敏感输入前，请查看 隐私政策 和 条款。处理源文件时可能会涉及外部提供方；备份和提供方的数据保留政策与平台删除机制相互独立。

请通过此代码库报告集成问题，并且仅使用合成内容进行复现；也可以私下联系 [email protected]。切勿在公开问题中附上客户文档、密钥或账单数据。

版本管理

兼容性新增内容仍使用 /v1；客户端应忽略未知响应字段。重大变更需要升级主要 API 版本或发布迁移公告。更新日志。

许可证

此开发工具包中的示例代码和文档采用 MIT 许可证。该许可证不适用于托管后端，也不代表可以免费使用托管服务；服务使用遵循其条款和积分定价。

批量处理 — API 1.5.0

通过同一处理流水线，为任意已公布的操作提交最多 100 个项目。一个批次使用同一组操作和选项，并创建常规子作业。处理上限仍为每家公司同时处理 4 个作业、全局同时处理 4 个作业；批次不保证 100 个项目并行执行。

1. 使用 POST /v1/uploads 上传文件，并保存其上传 ID。
2. 使用 {"operation":"jpg","upload_ids":["UPLOAD_A","UPLOAD_B"]} 调用 POST /v1/batches/estimate 获取报价。
3. 将相同载荷提交至 POST /v1/batches，并将 max_credits 设为报价总额，同时使用已持久化的 Idempotency-Key（允许 8–128 个字符）。
4. 轮询 GET /v1/batches/{batch_id}。每个 items[].job 都包含状态、积分和结果下载路径。progress 的取值范围为 0 到 1；终态为 completed、partial、failed。
5. 完成后下载 GET /v1/batches/{batch_id}/results.zip。归档文件包含成功处理的结果和 manifest.json。文件缺失或过期时会返回 410。ZIP 输出上限为 1 GB；对于更大的结果，请使用经过身份验证的单项下载。
6. 使用 POST /v1/batches/{batch_id}/retry-failed 并提供新的已持久化密钥，为失败项目创建一个单独计费的批次。重试请求与原始批次绑定。请在保留期结束前下载成功结果。

整个批次的积分会以原子方式预留。每个子作业单独核算；成功的项目会扣除积分，失败的项目会释放预留积分。重放相同的提交不会再次预留积分。复用密钥但更改请求会返回 409。批次项目计入每家公司 100 个排队作业的上限。

请使用 upload_ids（每个源文件对应一个子作业）或 items（显式分组），不可同时使用。PDF 合并要求每组包含 2–20 个 PDF：

{"operation":"pdf-merge","items":[{"upload_ids":["PDF_A","PDF_B"]},{"upload_ids":["PDF_C","PDF_D"]}],"webhook_mode":"both"}

分组式 Flow 输入使用相同的 items 结构。可选的 webhook_id 必须属于你的公司。webhook_mode 接受 batch（父级事件）、items（子级事件）或 both。父级事件包括 batch.completed、batch.partial、batch.failed；请验证相同的签名并对事件 ID 去重。父级投递 ID 与子级投递 ID 不同。

GET /v1/batches 会列出公司最近的批次。DELETE /v1/batches/{batch_id} 会删除已进入终态的结果和源文件规格，同时保留核算记录。源文件和结果的保留期为七天。重复失败防护机制可能会返回 429；请联系支持团队，而不要持续重新提交失败的源文件。请将准确的载荷、密钥和返回的 ID 保存到持久化存储中。

批量处理入门示例：Python · Node.js · 批量处理指南。设置 SKAVIO_API_KEY、SKAVIO_UPLOAD_IDS（上传后生成的 JSON 数组）和已持久化的 SKAVIO_BATCH_IDEMPOTENCY_KEY。示例会轮询并输出经过身份验证的结果路径；请在保留期结束前归档结果。

持久化工作流流水线

用于线性处理／审核／归档步骤、带检查点的执行和逐步结算积分。请参阅工作流指南。

官方 SDK 客户端

Python 和 Node.js 客户端位于 sdk/README.md。可从此仓库安装：使用 python3 -m pip install ./sdk/python 或 npm install ./sdk/javascript。它们支持当前 OpenAPI 的全部 92 个操作、持久化提交密钥、可恢复轮询、签名 Webhook 验证和经过身份验证的结果下载。软件包已发布：pip install skavio-sdk==1.1.0 和 npm install @skavio-llc/[email protected]。

API 1.9.0 控制与通知

批量暂停和取消需要 Idempotency-Key，并强制实施公司隔离。暂停会阻止新的子任务加入；已接受的任务会完成处理，并且只结算一次。取消是最终操作，会阻止后续调度。GET /v1/notifications 和 GET /v1/notifications/settings 均限定在租户范围内。PUT /v1/notifications/settings 需要公司管理员的 Web 会话。通知默认关闭；电子邮件需要配置传输方式。冻结事件会去重，并在有限的投递时段内重试。电子邮件发送至当前公司的账单地址，并支持 cs/de/en。

面向 AI Agent 的 USDC 付款验证

Skavio USDC Payment Verification — x402 API 会检查原生 Circle USDC 转账，匹配完全一致的收款方和小数金额，并生成区块链证据 PDF。可用于商户付款对账、会计交易审查和 Agent 工作流。PDF 证据不是税务发票，也不保证第三方授权。

• HTTP Verify：0.02 原生 USDC；Match：0.03 USDC；PDF：0.05 USDC。付款通过 x402 v2 在 Base 上单独结算。检查支持 Base、Polygon、Arbitrum、Optimism、Ethereum、Avalanche 和已最终确认的 Solana。
• API 快速入门、架构、错误和客户端配置 · 三路由发现 · OpenAPI。
• Skavio USDC Payment Verification & Proof MCP，版本 1.1.2。稳定的注册表命名空间和工具 ID 保持不变。使用 https://www.skavio.eu/mcp 连接（Streamable HTTP）。
• MCP 提供四个付费区块链/领域工具（verify_native_usdc、match_native_usdc_payment、usdc_transfer_evidence_pdf、domain_dns_tls_audit）、两个免费发现工具，以及十二个独立的、经过身份验证的 AgentTools 处理/作业/钱包中继。DNS/TLS 审计费用为 0.05 USDC，且不是漏洞扫描。
• **不带钱包 x402 扩展的标准 MCP 客户端无法自动付款。**发现功能免费。付费 MCP 重试会保留 params._meta["x402/payment"]；HTTP 重试使用 PAYMENT-SIGNATURE。切勿发送私钥或助记词。添加服务不会创建托管或自动支出。
• PayAPI 为 HTTP Verify，0.02 USDC、精确收款方/金额 Match，0.03 USDC 和 区块链 PDF 证据，0.05 USDC 分别发布了实时列表和历史结算收据。每个路由均于 2026-10-17 单独读取确认，且每笔先前的 Base USDC 收据均经过只读核验。本次文档更新未进行新的付款。这是区块链证据，不是税务发票。
• RPC 可用性和最终确认状态会影响结果。不承诺固定延迟 SLA。EVM 请求使用 32 字节的 0x 哈希；Solana 使用其交易签名。Match 接收收款方钱包地址和正数形式、最多六位小数且精确的 USDC 十进制字符串。

Cursor .cursor/mcp.json：

{"mcpServers":{"skavio-usdc":{"url":"https://www.skavio.eu/mcp"}}}

Claude Code：

claude mcp add --transport http skavio-usdc https://www.skavio.eu/mcp

使用 Node.js 和经过审查的 stdio-to-HTTP 桥接程序的 Claude Desktop：

{"mcpServers":{"skavio-usdc":{"command":"npx","args":["-y","mcp-remote","https://www.skavio.eu/mcp"]}}}

该桥接程序可能会下载第三方软件包，且不提供钱包付款支持。当前 Desktop 远程连接器可能可直接接受 HTTPS URL。

首次未付款请求（不签名或转账）：

curl -i 'https://www.skavio.eu/x402/v1/usdc/verify?tx_hash=0x98809948204426c574b6f0aabdec03baa996b5c43ce28cc9ca704fa5d07e592e&network=base'

预期返回 HTTP 402，并解码 PAYMENT-REQUIRED。在授权 x402 钱包客户端前，先检查确切金额、Base USDC 资产和收款方；然后才重试同一请求。如果响应状态不明确，请检查恢复状态，而不要盲目再次付款。

独立的 Skavio PDF, OCR & Document Processing MCP，版本 0.2.7，使用公司 OAuth，连接地址为 https://www.skavio.eu/processing/mcp，并使用共享预付额度。处理文档 说明公司所有权和按量计费的作业。可选 AgentTools 中继需要调用方自己的密钥和当前后端可用；请保留幂等键、轮询状态、下载结果并验证 SHA256。HTTP /x402/v1/processing 保持禁用。