# HiWelink 外贸 AI 找客插件（HiwelinkFinder）功能与使用说明

> 版本：v1.0.0 品牌：HiWelink · 外贸 AI 找客 / 外贸客户开发 接口服务：[https://www.hiwelink.com（云端登录、同步均强制走线上地址）](https://www.hiwelink.com%EF%BC%88%E4%BA%91%E7%AB%AF%E7%99%BB%E5%BD%95%E3%80%81%E5%90%8C%E6%AD%A5%E5%9D%87%E5%BC%BA%E5%88%B6%E8%B5%B0%E7%BA%BF%E4%B8%8A%E5%9C%B0%E5%9D%80%EF%BC%89)

---

## 一、产品简介

HiwelinkFinder 是一款面向外贸 B2B 业务员的**客户线索采集插件**：从 Google / Bing 搜索、Google / Bing Maps、LinkedIn、Facebook、WhatsApp Web 及任意网站，一键提取**名称、电话、邮箱、网址**四大核心字段（辅助提取职位、地址、公司、社媒链接），本地暂存、云端同步并智能去重，客户线索统一沉淀到 Hiwelink 云端线索库。

---

## 二、功能特性

### 1. 多平台自动识别

打开页面后插件自动识别当前平台并在弹窗中标注：

<table id="bkmrk-%E5%B9%B3%E5%8F%B0-%E6%A0%87%E8%AF%86-google-%E6%90%9C%E7%B4%A2-goog"><thead><tr><th>平台</th><th>标识</th></tr></thead><tbody><tr><td>Google 搜索</td><td>google\_search</td></tr><tr><td>Bing 搜索</td><td>bing</td></tr><tr><td>Google Maps</td><td>google\_maps</td></tr><tr><td>Bing Maps</td><td>bing\_maps</td></tr><tr><td>LinkedIn</td><td>linkedin</td></tr><tr><td>Facebook</td><td>facebook</td></tr><tr><td>WhatsApp Web</td><td>whatsapp</td></tr><tr><td>其他任意网站</td><td>generic\_website</td></tr></tbody></table>

### 2. 四大核心字段采集

- **名称**：`og:title` → 页面标题 → H1 → 搜索结果显示卡 → Maps 商家名，逐级回退；
- **电话**：`tel:` 链接优先，页面文本正则扫描，Maps 商家电话；多个号码以 `;` 分隔保留；
- **邮箱**：`mailto:` 优先，页面正则扫描（自动过滤 example/test 等黑名单域名、no-reply 等无效邮箱），多邮箱仅取第一个为主，其余写入备注；
- **网址/官网**：显式"官网"链接 → 反查企业域名 → Maps 网站字段 → 页面根域名，统一去除协议前缀与尾部斜杠。

同时采集扩展字段：**职位（job\_title）、位置（location）、公司名（company）、社媒链接（linkedin/facebook/twitter/instagram/wa.me 等）**。

### 3. 四种采集模式

<table id="bkmrk-%E6%A8%A1%E5%BC%8F-%E8%A7%A6%E5%8F%91%E6%96%B9%E5%BC%8F-%E8%A1%8C%E4%B8%BA-%E9%87%87%E9%9B%86%E6%9C%AC%E9%A1%B5-%E5%BC%B9%E7%AA%97%E3%80%8C%F0%9F%9A%80"><thead><tr><th>模式</th><th>触发方式</th><th>行为</th></tr></thead><tbody><tr><td>**采集本页**</td><td>弹窗「🚀 采集本页」/ 右键「采集本页线索」</td><td>秒级解析当前页面；搜索页则批量提取全部搜索结果线索</td></tr><tr><td>**深度采集**</td><td>弹窗「⛏️ 深度采集」/ 右键</td><td>自动发现页面中的 contact / about / team 链接，依次打开采集（最多 10 页，间隔 2 秒）</td></tr><tr><td>**深采搜索结果**</td><td>弹窗「🔎 深采搜索结果」/ 右键（仅搜索页显示）</td><td>打开搜索结果中每个网站（最多 10 站），逐一采集真实邮箱/电话</td></tr><tr><td>**快速搜邮箱**</td><td>弹窗「⚡ 快速搜邮箱」/ 右键（仅搜索页显示）</td><td>对搜索结果域名执行 `inbody:@域名` 搜索引擎全文检索，**不打开网站**直接提取邮箱（并发 6，自动跳过搜索引擎/社交站自身域名）</td></tr></tbody></table>

### 4. 本地暂存与去重

- 采集结果先进入**本地待同步队列**（chrome.storage 无限存储），断网也能继续采集；
- 队列内按「邮箱|电话|名称」自动去重，容量上限 5000 条（超出自动淘汰最早数据）；
- 待同步数量以**红色徽标**显示在插件图标上（超过 99 显示 99+）。

### 5. 云端同步与智能去重

- 点击「☁️ 同步」或右键「立即同步」上传（每 100 条分块，自动带 `crawl_session_id` 批次号）；
- 服务端按优先级合并：**邮箱一致→合并更新**（不覆盖商机金额/归属/星级等销售字段）、**网址+名称相似→合并**、**仅电话一致→标记重复**、**无匹配→新增**；
- 返回 新增/更新/跳过 统计；新线索自动发送系统通知；
- 每 **30 分钟自动同步**一次（需已登录且有待同步数据）；
- 每次同步写入采集历史（最近 200 条），可按批次追溯。

### 6. 同步队列管理页（manager.html）

点击弹窗「📋 管理队列」打开：

- **统计卡片**：待同步线索 / 含邮箱 / 含电话 / 含网址 数量；
- **筛选与搜索**：按名称/电话/邮箱/网址关键词搜索，按平台筛选；
- **批量操作**：全选、删除选中、清空队列、单条删除；
- **立即同步**与**采集历史**展示（时间、批次、新增/更新/跳过数）。

### 7. 右键菜单快捷操作

在任意网页右键即可使用：采集本页线索、深度采集本页、深采搜索结果各网站、快速搜邮箱（不打开网站）。

### 8. 账号体系

- 用户名/邮箱 + 密码登录；
- 未注册可跳转官网「注册并免费试用」；
- 登录状态云端校验，账号**到期 / 停用 / 删除**自动禁止采集与同步；
- 试用到期时弹窗提示联系管理员（邮箱 allen@hiwelink.com / 微信 18555112860）。

### 9. 清空本地数据

「🗑️ 清空本地数据」清除待同步队列与同步历史，**保留登录状态**，云端数据不受影响。

---

## 三、安装步骤

1. 将下载的 ZIP 压缩包**完整解压**（不能直接在压缩包内安装）。
2. 打开 Chrome 或 Edge 扩展程序页： 
    - Chrome：`chrome://extensions`
    - Edge：`edge://extensions`
3. 开启右上角**开发者模式**。
4. 点击「**加载已解压的扩展程序**」，选择解压后直接包含 manifest.json 的 **HiwelinkFinder** 文件夹。
5. 点击浏览器工具栏插件图标，登录 Hiwelink 账号即可开始使用。

> 更新旧版本：将新版文件覆盖到原插件文件夹，再到扩展程序页点击「重新加载」。不要先卸载旧插件，以免清除本地登录状态与待同步队列。

---

## 四、使用说明

### 1. 登录

- 点击插件图标 → 输入用户名/邮箱与密码 → 登录；
- 无账号点击「注册并免费试用」跳转 www.hiwelink.com/register 注册。

### 2. 采集当前页

- 打开目标网站（或 Google/Bing 搜索结果页、Maps 商家列表等）；
- 点击插件图标 → 「🚀 采集本页」；
- 查看统计（名称/电话/邮箱/网址数量），结果自动进入待同步队列。

### 3. 深度采集

在客户官网等页面点击「⛏️ 深度采集」，插件自动发现并打开 contact / about / team 等子页面逐页采集，聚合更完整的联系方式。

### 4. 深采搜索结果（搜索页专用）

在 Google/Bing 搜索结果页点击「🔎 深采搜索结果各网站」，后台依次打开结果网站采集真实邮箱/电话，适合把搜索结果批量转成线索。

### 5. 快速搜邮箱（搜索页专用）

点击「⚡ 快速搜邮箱」，对搜索结果域名执行搜索引擎全文检索，直接提取该域名下公开邮箱，**不打开任何网站**，秒级完成。

### 6. 同步到云端

- 点击「☁️ 同步」手动立即同步；
- 或等待每 30 分钟自动同步；
- 同步完成后查看新增/更新/跳过数量，新线索通知；
- 登录 www.hiwelink.com → 用户中心 → 联系人/线索 即可查看云端沉淀的客户数据。

### 7. 管理待同步队列

点击「📋 管理队列」：

- 查看待同步线索（含名称/联系方式/平台标签）；
- 按关键词或平台筛选，勾选删除不需要的数据；
- 点击「☁️ 立即同步」批量上传。

---

## 五、采集节奏与合规提示

- **安全延迟**：深度采集、搜索深采默认每个网站间隔 **2 秒**，快速搜邮箱带并发节流，避免触发平台风控；
- 请在合理频率下使用，特别是 LinkedIn / Facebook 等平台，短时间大量请求可能导致账号受限；
- 采集数据仅用于您自身的客户管理工作，支持随时在云端导出或删除。

---

## 六、常见问题（FAQ）

**Q1：为什么插件图标上一直有红色数字？** 红色数字 = 待同步队列条数。点击插件 → 「☁️ 同步」上传到云端后即消失；也可在「管理队列」中清理。

**Q2：采集不到邮箱？** 网站本身未公开邮箱时无法提取；可尝试「深度采集」或「快速搜邮箱」补充；部分网站做了邮箱混淆/图片化，需要到页面内查看。

**Q3：提示"账号已失效 / 请重新登录"？** 登录状态已过期或账号被停用/到期。重新登录；试用到期请联系管理员 allen@hiwelink.com。

**Q4：同步时提示失败？** 确认网络正常且接口地址为 [https://www.hiwelink.com；失败数据会保留在本地队列，恢复后可重新同步。](https://www.hiwelink.com%EF%BC%9B%E5%A4%B1%E8%B4%A5%E6%95%B0%E6%8D%AE%E4%BC%9A%E4%BF%9D%E7%95%99%E5%9C%A8%E6%9C%AC%E5%9C%B0%E9%98%9F%E5%88%97%EF%BC%8C%E6%81%A2%E5%A4%8D%E5%90%8E%E5%8F%AF%E9%87%8D%E6%96%B0%E5%90%8C%E6%AD%A5%E3%80%82)

**Q5：同步后云端没看到数据？** 登录 www.hiwelink.com → 用户中心 → 联系人/线索 查看；注意区分"本插件同步"与"社媒聊天采集"两个入口，线索归属当前登录账号。

**Q6：换电脑/重装插件后数据会丢吗？** 请先同步到云端再重装。重装后登录同一账号，云端线索仍在；本地未同步队列无法自动恢复。

---

## 七、技术说明（可选）

- 云端地址强制为 `https://www.hiwelink.com`（存储中出现其他地址一律回退，防本地环境串线）；
- 同步接口：`POST /api/v2/leads/sync`（每批 100 条，Bearer Token 鉴权）；
- 本地存储键：`hiwelink_finder_cloud`（登录态）、`hiwelink_finder_pending`（待同步队列）、`hiwelink_finder_history`（同步历史）；
- WhatsApp 采集通过注入 `wa-bridge.js`（WPP 库）读取会话联系人，仅在你打开 web.whatsapp.com 时生效。