ClawHub

patent-search

API key required
Data & APIs

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

Install

openclaw skills install patent-search

专利检索 · Patent Search

概述 | Overview

中文对接 9235 专利 API：检索、详情、权利要求、说明书、法律信息、引用/相似专利、企业画像（工商全称）、统计与 Excel 导出；数据范围 cn / all / us / jp / kr / tw / wo / ep。
English9235 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）
  • 著作权搜索: 软件著作权和作品著作权搜索
  • 商标搜索: 商标信息搜索

安装

自动安装

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

# 运行安装脚本
python3 setup.py

手动安装

# 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）：

{
  "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
}

环境变量配置

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

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

使用方法

运行模式

交互模式:

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

命令行模式:

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

1. 搜索专利

基本搜索:

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

高级搜索:

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

带选项搜索:

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

2. 查看专利详情

/patent CN110382353B

3. 查看权利要求

/claims CN110382353B

4. 查看说明书

/desc CN110382353B

5. 查看法律信息

/law CN110382353B

6. 查看引用分析

/citing CN110382353B

7. 查看相似专利

/similar CN110382353B

8. 企业画像分析

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

9. 著作权搜索

软件著作权:

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

作品著作权:

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

10. 商标搜索

商标列表:

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

商标详情:

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

11. 统计分析

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

12. 下载文件

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

13. 帮助信息

/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. 技术领域搜索

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

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

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

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

2. 企业分析

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

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

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

3. 专利分析

# 查看专利详情
/patent CN110382353B

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

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

# 查找相似专利
/similar CN110382353B

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

4. 统计分析

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

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

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

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

5. 文件操作

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

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

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

6. 著作权和商标

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

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

# 搜索商标
/trademark 华为

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

7. 复杂检索式

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

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

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

重要注意事项

API限制

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

使用建议

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

排序选项

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

常见问题

  1. Q: 为什么搜索不到结果？ A: 检查检索式语法，尝试简化关键词

  2. Q: 为什么无法查看专利详情？ A: 专利ID可能已过期，重新搜索获取新ID

  3. Q: 为什么下载失败？ A: 检查网络连接，确认专利有PDF文件

  4. Q: 如何提高搜索精度？ A: 使用字段限定、时间范围、逻辑运算

  5. 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

错误处理建议

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

高级功能

批量处理

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

统计分析

/search 新能源汽车 --stats

导出结果

/search 5G通信 --export csv

更新日志

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

详见 CHANGELOG.md。

技术支持

如有问题，请参考：

More in Data & APIs