asset-dashboard-search

专利资产看板检索技能，封装多个智慧芽专利检索API能力，支持按申请人、关键词等维度检索专利，返回去重后的专利列表。

知识产权
版本
v1.0.0
下载量
0
文件列表
5
最近更新
2026-07-02

关于

专利资产看板检索技能，封装多个智慧芽专利检索API能力，支持按申请人、关键词等维度检索专利，返回去重后的专利列表。

文件列表 5

asset-dashboard-search

SKILL.md

KeyValue
nameasset-dashboard-search
description专利资产看板检索技能，封装多个智慧芽专利检索API能力，支持按申请人、关键词等维度检索专利，返回去重后的专利列表。

asset-dashboard-search

概述

本技能封装了多个智慧芽专利检索API能力，用于专利资产看板场景下的专利数据获取。 每个子能力以 P00X / A00X / S00X / D00X 编号标识，逐步扩充。

鉴权方式

所有接口均通过 HTTP Header 传递 API Token：

plaintext
Authorization: Bearer <token>

Token 通过环境变量 ZHIHUIYA_API_TOKEN 注入，或通过 --token 参数传入。

公共固定请求体参数（所有 P002 系列共用）

json
{
  "collapse_by": "PBD",
  "collapse_type": "APNO",
  "collapse_order": "LATEST"
}

⚠️ 不得添加 collapse_order_authority 字段 ，否则会导致 CN 申请量统计偏差。

P002 — 按申请人检索全部专利（合并同族）

接口信息

  • 方法 ：POST

  • 地址 ： https://connect.zhihuiya.com/search/patent/query-search-patent/v2

请求体

json
{
  "query_text": "ANCS:(申请人名称)",
  "collapse_by": "PBD",
  "collapse_type": "APNO",
  "collapse_order": "LATEST"
}

数据路径

python
total = result["data"]["total_search_result_count"]
patents = result["data"]["results"]

测试验证记录

测试申请人 返回总数 状态
北京低碳清洁能源研究院 3,341 ✅
国家能源集团科学技术研究院有限公司 1,463 ✅

P002B — 按申请人检索授权发明专利

请求体

json
{
  "query_text": "ANCS:(申请人名称) and PATENT_TYPE:(B)",
  "collapse_by": "PBD",
  "collapse_type": "APNO",
  "collapse_order": "LATEST"
}

P002U — 按申请人检索实用新型专利

请求体

json
{
  "query_text": "ANCS:(申请人名称) and PATENT_TYPE:(U)",
  "collapse_by": "PBD",
  "collapse_type": "APNO",
  "collapse_order": "LATEST"
}

P002D — 按申请人检索外观设计专利

请求体

json
{
  "query_text": "ANCS:(申请人名称) and PATENT_TYPE:(D)",
  "collapse_by": "PBD",
  "collapse_type": "APNO",
  "collapse_order": "LATEST"
}

部分企业无外观设计专利，返回 total_search_result_count = 0。

A001 — 申请趋势（近10年：2016—2025）

接口信息

  • 方法 ：POST

  • 地址 ： https://connect.zhihuiya.com/insights-openapi/patent-trends-query

请求体参数

json
{
  "query_text": "ANCS:(申请人名称)",
  "collapse_by": "PBD",
  "collapse_type": "APNO",
  "collapse_order": "LATEST"
}

⚠️ 不得添加 collapse_order_authority。

返回结构

json
{
  "status": true,
  "data": [
    {"year": "2016", "application": 163, "granted": 133, "percentage": 0.816},
    ...
  ]
}

data 是 直接数组 ，用 result["data"] 取列表，再按年份过滤 2016—2025。

过滤逻辑

python
years_10 = [str(y) for y in range(2016, 2026)]
trend_10y = [item for item in result["data"] if item["year"] in years_10]

S001 — 战略新兴产业分布检索

接口信息

  • 方法 ：POST

  • 地址 ： https://connect.zhihuiya.com/search/patent/query-search-patent/v2

9个产业标签（固定顺序，循环9次）

  1. 新材料产业

  2. 节能环保产业

  3. 新能源汽车产业

  4. 新能源产业

  5. 生物产业

  6. 高端装备制造产业

  7. 新一代信息技术产业

  8. 相关服务业

  9. 数字创意产业

请求体（每次循环）

