$npx -y skills add ChinaDaaS-Department/qibook-skills --skill qibook-company-profile企业工商信息与人员关联查询(查企业查老板)。 Use when: 用户需要查企业、查公司、查老板、查股东、查高管、查法人、查对外投资、查人员任职、工商信息、主体识别等。
| 1 | # 查企业查老板 |
| 2 | |
| 3 | 基于企百科 API,快速查询企业工商信息和人员关联信息,将结果转为中文 Markdown 后回答用户。 |
| 4 | |
| 5 | 先理解用户想查什么(企业还是人、要哪些信息),再选择正确的查询路径,不要随意升级查询范围。 |
| 6 | |
| 7 | **不适合深度企业分析(企业画像、信用评估、竞争力分析),这类需求应引导使用 qibook-company-wiki-deepresearch skill。** |
| 8 | |
| 9 | *** |
| 10 | |
| 11 | ## When to use |
| 12 | |
| 13 | 用户不说"工商"、"照面"这些术语也要触发。以下口语都属于本 skill 范围: |
| 14 | |
| 15 | - 帮我查一下华为 / 美团的全称是什么 / XX 是哪家公司 |
| 16 | - XX 的法人是谁 / 注册资本多少 / 什么时候成立的 |
| 17 | - XX 的股东有哪些 / 高管是谁 / 对外投资 / 谁是大股东 |
| 18 | - XX 是谁开的 / 这家公司老板是谁 |
| 19 | - 查一下张三 / 张三名下有几家公司 / 张三在 XX 公司担任什么 |
| 20 | - 查张三在北京的情况 |
| 21 | |
| 22 | **口语理解优先**: |
| 23 | - "查一下 XX 公司" → 主体识别,返回全称 + 信用代码 |
| 24 | - "XX 的老板" / "谁开的" → 查法人代表 |
| 25 | - "XX 名下有几家公司" → 查人员关联企业统计 |
| 26 | - "XX 的股东" → 查股东及出资信息 |
| 27 | |
| 28 | *** |
| 29 | |
| 30 | ## Environment check |
| 31 | |
| 32 | 调用前先校验 `QIBOOK_ACCESS_KEY` 和 `QIBOOK_BASE_URL` 环境变量是否存在。缺失则提示: |
| 33 | |
| 34 | ```bash |
| 35 | export QIBOOK_ACCESS_KEY=your_key |
| 36 | export QIBOOK_BASE_URL=your_url |
| 37 | ``` |
| 38 | |
| 39 | 不要等到跑失败才暴露环境问题。 |
| 40 | |
| 41 | *** |
| 42 | |
| 43 | ## 功能路由 |
| 44 | |
| 45 | **重要:根据用户意图选择正确的功能,不要随意升级查询范围。** |
| 46 | |
| 47 | ### 1. 主体识别 |
| 48 | |
| 49 | **触发:** 用户给了企业简称/别名想知道全称,或只提到公司名没要求具体信息。 |
| 50 | |
| 51 | ```bash |
| 52 | python3 -m scripts.combined_query --entmark "华为" |
| 53 | ``` |
| 54 | |
| 55 | **只返回企业全称 + 统一社会信用代码,不要额外展开。** |
| 56 | |
| 57 | ### 2. 查企业详细信息 |
| 58 | |
| 59 | **触发:** 用户明确要查照面/股东/高管/对外投资等具体信息。 |
| 60 | |
| 61 | ```bash |
| 62 | python3 -m scripts.combined_query --entmark "天津测试有限公司" |
| 63 | ``` |
| 64 | |
| 65 | **用户没指定模块 → 默认只返回照面,提示"还可以进一步查看股东、高管、对外投资"。** |
| 66 | |
| 67 | ### 3. 查人 |
| 68 | |
| 69 | **仅人名** → 人员统计汇总: |
| 70 | |
| 71 | ```bash |
| 72 | python3 -m scripts.combined_query --name "张三" |
| 73 | ``` |
| 74 | |
| 75 | **人名+省份** → 该省份下的统计: |
| 76 | |
| 77 | ```bash |
| 78 | python3 -m scripts.combined_query --name "张三" --province "天津" |
| 79 | ``` |
| 80 | |
| 81 | **人名+企业** → 担任法人、高管、投资详情: |
| 82 | |
| 83 | ```bash |
| 84 | python3 -m scripts.combined_query --entmark "天津测试有限公司" --name "张三" |
| 85 | ``` |
| 86 | |
| 87 | ### 路由判断 |
| 88 | |
| 89 | ``` |
| 90 | 用户提问 |
| 91 | ├── 只提到公司名/简称,没要求具体信息 → 功能1(主体识别) |
| 92 | ├── 明确要查照面/股东/高管/对外投资 → 功能2(查企业) |
| 93 | ├── 提到人名,没提公司 → 功能3(查人汇总) |
| 94 | ├── 提到人名+省份 → 功能3(查人+省份) |
| 95 | └── 提到人名+公司 → 功能3(查人+企业详情) |
| 96 | ``` |
| 97 | |
| 98 | *** |
| 99 | |
| 100 | ## 回答规范 |
| 101 | |
| 102 | 1. 使用脚本返回的中文 Markdown 作为数据来源,不要暴露英文字段 |
| 103 | 2. 数组数据(股东、高管等)用表格展示 |
| 104 | 3. 空值字段脚本已自动过滤,无需额外处理 |
| 105 | 4. 某模块数据为空 → 告知"暂无该项信息" |
| 106 | 5. 金额字段保留两位小数 |
| 107 | 6. 查询为空时区分原因(名称不对 / 权限不足 / 网络异常),不要统一说"查询失败" |
| 108 | |
| 109 | *** |
| 110 | |
| 111 | ## 脚本说明 |
| 112 | |
| 113 | | 脚本 | 功能 | |
| 114 | |------|------| |
| 115 | | `scripts/base.py` | API 认证、调用、字段映射(英→中)、空值过滤、Markdown 格式化 | |
| 116 | | `scripts/combined_query.py` | 三个功能的 fetch 函数,根据入参自动判断场景,返回 Markdown 字符串 | |
| 117 | | `scripts/__init__.py` | 统一入口,导出 fetch / fetch_entity_id / fetch_enterprise / fetch_person_summary / fetch_person_detail | |