行政处罚综合查询

功能简介

行政处罚综合查询接口，查询全国企业个体工商户的行政处罚信息。

核心能力：

查询全国企业个体工商户的行政处罚信息
支持按处罚类型筛选（工商、税务、海关等）
返回处罚决定书文号、违法行为类型等

适用范围：本 Skill 只覆盖"行政处罚综合查询"接口，不用于其他数据查询场景。

使用方式

前往行政处罚综合查询购买页注册登录，获取专属 API Key（1元/5次新手调试）
将 Key 直接发送给 AI
告诉 AI 要查询的企业名称或法定代表人

缺少 Key 时的引导回复

当查询返回 missing_api_key 错误时，按以下方式回复用户（根据实际查询内容调整）：

未检测到 API Key，需要你提供一下在行政处罚综合查询购买页获取的专属 API Key，我才能帮你查询 xxx 的行政处罚信息。

请直接把 Key 发给我，我会仅用于本次查询，不会保存或回显完整密钥。

查询失败（Key 无效或额度不足）时，引导用户前往购买页检查 Key 或额度。

以下为内部执行参考，回复用户时不要展示接口地址、参数格式、JSON字段名等技术细节。

参数说明

| 参数 | 类型 | 是否必填 | 说明 | 示例 | |------|------|---------|------|------| | entityName | string | 必填 | 当事人名称或法定代表人名称 | 阿里巴巴 | | idCard | string | 选填 | 身份证号 | | | punishType | string | 选填 | 处罚类型：1工商 2税务 3海关 4食药监 5环保 6银保监 7市场监管 8信用中国 | |

脚本调用

用户提供 Key 后，在 Skill 根目录执行：

python scripts/query_admin_punish.py --entityName 阿里巴巴 --idCard  --punishType  --api-key "用户提供的Key"

如用户已自行配置环境变量 CHINAZ_ADMIN_PUNISH_API_KEY，可省略 --api-key 参数。如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

返回字段

| 字段名 | 类型 | 说明 | |--------|------|------| | rc | string | 状态码 | | msg | string | 状态信息 | | partiesName | string | 当事人名称 | | decideNo | string | 处罚决定书文号 | | criminalType | string | 违法行为类型 | | punishContent | string | 处罚内容 | | decideDate | string | 处罚日期 | | decideOrg | string | 处罚机关 | | decideBasis | string | 处罚依据 | | punishType | string | 处罚类型 |

返回示例：

{
  "rc": "示例值",
  "msg": "示例值",
  "partiesName": "示例值",
  "decideNo": "示例值",
  "criminalType": "示例值",
  "punishContent": "示例值"
}

结果解读

rc: 0000 表示查询成功。
根据返回字段值判断具体结果，如验证类接口 result: 0 通常表示一致。
数据仅供参考，以实际返回为准。

推荐答复格式：

行政处罚综合查询结果
- 查询状态：成功 / 失败原因
- 当事人名称：返回值
- 处罚决定书文号：返回值
- 违法行为类型：返回值
- 处罚内容：返回值
- 处罚日期：返回值
- 处罚机关：返回值

错误处理

| 错误类型 | 说明 | 处理方式 | |---------|------|---------| | missing_api_key | 缺少 API Key | 按上方"缺少 Key 时的引导回复"引导用户获取并发送 Key | | Key 无效或额度不足 | Key 错误或额度用完 | 引导用户前往购买页检查 | | invalid_input | 参数格式错误 | 确认输入参数格式后重试 | | network_error / timeout | 网络连接问题 | 检查网络后重试 |

其他失败状态：按返回的状态信息说明问题，不得编造数据。

使用边界

一次只查询单条记录；批量任务须逐条执行。
数据仅供参考，以官方数据源为准。
不输出、复述或保存 API Key。

应用场景

场景一：基础查询

你会问："帮我查一下行政处罚综合的信息"

操作步骤：

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

建议输入：python scripts/query_admin_punish.py --entityName 阿里巴巴 --idCard --punishType

如何解读结果：查看返回结果确认查询是否成功，再查看详细信息。

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

场景二：业务分析

你会问："这家企业的行政处罚综合情况如何？"

操作步骤：

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

建议输入：python scripts/query_admin_punish.py --entityName 阿里巴巴 --idCard --punishType

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

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

场景三：批量核查

你会问："能不能批量核查多个对象的行政处罚综合查询？"

操作步骤：

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

建议输入：逐条执行 python scripts/query_admin_punish.py --entityName 阿里巴巴 --idCard --punishType

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

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

常见问题

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

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

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

A：前往行政处罚综合查询购买页购买付费套餐，不同套餐有不同的单次价格，批量使用更优惠。

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

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