json
{
  "query_text": "ANCS:(申请人名称) and SEIC:(产业名称)",
  "collapse_by": "PBD",
  "collapse_type": "APNO",
  "collapse_order": "LATEST"
}

循环逻辑

python
seic_list = [
    "新材料产业", "节能环保产业", "新能源汽车产业", "新能源产业",
    "生物产业", "高端装备制造产业", "新一代信息技术产业", "相关服务业", "数字创意产业"
]
results = {}
for seic in seic_list:
    query = f"ANCS:({applicant_name}) and SEIC:({seic})"
    results[seic] = total_count

D109 — 海外布局（受理局分布）

接口信息

  • 方法 ：POST

  • 地址 ： https://connect.zhihuiya.com/shhgy/reportdata/rec-office

请求体参数

json
{
  "query_text": "ANCS:(申请人名称)",
  "collapse_by": "PBD",
  "collapse_type": "APNO",
  "collapse_order": "LATEST"
}

⚠️ 严禁添加 collapse_order_authority 字段 ，否则 CN 申请量会从 13,378 变成 16,179（宝山钢铁已验证）。

海外申请量计算规则

海外申请量 = 所有受理局之和 - 中国（CN）申请量

返回结构

json
{
  "data": {
    "values": [
      {"rec_office": "中国", "code": "CN", "num": 13378},
      {"rec_office": "欧洲", "code": "EP", "num": 628},
      ...
    ]
  }
}

计算逻辑

python
values = result["data"]["values"]
total_all = sum(item["num"] for item in values)
cn_count = next((item["num"] for item in values if item["code"] == "CN"), 0)
overseas_count = total_all - cn_count

测试验证记录

申请人 总量 CN 海外
北京低碳清洁能源研究院 3,341 3,066 275 ✅
宝山钢铁股份有限公司 17,088 13,378 3,710 ✅

A006 — 重点发明人（有效专利持有数量）

接口信息

  • 方法 ：GET

  • 地址 ： https://connect.zhihuiya.com/insights/inventor-ranking

query_text 格式

plaintext
ANCS:(申请人名称) and SIMPLE_LEGAL_STATUS:(1) and PATENT_TYPE:(B or U or D)

返回结构

json
{
  "data": [
    {"name": "孙琦", "count": 137},
    ...
  ]
}

数据路径

python
inventors = result["data"]  # 直接数组，按count降序

A002 — 创新词云

接口信息

  • 方法 ：POST

  • 地址 ： https://connect.zhihuiya.com/insights/word-cloud-query

请求体参数（完整，缺一不可）

json
{
  "lang": "cn",
  "query_text": "ANCS:(申请人名称)",
  "collapse_by": "PBD",
  "collapse_type": "DOCDB",
  "collapse_order": "LATEST"
}

⚠️ 本接口 collapse_type 使用 DOCDB，与其他接口不同（其他用 APNO）。 ⚠️ 必须传入 lang、 collapse_by、 collapse_order，缺少任一将导致结果不准确。

数据路径

python
words = result["data"]  # 直接数组，100个词条，按count降序

能力汇总

能力编号 方法 接口 说明
P002 POST query-search-patent/v2 全类型专利
P002B POST query-search-patent/v2 授权发明专利
P002U POST query-search-patent/v2 实用新型专利
P002D POST query-search-patent/v2 外观设计专利
A001 POST patent-trends-query 申请趋势（近10年 2016—2025）
S001 POST query-search-patent/v2 战略新兴产业分布（9次循环）
D109 POST rec-office 海外布局（海外=总量-CN，禁用collapse_order_authority）
A006 GET inventor-ranking 重点发明人（有效专利持有数量）
A002 POST word-cloud-query 创新词云（lang=cn，collapse_type=DOCDB）

待扩充能力

  • 更多能力持续补充中

使用前配置

本 Skill 依赖智慧芽开放平台 MCP 服务：

  • 完成安装、初次使用时需进行自检，参见 README.md

  • 用户需完成账号授权，并确保 Agent 环境已启用对应 MCP 工具

  • 若未完成配置，本 Skill 只能提供分析框架，无法检索实时数据或生成基于数据库的结论

  • 缺少MCP配置时，引导用户参照 README.md 在 [ open.zhihuiya.com ]( https://open.zhihuiya.com/ ) 获取MCP。