Business License Ocr
📖 技能介紹
name: business_license_ocr description: 精準識別中國大陸本營業執照。自動提取統一社會信用程式碼、企業名稱、法定代表人、註冊資本、成立日期、經營範圍、住所等資訊。 version: 1.0.5 author: SCNet license: MIT tags: - OCR - 證件識別 - 營業執照識別 - 企業資質識別 required_env_vars: - SCNET_API_KEY - SCNET_API_BASE # 可選，但有預設值 primary_credential: SCNET_API_KEY dependencies: - python3 - requests input: - ocrType : 識別型別，可選值見下文 - filePath : 待識別圖片的本地路徑 output: 結構化的 JSON 資料，包含識別結果和置信度
Sugon-Scnet 營業執照 OCR 技能
本技能封裝了 Sugon-Scnet 營業執照 OCR 服務，通過單一介面即可呼叫 1 種識別能力，高效提取文字及票據資訊。
🚨 重要隱私與安全警告（使用前必讀）
1. 資料外傳性質
本技能會將您提供的營業執照圖片，通過網路傳輸至第三方服務商（api.scnet.cn） 進行 OCR 處理。圖片資料會離開您的本地裝置，並非在本地離線處理。2. 資料的敏感性
營業執照包含以下高度敏感的商業資訊： - 企業身份：統一社會信用程式碼、企業名稱、法定代表人、住所（註冊地址）。 - 財務與運營：註冊資本、成立日期、經營範圍、營業期限。 - 登記資訊：登記機關、發證日期。 > 這些資訊一旦洩露，可能被用於假冒企業註冊、商業欺詐、合同詐騙等違法活動，對企業聲譽和經營造成嚴重影響。3. 資料用途與保留 - 用途：上傳的資料僅用於本次文本識別請求，服務商不會用於其他目的。 - 保留期限：請查閱服務商（
scnet.cn）官方隱私政策。強烈建議您在獲取識別結果後，立即手動刪除本地圖片及任何快取副本，以最大程度降低資料暴露風險。4. 法律合規與授權
使用本技能處理非本企業或未經授權的營業執照時，您必須確保已獲得該企業資訊主體的明確授權。未經授權處理他人商業資訊可能違反《個人資訊保護法》及《反不正當競爭法》等相關法律法規。5. 使用者知情同意
使用本技能即表示您已閱讀、理解並同意上述資料處理方式，並自願承擔因不當使用、未授權處理或資料洩露所引發的一切法律責任。
功能特性
- 行業資質：識別營業執照（統一社會信用程式碼、企業名稱等）。
前置配置
⚠️ 重要：使用前需要申請 Scnet API Token
申請 API Token
- 訪問 Scnet 官網 註冊/登入
- 在控制台申請 API 金鑰（格式：
sc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx） - 複製金鑰備用
配置 Token
手動配置（推薦）
1. 在技能目錄下建立 config/.env 檔案，內容如下：
# ===== Sugon-Scnet OCR API 配置 =====
# 申請地址：https://www.scnet.cn
SCNET_API_KEY=your_scnet_api_key_here
# API 基礎地址（一般無需修改）
SCNET_API_BASE=https://api.scnet.cn/api/llm/v1
- 新增：
SCNET_API_KEY=你的金鑰 - 設定檔案許可權為 600（僅所有者可讀寫） ⚠️ 安全警告：切勿將 API Key 直接貼上到聊天對話中，否則可能被記錄或洩露。
Token 更新
Token 過期後呼叫會返回 401 或 403 錯誤。更新方法：重新申請 Token 並替換 config/.env 中的 SCNET_API_KEY。
依賴安裝
本技能需要 Python 3.6+ 和 requests 庫。請執行以下命令：
pip install requests
使用方法
引數說明
來源於7w4.net。
| 引數名 | 型別 | 必填 | 描述 |
|---|---|---|---|
| ocrType | string | 是 | 識別型別列舉。必須為以下之一： • BUSINESS_LICENSE（營業執照） |
| filePath | string | 是 | 待識別圖片的本地絕對路徑。支援 jpg、png、pdf 等常見格式。 |
命令列呼叫示例
python .claude/skills/sugon-scnet-ocr/scripts/main.py BUSINESS_LICENSE /path/to/invoice.jpg
在 AI 對話中使用
使用者可以說：
- “請識別這張營業執照上的統一社會信用程式碼和企業名稱，圖片在 /Desktop/license.jpg”
- “幫我提取這個營業執照的法定代表人和註冊資本，路徑是 /Users/name/Downloads/license.png”
AI 會根據 description 中的關鍵詞自動觸發本技能。
AI 呼叫建議
為避免觸發 API 速率限制（10 QPS），請序列呼叫本技能，即等待前一個識別完成後再發起下一個請求。 如果使用 OpenClaw 的 exec 工具，建議設定 timeout 或 yieldMs 引數，讓命令同步執行，避免多個命令同時執行導致併發。
配置選項
編輯 config/.env 檔案：
| 變數名 | 預設值 | 說明 |
|---|---|---|
| SCNET_API_KEY | 必需 | Scnet API 金鑰 |
| SCNET_API_BASE | https://api.scnet.cn/api/llm/v1 | API 基礎地址（一般無需修改） |
輸出
- 標準輸出：識別結果的 JSON 資料，結構與 API 文件一致，位於
data欄位內。 - 識別結果位於 data[0].result[0].elements 中，具體欄位取決於 ocrType。
- 錯誤資訊：如果發生錯誤，會輸出以
錯誤:開頭的友好提示。
注意事項
- 本技能呼叫的 OCR API 有 10 QPS 的速率限制。
- 如果遇到 429 錯誤，請等待 2-3 秒後重試，不要連續發起請求。
- 建議在呼叫前確保圖片已準備就緒，避免因網路問題導致重複呼叫。
故障排除
| 問題 | 解決方案 |
|---|---|
| 配置檔案不存在 | 建立 config/.env 並填入 Token（參考前置配置） |
| API Key 無效/過期 | 重新申請 Token 並更新 .env 檔案 |
| 檔案不存在 | 檢查提供的檔案路徑是否正確 |
| 網路連線失敗 | 檢查網路連線或防火牆設定 |
| 不支援的檔案型別 | 確保副檔名為允許的型別（參考 API 文件） |
| 401/403/Unauthorized | Token 無效或過期，重新申請並配置 |
| 429 Too Many Requests | 請求過於頻繁，技能會自動等待並重試（最多 3 次）。若持續失敗，請降低呼叫頻率或聯絡服務方提高限額。 |
🤖 AI 評測
這是一個功能單一但實用的營業執照識別工具，質量良好。文件清晰易懂，錯誤處理完善，即使出錯也知道如何解決。使用時需要先到指定網站獲取API Key，略有一定門檻。指令碼執行邏輯清晰，能正確處理各種異常情況。適合需要快速識別營業執照資訊的場景使用。
