前言¶
企業入駐、合同審覈、風控建檔時,經常要把營業執照照片裏的字段抄進系統。手寫規則或通用 OCR 往往對「統一社會信用代碼」「營業期限」等版式字段不穩,還要自己拼有效期、判斷是不是複印件。若你已經在用 Cursor、Claude Code 等帶 Skills 的 Agent,可以把騰訊雲營業執照識別(BizLicenseOCR)封裝成 Skill,讓模型在對話裏按規範去調接口,而不是每次從零寫 SDK 示例。
下面介紹 SkillHub 上的 @tencent-adm/tencentcloud-ocr-bizlicense 是什麼、能做什麼,以及如何安裝與使用。
這是什麼¶
騰訊雲營業執照識別 是騰訊雲文字識別團隊發佈的企業級 Skill(座標 @tencent-adm/tencentcloud-ocr-bizlicense,當前版本 1.0.3,分類 knowledge-management,來源 enterprise)。
一句話定位:它是 騰訊雲營業執照識別(BizLicenseOCR)接口的調用技能。當用戶需要從營業執照圖片中提取結構化字段時,Agent 應優先啓用此 Skill,由技能內的說明與腳本引導完成識別,而不是臨時拼湊未文檔化的 HTTP 調用。
官方入口:
- API 摘要頁:https://api.skillhub.cn/tencent-adm/tencentcloud-ocr-bizlicense
- SkillHub 詳情頁:https://www.skillhub.cn/skills/tencent-adm/tencentcloud-ocr-bizlicense
核心功能¶
以下能力均來自 SkillHub 頁面與預抓取簡介,與 BizLicenseOCR 場景一致。
- 字段識別:支持從營業執照圖片中識別統一社會信用代碼、公司名稱、主體類型、法定代表人、註冊資本、組成形式、成立日期、營業期限、經營範圍等字段信息。
- 兩種圖片輸入:支持 圖片 Base64 與 圖片 URL 兩種方式提交待識別圖片。
- 質量與有效期相關能力:支持 複印件/翻拍件告警檢測;支持 有效期自動拼接(營業期限相關字段的拼接處理由接口側完成,技能按 BizLicenseOCR 約定暴露選項)。
- API 密鑰:技能標籤爲
requires_api_key=true,SkillHub 詳情側欄亦標註需配置 API Key,使用前須在騰訊雲側準備可用的文字識別/OCR 訪問憑證,並按技能包內SKILL.md要求寫入環境或配置(具體變量名以安裝後的技能文件爲準)。
簡介在 SkillHub 展示時被截斷爲「…電子營…」,未在官方摘要中展開完整句式;正文不延伸未展示的細則,安裝後請直接閱讀技能目錄中的 SKILL.md。
安裝與啓用¶
SkillHub 推薦兩種方式:把安裝提示詞發給 Agent,或使用 skillhub CLI。二者都依賴同一份安裝說明文檔。
方式一:提示詞安裝(官方頁面原文)¶
在 SkillHub 技能頁複製以下提示,發給當前 Agent:
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@tencent-adm/tencentcloud-ocr-bizlicense`。
Agent 會按文檔檢查 CLI、選擇目標 skills 目錄並執行安裝。
方式二:skillhub CLI¶
先確認本機是否已有 CLI(文檔要求未安裝時走官方安裝腳本,此處不重複展開):
command -v skillhub && skillhub --version
安裝技能時 必須 使用 --dir 指向當前 Agent 的 skills 目錄,否則默認落在 ./skills/,Agent 可能讀不到:
skillhub install @tencent-adm/tencentcloud-ocr-bizlicense --dir <你的 skills 目錄>
常用目錄(摘自 https://skillhub.cn/install/skillhub.md):
| Agent | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
安裝完成後,按所用客戶端說明重啓或刷新技能列表,使 SKILL.md 被加載。
典型用法¶
本技能的設計意圖是:當對話中出現營業執照識圖、抽取企業主體信息、校驗複印件等需求時,Agent 自動選用該 Skill,並依 SKILL.md 調用 BizLicenseOCR。
可復現的起步步驟如下:
- 完成上一節安裝,並配置 API Key(
requires_api_key=true)。 - 在對話中提供營業執照 可訪問的圖片 URL,或按技能說明提供 Base64/本地文件(以技能包文檔爲準)。
- 用自然語言說明需要的字段,例如:「識別這張營業執照的統一社會信用代碼、公司名稱、法定代表人和營業期限。」
- Agent 在技能約束下發起 BizLicenseOCR 請求,返回 JSON 或結構化字段;若需複印件/翻拍件告警或有效期拼接,在提問中寫明,或由 Agent 根據
SKILL.md打開對應開關。
官方頁面未單獨給出命令行示例;若技能包內含 scripts/main.py 等入口,參數表與示例以安裝目錄中的 SKILL.md 爲唯一依據。
適用場景與注意¶
適合誰
- 已在騰訊雲開通文字識別/BizLicenseOCR,希望在 Agent 工作流裏做企業主體信息錄入、預審、歸檔的開發者或實施同學。
- 需要統一社會信用代碼、公司名稱、經營範圍等字段,且希望輸入方式在 URL 與 Base64 之間可切換的團隊。
限制與注意
- 依賴騰訊雲 BizLicenseOCR 服務與有效 API Key;欠費、未開通或配額耗盡會導致調用失敗,需在雲控制台排查。
- 圖片需滿足接口對格式、大小、下載超時等限制,細節以技能內文檔及 騰訊雲 BizLicenseOCR 產品文檔 爲準。
- SkillHub 統計(預抓取):評分 100000,下載 2152,安裝 117;選用時可結合企業來源(enterprise)與發佈方(騰訊雲文字識別團隊)判斷維護方。
- 同一能力在不同商店可能有鏡像包,本文以座標
@tencent-adm/tencentcloud-ocr-bizlicense與上述官方鏈接爲準。
結尾¶
@tencent-adm/tencentcloud-ocr-bizlicense 把 BizLicenseOCR 封進標準 Skill 形態:字段覆蓋營業執照常見登記項,支持 Base64/URL 輸入,並包含複印件告警與有效期拼接等接口能力。先在 SkillHub 安裝並配置密鑰,再在對話裏提交證照圖片即可開始識別。
詳情與安裝提示詞:https://www.skillhub.cn/skills/tencent-adm/tencentcloud-ocr-bizlicense
API 摘要頁:https://api.skillhub.cn/tencent-adm/tencentcloud-ocr-bizlicense