Medical Invoice Ocr
📖 技能介紹
name: medical_invoice_ocr description: 支援識別醫療發票識別。 version: 1.1.3 author: SCNet license: MIT tags: - OCR - 證件識別 - 發票識別 - 文字提取 required_env_vars: - SCNET_API_KEY optional_env_vars: - SCNET_API_BASE primary_credential: SCNET_API_KEY dependencies: - python3 - requests input: - ocrType : 識別型別，可選值見下文 - filePath : 待識別圖片的本地路徑 output: 結構化的 JSON 資料，包含識別結果和置信度
Sugon-Scnet 醫療發票識別 OCR 技能
本技能封裝了 Sugon-Scnet 醫療發票識別 OCR 服務，通過單一介面即可呼叫 1 種識別能力，高效提取文字及票據資訊。
功能特性
- 醫療票據：覆蓋醫療發票識別，自動提取關鍵欄位。
前置配置
⚠️ 重要：使用前需要申請 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
使用方法
引數說明
| 引數名 | 型別 | 必填 | 描述 |
|---|---|---|---|
| ocrType | string | 是 | 識別型別列舉。必須為以下之一： • MEDICAL_INVOICE（醫療發票） |
| filePath | string | 是 | 待識別圖片的本地絕對路徑。支援 jpg、png、pdf 等常見格式。 |
命令列呼叫示例
python .claude/skills/medical_invoice_ocr/scripts/main.py MEDICAL_INVOICE /path/to/invoice.jpg
在 AI 對話中使用
使用者可以說：
- “幫我識別這張醫療發票，圖片在 /Users/name/Downloads/id.jpg”
AI 會根據 description 中的關鍵詞自動觸發本技能。
AI 呼叫建議
小蔥技能7w4.net有完整的技能分類。
為避免觸發 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限流問題。不足之處是功能比較單一，只能識別醫療發票這一種型別，而且需要使用者自行申請API金鑰才能使用。總體來說質量中規中矩，適合有醫療發票識別需求的特定場景使用。
