patent-search

name	patent-search
description	Patent search and analytics via 9235 API (search, detail, claims, company portrait, Excel export).
version	1.0.10
metadata	{"openclaw":{"emoji":"📜","homepage":"https://www.9235.net/api/open","primaryEnv":"PATENT_API_TOKEN","requires":{"env":["PATENT_API_TOKEN"],"bins":["python3"]},"envVars":[{"name":"PATENT_API_TOKEN","required":true,"description":"9235 patent search API token from https://www.9235.net/api/open"},{"name":"PATENT_API_BASE_URL","required":false,"description":"Optional API base URL (default https://www.9235.net/api)"},{"name":"PATENT_URL_TEMPLATE","required":false,"description":"Patent web page template, e.g. https://www.9235.net/patent/{patent_id}.html"}],"install":[{"kind":"uv","package":"requests"}]}}

专利检索 · 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 & family 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

可选配置（config.json）：patentUrl（如 https://www.9235.net/patent → 链到 …/patent/CN115755970A.html）、show_patent_images（详情内嵌摘要附图）。命令 image 可返回附图 Markdown 与可下载文件。

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

---

功能概述

• 专利搜索: 根据关键词、申请人、发明人、IPC分类等条件搜索专利
• 专利详情: 查看专利的完整信息，包括摘要、申请人、发明人、法律状态等
• 权利要求: 查看专利的权利要求书
• 说明书: 查看专利的说明书全文
• 法律信息: 查看专利的法律事务信息
• 引用分析: 查看专利的引用和被引用情况
• 相似专利: 查找技术相近专利（/api/patent/like）
• 专利同族: 同一专利族在不同国家/阶段的文献（/api/patent/family，命令 family）
• 企业画像: 分析企业的专利布局和竞争力
• 文件下载: 下载专利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. 查看专利同族

/family CN110382353B
/family CN110382353B --limit 30

9. 企业画像分析

/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。

技术支持

如有问题，请参考：

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