---
name: customs-ip-search
description: 海关知识产权备案查询。通过 Chrome 浏览器自动化访问海关总署备案查询系统（http://202.127.48.145:8888），查询品牌的海关保护备案状态，并提供风险评估和物流建议。当用户提到"查海关备案"、"品牌备案"、"海关备案查询"、"品牌合规筛查"、"知识产权海关备案"、"备案状态"等场景时使用。
---

# 海关知识产权备案查询

## 前置依赖

查询前按顺序检测并安装：

1. **Chrome 浏览器** — 运行检测：
   ```bash
   python3 scripts/customs_search.py --check-env
   ```
   若 chrome 字段为 false，提示用户安装 Chrome（https://www.google.com/chrome/），中止。

2. **Python 依赖** — 若 nodriver 字段为 false，安装：
   ```bash
   python3 scripts/customs_search.py --install-deps
   ```
   安装超时则自动切换清华镜像（`https://pypi.tuna.tsinghua.edu.cn/simple`）。

## 工作流

### 1. 识别品牌

从用户消息中提取品牌名称列表。示例：
- "查一下 TRW 的备案" → `["TRW"]`
- "帮我查 NIKE ADIDAS PUMA" → `["NIKE", "ADIDAS", "PUMA"]`

### 2. 逐条查询

对每个品牌，调用脚本执行查询：
```bash
# 如果 .venv 存在，使用 venv 的 Python
if [ -f scripts/../.venv/bin/python ]; then
  .venv/bin/python scripts/customs_search.py --brand "TRW"
else
  python3 scripts/customs_search.py --brand "TRW"
fi
```

简化判断：先用 `--check-env` 检测，返回的 `venv_python` 字段即为可用的 Python 路径。

脚本内部自动完成：
- 检测 Chrome + Python 环境
- 读取本地 CSV 缓存，判断是否需要在线查询
- 缓存 < 7 天 → 直接返回缓存结果
- 缓存 ≥ 7 天或无缓存 → nodriver 启动 Chrome 在线查询
- 在线查询结果自动写入 CSV

多个品牌串行查询，每次间隔 2 秒，避免被封 IP。

### 3. 解析结果

脚本输出 JSON，格式：
```json
{
  "brand": "TRW",
  "source": "online|cache",
  "count": 4,
  "records": [
    {
      "查询品牌": "TRW",
      "权利名称": "TRW",
      "权利人名称": "TRW知识产权公司",
      "权利人国别": "美国",
      "权利号": "244497",
      "备案号": "T2016-50578",
      "权利类别": "国内注册",
      "商品分类": "第9类",
      "备案状态": "生效",
      "备案开始日期": "2026-02-28",
      "备案截止日期": "2036-02-27",
      "查询时间": "2026-05-25 18:00:00"
    }
  ],
  "risk": {
    "level": "high|medium|low",
    "emoji": "🔴|🟡|🟢",
    "label": "高风险|中风险|低风险",
    "advice": "物流建议文本"
  }
}
```

### 4. 通知用户

按品牌分组展示结果，格式：

```
🔍 TRW 查询结果（共 4 条，来源：在线）

🔴 高风险 — 品牌已备案生效，海关重点监控

1. TRW | TRW知识产权公司 | 美国 | T2016-50578 | 第9类 | 生效 | 2026-02-28 ~ 2036-02-27
2. TRW | TRW知识产权公司 | 美国 | T2016-50576 | 第9类 | 生效 | 2026-02-28 ~ 2036-02-27
...

⚠️ 物流建议：品牌已备案生效，海关重点监控。请确认货物是否有品牌授权书，无授权情况下退运/扣货风险极高。
```

### 5. 多品牌汇总

全部查询完毕后，如有多个品牌，给出汇总表格。

## 风险评估规则

| 备案状态 | 风险等级 | 建议 |
|---------|---------|------|
| 生效 | 🔴 高风险 | 确认是否有品牌授权，无授权退运/扣货风险极高 |
| 到期 | 🟡 中风险 | 曾有保护记录，存在追溯风险，谨慎处理 |
| 撤销/注销 | 🟢 低风险 | 常规通关，建议定期复查 |
| 无记录 | 🟢 低风险 | 通关风险较低 |

## CSV 缓存

- 文件：`知识产权海关保护备案.csv`（工作区根目录）
- 编码：UTF-8 BOM
- 表头：`查询品牌,权利名称,权利人名称,权利人国别,权利号,备案号,权利类别,商品分类,备案状态,备案开始日期,备案截止日期,查询时间`
- 同一品牌多条备案按行存储
- 过期判断：该品牌最新 `查询时间` 距今 ≥ 7 天则重新查询
- 更新策略：重新查询后替换该品牌全部旧记录

## 注意事项

- 每次查询约 15-20 秒（含 WAF 验证）
- 不要并发查询，串行处理
- 查询过程中会弹出 Chrome 窗口，查询完毕自动关闭
- 需要能访问 `202.127.48.145:8888`
- 如果脚本报错，检查 Chrome 和 Python 环境是否正常