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