一、工具介绍
cSubsidiary 是一款基于天眼查 API 的开源工具,主要用于查询企业的子公司、控股公司及相关资产信息。通过递归查询和控股比例筛选,可快速获取目标企业的组织架构和关联资产,广泛应用于渗透测试、企业信息收集等场景。
二、安装教程
- 环境准备
-
- 需要 Python 3.6+ 环境,推荐使用虚拟环境:
python3 -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
-
- 安装依赖库:
pip install requests
- 获取工具代码
-
- 通过 Git 克隆仓库或直接下载 ZIP 文件:
git clone https://github.com/canc3s/csubsidiary.git
cd csubsidiary
- 配置天眼查 Cookie
-
- 登录天眼查官网(https://www.tianyancha.com/),在浏览器开发者工具中找到
auth_token
字段值(通常在 Cookie 或请求头中)。 - 将该值填入项目根目录的
config.yaml
文件:
- 登录天眼查官网(https://www.tianyancha.com/),在浏览器开发者工具中找到
auth_token: "your_auth_token_here"
三、使用教程
- 基础查询
-
- 查询目标企业及其子公司(默认控股比例≥90%):
python csubsidiary.py -n "目标企业名称"
-
- 示例:查询“绿盟科技”及其子公司:
python csubsidiary.py -n "绿盟科技" -rate 50 # 控股比例≥50%
- 递归查询
-
- 支持多层子公司查询(如查询三层子公司):
python csubsidiary.py -n "中国移动" -deep 3
- 批量查询
-
- 从文件批量读取企业名称:
python csubsidiary.py -f enterprises.txt
四、官方下载地址
- GitHub 仓库:GitHub - canc3s/cSubsidiary: 利用天眼查查询企业子公司
- 注意事项:
-
- 需遵守天眼查 API 使用条款,禁止用于非法用途。
- 部分企业可能因数据未公开或接口限制无法查询,需结合其他工具(如爱企查、企查查)补充。