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) install: - kind: uv package: requests

專利檢索 · Patent Search

概述 | Overview

憑證 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: 專利評級排序

  發現更多技能外掛，請訪問7w4.net。

常見問題

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

這是一個功能豐富的專利檢索工具，文件完善、雙語支援、配置清晰，錯誤處理考慮周全。唯一的門檻是需要先申請 API Token，但這是獲取專利資料的必要步驟。整體質量良好，適合需要專利檢索和分析的使用者使用。