AI Agent Hub
Back to skills
Tencent Cloud Business License OCR icon

Tencent Cloud Business License OCR

Knowledge Management Updated 2026.08.30

Paste the following prompt into your AI chat to install this skill:

Install @tencent-adm/tencentcloud-ocr-bizlicense according to https://skillhub.cn/install/skillhub.md.

About this skill

Problem

Business license images contain structured business data, but manual entry can miss fields such as the unified social credit code, legal representative, and business term. This skill is for engineering workflows that need to turn business license images into JSON fields, such as form prefill, enterprise data collection, post-OCR validation, or compliance checks. It wraps the Tencent Cloud BizLicenseOCR API instead of requiring business code to assemble the request directly.

How It Works

The skill accepts ImageBase64 or ImageUrl, with ImageUrl taking priority when both are provided. By default, it returns basic fields such as company name, unified social credit code, registered capital, legal representative, address, business scope, entity type, business term, composition form, and establishment date. It can also return extended fields including registration date, registration authority, title, number, and important notice.

  • Warning detection: With EnableCopyWarn, it can return black-and-white copy warnings -9102 and reshoot warnings -9104, which help downstream risk control or manual review.
  • Business certificate routing: With EnableBusinessCertificate, it first calls a card/document classification model. If the image is classified as a business license, it uses the original engine; if classified as an enterprise license, it uses the BizLicenseNew engine; otherwise it returns FailedOperation.NoBizLicense.
  • Electronic licenses: The result can identify electronic business licenses through the Electronic field, and may include auxiliary signals such as whether the image is a copy, rotation angle, and presence of the national emblem, QR code, or seal.

Boundaries And Notes

Images must be PNG/JPG/JPEG, with Base64 payload no larger than 7 MB, and GIF is not supported. The default request rate is 10 requests per second. EnablePeriodComplete is enabled by default and automatically concatenates the business period. Callers should handle errors such as FailedOperation, LimitExceeded, and ResourceUnavailable when the image is invalid, too large, or the account/resource state is wrong.

Use Cases

  • During enterprise onboarding, extract company name, unified social credit code, and legal representative from uploaded business license images to prefill qualification forms.
  • In supplier access review, recognize the business license and enable `EnableCopyWarn` to detect black-and-white copies or reshoot warnings for manual verification.
  • In document routing workflows, enable `EnableBusinessCertificate` to separate business licenses from enterprise licenses and send them to the correct processing engine.
  • In batch data collection, call the API with `ImageUrl` to return structured JSON fields while handling exceptions such as `FailedOperation.NoBizLicense`.

Best For

  • Engineering teams handling enterprise onboarding who need to extract the unified social credit code, company name, and business scope from license images.
  • Backend engineers building supplier qualification checks who need to detect copies or reshoots and return risk-control warning codes.
  • Platform engineers building document routing pipelines who need to separate business licenses from enterprise licenses and handle non-license errors.
  • Automation engineers storing enterprise data who need to convert license images into structured JSON while supporting electronic license fields.