这个项目能做什么

## 概述 Web Visitor Analytics for Telegram 是专为Python Web应用（Flask、Django或任意Python后端）设计的服务器端监控模块。该模块通过Telegram Bot API提供实时访客提醒，并利用公共IP-API服务解析请求来源IP的地理位置与运营商数据。 此模块非独立应用——需将代码片段嵌入主应用文件（如`app.py`），使其与现有路由处理器同步执行。 ## 核心功能 - **实时Telegram通知**：页面每次访问均触发即时提醒，将结构化访问摘要推送至指定Telegram用户或群组 - **地理定位数据**：通过IP-API自动解析访客城市、国家及运营商信息 - **非阻塞式集成**：内置错误处理机制，确保追踪API或Telegram推送故障不影响主应用流程 - **隐私保护设计**：通知中IP地址采用部分掩码显示，在保障识别度的同时降低信息暴露风险 ## 环境要求 - Python运行环境 - requests库（`pip install requests`） - 通过@BotFather获取的Telegram Bot令牌 - 通过@userinfobot获取的个人Telegram聊天ID ## 安装配置 1. 在Telegram通过@BotFather创建机器人并保存API令牌 2. 从@userinfobot获取个人聊天ID 3. 将集成代码片段插入项目主入口文件（如`app.py`） 4. 替换占位符中的令牌与聊天ID（建议通过环境变量配置而非硬编码） ``` pip install requests ``` ## 兼容性说明 本模块纯Python实现，开箱支持Flask与Django框架，可适配任意Python后端。无法在静态HTML站点或非Python环境直接运行，需移植至对应语言。 ## 重要声明 - **地理定位精度**：位置信息基于ISP网络路由判定，非GPS坐标。用户实际物理位置可能与显示城市存在偏差 - **隐私合规**：本工具收集并传输IP衍生数据，使用者须自行确保符合GDPR/CCPA等隐私法规，应合法合规使用 - **安全规范**：切勿在公共代码仓库硬编码机器人令牌与聊天ID，建议使用环境变量或密钥管理服务 ## 应用场景 作者在个人生产环境作品集网站中部署此模块，实时监控访客流量并通过Telegram设备获取安全预警。示例通知包含掩码IP、运营商名称、城市及国家的紧凑格式化消息。