Content
# Tool List
> **All-in-one AI Document Scanning and Processing Open Platform** — 36 AI capabilities, 5 integration methods, covering text recognition, file scanning, format conversion, and AIGC.
---
<p>Official Website: https://scan.quark.cn/business</p>
<p>Cooperation Hotline: 4009030958</p>
<p>Cooperation Email: quark-ai@service.alibaba.com</p>
---
<p>
<img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg">
<img alt="Python" src="https://img.shields.io/badge/python-3.9%2B-green.svg">
<img alt="OpenClaw" src="https://img.shields.io/badge/OpenClaw-Compatible-orange.svg">
<img alt="Platform" src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg">
<img alt="Scenes" src="https://img.shields.io/badge/scenes-30%2B-brightgreen.svg">
<img alt="Stars" src="https://img.shields.io/github/stars/YOUR_ORG/openclaw-yescan-skills?style=social">
</p>
---
## Table of Contents
- [Platform Introduction](#platform-introduction)
- [Core Advantages](#core-advantages)
- [Capability Overview](#capability-overview)
- [Text Recognition OCR (19 items)](#text-recognition-ocr19-items)
- [File Scanning (13 items)](#file-scanning-13-items)
- [Format Conversion (3 items)](#format-conversion-3-items)
- [AI ID Photo AIGC (1 item)](#ai-id-photo-aigc1-item)
- [Five Integration Methods](#five-integration-methods)
- [User Scenarios](#user-scenarios)
- [Customer Cases](#customer-cases)
- [Billing Plan](#billing-plan)
- [Quick Start](#quick-start)
- [FAQs](#faqs)
- [Contact Us](#contact-us)
---
## Platform Introduction
Quark Scan Open Platform is an AI document processing PaaS platform under Alibaba's Intelligent Information Business Unit, originating from Quark Scan App's core AI technology precipitation for hundreds of millions of users.
The platform provides **36 AI capabilities** for B-end developers and enterprises, covering text recognition (OCR), file scanning enhancement, format conversion, and AI ID photo generation. It supports **20+ language recognitions**, with a daily processing capacity of up to millions.
**One API, 36 capabilities** — All capabilities are accessed through a unified Vision API endpoint. Developers only need to switch parameters to call different capabilities, greatly reducing integration costs.
---
## Core Advantages
### 🎯 **High-precision Text Recognition**
Deep learning-based OCR engine, with industry-leading accuracy, accurately recognizes printed, handwritten, mathematical formulas, and multi-language mixed-arranged complex scenes.
### 📐 **Intelligent Layout Restoration**
Large model deep understanding of document layout structure, tables, mixed graphics and text, multi-column layout can be accurately restored, outputting Word/Excel/PDF documents that keep the original layout.
### 🔍 **Extremely High-quality Scanning**
Ultra-clear scanning quality, intelligent identification and erasure of handwritten words, watermarks, shadows, screen textures, and other impurities, restoring clean and clear document images.
### 🔌 **Five Integration Methods**
API / MCP / OpenClaw / CLI / Hermes Agent — covering direct integration, AI Agent collaboration, command-line scripts, and other full-scenario access, with 1-minute access completion.
### 🛡️ **Enterprise-level Security**
SHA3-256 signature authentication + multi-layer current limiting (global QPS / account QPS / capability frequency) + data non-falling disk options, meeting enterprise-level security compliance requirements.
---
## Capability Overview
```
┌──────────────────────────────────────────────────────────────────────┐
│ Quark Scan Open Platform · 36 AI Capabilities │
├─────────────┬────────────────────────────────────────────────────────┤
│ Text Recognition OCR │ 19 items: General Text / Handwritten Text / Table / ID Card / │
│ (19 items) │ Business License / Social Security Card / Driving License / │
│ │ VAT Invoice / Train Ticket / Hong Kong and Macau Travel Permit / │
│ │ Degree Certificate / Formula / Question / Overseas Bill / │
│ │ Medical Report / Drug Report / Commodity Picture / Picture Translation │
├─────────────┼────────────────────────────────────────────────────────┤
│ File Scanning │ 13 items: Scan File / Test Paper Enhancement / ID Card and │
│ (13 items) │ Bill Enhancement / Handwriting Removal / Watermark Removal / │
│ │ Shadow Removal / Screen Texture Removal / Image Quality Enhancement / │
│ │ Document Background Removal / Contract Organization / Sketch / │
│ │ Line Draft Extraction / Image Cropping and Correction │
├─────────────┼────────────────────────────────────────────────────────┤
│ Format Conversion │ 3 items: Image to Word / Image to Excel / Image to PDF │
│ (3 items) │ │
├─────────────┼────────────────────────────────────────────────────────┤
│ AI ID Photo │ 1 item: Intelligent ID Photo Generation (9 styles / 3 colors / │
│ (1 item) │ Clarity Adjustment) │
└─────────────┴────────────────────────────────────────────────────────┘
```
### Text Recognition OCR (19 items)
Full coverage of recognition capabilities from general text to vertical scenes, supporting printed, handwritten, and structured field extraction.
| Capability | Description | Applicable Scenes |
|------|------|---------|
| **General Text Recognition** | Supports 20+ languages, returns text content and coordinates | Document digitalization, content extraction |
| **Handwritten Text Recognition** | High-precision recognition of handwritten text | Handwritten notes, annotation recognition |
| **Table Recognition** | Structured extraction of tables, including row and column merging | Financial statements, data entry |
| **ID Card Recognition** | Full-field structured extraction of front and back sides | Real-name authentication, account opening |
| **Business License Recognition** | 14-field structured extraction | Enterprise access review |
| **VAT Invoice** | Full-information extraction of invoice | Reimbursement, financial system |
| **Driving License / Vehicle License** | Key information structured extraction | Vehicle management, insurance |
| **Social Security Card / Hong Kong and Macau Travel Permit / Degree Certificate** | Structured recognition of ID cards | Government, personnel management |
| **Train Ticket / Overseas Bill** | Bill information extraction | Travel reimbursement |
| **Formula Recognition** | LaTeX formula output | Education, academic |
| **Question Recognition** | Structured splitting of test questions | Education technology, online learning |
| **Medical Report / Drug Report** | Professional medical document recognition | Medical informatization |
| **Commodity Picture Recognition** | Commodity label + barcode recognition | E-commerce, retail |
| **Picture Translation** | Translation of text in pictures and embedding in original picture | Cross-language document processing |
### File Scanning (13 items)
AI-driven document image enhancement and processing, restoring mobile phone-scanned documents to scanner-level quality.
| Capability | Description | Applicable Scenes |
|------|------|---------|
| **Scan File** | Intelligent cropping + correction + enhancement, one-click generation of scanned file | Document archiving, digitalization |
| **Test Paper Enhancement** | Test paper-specific optimization, improving clarity | Education scene |
| **ID Card and Bill Enhancement** | ID card picture quality optimization | Identity authentication |
| **Handwriting Removal** | Intelligent erasure of handwritten words, retaining printed content | Test paper correction, document sorting |
| **Watermark Removal** | Removing document watermarks | Document restoration |
| **Shadow Removal** | Eliminating photographing shadows | Mobile phone-scanned documents |
| **Screen Texture Removal** | Eliminating screen-flipped Moire patterns | Screen flipping |
| **Image Quality Enhancement** | Low-resolution image super-clear enhancement | Old documents |
| **Document Background Removal** | Removing colored backgrounds and converting to pure white | Document printing |
| **Contract Organization** | Contract document-specific organization and enhancement | Legal scene |
| **Sketch** | Photo conversion to sketch style | Creative application |
| **Line Draft Extraction** | Extracting image outline lines | Design reference |
| **Image Cropping and Correction** | Automatic detection of document boundary cropping | Document scanning pre-processing |
### Format Conversion (3 items)
Intelligent conversion of image-level documents to editable files, maintaining original layout.
| Capability | Description | Output Format |
|------|------|---------|
| **Image to Word** | Retaining original layout, generating Word document | .docx |
| **Image to Excel** | Converting table pictures to editable tables | .xlsx |
| **Image to PDF** | Converting image documents to searchable PDF | .pdf |
### AI ID Photo AIGC (1 item)
Large model-driven intelligent ID photo generation, supporting rich customization options.
| Function | Options |
|------|------|
| **Style** | Original, delicate, rosy, matte, white, skin, child, Korean, natural (9 styles) |
| **Background Color** | Red, white, blue |
| **Clarity** | 4-level adjustable (0-3) |
| **Applicable Scenes** | Employee entry, exam registration, social security, loan application, visa application, resume making |
---
## Five Integration Methods
### Method 1: **Direct API Integration (Recommended)**
The most standard integration method, suitable for teams with back-end development capabilities to directly embed into business systems.
```
POST https://scan-business.quark.cn/vision
Content-Type: application/json
```
**Python Code Example**:
```python
from time import time
import requests, uuid, hashlib
client_id = "your-client-id"
client_secret = "your-client-secret"
sign_nonce = uuid.uuid4().hex
timestamp = int(time() * 1000)
# SHA3-256 signature
raw = f"{client_id}_vision_SHA3-256_{sign_nonce}_{timestamp}_{client_secret}"
signature = hashlib.sha3_256(raw.encode("utf-8")).hexdigest()
resp = requests.post("https://scan-business.quark.cn/vision", json={
"dataUrl": "https://example.com/document.jpg",
"dataType": "image",
"serviceOption": "ocr",
"inputConfigs": '{"function_option":"RecognizeGeneralDocument"}',
"clientId": client_id,
"signMethod": "SHA3-256",
"signNonce": sign_nonce,
"timestamp": timestamp,
"signature": signature
})
print(resp.json())
```
### Method 2: **MCP Protocol Integration**
AI Agent collaboration mode, configuring once to obtain **32 capabilities**. Supporting Claude Code / Cursor / VSCode / Cline and other mainstream AI development tools.
**Server URL**:
```
https://scan-mcp.quark.cn/mcp?aiApiKey=your-api-key
```
**Claude Code Integration**:
```bash
claude mcp add --transport http quark-scan-business-mcp \
"https://scan-mcp.quark.cn/mcp?aiApiKey=your-api-key"
```
**Cline Integration**: VS Code installation of Cline extension → MCP Server configuration → Fill in Server URL → Select Streamable HTTP protocol.
### Method 3: **Skill Integration**
OpenClaw and other Agent Skill integration, the lightest, with 3 aggregated Skill packages covering all capabilities:
| Skill Package | Covered Capabilities | Download Address |
|----------|---------|---------|
| OCR Recognition | General / Handwritten / Table / ID Card / Bill, etc. | `https://cdn.sm.cn/static/yescan-ocr-universal.zip` |
| File Scanning | Document / ID Card / Contract, etc. scanning enhancement | `https://cdn.sm.cn/static/yescan-scan-universal.zip` |
| Office Conversion | Image to Word / Excel / PDF | `https://cdn.sm.cn/static/yescan-transoffice-universal.zip` |
### Method 4: **CLI Command Line Integration**
Developer-friendly command-line tool, suitable for script processing and rapid testing.
```bash
# Installation
pip install yescan
# API Key configuration
yescan config set SCAN_WEBSERVICE_KEY your-api-key
# Usage - one-click invocation by scene name
yescan -s general-ocr -p ./document.jpg # General OCR
yescan -s idcard-ocr -p ./id_card.jpg # ID Card Recognition
yescan -s image-to-word -p ./paper.jpg -o ./out/ # Image to Word
yescan -s remove-watermark -p ./watermarked.jpg # Watermark removal
yescan --list-scenes # View all available scenes
```
### Method 5: **Hermes Agent Integration**
Through Hermes Agent skill package mode integration, sending pictures + instructions in the dialog box to use.
```bash
# Install skill
/path/to/yescan-ocr-universal.zip install this skill
# Configure environment variables
echo 'SCAN_WEBSERVICE_KEY=your-api-key' >> ~/.hermes/.env
# Usage
https://img.example.com/doc.jpg extract text information
```
### Integration Method Comparison
| Characteristics | API | MCP | OpenClaw | CLI | Hermes |
|------|-----|-----|----------|-----|--------|
| Suitable Scenes | Business system integration | AI Agent collaboration | Lightweight / Agent | Script / testing | Conversational |
| Development Threshold | Medium | Low | Low | Low | Low |
| Capability Coverage | All 36 items | 32 items | All (by package) | All | All (by package) |
| Requires Coding | ✅ | ❌ Configuration ready | ❌ | ✅ Command line | ❌ |
| Custom Parameters | ✅ Fully controllable | ⚠️ Limited | ⚠️ Limited | ✅ Fully controllable | ⚠️ Limited |
---
## User Scenarios
### 📚 **Education Industry**
- **Test Paper Digitalization**: Test paper enhancement + handwritten removal → Clean electronic version of test paper
- **Question Recognition**: Automatically split and recognize each question from test paper images
- **Formula Recognition**: Math formulas to LaTeX, automatically entered into question bank
- **Homework Correction**: Handwritten text recognition + handwritten removal, separating student answers from original questions
### 🏦 **Financial Industry**
- **Bill Recognition**: VAT invoice, train ticket, and other bills automatically entered into reimbursement system
- **Business License Review**: Automatically extract 14 fields, enterprise access automation
- **Contract Management**: Contract organization + general text recognition + image to PDF
- **Identity Authentication**: ID card recognition + face comparison
### 🏛️ **Government Industry**
- **ID Card Digitalization**: ID card, driving license, social security card, etc. batch recognition
- **Document Archiving**: Scanned file + shadow removal + image quality enhancement → High-quality electronic archives
- **Table Data Entry**: Table recognition → Excel, eliminating manual entry
### 🏥 **Medical Industry**
- **Medical Report Digitalization**: Structured extraction of medical report and drug inspection reports
- **Prescription Recognition**: Handwritten prescription text recognition
- **Medical Record Archiving**: Scanning + background removal + OCR → Searchable electronic medical records
### 🛒 **E-commerce and Retail**
- **Commodity Information Extraction**: Commodity picture text + barcode recognition
- **Product Picture Watermark Removal**: Remove competitor watermarks, obtain clean materials
- **Picture Translation**: Cross-border e-commerce product picture multi-language translation
### 🚗 **Vehicle and Logistics**
- **Driving License / Vehicle License**: Vehicle information automatic entry
- **Overseas Bill**: Cross-border logistics bill recognition
- **Cargo Bill Scanning**: Scanned file + correction enhancement
### 👤 **Personal / HR**
- **ID Photo Generation**: 9 styles × 3 colors background, one-click generation for job application, visa, exam
- **Resume Scanning**: Paper resume → Editable electronic document
- **Note Digitalization**: Handwritten note recognition + image to Word
---
## Customer Cases
### Case 1: **Education Technology Company - Automated Question Bank Construction**
**Pain Point**: Tens of thousands of test papers need manual entry into question bank, very inefficient.
**Solution**:
1. Test paper enhancement → Handwritten removal → General OCR recognition
2. Formula recognition → LaTeX format directly into database
3. Table recognition → Answer sheet automatic scoring
**Effect**: Question bank construction efficiency **10x** improvement, labor cost reduction **80%**.
### Case 2: **Financial Institution - Bill Reimbursement Automation**
**Pain Point**: Thousands of reimbursement bills processed monthly, high manual entry error rate.
**Solution**:
1. VAT invoice recognition → Full-field automatic extraction
2. Train ticket / Commercial invoice recognition → Travel expense automatic summary
3. Business license recognition → Supplier information automatic review
**Effect**: Invoice processing time from **3 minutes / bill** reduced to **3 seconds / bill**, accuracy **99%+**.
### Case 3: **Law Firm - Contract Digitalization**
**Pain Point**: Thousands of paper contracts difficult to read, key information retrieval efficiency low.
**Solution**:
1. Scanned file → Shadow removal → Image quality enhancement → High-definition electronic archive
2. General text recognition → Full content extraction → Full-text search
3. Image to PDF → Searchable PDF archiving
**Effect**: Contract retrieval time from **hours** shortened to **seconds**.
---
## Billing Plan
### Billing Model
By invocation count, providing multiple package deals, prepaid + quota management.
### Free Experience
Register and give away free experience quota, zero-cost try all capabilities.
### Tool List
| Tool Package | Included Capabilities | Description |
|-------------|----------------------|-------------|
| **OCR Identification Package** | 19 text recognition capabilities | General text, ID documents, invoices, formulas, etc. |
| **File Scanning Package** | 13 scanning enhancement capabilities | Scanning, handwritten removal, watermark removal, enhancement, etc. |
| **Format Conversion Package** | 3 format conversion capabilities | Image to Word / Excel / PDF |
| **AIGC Package** | 1 AI generation capability | ID photo generation |
### How to Purchase
1. Log in to the [Developer Backend](https://scan.quark.cn/business)
2. Go to "Management Center" → "Purchase Packages"
3. Select the required package and specifications
4. Supports Alipay / WeChat Pay
## Quick Start
### Step 1: Obtain API Key
1. Visit https://scan.quark.cn/business
2. Click "Developer Backend", register/login with mobile number
3. Obtain **API Key ID** (clientId) and **API Key** (clientSecret) in the backend
### Step 2: Choose Access Method
| Your Needs | Recommended Method |
|-------------|--------------------|
| I have a backend development team | Direct API access |
| I'm using AI Agent (Claude/Cursor/Cline) | MCP access |
| I want to experience it quickly | CLI access (`pip install yescan`) |
| I'm using OpenClaw / Hermes | Corresponding Agent access |
### Step 3: Make a Call
Using CLI as an example, 3 commands can be completed:
```bash
pip install yescan
yescan config set SCAN_WEBSERVICE_KEY your-api-key
yescan -s general-ocr -p ./test.jpg
```
### Image Format Requirements
| Requirement | Specification |
|--------------|--------------|
| Supported Formats | PNG / JPG / JPEG / BMP / GIF / TIFF / WebP |
| Image Size | 15px < length/width < 8192px, aspect ratio < 50 |
| File Size | ≤ 10MB, recommended 1.5MB |
## Frequently Asked Questions
### Q: Can one API Key call all capabilities?
A: Yes, all 36 capabilities share the same API Key, and different capabilities are switched through `serviceOption` + `function_option` parameters.
### Q: Does it support PDF input?
A: Some capabilities support PDF input (such as general text recognition), and specific capabilities are documented. Image input is the main recommended method.
### Q: What is the QPS limit?
A: Different QPS quotas are available according to package types. If high concurrency is required, please contact business to customize the solution.
### Q: How is data security ensured?
A: SHA3-256 signature authentication, HTTPS encryption in the transmission layer, support for file non-disk options, and compliance with enterprise-level data security specifications.
### Q: How to troubleshoot errors?
A: Please refer to the error code table:
| Error Code | Meaning | Solution |
|------------|----------|---------|
| `00000` | Success | — |
| `A0100` | Access unauthorized | Check if API Key is correct |
| `A0202` | Invalid timestamp | Check client time synchronization |
| `A0300` | Exceeds QPS limit | Reduce frequency or upgrade package |
| `A0301` | Exceeds daily call limit | Wait for the next day to reset or upgrade |
| `A0400` | Image parsing failed | Check image format and size |
| `B0101` | System timeout | Retry |
## Contact Us
| Channel | Information |
|----------|------------|
| 🌐 Official Website | https://scan.quark.cn/business |
| 📞 Cooperation Hotline | 4009030958 |
| 📧 Cooperation Email | quark-ai@service.alibaba.com |
| 📖 Development Documentation | https://scan.quark.cn/blm/scank-business-docs-703/docs-v2 |
*© 2025 Alibaba Intelligent Information Business Group · Quark Scan King Team*
MCP Config
Below is the configuration for this MCP Server. You can copy it directly to Cursor or other MCP clients.
mcp.json
Connection Info
You Might Also Like
No recommendations available