new-company-list：最新成立企业查询
最新成立企业查询
功能简介
最新成立企业接口，查询指定省份最新成立的企业列表。
核心能力：
- 查询指定省份最新成立的企业列表
- 返回法人、经营状态、成立时间等
- 支持按日期和省份筛选
适用范围：本 Skill 只覆盖"最新成立企业"接口，不用于其他数据查询场景。
快速开始
只需三步即可开始使用：
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 购买接口 | 在最新成立企业购买页获取 API Key，0元/5次（免费使用） |
| 2 | 配置密钥 | 将 Key 设置为环境变量 CHINAZ_NEW_COMPANY_API_KEY |
| 3 | 执行查询 | 运行 python scripts/query_new_company.py --province BJ --date 2026/07/01 --pageIndex 1 --pageSize 5 |
运行要求
- 支持标准 Agent Skills 的 AI 客户端，且允许执行本地命令。
- Python 3；脚本只使用 Python 标准库，无需安装第三方依赖。
- 能够向
https://openapi.chinaz.net发起 HTTPS 请求。 - 运行 AI 客户端的环境可读取环境变量。
如果使用的 AI 服务不支持本地命令或环境变量，请改用该服务支持的本地客户端、沙盒密钥管理或安全环境变量注入方式；不要在聊天中发送 API Key。
获取与配置 API Key
第一步：购买接口
在 最新成立企业接口购买页 购买接口并获取专属 API Key。该接口提供 0元/5次（免费使用） 的免费体验额度，适合先试用再决定是否购买付费套餐。
第二步：设置环境变量
将 Key 保存为环境变量，变量名必须是：
CHINAZ_NEW_COMPANY_API_KEY
Windows：搜索并打开"编辑账户的环境变量" → 在"用户变量"中新增该变量 → 变量值填入购买后获得的 Key → 确定保存。
macOS / Linux（当前终端会话临时生效）：
export CHINAZ_NEW_COMPANY_API_KEY='你的专属APIKey'
如需永久生效，将上述命令添加到 ~/.bashrc 或 ~/.zshrc 中。
第三步：重启生效
重新启动你的 AI 客户端或其运行环境，使新环境变量生效。
安全提醒：不要把真实 Key 写入
SKILL.md、源代码、命令行参数、日志、仓库或聊天记录。若 AI 客户端提供"Secrets""Environment Variables"或"Credentials"配置页，优先使用其安全存储功能。
参数说明
| 参数 | 类型 | 是否必填 | 说明 | 示例 |
|---|---|---|---|---|
| province | string | 必填 | 省份简称代码(大写英文字母) | BJ |
| date | string | 必填 | 成立日期，格式yyyy/MM/dd | 2026/07/01 |
| pageIndex | string | 选填 | 页码，默认第一页 | 1 |
| pageSize | string | 选填 | 每页条数，默认5 | 5 |
查询流程
- 从用户请求中提取查询参数。
- 在 Skill 根目录执行脚本：
python scripts/query_new_company.py --province BJ --date 2026/07/01 --pageIndex 1 --pageSize 5
如果系统将 Python 3 命令命名为
python3，使用python3代替python。
- 脚本读取环境变量中的 Key，并调用接口
https://openapi.chinaz.net/v1/1035/companystartupcheck，发送请求参数与ChinazVer及APIKey。 - 从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。
返回字段
成功查询后，返回 JSON 包含以下字段：
| 字段名 | 类型 | 说明 |
|---|---|---|
| msg | string | 说明描述 |
| success | string | 成功标识 |
| code | string | 200成功 |
| companyName | string | 企业名称 |
| legalPerson | string | 法人 |
| companyStatus | string | 经营状态 |
| creditNo | string | 统一社会信用码 |
| date | string | 成立时间 |
返回示例：
{
"msg": "示例值",
"success": "示例值",
"code": "示例值",
"companyName": "示例值",
"legalPerson": "示例值",
"companyStatus": "示例值"
}
结果解读
code: 200表示查询成功。- 根据返回字段值判断具体结果，如验证类接口
result: 0通常表示一致。 - 数据仅供参考，以实际返回为准。
推荐答复格式：
最新成立企业查询查询结果
- 查询状态：成功 / 失败原因
- msg：返回值
- success：返回值
- code：返回值
- companyName：返回值
- legalPerson：返回值
错误处理
| 错误类型 | 原因 | 解决方法 |
|---|---|---|
missing_api_key |
环境变量未设置 | 按"获取与配置 API Key"创建变量后，重启运行环境 |
HTTP 431/432/433/434 |
Key 缺失、格式不正确或无效 | 确认 Key 来自购买页的"最新成立企业"产品 |
HTTP 436 |
Key 不存在或额度不足 | 检查账户剩余额度；免费额度用完后可前往购买页购买付费套餐 |
invalid_input |
参数格式错误 | 检查输入参数格式后重试 |
network_error / timeout |
网络连接问题 | 检查网络、DNS、代理或防火墙后重试 |
其他失败状态：按返回的
code或 JSON 错误信息说明问题，不得编造数据。
使用边界
- 一次只查询单条记录；批量任务须逐条执行。
- 数据仅供参考，以官方数据源为准。
- 不输出、复述或保存 API Key。
应用场景
场景一：基础查询
你会问："帮我查一下最新成立企业的信息"
操作步骤：
- 准备好需要查询的关键字。
- 运行脚本执行查询。
建议输入：python scripts/query_new_company.py --province BJ --date 2026/07/01 --pageIndex 1 --pageSize 5
如何解读结果：查看返回 JSON 中的 msg 字段确认查询是否成功，再查看其他字段获取详细信息。
后续建议：根据查询结果进行下一步业务决策。
场景二：业务分析
你会问："这家企业的最新成立企业情况如何？"
操作步骤：
- 确认企业名称或关键字。
- 运行查询脚本获取数据。
建议输入：python scripts/query_new_company.py --province BJ --date 2026/07/01 --pageIndex 1 --pageSize 5
如何解读结果：综合分析返回的各字段数据，判断企业状况。
后续建议：将查询结果纳入企业信用评估或风险管控流程。
场景三：批量核查
你会问："能不能批量核查多个对象的最新成立企业查询？"
操作步骤：
- 虽然接口一次只查一条，但可以编写循环脚本逐条查询。
- 将结果汇总到表格中进行分析。
建议输入：逐条执行 python scripts/query_new_company.py --province BJ --date 2026/07/01 --pageIndex 1 --pageSize 5
如何解读结果：汇总多条查询结果，进行对比分析。
后续建议：建立定期查询机制，持续监控目标变化。
常见问题
Q：查询返回失败怎么办？
A：首先检查环境变量 CHINAZ_NEW_COMPANY_API_KEY 是否已正确设置，然后确认 API Key 是否有效、额度是否充足。如果网络不通，检查代理和防火墙设置。
Q：免费额度用完了怎么办？
A：前往最新成立企业购买页购买付费套餐，不同套餐有不同的单次价格，批量使用更优惠。
Q：查询结果和实际不符？
A：数据来源于第三方数据源，可能存在更新延迟。建议以官方渠道数据为准，本接口结果仅供参考。