| name | equity-pledge |
| description | 查询企业股权质押情况，返回质押人信息、质押股份、质押状态等。适用于"股权质押查询""企业质押信息""股份质押""质押状态查询""股权冻结查询""质押风险查询"等请求。通过本地 Python 脚本调用企业股权质押接口，并使用环境变量中的专属 API Key。 |
企业股权质押查询
功能简介
企业股权质押接口，查询企业股权质押情况。
核心能力：
- 查询企业股权质押情况
- 返回质押人、质押股份、质押状态等信息
- 助力风险管控和尽职调查
适用范围：本 Skill 只覆盖"企业股权质押"接口，不用于其他数据查询场景。
快速开始
只需三步即可开始使用：
| 步骤 | 操作 | 说明 |
|---|
| 1 | 购买接口 | 在企业股权质押购买页获取 API Key，1元/10次（新手调试） |
| 2 | 配置密钥 | 将 Key 设置为环境变量 CHINAZ_EQUITY_PLEDGE_API_KEY |
| 3 | 执行查询 | 运行 python scripts/query_equity_pledge.py --keyword 阿里巴巴 --pageNum 1 --pageSize 10 |
运行要求
- 支持标准 Agent Skills 的 AI 客户端，且允许执行本地命令。
- Python 3；脚本只使用 Python 标准库，无需安装第三方依赖。
- 能够向
https://openapi.chinaz.net 发起 HTTPS 请求。
- 运行 AI 客户端的环境可读取环境变量。
如果使用的 AI 服务不支持本地命令或环境变量，请改用该服务支持的本地客户端、沙盒密钥管理或安全环境变量注入方式；不要在聊天中发送 API Key。
获取与配置 API Key
第一步：购买接口
在 企业股权质押接口购买页 购买接口并获取专属 API Key。该接口提供 1元/10次（新手调试） 的免费体验额度，适合先试用再决定是否购买付费套餐。
第二步：设置环境变量
将 Key 保存为环境变量，变量名必须是：
CHINAZ_EQUITY_PLEDGE_API_KEY
Windows：搜索并打开"编辑账户的环境变量" → 在"用户变量"中新增该变量 → 变量值填入购买后获得的 Key → 确定保存。
macOS / Linux（当前终端会话临时生效）：
export CHINAZ_EQUITY_PLEDGE_API_KEY='你的专属APIKey'
如需永久生效，将上述命令添加到 ~/.bashrc 或 ~/.zshrc 中。
第三步：重启生效
重新启动你的 AI 客户端或其运行环境，使新环境变量生效。
安全提醒：不要把真实 Key 写入 SKILL.md、源代码、命令行参数、日志、仓库或聊天记录。若 AI 客户端提供"Secrets""Environment Variables"或"Credentials"配置页，优先使用其安全存储功能。
参数说明
| 参数 | 类型 | 是否必填 | 说明 | 示例 |
|---|
| keyword | string | 必填 | 企业id/企业名称/统一社会信用代码/注册号 | 阿里巴巴 |
| pageNum | string | 选填 | 当前页 | 1 |
| pageSize | string | 选填 | 每页条数，默认10，最多20 | 10 |
查询流程
- 从用户请求中提取查询参数。
- 在 Skill 根目录执行脚本：
python scripts/query_equity_pledge.py --keyword 阿里巴巴 --pageNum 1 --pageSize 10
如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。
- 脚本读取环境变量中的 Key，并调用接口
https://openapi.chinaz.net/v1/1057/dsj_ep，发送请求参数与 ChinazVer 及 APIKey。
- 从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。
返回字段
成功查询后，返回 JSON 包含以下字段：
| 字段名 | 类型 | 说明 |
|---|
| code | string | 状态码 |
| message | string | 状态码描述 |
| total | string | 总数 |
| shareholderName | string | 股东名称 |
| pledgeFreezeType | string | 质押冻结类型 |
| freezeHoldNum | string | 质押/冻结股数 |
| pledgeObj | string | 质押目的 |
| pledgeFreezeStartDt | string | 质押起始日 |
| pledgeFreezeEndDt | string | 质押截止日 |
| pledgeFreezeProg | string | 质押冻结进度 |
返回示例：
{
"code": "示例值",
"message": "示例值",
"total": "示例值",
"shareholderName": "示例值",
"pledgeFreezeType": "示例值",
"freezeHoldNum": "示例值"
}
结果解读
code: 0 表示查询成功。- 根据返回字段值判断具体结果，如验证类接口
result: 0 通常表示一致。
- 数据仅供参考，以实际返回为准。
推荐答复格式：
企业股权质押查询查询结果
- 查询状态：成功 / 失败原因
- code：返回值
- message：返回值
- total：返回值
- shareholderName：返回值
- pledgeFreezeType：返回值
错误处理
| 错误类型 | 原因 | 解决方法 |
|---|
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_equity_pledge.py --keyword 阿里巴巴 --pageNum 1 --pageSize 10
如何解读结果：查看返回 JSON 中的 code 字段确认查询是否成功，再查看其他字段获取详细信息。
后续建议：根据查询结果进行下一步业务决策。
场景二：业务分析
你会问："这家企业的企业股权质押情况如何？"
操作步骤：
- 确认企业名称或关键字。
- 运行查询脚本获取数据。
建议输入：python scripts/query_equity_pledge.py --keyword 阿里巴巴 --pageNum 1 --pageSize 10
如何解读结果：综合分析返回的各字段数据，判断企业状况。
后续建议：将查询结果纳入企业信用评估或风险管控流程。
场景三：批量核查
你会问："能不能批量核查多个对象的企业股权质押查询？"
操作步骤：
- 虽然接口一次只查一条，但可以编写循环脚本逐条查询。
- 将结果汇总到表格中进行分析。
建议输入：逐条执行 python scripts/query_equity_pledge.py --keyword 阿里巴巴 --pageNum 1 --pageSize 10
如何解读结果：汇总多条查询结果，进行对比分析。
后续建议：建立定期查询机制，持续监控目标变化。
常见问题
Q：查询返回失败怎么办？
A：首先检查环境变量 CHINAZ_EQUITY_PLEDGE_API_KEY 是否已正确设置，然后确认 API Key 是否有效、额度是否充足。如果网络不通，检查代理和防火墙设置。
Q：免费额度用完了怎么办？
A：前往企业股权质押购买页购买付费套餐，不同套餐有不同的单次价格，批量使用更优惠。
Q：查询结果和实际不符？
A：数据来源于第三方数据源，可能存在更新延迟。建议以官方渠道数据为准，本接口结果仅供参考。
