patent-search

Patent search and analytics via 9235 API (search, detail, claims, company portrait, Excel export).

Install

openclaw skills install @windinwing/patent-search

专利检索 · Patent Search

概述 | Overview


中文	对接 9235 专利 API：检索、详情、权利要求、说明书、法律信息、引用/相似专利、企业画像（工商全称）、统计与 Excel 导出；数据范围 `cn` / `all` / `us` / `jp` / `kr` / `tw` / `wo` / `ep`。
English	9235 patent API client: search, detail, claims, description, legal events, citations, similar patents, company portrait, analytics, Excel export; scopes `cn`, `all`, `us`, `jp`, `kr`, `tw`, `wo`, `ep`.

凭证 Credentials: PATENT_API_TOKEN 或 OpenClaw skills.entries.patent-search.apiKey · 申请 https://www.9235.net/api/open

用户可说：「检索大疆无人机专利」「全球检索锂电池」「华为技术有限公司企业画像」「导出当前检索 Excel」。

功能概述

专利搜索: 根据关键词、申请人、发明人、IPC分类等条件搜索专利
专利详情: 查看专利的完整信息，包括摘要、申请人、发明人、法律状态等
权利要求: 查看专利的权利要求书
说明书: 查看专利的说明书全文
法律信息: 查看专利的法律事务信息
引用分析: 查看专利的引用和被引用情况
相似专利: 查找相似专利
企业画像: 分析企业的专利布局和竞争力
文件下载: 下载专利PDF全文和摘要附图
统计分析: 专利维度统计分析
导出 Excel: export 导出检索列表；export_analysis 导出统计分布（需 dimension）
著作权搜索: 软件著作权和作品著作权搜索
商标搜索: 商标信息搜索

安装

自动安装

bash

# 进入技能目录（本仓库 patents/patent-search）
cd /path/to/patents/patent-search

# 运行安装脚本
python3 setup.py

手动安装

bash

# 1. 安装依赖
pip3 install requests --break-system-packages

# 2. 设置文件权限
chmod +x patent_api.py main.py setup.py

# 3. 创建配置文件
cp config.example.json config.json
# 编辑config.json，设置您的API token

配置

配置文件

在技能目录下创建 config.json 文件（或复制 config.example.json）：

json

{
  "api_base_url": "https://www.9235.net/api",
  "token": "YOUR_API_TOKEN_HERE",
  "default_data_scope": "cn",
  "default_page_size": 10,
  "max_records": 1000,
  "timeout_seconds": 30,
  "download_dir": "./downloads",
  "enable_cache": false,
  "cache_ttl_seconds": 3600,
  "retry_times": 3,
  "retry_delay_seconds": 1
}

环境变量配置

bash

export PATENT_API_TOKEN="your_token_here"
export PATENT_API_BASE_URL="https://www.9235.net/api"
export PATENT_DEFAULT_SCOPE="cn"
export PATENT_DOWNLOAD_DIR="./downloads"

获取API Token

访问 https://www.9235.net/api/open
申请API访问权限
获取token后填入配置文件

使用方法

运行模式

交互模式:

bash

python3 main.py
# 然后输入命令，如: search 无人机

命令行模式:

bash

python3 main.py <命令> <参数>

1. 搜索专利

基本搜索:

bash

/search 无人机
/search 石墨烯
/search "新能源汽车"

高级搜索:

bash

/search agency:北京博思佳知识产权代理有限公司
/search documentYear:[2020 TO 2024] AND 锂电池
/search applicant:"清华大学" AND 人工智能
/search 无人机 AND type:发明授权 AND legalStatus:有效专利

带选项搜索:

bash

/search 无人机 --page 2 --page-size 20
/search 无人机 --sort applicationDate
/search 无人机 --sort !documentDate  # 降序
/search 无人机 --scope all  # 全球搜索
/search 无人机 --details  # 显示详细信息

2. 查看专利详情

bash

/patent CN110382353B

3. 查看权利要求

bash

/claims CN110382353B

4. 查看说明书

bash

/desc CN110382353B

5. 查看法律信息

bash

/law CN110382353B

6. 查看引用分析

bash

/citing CN110382353B

7. 查看相似专利

bash

/similar CN110382353B

8. 企业画像分析

bash

/company 深圳市大疆创新科技有限公司
/company 华为技术有限公司

