群组消息关键词搜索器

📣 功能定位与用途

该模块用于从你指定的 Telegram 群组中，搜索在最近若干天的群聊消息中出现的关键词内容，并记录下：

• 哪些用户发了包含关键词的消息

• 所在群组、关键词内容、发言人信息

适合用于：

• 精准线索识别（如提及“买币”、“接单”、“求合作”等）

• 获取目标行业中的“活跃需求用户”名单

• 结合监听器、私信模块做后续触达

---

🛠 使用流程说明

1. 输入目标群组

• 在第一个文本框粘贴你要监听的群组名称，每行一个，例如：

  @空投福利群  
  @项目对接TG  
  @外贸交流群

• 可点击按钮 【恢复历史】 快速加载之前输入过的群组列表

---

2. 输入关键词列表

• 在第二个文本框中粘贴你要监听的关键词，每行一个：

  空投  
  接单  
  找兼职  
  电影资源  
  低价出售

• 支持关键词中英文混合，系统会依次比对

---

3. 设置消息时间范围

• 在字段 【消息搜索时间范围】 中填写数字，例如：

  30

  表示只搜索目标群组中“过去 30 天内”的所有消息

• 时间单位为 天，你也可以调整为 7、60、90 等不同周期

---

4. 选择执行账号

• 点击 【选择账号】 → 弹出账号选择界面，支持：

  • 按账号编号筛选（例如账号 1～30）

  • 批量勾选要参与此次任务的协议号

---

5. 启动任务

• 点击 【启动】 按钮，系统将开始执行以下流程：

  • 登录账号

  • 进入你指定的群组

  • 扫描过去 X 天内的消息

  • 提取包含关键词的消息内容

  • 获取该消息的发言人、时间、命中关键词

---

6. 导出结果

• 点击 【保存结果】 按钮，导出搜索到的所有包含关键词的用户用户名（@username）

  ⚠ 当前版本仅导出用户列表，若你希望获取具体的消息内容或关键词对应行数，请结合监听机器人产品使用

---

✅ 推荐应用场景

应用场景	建议设置方式
寻找主动“需求”用户	输入关键词如：买粉、要机器人、代运营、兼职，收集精准用户群体
监听行业术语，建立线索池	用“币圈、拉人、广告位”等关键词，快速构建潜在客户触达名单
提取热词相关发言人用于私信引导	导出 @username 直接导入 TG-WAVE 的【私信功能模块】执行触达任务
联动监听器或答录机模块使用	可配合关键词监听器的数据输出，做线索挖掘与数据整合

---

⚠ 风控建议

• 避免使用长期风控账号，关键词搜索属于轻交互功能，但依然需要账号具备浏览权限

• 每个账号建议搜索不超过 30 个群组

• 若部分群组不可访问（私有、封禁、语言限制），程序会自动跳过