GmgnTwitterClaw 🦅

基于 GMGN.ai 的实时 Twitter KOL 监控引擎,通过浏览器自动化拦截 WebSocket 数据流,将推特动态标准化后实时分发至 Telegram 频道、WebSocket 广播和 Webhook 三大通道。

✨ 核心特性

• 全动作捕获：覆盖发推、转推、回复、引用、关注/取关、删帖、换头像、改昵称、改简介、置顶/取消置顶共 12 种推特行为
• FxTwitter / vxTwitter 富文本卡片:推文自动渲染为带图/视频的嵌入式预览卡片,关注/取关等主页类动作自动渲染为用户名片
• DeepSeek 实时翻译:非阻塞异步翻译,推送完成后自动추가 中文译文,零延迟不卡主循环
• 多频道智能路由:按推特 Handle 分组路由到不同 Telegram 频道,同一博主可同时推送至多个频道
• 双轨数据捕获:WebSocket 实时监听 + HTTP Polling 降级拦截,重连间隙零丢失
• 去重引擎:基于 'internal_id' 的快照/完整版智能去重,500ms 窗口内自动选优
• 三通道扇出分发:Telegram、WebSocket、Webhook 并行推送,任一通道故障不影响其余
• 12 小时自动刷新:systemd 'RuntimeMaxSec' 定时重启,防止长时间运行导致浏览器 메모리 泄漏

---

💡 FAQ:首次授权与账号准备必读

在开始部署之前,你需要了解 GMGN 的底层授权机制:

• GMGN 官网:
• 获取授权链接: 首次使用时,你需要在 Telegram 中找到 GMGN Bot 提供的专属登录/授权链接(右键复制链接),并将其填入到本项目的配置文件 'config.py' 中的 'AUTH_URL' 里(详见下文第 5 步).
• ⚠️ 账号风控注意: 强烈建议使用一个 空 TG / 小号 来扫码授权隔离风险。 하지만 请注意 GMGN 공식 규칙:对于没有任何交易量的纯空号,GMGN 会限制其관심 小众博主(需要有交易量才能解锁)。 相关限制规则请自行了解。
• 📹 推特演示说明: 点此查看视频说明演示

---

📂 项目结构

---

🚀 部署指南

1. 설치기본依赖和 Python 도구 'uv'

'uv' 是比原生的 'pip' 快几百倍的现代化 Python 환경관리工具,本程序使用它来隔离虚拟环境。

2. 설치: Playwright 内核与 Linux 缺失的底层桌面包

因为程序的核心本质是操纵真的浏览器进行抓取,所以我们需要安装浏览器内核及在 Linux 裸机运行虚拟桌面所必须的 C 语言底层库。

3. 设置 Cloudflare WARP 代理(突破 IP 盾防御核心)

만약 불배치这一步,机房 VPS 的 IP 访问 gmgn.ai 会被 Cloudflare 100% 出现盾阻断("죄송합니다, 차단되었습니다"),甚至连验证码都不会给。 通过挂载官方 WARP 서비스,并将其转化为本地 Proxy,脚本将可以获得家庭宽带级别的隐身穿透能力。

4. 配置环境变量

모든 민감한 信息通过 '.env' 문서관리,严禁提交到 Git(已在 '.gitignore' 中屏蔽).

完整的环境变量说明：

| 变量名 | 必填

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.