🔎 超级群组与频道搜索发现 (search_groups) 操作指南

1. 功能整体描述与核心价值

• 功能概述：利用 Telegram 原生全局检索协议（contacts.search 与 channels.searchGlobal），突破客户端本地仅显示前 3 个结果的限制，暴力挖掘海量行业群组、竞品频道与兴趣社区。
• 实现功能：
  • 多关键词衍生递归深度检索；
  • 自动识别搜索结果是“公开超级群（Group）”还是“广播频道（Channel）”；
  • 自动提取群内当前人数、在线人数、群描述与公开链接；
  • 支持按人数下限与上限（如仅要 1000 人以上的大群）自动过滤。
• 核心优点：
  • 源头活水拓客：彻底解决“没有群组链接无法展开采集和营销”的冷启动痛点；
  • 群活跃度透视：直接提取群当前在线人数，过滤无人发言的死群与纯僵尸群；
  • 一键导入流水线：搜索出的群链接可一键同步给“全量采集”或“超级群发”模块。

2. 界面功能全景图

3. 输入参数字典与控制开关深度说明

表 1：输入参数清单

字段 / 控件 ID	界面显示名	数据类型	默认值	推荐配置	字段深度业务逻辑与防封说明
keywords	搜索关键词列表	文本域	空	行业词	支持中英文核心词（如 “crypto, web3, 外贸, 亚马逊, 换汇”）
min_members	成员数量下限	整数	100	500~1000	自动过滤人数少于该阈值的小群，确保群质量
max_results	单词最大搜索数	整数	50	100	每个关键词从 Telegram 全局网络中抓取的最大条目上限
file_db	结果输出文件	字符串	空	绝对路径	搜索到的群资产库存储路径

表 2：控制开关深度说明

开关控件 ID	界面开关名	默认状态	底层 MTProto 协议机制与防封说明
only_groups	仅保留超级群组	开启	自动剔除无法发言的广播频道，仅输出可以拉人和群发的有效群组
only_channels	仅保留广播频道	关闭	仅输出适合投放广告或采集动态评论的行业顶流频道
check_can_send	检测群内发言权限	开启	自动预检该群是否开启了“全员禁言”或“慢速模式”，剔除死禁群

4. 推荐标准操作流程 (SOP)

1. 第一步：定义搜索词：输入您行业的 5~10 个核心词汇及长尾词。
2. 第二步：设置质量过滤：勾选 only_groups，人数下限设置为 500。
3. 第三步：执行检索与导出：点击开始搜索，几秒钟内即可抓取数百个垂直行业大群，一键导出为 TXT 供后续拉群与群发使用。

5. 执行结果与产物说明

• 产物文件：在 results/search/ 下生成 search_groups_时间戳.txt，包含群标题、公开链接、成员总数。