企业股权穿透
概述
查询企业的股权结构，可查询直接股东数量、名称及持股比例（按持股比例返回最多10个），以及间接股东数量、名称、持股比例和最短层级（按持股比例返回最多100个）。
特性
- 直接股东：按持股比例排序的股东列表（最多10个）
- 间接股东：穿透多层股权关系，展示最短路径和层级（最多100个）
- 路径追溯：每个间接股东都附带完整穿透路径（从目标企业到该股东的每一层节点及比例）
快速上手
1. 获取 API Token
需要启信宝 API Token，格式类似：ent_xxx_xxxxxxxxxx。如果没有，请联系启信宝平台管理员获取。
2. 配置 Token
设置环境变量 QXBENT_API_TOKEN：
Windows：
- 按
Win + R，输入sysdm.cpl，按回车 - 点击"高级" -> "环境变量"
- 在"用户变量"中点击"新建"
- 变量名：
QXBENT_API_TOKEN，变量值：粘贴你的 Token - 点击"确定"保存，重启 AI 应用
Mac/Linux：
echo 'export QXBENT_API_TOKEN="your_token_here"' >> ~/.zshrc
source ~/.zshrc
3. 使用示例
帮我查一下蚂蚁集团的股权穿透，看看间接股东有哪些
查询华为技术有限公司的股东结构
这家公司的实际控制人是谁？帮我穿透一下股权
API 接口
| 接口名 | 描述 | 参数 |
|---|---|---|
| getEquityPenetration | 查询企业股权穿透 | ename（企业名称）或 eid（企业ID） |
工具权限
Bash(node:*): 允许执行 Node.js/TypeScript 代码Read: 允许读取接口文档
运行时要求
Bins
node(Node.js >= 16.x)npm
Env
QXBENT_API_TOKEN(必需) - 启信宝 API 访问凭证
初始化
首次使用时需要安装依赖：
npm install
数据说明
- 支持通过企业名称（ename）或企业ID（eid）查询
- 企业名称支持模糊匹配，自动取最佳匹配结果
- 返回数据中包含
ename字段，标识实际查询的企业 - 直接股东数据来源为工商登记信息
- 间接股东通过多层穿透计算得出
参考文件
- 接口详细文档：读取 references/getEquityPenetration.md