启信宝企业信息查询
概述
启信宝(QiXinBao)企业信息查询 Skill,提供全面的企业数据查询服务。本 Skill 基于启信宝 API,支持通过企业名称查询工商信息、股东信息、主要人员、变更记录等数据。
特性
- 🏢 企业工商信息 - 查询企业注册信息、经营状态等基础数据
- 👥 股东信息 - 获取企业股东持股情况
- 👤 主要人员 - 查询企业高管、董事等关键人员信息
- 📋 变更记录 - 追踪企业工商变更历史
- 🔍 智能识别 - 支持通过企业名称自动查询
快速上手
1. 获取 API Token
首先需要获取启信宝 API Token。Token 格式类似:ent_xxx_xxxxxxxxxx
如果没有,请联系启信宝平台管理员获取。
2. 配置 Token
推荐方式:环境变量
设置环境变量 QXBENT_API_TOKEN:
Windows 永久配置:
- 按
Win + R,输入sysdm.cpl,按回车 - 点击"高级" → "环境变量"
- 在"用户变量"中点击"新建"
- 变量名:
QXBENT_API_TOKEN - 变量值:粘贴你的 Token
- 点击"确定"保存
- 重启 AI 应用
Mac/Linux 永久配置:
# 如果使用 bash
echo 'export QXBENT_API_TOKEN="your_token_here"' >> ~/.bashrc
source ~/.bashrc
# 如果使用 zsh (Mac 默认)
echo 'export QXBENT_API_TOKEN="your_token_here"' >> ~/.zshrc
source ~/.zshrc
临时方式:告诉 AI
在对话中直接告诉 AI:
我的启信宝 API Token 是 ent_xxx_xxx,请记住并在使用 qxbent 时自动使用这个 token
注意:这种方式仅在当前对话有效,下次对话需要重新告知。
3. 使用示例
在支持的 AI 智能体中加载此 Skill 后,可以用自然语言进行查询:
查询企业工商信息:
查询上海合合信息科技发展有限公司的工商信息
查询企业股东:
帮我查一下恒大地产集团有限公司的股东信息
查询主要人员:
查询上海合合信息科技发展有限公司的主要人员
查询变更记录:
查看上海合合信息科技发展有限公司最近的变更记录
API 接口列表
| 接口名 | 描述 | 参数 |
|---|---|---|
| getEnterpriseInformation | 查询企业工商信息 | ename(企业名称) |
| getPartnerListV3 | 查询企业股东信息 | ename(企业名称) |
| getEmployeesListV4 | 查询企业主要人员 | ename(企业名称) |
| getPagingEntBasicInfo | 查询企业变更记录 | ename(企业名称) |
工具权限
Bash(node:*): 允许执行 Node.js/TypeScript 代码Read: 允许读取接口文档
初始化
首次使用时,如果遇到模块未找到错误,需要先安装依赖:
# 在 skill 根目录执行
npm install
AI 助手会在必要时自动检测并执行此命令。
数据说明
- 所有接口都支持通过企业名称(ename)查询
- 企业名称会自动转换为企业 ID 进行查询
- 股东信息、主要人员默认返回前 10 条记录
- 变更记录默认返回最近 10 条记录
企业名称匹配说明
当使用不完整或简称查询时,可能会遇到以下情况:
情况 1: 精确匹配
- 输入:
上海合合信息科技发展有限公司 - 结果:直接返回企业信息
情况 2: 多个候选企业
- 输入:
胜宏科技 - 结果:返回
MultipleMatchError错误,包含候选企业列表 - AI 处理:展示候选企业列表,请用户选择或提供更完整的企业名称
示例候选列表:
找到多个匹配的企业,请选择:
1. 胜宏科技(惠州)股份有限公司
2. 惠州市胜宏科技研究院有限公司
3. 南通胜宏科技有限公司
4. 武汉市胜宏科技有限公司
5. 北京胜宏科技有限公司
情况 3: 企业未找到
- 输入:
不存在的企业名称 - 结果:返回
EnterpriseNotFoundError错误
AI 交互流程建议
- 用户使用简称查询 → 捕获
MultipleMatchError - AI 展示候选企业列表
- 用户选择具体企业
- AI 使用完整企业名称重新查询
注意事项
本 Skill 仅供学习和研究使用,请勿用于商业用途。使用时请遵守启信宝 API 的使用条款和访问限制。