Xpersona
agentCLAWHUBUnverified

发票识别

发票识别技能。上传发票文件进行 OCR 识别，返回发票票面信息。适用于从发票图片或文件中提取结构化数据的场景。 Skill: 发票识别 Owner: zxt Summary: 发票识别技能。上传发票文件进行 OCR 识别，返回发票票面信息。适用于从发票图片或文件中提取结构化数据的场景。 Tags: latest:1.0.1 Version history: v1.0.1 | 2026-06-17T07:38:11.472Z | user 主体迁移 v1.0.0 | 2026-05-25T08:03:24.921Z | user 正式版 v1.0.0-beta | 2026-05-22T01:05:01.874Z | user - 更新了 apiKey 申请及注册地址至 https://skill.quandianfapiao.com/ - 相关说明同步调整为“中兴通简税Skill平台：https://skill.quandianfapiao.com/” - 其他功能和流程无变动 v1.0.0-alpha | 2026-05-21T09:2

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.0.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 11, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 11, 2026
Adoption signal
1.1K downloadsadoption · observed Oct 11, 2026
Latest release
1.0.1release · observed Jun 17, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s176y1zx801xf9nrys54e3xztd88t1jf:invoice-ocr-pro
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-ocr-pro/snapshot"

Documentation

CLAWHUB

28,033 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: invoice-ocr
description: 发票识别技能。上传发票文件进行 OCR 识别，返回发票票面信息。适用于从发票图片或文件中提取结构化数据的场景。
---

# 发票识别技能

使用此技能通过上传发票文件进行 OCR 识别，自动提取发票票面结构化信息。

## 使用场景

满足以下需求时使用：

- 上传发票图片或文件（PDF/OFD/JPEG/JPG/PNG/XML）进行 OCR 识别。
- 从发票图片中提取发票号码、金额、销购方等结构化信息。
- 批量处理发票文件的自动识别。

## 触发语句示例

以下用户输入应触发此技能：

- 帮我识别这张发票 / 发票识别 / 识别发票
- 这张发票里有什么信息
- 提取发票信息 / 发票 OCR
- 读取发票内容
- 这个发票文件帮我识别一下
- 识别发票文件

## 输入参数

执行前准备以下参数：

- apiKey（必填）：通过 https://skill.quandianfapiao.com/ 申请。

### 发票识别 (ocr)

- 发票文件路径（必填，支持 PDF、OFD、JPEG、JPG、PNG、XML）

## 执行流程

**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**

注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：

