前言¶
企业入驻、合同审核、风控建档时,经常要把营业执照照片里的字段抄进系统。手写规则或通用 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