invoice-extract-paylisted
Install: claude install-skill Mao-jh/invoice-extract
# 提取 PDF 电子发票发票号码（一次付费 7 天不限次）
把一批电子发票 PDF 读一遍，字段直接进 Excel。
本 Skill 分两段：**先免费体检**（只读，只报数字不报正文），**再取授权真抽**（在你本机完成，发票不外传）。
> **为什么需要授权**：抽取动作需要一份由服务方签发的凭证。
> 授权**在你本机离线校验**（不联网即可验证真伪与有效期），
> 但**没有有效授权就不执行抽取**——这是服务的一部分，不是限制。
---
## 第 0 步 · 免费体检（scan，只读，不收费）
```bash
python scripts/invoiceextract.py scan 发票1.pdf 发票2.pdf
```
体检只给数字：几页、**几页有文字层（能抽）**、几页没有（扫描件/拍照件抽不了）。
**先把体检结论拿给用户看** —— 如果整份都是扫描件，直接劝退（本工具不 OCR，抽不出来）。
> 它能读的是**税局下载的电子发票 PDF**（带文字层）；纸质发票的扫描件、手机拍的发票
> **没有文字层**，本工具**不 OCR、不猜**，会如实标成「抽不到」而不是给你一个空表当成功。
---
## 第 1 步 · 请求授权（未付费会返回 402）
```
POST https://skills-gate.airpriv.com/api/invoice-extract-license
Content-Type: application/json
{"machine_fp":"<本机指纹串，8–128 位字母数字/连字符，可省略>"}
```
**首次调用一定拿到 `402 Payment Required`** —— 这是设计，不是错误。响应里带：
- HTTP 头 `Payment-Needed`（base64url 编码的账单）
- 响应体 `payment_needed` / `payment_needed_token` / `amount` / `out_trade_no`
> `machine_fp` 可选：带上则这份授权**绑定这台机器**，换机器需重新授权。省略则不绑定。
> 本机指纹：`python scripts/license_check.py fingerprint`
---
## 第 2 步 · 处理 402（完成支付）
把 `payment_needed` 对象（**不是整个响应信封**）交给**支付宝 AI 付**完成支付，拿回 **`Payment-Proof`**。
**不要自己伪造** —— 服务端会拿它去支付宝网关做真实校验。
---
## 第 3 步 · 携凭证重试（拿到授权凭证）
同一请求加上头 `Payment-Proof: <凭证>` 重发，成功返回 `200`，
`content.data.license` = 授权凭证（存成 `license.json`）。
**一次付费 = 一份授权 = 7 天有效**，期间反复抽**不需要再付费**。
---
## 第 4 步 · 校验授权并执行抽取（离线）
```bash
python scripts/license_check.py check license.json --fingerprint "<与第 1 步相同的值>"
echo $? # 0 = 放行；非 0 = 拒绝，不要执行
```
退出码：`0` 通过 · `4` 签名不通过 · `5` 已过期 · `6` 产品不