- Windows：执行 `powershell -Command "[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。
- macOS/Linux：检查 `$ZXT_API_KEY` 即可。

如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：

> 您需要完成以下三步，即可自动配置并执行技能：
>
> 1. **注册账号**
>    访问中兴通简税Skill平台：https://skill.quandianfapiao.com/ 完成注册。
>
> 2. **申请 apiKey**
>    登录后进入"技能中心"，复制您的 apiKey。
>
> 3. **提供 apiKey**
>    将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。

**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**

- 禁止读取文件（Excel、PDF、图片等）
- 禁止调用任何 API
- 禁止执行任何脚本或命令
- 禁止进行参数解析或预处理

**只允许输出提示信息，然后停止，等待用户提供 apiKey。**

用户提供 apiKey 后，写入系统环境变量并使当前会话生效：

- Windows：`setx ZXT_API_KEY <apiKey>` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=<apiKey>` 使当前会话生效。
- macOS/Linux：将 `export ZXT_API_KEY=<apiKey>` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=<apiKey>` 使当前会话生效。

环境变量就绪后，继续以下步骤：

1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**
   - 缺少发票文件路径：停止并提示用户提供文件。
   - 文件不存在或不支持该文件类型：停止并提示用户。
2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。
3. 检查返回的 status 字段，非 200 时停止并将错误信息展示给用户，禁止重试或忽略。
4. 解析返回结果并以可读格式输出。

## 请求参数说明

### 发票识别 — POST /api/jxplus/zxtSkill/discern/invoiceDiscern

请求头：`Content-Type: multipart/form-data`

| 参数   | 类型   | 必填 | 说明                             |
| ------ | ------ | ---- | -------------------------------- |
| apiKey | string | 是   | apiKey                           |
| file   | file   | 是   | 发票文件（pdf/ofd/jpeg/jpg/png/xml） |

## 返回说明

### 外层返回字段

| 字段    | 类型   | 说明                 |
| ------- | ------ | -------------------- |
| status  | string | 返回接口状态码       |
| message | string | 返回接口状态描述信息 |
| data    | object | 业务数据体           |

### data 业务数据体

| 字段           | 类型   | 说明               |
| -------------- | ------ | ------------------ |
| invoiceType    | string | 发票种类           |
| invoiceCode    | string | 发票代码           |
| invoiceNumber  | string | 发票号码           |
| invoiceDate    | string | 开票日期           |
| hjje           | string | 合计金额           |
| hjse           | string | 合计税额           |
| jshj           | string | 价税合计           |
| xsfMc          | string | 销售方名称         |
| xsfNsrsbh      | string | 销售方纳税人识别号 |
| xsfAddressTel  | string | 销售方地址、电话   |
| xsfBankAccount | string | 销售方开户行及账号 |
| gmfMc          | string | 购买方名称         |
| gmfNsrsbh      | string | 购

_meta.json

{
  "ownerId": "kn78wqnm3g9mqn7q7x83dh3jvn874tn3",
  "slug": "invoice-ocr-pro",
  "version": "1.0.1",
  "publishedAt": 1781681891472
}

skill-card.md

## Description:

发票识别技能用于上传发票图片或文件进行 OCR 识别，并返回发票票面结构化信息。

This skill is ready for commercial/non-commercial use.

## Publisher:

[zxt](https://clawhub.ai/user/zxt)

### License/Terms of Use:

MIT-0

## Use Case:

External users and agents use this skill to upload invoice files and extract structured invoice fields such as invoice number, dates, amounts, buyer and seller details, and line items.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill sends invoice files to skill.quandianfapiao.com for OCR processing.

Mitigation: Use only invoices the user is allowed to transmit to that service and review data handling requirements before processing sensitive documents.

Risk: The security review says the skill asks users to share an API key in chat and persistently writes it into shell configuration without clear consent or safe secret handling.

Mitigation: Use a platform secret manager or per-run environment variable, avoid pasting long-lived API keys into chat, and do not allow automatic modification of ~/.bashrc, ~/.zshrc, or persistent user environment settings.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/zxt/skills/invoice-ocr-pro)
- [Publisher profile](https://clawhub.ai/user/zxt)
- [ZXT invoice OCR service](https://skill.quandianfapiao.com/)

## Skill Output:

**Output Type(s):** [Text, Shell commands, Guidance]

**Output Format:** [Plain text with structured invoice fields and error messages]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Supports PDF, OFD, JPEG, JPG, PNG, and XML invoice files up to 10 MB; requires ZXT_API_KEY or an apiKey argument.]

## Skill Version(s):

1.0.1 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Related agents

Same protocol, similar job.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/zxt/skills/invoice-ocr-pro",
      "sourceUrl": "https://clawhub.ai/zxt/skills/invoice-ocr-pro",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T11:57:42.079Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-ocr-pro/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-ocr-pro/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T11:57:42.079Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.1K downloads",
      "href": "https://clawhub.ai/zxt/invoice-ocr-pro",
      "sourceUrl": "https://clawhub.ai/zxt/invoice-ocr-pro",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T11:57:42.079Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.1",
      "href": "https://clawhub.ai/zxt/invoice-ocr-pro",
      "sourceUrl": "https://clawhub.ai/zxt/invoice-ocr-pro",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-17T07:38:11.472Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-ocr-pro/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-ocr-pro/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.1",
      "description": "主体迁移",
      "href": "https://clawhub.ai/zxt/invoice-ocr-pro",
      "sourceUrl": "https://clawhub.ai/zxt/invoice-ocr-pro",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-17T07:38:11.472Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to 发票识别 and adjacent AI workflows.