👥 全量群成员高纯度精准采集 (parsing) 操作指南

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

• 功能概述：系统针对 Telegram 公开超级群组（Supergroup）与频道讨论群，进行底层协议级全量或活跃成员数据逆向采集提取。支持按用户最近在线时间、多国语言特征（中文、英语、俄语、阿拉伯语、波斯语、希伯来语等）、会员身份过滤，剔除管理员与僵尸粉，直接沉淀高净值客户名单。
• 实现功能：
  • 突破官方客户端限制提取全量成员；
  • 按照最后在线时间范围（如近 1 天、3 天、7 天内活跃）提取活跃用户；
  • 自动识别多国语言并精准按语种分流输出；
  • 自动剔除群主、群管理团队与官方机器人，防止后续营销误触风控；
  • 采集完成后全自动静默退群，不在目标群组留下任何痕迹。
• 核心优点：
  • 多语种极速过滤：原生支持中、英、阿、波斯等多语种名字与简介过滤引擎；
  • 高存活高转化：严格过滤已注销死号（Deleted Account）与死粉，确保名单 100% 为实时真人；
  • 协议多线程并发：多个小号分段轮流抓取群元数据，单群万级成员仅需几十秒。

2. 界面功能全景图

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

表 1：输入参数清单

字段 / 控件 ID	界面显示名	数据类型	默认值	推荐配置	字段深度业务逻辑与防封说明
usernames	目标群组链接	文本域	空	每行一个链接	支持 @groupname 或 https://t.me/groupname 格式
parsing_days	活跃时间跨度	整数(天)	0	3~7 天	0 为不限时间采集全量；填 7 表示仅抓取最近 7 天内上线过的真实活跃用户
max_flood_wait	最大防风控容忍	整数(秒)	60	300	遇到 Telegram 服务器 FloodWait 频率限制时的最大等待秒数，超时则自动跳过
file_db	目标输出数据库	字符串	空	绝对路径	采集结果存储的 SQLite 数据库文件路径（可直接作为后续发信或拉群输入库）
thread_count	并发线程数	整数	1	2~5	多个账号并发执行采集任务的线程数量
thread_wait_from	线程间隔下限	整数(秒)	1	2~5	连续处理两个群组之间的最小随机休眠秒数
thread_wait_to	线程间隔上限	整数(秒)	3	5~10	连续处理两个群组之间的最大随机休眠秒数

表 2：控制开关深度说明

开关控件 ID	界面开关名	默认状态	底层 MTProto 协议机制与防封说明
users_cn	仅保留中文用户	关闭	通过正则匹配中文汉字昵称与简介，专用于华人跨境与出海圈精准捞客
users_en	仅保留英语用户	关闭	筛选拉丁字母用户，适用于欧美与全球化加密项目引流
users_ru	仅保留俄语用户	关闭	筛选西里尔字母用户，适用于独联体国家业务拓展
users_ar	仅保留阿拉伯语用户	关闭	筛选中东与北非高客单阿语流量
leave_group	采集完毕自动退群	开启	调用 channels.leaveChannel，采集完成后立即退出目标群，降低被群管理员反查风险
exclude_admins	自动剔除管理员	开启	自动比对群管理名单，剔除群主和所有管理员，避免后续私信营销被管理直接举报封禁
create_txt	导出独立 TXT 文本	开启	除了存入数据库外，额外生成纯文本格式的 @username 清单文件方便二次分发
use_data_base	使用已有数据库	关闭	开启后采集数据追加并排重至已有数据库，关闭则覆盖或新建
accounts_choose_all	选用所有已选账号	关闭	快速分配当前左侧过滤好的执行小号进行协同轮换采集

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

1. 第一步：输入群链接与语种：在左侧输入目标群组链接，勾选目标语言（如 users_cn），输入活跃限制为 3 天。
2. 第二步：配置防封与退出：务必勾选 leave_group（退群）与 exclude_admins（剔除管理），指定落地数据库文件。
3. 第三步：启动采集与导出：点击右上角绿色“开始采集”按钮。界面实时刷新抓取进度条，完成后在软件根目录 results/ 生成对应 TXT 和 DB 文件。

5. 执行结果与产物说明

• 产物文件：在 results/parsing/ 目录下生成 群名_语种_时间戳.txt 与 SQLite 格式数据包，包含用户 ID、Access Hash、Username、全名、最后上线时间戳、语言分类。