equity-pledge

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

查询流程

1. 从用户请求中提取查询参数。
2. 在 Skill 根目录执行脚本：

python scripts/query_equity_pledge.py --keyword 阿里巴巴 --pageNum 1 --pageSize 10

如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

3. 脚本读取环境变量中的 Key，并调用接口 https://openapi.chinaz.net/v1/1057/dsj_ep，发送请求参数与 ChinazVer 及 APIKey。
4. 从脚本输出的 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。

应用场景

场景一：基础查询

你会问："帮我查一下企业股权质押的信息"

操作步骤：

1. 准备好需要查询的关键字。
2. 运行脚本执行查询。

建议输入：python scripts/query_equity_pledge.py --keyword 阿里巴巴 --pageNum 1 --pageSize 10

如何解读结果：查看返回 JSON 中的 code 字段确认查询是否成功，再查看其他字段获取详细信息。

后续建议：根据查询结果进行下一步业务决策。

场景二：业务分析

你会问："这家企业的企业股权质押情况如何？"

操作步骤：

1. 确认企业名称或关键字。
2. 运行查询脚本获取数据。

建议输入：python scripts/query_equity_pledge.py --keyword 阿里巴巴 --pageNum 1 --pageSize 10

如何解读结果：综合分析返回的各字段数据，判断企业状况。

后续建议：将查询结果纳入企业信用评估或风险管控流程。

场景三：批量核查

你会问："能不能批量核查多个对象的企业股权质押查询？"

操作步骤：

1. 虽然接口一次只查一条，但可以编写循环脚本逐条查询。
2. 将结果汇总到表格中进行分析。

建议输入：逐条执行 python scripts/query_equity_pledge.py --keyword 阿里巴巴 --pageNum 1 --pageSize 10

如何解读结果：汇总多条查询结果，进行对比分析。

后续建议：建立定期查询机制，持续监控目标变化。

常见问题

Q：查询返回失败怎么办？

A：首先检查环境变量 CHINAZ_EQUITY_PLEDGE_API_KEY 是否已正确设置，然后确认 API Key 是否有效、额度是否充足。如果网络不通，检查代理和防火墙设置。

Q：免费额度用完了怎么办？

A：前往企业股权质押购买页购买付费套餐，不同套餐有不同的单次价格，批量使用更优惠。

Q：查询结果和实际不符？

A：数据来源于第三方数据源，可能存在更新延迟。建议以官方渠道数据为准，本接口结果仅供参考。