基于 PatSeek 专利检索平台 API,提供三种核心专利检索能力:
ps_ + 32 位十六进制字符串)ps_0931e2efa48df3aa2596de57c27d9449PATSEEK_API_KEY 传入,或在调用脚本时通过 --api-key 参数指定requests 库所有检索操作均通过脚本 scripts/patseek_client.py 执行:
PYTHON_BIN=/Users/wayne/.workbuddy/binaries/python/envs/default/bin/python
SCRIPT=~/.workbuddy/skills/patseek-patent-search/scripts/patseek_client.py
确保 requests 已安装:
$PYTHON_BIN -m pip install requests -q
专利文本中同一技术概念可能使用不同术语。为提高检索全面性,构造 Bool 检索式时必须对用户给出的关键词进行同义词扩展,用 (A OR B OR C) 语法覆盖同一概念的不同表述。
(智能驾驶 OR 自动驾驶 OR 无人驾驶 OR 辅助驾驶 OR ADAS OR ADS)锂电池 → (锂电池 OR lithium battery OR Li-ion)人工智能 → (人工智能 OR AI OR 机器智能)在构造 Bool 检索式时,按以下步骤执行关键词扩展:
步骤1:识别用户查询中的技术关键词(排除申请人、日期等非技术条件)
步骤2:对每个技术关键词,思考同义/近义/中英文变体术语
步骤3:参考 references/keyword_expansion.md 中的对照表(如有匹配领域)
步骤4:将扩展后的关键词用 OR 组合,放入括号中
步骤5:组合最终检索式并执行
| 用户原始表述 | 扩展后检索式(关键词部分) |
|---|---|
| --- | --- |
| 智能驾驶 | (智能驾驶 OR 自动驾驶 OR 无人驾驶 OR 辅助驾驶 OR ADAS OR ADS OR 自适应巡航) |
| 固态电池 | (固态电池 OR 全固态电池 OR 固态电解质电池 OR solid-state battery) |
| 大模型 | (大模型 OR 大语言模型 OR LLM OR 基础模型 OR 预训练模型 OR foundation model) |
| 低空经济 | (低空经济 OR 低空飞行 OR eVTOL OR 城市空中交通 OR UAM OR 飞行汽车) |
| 量子计算 | (量子计算 OR 量子处理器 OR 量子比特 OR quantum computing OR qubit) |
关键词扩展应适度,避免引入噪音导致检索结果不相关:
IPC=() 限定技术领域,减少噪音AP=(华为) (智能驾驶 OR 自动驾驶 OR 无人驾驶 OR 辅助驾驶 OR ADAS) IPC=(B60W OR G05D1) AD>=2024(芯片 OR chip OR 晶圆) NOT=(薯片) (极端示例,实际中较少出现)以下场景不需要对关键词进行同义扩展:
CN118658342A),使用 PID= 或 AN= 精确匹配,不做扩展"固态电解质"),不扩展| 场景 | 推荐方式 | 理由 |
|---|---|---|
| --- | --- | --- |
| 已知专利号/申请人 | Bool 检索 | 精确定位,速度快,消耗少 |
| 关键词检索 | Bool 检索 + 关键词扩展 | 同义词覆盖更全面 |
| 查新/避雷/技术调研 | 语义检索 | 语义匹配不受术语限制,发现隐蔽相关专利 |
| Bool 命中 < 20 条 | 推荐 + 语义检索 | Bool 关键词可能覆盖不全,语义检索补充 |
当 Bool 检索(含关键词扩展后)命中数 < 20 条时,按以下顺序尝试:
> "Bool 检索仅命中 X 条结果,可能存在使用不同术语表述的相关专利。建议使用语义检索获取更全面的结果(约45秒,10积分),是否尝试?"
当 Bool 检索命中数 > 5000 条时,按以下顺序缩小范围:
IPC=() 缩小技术领域按公开号/申请号获取专利详情:
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT patent CN118658342A
按关键词简单检索(自动走 Bool 检索接口):
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT bool "无人机" --page-size 10
输出包含:公开号、申请号、名称、申请人、IPC、申请日、公开日、摘要。
支持逻辑组合和字段前缀,实现精确筛选。详细语法见 references/query_syntax.md。
> 关键词扩展提醒:构造 Bool 检索式时,务必先对技术关键词进行同义/近义扩展,详见上方"关键词扩展策略"章节。常见领域的同义词对照表见 references/keyword_expansion.md。
| 写法 | 含义 | 示例 |
|---|---|---|
| --- | --- | --- |
A B(空格) | AND,所有词都必须出现 | 固态电池 电解质 |
A AND B | 显式 AND | 低空空域 AND 无人机 |
A OR B | 任一出现即命中 | 人工智能 OR 机器学习 |
(A OR B) C | 括号控制优先级 | (固态 OR 全固态) 电池 |
| 前缀 | 字段 | 匹配方式 | 示例 |
|---|---|---|---|
| --- | --- | --- | --- |
AP=(...) | 申请人 | match_phrase | AP=(华为) |
IPC=(...) | IPC 分类号 | match + and | IPC=(H01M) |
PID=(...) | 公开号 | term 精确 | PID=(CN101971633A) |
AN=(...) | 申请号 | match_phrase | AN=(CN200980108398) |
AD | 申请日 | range | AD>=2020 |
PD | 公开日 | range | PD>=2024 |
NOT=(...) | 排除 | must_not | NOT=(液态) |
前缀支持 = 和 : 两种写法,如 AP=(华为) 等同于 AP:(华为)。
申请人 AP=:
AP=(华为) # 单个申请人
AP=(华为 OR 中兴) # 多个申请人用 OR 连接,不支持 AND
AP=(上海市第一人民医院 OR 上海交通大学附属第一人民医院) # 全称/简称均可
IPC 分类号 IPC=:
IPC=(H01M) # 单个 IPC(只用前 4 位!)
IPC=(H01M OR H02J) # 多个 IPC
⚠️ IPC 只用前 4 位,6 位或更长的代码会漏匹配:IPC=(H01M) ✅ / IPC=(H01M10) ❌
常用 IPC 速查:
| 领域 | 代码 | 领域 | 代码 |
|---|---|---|---|
| --- | --- | --- | --- |
| 电池 | H01M | 通信 | H04L, H04W |
| 储能/充电 | H02J | 生物医药 | A61K, A61P |
| 人工智能 | G06N | 机器人 | B25J |
| 图像处理(软件) | G06T, G06V | 光学 | G02B |
| 自动驾驶 | B60W, G05D1 | 半导体 | H01L |
日期 AD= / PD=: AD = 申请日,PD = 公开日
AD>=2020 # 2020 年及以后
AD<2015 # 2015 年初之前
AD=2023 # 2023 整年
AD=202301 # 2023 年 1 月
AD=20230115 # 精确日期
AD=2020-2023 # 范围:2020 到 2023
AD=2020 to 2023 # 范围(to 写法)
日期格式支持:YYYY、YYYYMM、YYYYMMDD、YYYY-MM-DD、YYYY/MM/DD、YYYY.MM.DD
公开号 PID=: term 精确匹配,大小写不敏感
PID=(CN101971633A)
PID=(CN101971633A OR CN222118806U) # 多个用 OR 连接
申请号 AN=:
AN=(CN200980108398)
⚠️ 13 位申请号需去掉最后一位(校验位):2019205174826 → 201920517482
排除 NOT=:
固态电池 NOT=(液态)
图像识别 NOT=(医疗 OR 医学)
专利号自动识别(无需前缀): 直接输入专利号,系统自动识别:
CN101971633A # 中国专利(带后缀)
CN101971633 # 中国专利(无后缀)
101971633 # 纯数字,默认补 CN
US10234567B2 # 美国专利
关键词全文检索: 无字段前缀时,在以下字段全文检索(权重从高到低):
title^3 > abstract^2 > claims > description > pid > appnum
匹配规则:所有关键词都必须出现,不要求连续或顺序。引号内视为精确短语。
固态电池 # "固态" 和 "电池" 都必须出现
"固态电解质" # 精确短语匹配
(固态 OR 全固态) 电池 # 括号分组 + OR 扩展
> 以下示例中的技术关键词均已做同义词扩展(OR 组合),参考「关键词扩展策略」章节。
# 申请人 + 关键词扩展
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT bool "AP=(华为) (5G OR 第五代移动通信 OR NR OR 新空口)" --page-size 10
# 多申请人 + 关键词扩展
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT bool "AP=(华为 OR 中兴 OR 爱立信) (通信 OR 通讯 OR telecom)" --page-size 10
# IPC 领域 + 关键词扩展
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT bool "IPC=(H01M) (固态电池 OR 全固态电池 OR 固态电解质 OR solid-state battery)" --page-size 10
# 日期范围 + 关键词扩展
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT bool "(飞行汽车 OR eVTOL OR 城市空中交通 OR UAM) AD>=2020" --page-size 10
# 申请人 + IPC + 关键词扩展 + 日期
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT bool "AP=(比亚迪) (电池 OR 蓄电池 OR battery) IPC=(H01M OR H02J) AD>=2020" --page-size 10
# 精确专利号(无需关键词扩展)
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT bool "PID=(CN101971633A)" --page-size 10
# 关键词扩展 + 排除
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT bool "(固态 OR 全固态) 电池 NOT=(液态 OR 液体 OR 液态电解质)" --page-size 10
# 完整组合:申请人 + 关键词扩展 + IPC + 日期 + 排除
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT bool "AP=(华为) (智能驾驶 OR 自动驾驶 OR 无人驾驶 OR 辅助驾驶 OR ADAS OR ADS) IPC=(B60W OR G05D1) AD>=2022 NOT=(仿真 OR 模拟 OR 测试)" --page-size 10
分页参数: --page 页码(默认 1),--page-size 每页条数 1-100(默认 20)。
输入技术方案或技术问题描述,通过语义匹配返回相关专利。适用于查新、技术调研、专利避雷等场景。
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT semantic "新能源汽车电池热管理与安全监控系统" --timeout 180
工作流程:
task_id关键信息:
--timeout 默认 180 秒输出字段: 公开号、相似度、名称、申请人、IPC、申请日、公开日、摘要。
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT task <task_id>
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT cancel <task_id>
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT tasks --limit 10
语义检索返回的 claims 可能被截断,且不含 description(说明书)。如需完整内容,用 Bool 检索接口补全:
PATSEEK_API_KEY=ps_xxx $PYTHON_BIN $SCRIPT patent CN118447723A
| 错误 | 原因 | 处理方式 |
|---|---|---|
| --- | --- | --- |
| 401 INVALID_API_KEY | API Key 无效或已过期 | 提醒用户去 https://patseek.cn 重新申请 |
| 402 INSUFFICIENT_CREDITS | 积分不足 | 提醒用户登录 patseek.cn 充值积分 |
| 403 KEY_DISABLED | Key 被禁用 | 联系平台管理员 |
| 429 TASK_LIMIT_EXCEEDED | 并发任务超限 | 等待现有任务完成或取消不需要的任务 |
| 429 频率限制 | 请求过快 | 稍后重试 |
| 503 DB_UNAVAILABLE | 数据库不可用 | 稍后重试 |
当检测到未提供 PATSEEK_API_KEY 时,应向用户说明如何获取:
> 检测到未配置 PatSeek API Key。
> 请访问 https://patseek.cn 注册登录,在「个人中心 → API Key 管理」中创建新 Key。
> 获取后可通过以下方式之一使用:
> 1. 设置环境变量:export PATSEEK_API_KEY=ps_你的Key
> 2. 每次调用时加参数:--api-key ps_你的Key
H01M10 等长代码可能漏匹配,统一用 H01Minventors 字段只能通过关键词全文命中,精度有限references/query_syntax.mdreferences/api_reference.mdreferences/keyword_expansion.md共 2 个版本