customs-ip-search

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

海关知识产权备案查询

前置依赖

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

1. Chrome 浏览器 — 运行检测：

   python3 scripts/customs_search.py --check-env
   

   若 chrome 字段为 false，提示用户安装 Chrome（https://www.google.com/chrome/），中止。

2. Python 依赖 — 若 nodriver 字段为 false，安装：

   python3 scripts/customs_search.py --install-deps
   

   安装超时则自动切换清华镜像（https://pypi.tuna.tsinghua.edu.cn/simple）。

工作流

1. 识别品牌

从用户消息中提取品牌名称列表。示例：

• "查一下 TRW 的备案" → ["TRW"]
• "帮我查 NIKE ADIDAS PUMA" → ["NIKE", "ADIDAS", "PUMA"]

2. 逐条查询

对每个品牌，调用脚本执行查询：

# 如果 .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，格式：

{
  "brand": "TRW",
  "source": "online|cache",
  "count": 4,
  "records": [
    {
      "查询品牌": "TRW",
      "权利名称": "TRW",
      "权利人名称": "TRW知识产权公司",
      "权利人国别": "美国",
      "权利号": "244497",
      "备案号": "T2016-50578",
      "权利类别": "国内注册",
      "商品分类": "第9类",
      "备案状态": "生效",
      "备案开始日期": "2026-02-28",
      "备案截止日期": 
       
    
  
   
     
     
     
     
  

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 环境是否正常