Trademark Information Inquiry

---
name: "Trademark Information Inquiry - 商标信息查询"
description: 商标关键词搜索与详情查询（申请人、分类、公告等）。当用户说：查一下「某某」商标有没有被注册？这个商标注册人是谁？或类似商标问题时，使用本技能。
metadata: { "openclaw": { "emoji": "®️", "requires": { "bins": ["python3"], "env": ["JISU_API_KEY"] }, "primaryEnv": "JISU_API_KEY" } }
---

# 极速数据商标信息（Jisu Trademark）

> 数据由 **[极速数据（JisuAPI）](https://www.jisuapi.com/)** 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。

- **商标搜索**（`/trademark/search`）：按关键字、申请号、申请人等搜索商标；
- **商标详情**（`/trademark/detail`）：按申请/注册号 + 国际分类查询商标完整信息。

## 前置配置：获取 API Key

1. 前往 [极速数据官网](https://www.jisuapi.com/) 注册账号
2. 进入 [商标信息 API](https://www.jisuapi.com/api/trademark/) 页面，点击「申请数据」
3. 在会员中心获取 **AppKey**
4. 配置 Key：


```bash
# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
```

## 脚本路径

脚本文件：`skills/trademark/trademark.py`

## 使用方式

### 1. 商标搜索（/trademark/search）

```bash
python3 skills/trademark/trademark.py search '{"keyword":"手机","pagenum":1,"pagesize":10}'
```

请求 JSON 示例：

```json
{
  "keyword": "手机",
  "pagenum": 1,
  "pagesize": 10,
  "ismatch": 0,
  "type": 1,
  "classid": "0"
}
```

### 2. 商标详情（/trademark/detail）

```bash
python3 skills/trademark/trademark.py detail '{"regno":"4952050","classid":"42"}'
```

请求 JSON 示例：

```json
{
  "regno": "4952050",
  "classid": "42"
}
```

## 请求参数

### 商标搜索

| 字段名   | 类型   | 必填 | 说明                                                                 |
|----------|--------|------|----------------------------------------------------------------------|
| keyword  | string | 是   | 关键词                                                               |
| pagenum  | int    | 是   | 当前页，默认 1，最大 40                                              |
| pagesize | int    | 是   | 每页数量，默认 10，最大 100                                          |
| ismatch  | int    | 否   | 关键词是否完全匹配，默认 0                                           |
| type     | string | 否   | 关键词类型：1商标名，2注册号，3申请人，4商标名/注册号/申请人任一匹配，默认 1 |
| classid  | string | 否   | 国际分类，0 为全部，非 0 时限定在指定类别，多类别用分号分隔                 |

### 商标详情

| 字段名  | 类型   | 必填 | 说明       |
|---------|--------|------|------------|
| regno   | string | 是   | 申请/注册号 |
| classid | string | 是   | 国际分类     |

## 返回结果示例（节选）

### 商标搜索

```json
{
  "keyword": "手机",
  "pagenum": "1",
  "pagesize": "20",
  "list": [
    {
      "name": "手机工坊 SHOUJIDIY",
      "regno": "13145424",
      "classid": "14",
      "appdate": "2013-08-27",
      "firsttrialno": "1430",
      "firsttrialdate": "2014-11-06",
      "announceno": "1442",
      "announcedate": "2015-02-07",
      "pic": "http://api.jisuapi.com/trademark/upload/201807/31173651574910.jpg",
      "agent": "杭州龙华知识产权代理有限公司",
      "status": "注册申请完成",
      "registrant": "浙江富春江移动通信科技有限公司"
    }
  ],
  "total": "2764"
}
```

### 商标详情

```json
{
  "regno": "4952050",
  "classid": "42",
  "appdate": "2005-10-19",
  "firsttrialno": "1156",
  "firsttrialdate": "2009-02-20",
  "announceno": "1168",
  "announcedate": "2009-05-21",
  "startdate": "2009-05-21",
  "enddate": "2019-05-20",
  "iscommon": "0",
  "type": "一般",
  "pic": "http://api.jisuapi.com/trademark/upload/201807/29194006862201.jpg",
  "agent": "",
  "status": "",
  "name": "S",
  "registrant": "北京搜狗信息服务有限公司",
  "idcard": "",
  "address": "北京市海淀区中关村东路1号院9号楼搜狐网络大厦9层02房间",
  "productlist": [
    {
      "classid": "4220",
      "name": "计算机软件更新"
    }
  ],
  "processlist": [
    {
      "name": "商标注册申请中",
      "date": "2005-10-19"
    }
  ]
}
```

## 常见错误码

来源于 [极速数据商标文档](https://www.jisuapi.com/api/trademark/)：

| 代号 | 说明             |
|------|------------------|
| 201  | 关键词为空       |
| 202  | 注册号为空       |
| 203  | 分类 ID 为空     |
| 205  | 没有匹配的结果（扣次数） |
| 210  | 没有信息         |

系统错误码：

| 代号 | 说明                 |
|------|----------------------|
| 101  | APPKEY 为空或不存在  |
| 102  | APPKEY 已过期        |
| 103  | APPKEY 无请求权限    |
| 104  | 请求超过次数限制     |
| 105  | IP 被禁止            |

## 推荐用法

1. 用户输入：「帮我查一下和‘手机工坊’相关的注册商标。」  
2. 代理构造 JSON：`{"keyword":"手机工坊","pagenum":1,"pagesize":10}` 并调用：  
   `python3 skills/trademark/trademark.py search '{"keyword":"手机工坊","pagenum":1,"pagesize":10}'`  
3. 从搜索结果中选取目标商标（根据名称、申请人、分类等），记下其 `regno` 和 `classid`，再调用 `detail` 子命令获取完整详情。  
4. 将商标状态、公告期号、分类和申请人等关键信息整理成自然语言说明给用户。

## 关于极速数据

**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：

- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息  
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测  
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询  
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别  
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令  
- **位置服务**：基站查询，经纬度地址转换，坐标系转换  

在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。