Telegram OSINT实战指南:Third-Eye 如何让公共频道帖子实时落在全球地图上
Telegram OSINT实战指南:Third-Eye 如何让公共频道帖子实时落在全球地图上
Third-Eye 是一个开源的生产级 OSINT(开源情报)平台,它内置的 Telegram OSINT 能力可以抓取 Telegram 公共频道的帖子,自动完成地理编码与风险打分,然后把每一条情报实时标在全球地图上。整个过程不需要申请 Bot API、不需要 MTProto 协议,只要读取公共频道的网页预览即可。本文将从实战角度拆解这条「帖子 → 坐标 → 地图标记」的数据链路,并带你两步跑起一个可自定义频道的 Telegram OSINT 全球地图。
一、为什么 Telegram 公共频道是 OSINT 的富矿
冲突前线、地缘突发、网络事件往往最先在 Telegram 公共频道里「爆料」,比传统新闻快几分钟到几小时。对这些频道做聚合,就能获得一条高时效的开源情报流。
难点在于落地:帖子是纯文本,没有坐标,怎么让它出现在地图的对应位置?这正是 Third-Eye 要解决的问题。
💡 核心思路:不追求 100% 精确的 NLP 地理编码,而是用一套地名关键词字典做快速映射——文本里出现哪个地名,就把这条情报标到该地名对应的坐标上。轻量、可解释、够用于态势感知。
二、抓取原理:不写 Bot、不碰 MTProto,直接读网页预览
Third-Eye 用浏览器能访问的公共网页预览 t.me/s/{频道名} 作为数据源,而不是官方的 Bot API。这意味着零配置、零鉴权。
-
内置默认频道:代码里内置了一组公开 OSINT 频道,开箱即用 👇
OSINTtechnical / Faytuks / Liveuamap / CyberKnow -
并发抓取:四个频道同时拉取,每个请求设 8 秒超时,谁超时都不影响整体(
Promise.allSettled)。 -
HTML 解析:用正则从
tgme_widget_message块里抽出正文、原文链接、发布时间,短于 10 字符的碎片帖直接丢弃。
相关源码:src/app/api/news/route.ts 定义频道列表,parseTelegramHTML 负责解析。
三、从帖子到坐标:关键词地理编码 + 风险打分
拿到正文后,后端做两件关键加工,把一条「帖子」变成地图上能点的「点」:
| 阶段 | 做什么 | 效果 |
|---|---|---|
| 🌍 地理编码 | 用多语言地名字典匹配关键词(如 ukraine、kyiv、gaza、israel…) |
命中即返回该地名坐标,未命中则 coords 为 null |
| ⚠️ 风险打分 | 统计正文里的风险词(war、missile、drone、attack、strike…) |
每命中一个 +2 分,封顶 10 分,输出 risk_score |
text.find("ukraine") → coords = [49.487, 31.272]
text.count(risk_kw) → risk_score = min(10, 1 + 2*命中数)
risk_score >= 8 → machine_assessment(高优先级提示)
- 地理编码字典见 KEYWORD_COORDS,匹配逻辑在 findCoords。
- 打分逻辑在 scoreRisk;分数 ≥ 8 的情报会附带一句 AI 风格的高优先级评估。
每条情报还会用
link + pubDate的 MD5 作为稳定id,避免刷新后重复渲染。
四、落到全球地图:WebGL 实时渲染 + 情报面板
后端把带坐标的情报返回给前端后,Three 个组件协同,让帖子「活」在地图上:
-
地图标记(src/components/ThirdEyeMap.tsx)
- 基于 MapLibre GL(WebGL) 的
sigint-news图层,把有坐标的帖子渲染成金色光点,并随缩放平滑变化。 - 该图层默认开启(
news_intel),打开页面就能看到金色情报点散布全球。
- 基于 MapLibre GL(WebGL) 的
-
SIGINT 情报面板(src/components/IntelFeed.tsx)
- 左侧「SIGINT FEED」列出帖子:风险等级徽章(CRITICAL/HIGH/ELEVATED/LOW)、来源、相对时间。
- 点击帖子旁的 📍 图钉,地图直接飞入该情报位置。
-
实时告警面板(src/components/LiveAlerts.tsx)
- 把 Telegram 新闻、地震等多源情报合并成统一告警流,按
risk_score映射成红/橙/黄/绿告警色,点击同样支持一键定位。
- 把 Telegram 新闻、地震等多源情报合并成统一告警流,按
数据刷新节奏:页面加载时先拉一次 /api/news,之后每 30 分钟轮询更新(src/app/page.tsx),兼顾实时性与边缘请求开销。
![基于 MapLibre GL 的 Telegram 情报全球地图,金色光点代表已地理编码的公共频道帖子]
⚠️ 小提示:地图里有坐标的帖子才会以金色点标出;未命中地名字典的帖子仍会进入侧边情报面板(只是没有地图定位)。
五、如何自己跑起来:两步部署 Telegram OSINT 地图
整个平台无需任何 API Key 即可启动。最省事的方式:
git clone https://gitcode.com/gh_mirrors/thir/Third-Eye
cd Third-Eye
npm install
npm run dev
打开 http://localhost:3000,地图上的金色情报点与左侧 SIGINT FEED 就已经在实时工作。
偏好 Docker 的用户可用一条命令自托管:
git clone https://gitcode.com/gh_mirrors/thir/Third-Eye
cd Third-Eye
cp .env.template .env # 可选:配置端口/密钥
docker compose up -d
六、进阶:自定义频道列表 + 自动回退机制
- 自定义要监听的频道:通过环境变量
THIRDEYE_TELEGRAM_CHANNELS覆盖默认列表,填逗号分隔的频道用户名(不带@),即可把地图对准你关心的情报源。详见 DOCKER.md。 - IP 被墙的自动回退:如果 Telegram 完全屏蔽了服务器 IP,
/api/news会自动切换到 BBC、Al Jazeera、GDACS 等 RSS 源兜底,保证面板不空(src/app/api/news/route.ts)。
# 只填用户名,多个用英文逗号分隔
THIRDEYE_TELEGRAM_CHANNELS=channel_a,channel_b,channel_c
小结
Third-Eye 用一条极简而可解释的链路,把「Telegram 公共频道帖子」变成全球地图上可点击、可定位、带风险等级的实时情报点:
- 抓:读
t.me/s/网页预览,零 Bot、零 MTProto; - 算:地名字典做地理编码 + 关键词做风险打分;
- 画:MapLibre GL(WebGL)金色光点 + SIGINT 面板 + 实时告警,一键飞入定位。
对 OSINT 新手来说,这是一套无需密钥、开箱即用、可自定义频道的全球态势感知起点。打开地图的那一刻,全球公共频道的情报已经实时「落」在你眼前。