9. 著作权搜索

软件著作权:

bash

/copyright 档案管理系统 --type software
/copyright owner:阿里巴巴 --type software --field owner

作品著作权:

bash

/copyright 美术作品 --type works
/copyright author:张三 --type works --field author

10. 商标搜索

商标列表:

bash

/trademark 华为
/trademark 阿里巴巴 --page 2 --page-size 20

商标详情:

bash

/trademark --detail --trademark-id "2020163926c8006d56dba63557fbefe8213a3aaa"

11. 统计分析

bash

/analysis 人工智能 --dimension ipc
/analysis 锂电池 --dimension applicant --scope all
/analysis documentYear:[2020 TO 2024] AND 5G --dimension province

12. 下载文件

bash

/download CN110382353B --type pdf
/download CN110382353B --type image
/download CN110382353B --type all --output ./my_downloads/

13. 帮助信息

bash

/help

检索式语法参考

字段限定

title:无人机 - 标题包含无人机
applicant:"清华大学" - 申请人为清华大学
inventor:王勇 - 发明人包含王勇
agency:北京博思佳知识产权代理有限公司 - 代理机构
ipc:G01C - IPC分类号
mainIpc:H04N - 主分类号
province:广东省 - 省份
city:深圳市 - 城市

时间范围

applicationYear:[2020 TO 2024] - 申请年份范围
documentYear:[2019 TO 2023] - 公开年份范围
applicationDate:[2020-01-01 TO 2024-12-31] - 申请日期范围

逻辑运算

AND - 与关系 (默认，空格表示AND)
OR - 或关系
NOT - 非关系
() - 括号分组

专利类型

type:发明公开
type:发明授权
type:实用新型
type:外观设计
type:PCT发明专利
type:PCT实用新型

法律状态

legalStatus:有效专利
legalStatus:失效专利
legalStatus:实质审查
legalStatus:公开

国家/地区

countryCode:CN - 中国
countryCode:US - 美国
countryCode:JP - 日本
countryCode:EP - 欧洲

精确匹配

使用双引号: "无人机控制系统"
避免分词: "新能源汽车电池"

通配符

*: 多个字符通配符
?: 单个字符通配符
示例: comput* 匹配 computer, computing 等

完整示例

1. 技术领域搜索

bash

# 搜索无人机相关专利
/search 无人机

# 搜索大疆公司的无人机专利
/search 无人机 AND applicant:"深圳市大疆创新科技有限公司"

# 搜索2020-2024年的锂电池专利，按申请时间降序
/search documentYear:[2020 TO 2024] AND 锂电池 --sort !applicationDate

# 搜索清华大学的AI专利，显示详细信息
/search applicant:"清华大学" AND 人工智能 --details

2. 企业分析

bash

# 华为公司专利分析
/company 华为技术有限公司

# 阿里巴巴集团专利布局
/company 阿里巴巴集团控股有限公司

# 分析大疆公司的技术领域
/analysis applicant:"深圳市大疆创新科技有限公司" --dimension ipc

3. 专利分析

bash

# 查看专利详情
/patent CN110382353B

# 查看专利权利要求
/claims CN110382353B

# 查看专利法律状态变化
/law CN110382353B

# 查找相似专利
/similar CN110382353B

# 分析专利引用关系
/citing CN110382353B

4. 统计分析

bash

# 分析人工智能技术的IPC分类分布
/analysis 人工智能 --dimension ipc

# 分析锂电池技术的申请人分布
/analysis 锂电池 --dimension applicant

# 分析5G技术的省份分布
/analysis 5G --dimension province

# 分析新能源汽车的申请趋势
/analysis 新能源汽车 --dimension applicationYear

5. 文件操作

bash

# 下载专利PDF
/download CN110382353B --type pdf

# 下载专利图片
/download CN110382353B --type image

# 下载所有文件到指定目录
/download CN110382353B --type all --output ./patent_files/

6. 著作权和商标

bash

# 搜索软件著作权
/copyright 管理系统 --type software

# 搜索作品著作权
/copyright 美术作品 --type works

# 搜索商标
/trademark 华为

# 查看商标详情
/trademark --detail --trademark-id "商标ID"

7. 复杂检索式

bash

# 组合条件搜索
/search (无人机 OR 无人车) AND (雷达 OR 传感器) AND applicationYear:[2020 TO 2024]

