← 返回 Skills 市场
52
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install adp-global-invoice-extraction-free
功能描述
A limited-time free skill launched by the Laiye ADP team. It accurately identifies and extracts information from invoices and receipts in over 100 global lan...
使用说明 (SKILL.md)
\r \r
ADP Global Invoice Extraction Free Skill\r
\r Powered by the Laiye ADP Team (Agentic Document Processing), this skill enables intelligent, high-precision parsing and data extraction for invoices, bills and vouchers across the globe, whether standard or unstructured. It works seamlessly with electronic PDFs, scanned files and images, and returns standardized structured JSON data to facilitate business workflow integration and downstream automation.\r \r \r
📄 Quick Start Guide\r
\r
Step 1: Select Base URL\r
We offer dedicated public cloud access endpoints for domestic and international users, with separate regional configurations. Connecting to the nearest node ensures fast and stable network calls. No account registration or API Key is required — you may send requests directly to the endpoints listed below. \r
\r
| Environment | API Endpoint |\r
|------|---------|\r
| Global | https://adp-global.laiye.com/public/v1/invoice-fast/extract |\r
| China | https://adp.laiye.com/public/v1/invoice-fast/extract |\r
\r
Step 2: Send Request\r
Choose one file transfer method and send a POST request:\r
\r
Method 1: File URL\r
curl -X POST "https://adp-global.laiye.com/public/v1/invoice-fast/extract" \\r
-H "Content-Type: application/json" \\r
-d '{\r
"file_url": "shturl.cc/vZd6rD9NxsmfNZPF5KjsnB78s"\r
}'\r
```\r
\r
#### Method 2: Base64 Encoded File Content\r
```bash\r
curl -X POST "https://adp-global.laiye.com/public/v1/invoice-fast/extract" \\r
-H "Content-Type: application/json" \\r
-d '{\r
"file_base64": "\x3Cbase64-encoded-file-content>"\r
}'\r
```\r
#### Request Example in Python:\r
```python\r
import base64, requests\r
\r
with open("invoice.pdf", "rb") as f:\r
b64 = base64.b64encode(f.read()).decode()\r
\r
response = requests.post(\r
"https://adp-global.laiye.com/public/v1/invoice-fast/extract",\r
json={"file_base64": b64},\r
timeout=180,\r
)\r
print(response.json())\r
```\r
\r
### Step 3: Result Example\r
\r
| Field | Type | Description |\r
|------|------|------|\r
| `success` | boolean | Request status |\r
| `doc_type` | string | Identified document type: `invoice` or `receipt` |\r
| `extraction_result` | array | List of extracted fields and values |\r
| `aigc` | object | Metadata about the AIGC processing, including labels, producer info, and processing types |\r
| `upgrade_message` | string | Message prompting users to register for enhanced features |\r
| `signup_url` | string | URL for user registration to unlock full features |\r
\r
```json\r
{\r
"success": true,\r
"doc_type": "invoice",\r
"extraction_result": [\r
{\r
"field_key": "invoice_number",\r
"field_name": "Invoice Number",\r
"field_values": [\r
{\r
"field_value": "09071666",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "09071666"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "invoice_date",\r
"field_name": "Invoice Date",\r
"field_values": [\r
{\r
"field_value": "2019-11-28",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "2019-11-28"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "supplier_name",\r
"field_name": "Supplier Name",\r
"field_values": [\r
{\r
"field_value": "Beijing******Company",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "Beijing******Company"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "supplier_vat_number",\r
"field_name": "Supplier VAT Number",\r
"field_values": [\r
{\r
"field_value": "9111******4393T",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "9111******4393T"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "customer_name",\r
"field_name": "Customer Name",\r
"field_values": [\r
{\r
"field_value": "Hunan******Company",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "Hunan******Company"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "currency",\r
"field_name": "Currency",\r
"field_values": [\r
{\r
"field_value": "CNY",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "CNY"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "total_amount",\r
"field_name": "Total Amount (Tax Included)",\r
"field_values": [\r
{\r
"field_value": "¥1600.00",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "¥1600.00"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "line_items",\r
"field_name": "Line Items",\r
"table_values": [\r
[\r
{\r
"field_key": "line_items_item_code",\r
"field_name": "Item Code",\r
"field_values": [\r
{\r
"field_value": "",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": ""\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "line_items_description",\r
"field_name": "Description",\r
"field_values": [\r
{\r
"field_value": "Accommodation Service*Accommodation Service",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "*Accommodation Service*Accommodation Service"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "line_items_quantity",\r
"field_name": "Quantity",\r
"field_values": [\r
{\r
"field_value": "2",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "2"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "line_items_unit_price",\r
"field_name": "Unit Price",\r
"field_values": [\r
{\r
"field_value": "754.716981132",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "754.716981132"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "line_items_total_amount",\r
"field_name": "Total Amount",\r
"field_values": [\r
{\r
"field_value": "1509.43",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "1509.43"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "line_items_rate",\r
"field_name": "tax rate",\r
"field_values": [\r
{\r
"field_value": "6%",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "6%"\r
}\r
]\r
}\r
]\r
},\r
{\r
"field_key": "line_items_tax",\r
"field_name": "tax",\r
"field_values": [\r
{\r
"field_value": "90.57",\r
"field_confidence": 0.0,\r
"references": [\r
{\r
"search_text": "90.57"\r
}\r
]\r
}\r
]\r
}\r
]\r
]\r
}\r
],\r
"aigc": {\r
"Label": "AIGCLabelType.AI_GENERATED",\r
"ContentProducer": "001191110108587659081E10001",\r
"ProduceID": "e3563f165b4011f19f02d85ed35661fd",\r
"ReservedCode1": "34c55657beb0071fecf8abce14b0cdee",\r
"ContentPropagator": "001191110108587659081E10001",\r
"PropagateID": "e3563f165b4011f19f02d85ed35661fd",\r
"ReservedCode2": "34c55657beb0071fecf8abce14b0cdee",\r
"ProcessingTypes": [\r
"ocr",\r
"llm_extract"\r
]\r
},\r
"upgrade_message": "Sign up to get 100 credits per month and unlock all features, including multi-tier tax calculation, self-evolving recognition capabilities, expanded fields and enhanced performance.",\r
"signup_url": "https://adp.laiye.com/"\r
}\r
```\r
\r
## 📄 Extraction Field Reference\r
\r
## Text Fields\r
| field_key | field_name (example) | Description |\r
|-----------------------|------------------------|-----------------------------------------------------------------------------|\r
| `invoice_number` | Invoice Number | Unique identifier of the invoice. |\r
| `invoice_date` | Invoice Date | Date when the invoice was issued. |\r
| `supplier_name` | Supplier Name | Name of the issuing supplier. |\r
| `supplier_vat_number` | Supplier VAT Number | VAT registration number of the supplier. |\r
| `customer_name` | Customer Name | Name of the billed customer. |\r
| `currency` | Currency | Currency code of the invoice (e.g., USD, EUR). |\r
| `total_amount_inc_tax`| Total Amount (Inc. Tax)| Total invoice amount including tax. |\r
\r
## Table Fields\r
| field_key | field_name (example) | Description |\r
|-------------------|----------------------|-----------------------------------------------------------------|\r
| `item_code` | Item Code | Code/SKU of the line item. |\r
| `description` | Description | Description of the line item. |\r
| `quantity` | Quantity | Quantity of the line item. |\r
| `unit_price` | Unit Price | Unit price of the line item. |\r
| `total_amount` | Total Amount | Total amount of the line item. |\r
| `tax_rate` | Tax Rate | Applicable tax rate for the item (full coverage). |\r
| `tax_amount` | Tax Amount | Tax amount for the line item (full coverage). |\r
\r
## Common Field Structure\r
| Field | Type | Description |\r
|------|------|------|\r
| `field_key` | string | Field identifier |\r
| `field_name` | string | Field name |\r
| `field_values` | array | List of extracted values (supports multiple values) |\r
| `field_values[].field_confidence` | float | Confidence score (0.0 - 1.0) |\r
| `field_values[].references` | array | List of reference points in the document (e.g., bounding boxes, page numbers) |\r
| `line_items_item_code` | string | Code/SKU of the line item |\r
| `line_items_description` | string | Description of the line item |\r
| `line_items_quantity` | string | Quantity of the line item | \r
| `line_items_unit_price` | string | Unit price of the line item |\r
| `line_items_total_amount` | string | Total amount of the line item |\r
| `line_items_tax_rate` | string | Tax rate for the line item |\r
| `line_items_tax` | string | Tax amount for the line item |\r
\r
\r
> **How to distinguish field types:** If `table_values` is present → table field, read from `table_values`; otherwise → regular field, read from `field_values`.\r
\r
## ⚠️ Usage Limits\r
\r
| Item | Requirement / Limit |\r
|------|---------------------|\r
| File Size | Less than 2 MB |\r
| Page Count | Single page only. Multi-page PDF files will be rejected |\r
| Supported Formats | jpeg, .jpg, .png, .bmp, .tiff, .pdf, .doc, .docx, .xlsx, .ofd |\r
| URL Accessibility | Publicly accessible HTTP/HTTPS URL. Private network or internal IP addresses are not supported |\r
| Per IP per minute | 30 requests (within any consecutive 60 seconds) |\r
| Per IP per day | 30 requests |\r
| Global daily pool | 5,000 requests |\r
\r
When the limit is exceeded, the API returns HTTP `429` with registration guidance included in the response. \r
```json\r
{\r
"code": "rate_limited_day",\r
"message": "Daily free usage limit has been used up. Please come back tomorrow.",\r
"upgrade_message": "Sign up for 100 monthly free credits, more fields, higher performance, multi-tax support & self-optimization",\r
"signup_url": "https://adp-global.laiye.com/?utm_source=promotions-clawhub"\r
}\r
```\r
\r
## ❌ Error Codes\r
| HTTP Status Code | code | Description |\r
|-------------|------|------|\r
| 400 | `invalid_input` | No file provided, or both `file_base64` and `file_url` are passed simultaneously |\r
| 400 | `invalid_base64` | The content of `file_base64` is not valid Base64 encoding |\r
| 400 | `invalid_url` | Invalid `file_url` format (not HTTP/HTTPS) |\r
| 400 | `ssrf_blocked` | `file_url` points to an internal network or private IP address |\r
| 400 | `download_failed` | Failed to download file from `file_url` |\r
| 400 | `file_too_large` | File size exceeds 2 MB |\r
| 400 | `multi_page` | Multi-page PDF detected. Only single-page files are supported |\r
| 400 | `unsupported_format` | Unsupported file format |\r
| 429 | `rate_limited_minute` | Exceeded per-IP minute limit (30 requests within 60 seconds) |\r
| 429 | `rate_limited_day` | Exceeded per-IP daily limit (30 requests) |\r
| 429 | `rate_limited_global` | Exceeded global daily limit (5,000 requests) |\r
| 500 | `extraction_failed` | Server processing failed. Please try again later |\r
\r
\r
## 🚀 Advanced Usage\r
\r
This API uses the fixed `invoice-fast` (high-speed) model with preset field configurations, designed exclusively for a quick experience.\r
\r
**Upgrade to the full ADP account to unlock these premium capabilities:**\r
- Invoice file size exceeds 2MB\r
- Higher API call frequency & **unlimited request quotas**\r
- **Custom extraction fields** (add or remove fields as needed)\r
- Asynchronous batch processing\r
- Human-in-the-loop (HITL) review workflow\r
- Webhook callback support\r
- Support for **more document types** (purchase orders, ID cards, domestic invoices, etc.)\r
- MCP tool integration for AI clients (Claude Desktop, Cursor, etc.)\r
\r
New users will receive **100 free credits** upon registration to experience all full-function features.We provide independent Public Cloud access addresses fr domestic and international users, which need to be configured separately by region. Accessing from a nearby location can better ensure high-speed and stable invocation across the network.\r
- Users in Chinese Mainland [Log in](https://adp.laiye.com/?utm_source=promotions-clawhub)\r
- Users outside Chinese Mainland [Log in](https://adp-global.laiye.com/?utm_source=promotions-clawhub)\r
\r
## 🛠️ Support & Contact\r
- **CLI User Guide:** [ADP CLI User Guide](https://laiye-tech.feishu.cn/wiki/YIaawiK2DimisZk5KfDc8a8cnLh)\r
- **API Documentation:** [Open API User Guide](https://laiye-tech.feishu.cn/wiki/S1t2wYR04ivndKkMDxxcp2SFnKd)\r
- **ADP Product Manual:** [Public Cloud Manual](https://laiye-tech.feishu.cn/wiki/OfexwgVUQiOpEek4kO7c7NEJnAe)\r
- **Issue Tracker:** [GitHub Issues](https://github.com/Laiye-ADP/adp-skills/issues)\r
- **Email:** [email protected]\r
- **Website:** [Laiye ADP](https://laiye.com/en/product/adp-platform)\r
\r
\r
Copyright 2026 [Laiye Technology (Beijing) Co., Ltd.] All rights reserved.\r
安全使用建议
Install only if you are comfortable sending selected invoices, receipts, or public file URLs to Laiye-operated cloud endpoints. Do not submit confidential, regulated, customer, employee, tax, or payment documents unless you are authorized to share them and have reviewed Laiye's data handling, retention, regional processing, and compliance terms.
能力标签
能力评估
Purpose & Capability
The stated purpose is invoice and receipt extraction, and the documented capability is limited to user-directed API calls that submit a file URL or base64 document and return structured JSON.
Instruction Scope
The external upload behavior is explicit, but the docs do not provide meaningful privacy, retention, jurisdiction, logging, or model-training disclosures for sensitive financial documents.
Install Mechanism
The package contains markdown documentation and a license only; no executable scripts, dependencies, installer hooks, or background components were present.
Credentials
Cloud processing of invoice files is proportionate to the service purpose, and limits plus SSRF-blocking behavior are documented, but submitted documents leave the user's environment.
Persistence & Privilege
No persistence, privilege escalation, credential collection, local indexing, automatic file access, or broad mutation authority was found.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install adp-global-invoice-extraction-free - 安装完成后，直接呼叫该 Skill 的名称或使用
/adp-global-invoice-extraction-free触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial public release of adp-global-invoice-extraction-free:
- Launches a free skill for extracting and identifying invoice/receipt data in over 100 languages.
- No registration, login, or API key required—direct access via public endpoints for global and China regions.
- Supports multiple file input methods (file URL and base64 content) for both scanned images and PDFs.
- Delivers structured JSON output with detailed extraction of key invoice fields (e.g., numbers, dates, amounts, parties).
- Suitable for personal trials and daily small-batch document processing.
元数据
常见问题
ADP Global Invoice Extraction · Free API 是什么？
A limited-time free skill launched by the Laiye ADP team. It accurately identifies and extracts information from invoices and receipts in over 100 global lan... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 52 次。
如何安装 ADP Global Invoice Extraction · Free API？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install adp-global-invoice-extraction-free」即可一键安装，无需额外配置。
ADP Global Invoice Extraction · Free API 是免费的吗？
是的，ADP Global Invoice Extraction · Free API 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
ADP Global Invoice Extraction · Free API 支持哪些平台？
ADP Global Invoice Extraction · Free API 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 ADP Global Invoice Extraction · Free API？
由 Laiye ADP（@laiye-adp）开发并维护，当前版本 v1.0.0。
推荐 Skills