borschai/uk-sic-codes
GitHub: borschai/uk-sic-codes
一个用于英国 SIC 2007 行业分类代码快速查找、模糊搜索和验证的零依赖工具库,同时支持 Node.js 和 Python 平台。
Stars: 0 | Forks: 0
# uk-sic-codes
适用于 Node.js 和浏览器的快速、零依赖 UK SIC 2007 代码查找、搜索和验证库。
[](https://www.npmjs.com/package/uk-sic-codes)
[](https://pypi.org/project/uk-sic-codes/)
[](https://opensource.org/licenses/MIT)
也可作为 [Python 包](https://pypi.org/project/uk-sic-codes/) 提供(`pip install uk-sic-codes`)。
## 功能
- 完整的 UK SIC 2007 数据库(**731 个代码**,21 个部分,88 个部门)
- 带相关性评分的模糊关键词搜索
- 代码验证(4 或 5 位数字格式)
- 部分和部门浏览
- 完整的分层树状结构
- 零依赖
- 包含 TypeScript 类型
- 适用于 Node.js 和浏览器
- 支持 ESM 和 CommonJS
## 安装
```
npm install uk-sic-codes
```
## 快速开始
```
import { lookup, search, validate } from "uk-sic-codes";
// Look up a code
const code = lookup("62012");
// {
// code: "62012",
// description: "Business and domestic software development",
// section: "J",
// sectionName: "Information and Communication",
// division: "62",
// group: "620",
// classCode: "6201"
// }
// Search by keyword
const results = search("restaurant");
// [
// { code: "56101", description: "Licenced restaurants", ... },
// { code: "56102", description: "Unlicenced restaurants and cafes", ... },
// ...
// ]
// Validate a code
validate("62012"); // true
validate("00000"); // false
```
## API
### `lookup(code: string): SICCode | null`
通过数字字符串查找 SIC 代码。接受 4 位或 5 位数字的代码。
```
lookup("62012"); // Business and domestic software development
lookup("1110"); // Growing of cereals (auto-pads to 01110)
lookup("62.01.2"); // Also works (strips punctuation)
```
### `search(query: string, limit?: number): SICCode[]`
通过关键词搜索代码。不区分大小写,并带有相关性评分。
```
search("software"); // All software-related codes
search("coal mining"); // Multi-word search
search("manufacture", 5); // Limit to 5 results
```
### `validate(code: string): boolean`
检查字符串是否为有效的 UK SIC 2007 代码。
```
validate("62012"); // true
validate("99999"); // true (Dormant Company)
validate("abc"); // false
validate("00000"); // false
```
### `listSection(letter: string): SICCode[]`
获取某个部分(A-U)的所有代码。
```
listSection("J"); // All Information and Communication codes
listSection("A"); // All Agriculture codes
```
### `listDivision(code: string): SICCode[]`
获取某个 2 位数部门的所有代码。
```
listDivision("62"); // IT activities (62011, 62012, 62020, 62030, 62090)
listDivision("56"); // Food service (56101, 56102, 56103, ...)
```
### `tree(): SICSection[]`
获取完整的层级结构:包含所有部门及其代码的所有部分。
```
const hierarchy = tree();
// [
// { letter: "A", name: "Agriculture...", divisions: ["01","02","03"], codes: [...] },
// { letter: "B", name: "Mining...", divisions: ["05","06",...], codes: [...] },
// ...
// ]
```
### `sections(): Array<{ letter: string; name: string }>`
获取所有 21 个部分的字母和名称。
```
sections();
// [
// { letter: "A", name: "Agriculture, Forestry and Fishing" },
// { letter: "B", name: "Mining and Quarrying" },
// ...
// ]
```
### `count(): number`
获取数据库中的代码总数。
```
count(); // 731
```
## 类型
```
interface SICCode {
code: string; // 5-digit code, e.g. "62012"
description: string; // Full description
section: string; // Section letter, e.g. "J"
sectionName: string; // Section name, e.g. "Information and Communication"
division: string; // 2-digit division, e.g. "62"
group: string; // 3-digit group, e.g. "620"
classCode: string; // 4-digit class, e.g. "6201"
}
interface SICSection {
letter: string; // Section letter
name: string; // Section name
divisions: string[]; // 2-digit division codes
codes: string[]; // All 5-digit codes in this section
}
```
## 数据来源
基于 Companies House 和 [国家统计局](https://www.ons.gov.uk/methodology/classificationsandstandards/ukstandardindustrialclassificationofeconomicactivities/uksic2007) 发布的官方 [UK SIC 2007 简明列表](https://resources.companieshouse.gov.uk/sic/)。
## 需要更多公司数据?
本包提供 SIC 代码查找功能。如需完整的英国公司数据——涵盖 590 万家公司的搜索、风险评分、董事网络、政府信号以及 AI 驱动的分析——请访问 [borsch.ai](https://borsch.ai)。
## 许可证
MIT
标签:CMS安全, CommonJS, ESM, GNU通用公共许可证, JavaScript, MITM代理, Node.js, npm包, Python, SIC 2007, TypeScript, UK SIC, 代码查询, 代码验证, 企业合规, 安全插件, 开源库, 搜索引擎爬虫, 数据可视化, 数据查找, 数据验证, 无后门, 暗色界面, 标准行业分类, 模糊搜索, 浏览器, 自动化攻击, 英国SIC代码, 行业分类, 逆向工具, 零依赖