# 排除特定分类
/search 石墨烯 AND NOT mainIpc:H

# 多条件筛选
/search 电池 AND type:发明授权 AND legalStatus:有效专利 AND province:广东省

重要注意事项

API限制

记录限制: 每次搜索最多返回1000条记录
分页限制: 最大100页，每页最多50条
ID有效期: 专利ID有效期为60分钟
访问限制: 直接访问详情接口每天前200个免费
频率限制: 注意API调用频率，避免被封禁

使用建议

合理分页: 使用--page和--page-size参数控制数据量
精确检索: 使用字段限定提高检索精度
时间范围: 使用时间范围缩小检索结果
保存ID: 及时使用搜索得到的专利ID
错误处理: 注意错误代码，合理重试

排序选项

relation: 相关度排序 (默认)
applicationDate: 申请时间排序
!applicationDate: 申请时间降序
documentDate: 公开时间排序
!documentDate: 公开时间降序
rank: 专利评级排序

常见问题

Q: 为什么搜索不到结果？ A: 检查检索式语法，尝试简化关键词
Q: 为什么无法查看专利详情？ A: 专利ID可能已过期，重新搜索获取新ID
Q: 为什么下载失败？ A: 检查网络连接，确认专利有PDF文件
Q: 如何提高搜索精度？ A: 使用字段限定、时间范围、逻辑运算
Q: 如何获取API token？ A: 访问 https://www.9235.net/api/open 申请

错误代码处理

常见错误代码

200: 响应成功
201: token为空 - 检查配置文件或环境变量
202: 非法token - token无效或过期，重新申请
203: 响应异常 - API服务器错误，稍后重试
204: ip被拒绝访问 - 检查IP白名单
205: 参数值为空 - 检查请求参数
206: 没有找到对应数据 - 调整检索条件
207: 该接口当天访问次数已经用尽 - 次日再试或升级套餐
208: 没有访问权限 - 检查API权限
209: 版本号为空 - 内部错误，联系技术支持
210: 参数错误 - 检查参数格式
211: 该等级接口当年专利总数量已经用尽 - 升级套餐或次年使用
212: 分析维度为空 - 指定分析维度
213: 分析维度不存在 - 检查维度名称
214: TOKEN类型错误 - 检查token类型
215: 异常访问，被终止 - 遵守API规范，通过搜索接口获取ID

错误处理建议

检查配置: 确认token和API地址正确
验证网络: 检查网络连接是否正常
简化请求: 减少请求数据量，使用分页
查看日志: 查看详细错误信息
联系支持: 访问 https://www.9235.net 获取技术支持

高级功能

批量处理

text

/search 锂电池 --save-to-file patents.json

统计分析

text

/search 新能源汽车 --stats

导出结果

text

/search 5G通信 --export csv

更新日志

v1.0.10: 精简核心（移除 trend/analysis/test 等 8 个开发脚本）；Excel 导出（excel_export.py）；完善凭证说明与文档。
v1.0.0: 初始版本，支持基本搜索和详情查看

详见 CHANGELOG.md。

技术支持

如有问题，请参考：

API文档: https://www.9235.net/api/interface.html
检索帮助: https://www.9235.net/help/index.html
申请token: https://www.9235.net/api/open

patent-search

Install

专利检索 · Patent Search

概述 | Overview

功能概述

安装

自动安装

手动安装

配置

配置文件

环境变量配置

获取API Token

使用方法

运行模式

1. 搜索专利

2. 查看专利详情

3. 查看权利要求

4. 查看说明书

5. 查看法律信息

6. 查看引用分析

7. 查看相似专利

8. 企业画像分析

9. 著作权搜索

10. 商标搜索

11. 统计分析

12. 下载文件

13. 帮助信息

检索式语法参考

字段限定

时间范围

逻辑运算

专利类型

法律状态

国家/地区

精确匹配

通配符

完整示例

1. 技术领域搜索

2. 企业分析

3. 专利分析

4. 统计分析

5. 文件操作

6. 著作权和商标

7. 复杂检索式

重要注意事项

API限制

使用建议

排序选项

常见问题

错误代码处理

常见错误代码

错误处理建议

高级功能

批量处理

统计分析

导出结果

更新日志

技术支持

Related skills