核心用法
tg-channel-reader 是一款基于 MTProto 协议的 Telegram 频道读取工具,支持 Pyrogram 与 Telethon 双后端。核心功能包括:
- 频道信息获取:
tg-reader info @channel返回频道标题、描述、订阅数等元数据 - 帖子抓取:
tg-reader fetch @channel --since 24h按时间窗口获取帖子,支持多频道顺序抓取(带延迟控制) - 评论抓取:
--comments参数启用讨论组回复读取,自动降级限制至 30 条帖子以防超限 - 未读追踪模式:
read_unread: true实现增量同步,自动记录上次读取位置,适合日报生成
显著优点包括:双 MTProto 后端冗余保障;完善的预检工具 tg-reader-check 快速诊断配置问题;灵活的输出格式(JSON/文本)及文件导出模式节省 Token;错误类型化设计便于自动化重试决策。
潜在缺点与局限性:
- 媒体内容仅提取文字说明,无 OCR 或视觉分析能力
- 评论中的图片/视频不解析
- 用户名变更会导致未读状态重置
- 并发写入同一频道时「最后写入者胜出」可能丢失追踪状态
- 孤立 Docker 会话模式存在
AUTH_KEY_UNREGISTERED风险
适合人群:需要监控公开/私密 Telegram 频道的信息分析师、内容聚合者、舆情追踪团队,以及希望自动化生成频道摘要的开发者。
常规风险:
- 凭证安全:
TG_API_HASH与 session 文件授予完整账户权限,泄露可导致账户被接管 - 速率限制:频繁抓取可能触发 Telegram
flood_wait,工具自动处理 ≤60 秒等待,更长需人工介入 - 隐私合规:抓取他人频道内容需遵守 Telegram ToS 及当地数据法规