| name | customs-ip-search |
| description | 海关知识产权备案查询。通过 Chrome 浏览器自动化访问海关总署备案查询系统（http://202.127.48.145:8888），查询品牌的海关保护备案状态，并提供风险评估和物流建议。当用户提到"查海关备案"、"品牌备案"、"海关备案查询"、"品牌合规筛查"、"知识产权海关备案"、"备案状态"等场景时使用。 |
海关知识产权备案查询
前置依赖
查询前按顺序检测并安装：
-
Chrome 浏览器 — 运行检测：
python3 scripts/customs_search.py --check-env
若 chrome 字段为 false，提示用户安装 Chrome（https://www.google.com/chrome/），中止。
-
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. 逐条查询
对每个品牌，调用脚本执行查询：
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 环境是否正常
