🤖 自动完成 SheerID 学生/教师认证的 Telegram 机器人
基于 @auto_sheerid_bot GGBond 的旧版代码改进
这是一个基于 Python 的 Telegram 机器人，可以自动完成多个平台的 SheerID 学生/教师身份认证。机器人自动生成身份信息、创建认证文档并提交到 SheerID 平台，大大简化了认证流程。
⚠️ 重要提示：
- Gemini One Pro、ChatGPT Teacher K12、Spotify Student、YouTube Premium Student 等服务在使用前需要更新各模块配置文件中的
programId等验证资料，具体请参考下方"使用前必读"章节。- 本项目还提供了 ChatGPT 军人认证的实现思路和接口文档，详细内容请查看
military/README.md，用户可根据文档自行集成。
| 命令 | 服务 | 类型 | 状态 | 说明 |
|---|---|---|---|---|
/verify |
Gemini One Pro | 教师认证 | ✅ 完整 | Google AI Studio 教育优惠 |
/verify2 |
ChatGPT Teacher K12 | 教师认证 | ✅ 完整 | OpenAI ChatGPT 教育优惠 |
/verify3 |
Spotify Student | 学生认证 | ✅ 完整 | Spotify 学生订阅优惠 |
/verify4 |
Bolt.new Teacher | 教师认证 | ✅ 完整 | Bolt.new 教育优惠（自动获取 code） |
/verify5 |
YouTube Premium Student | 学生认证 | YouTube Premium 学生优惠（见下方说明） |
⚠️ YouTube 认证特别说明：YouTube 认证功能目前为半成品状态，使用前请仔细阅读
youtube/HELP.MD文档。主要区别：
- YouTube 的原始链接格式与其他服务不同
- 需要手动从浏览器网络日志中提取
programId和verificationId- 然后手动组成标准的 SheerID 链接格式
使用步骤：
- 访问 YouTube Premium 学生认证页面
- 打开浏览器开发者工具（F12）→ 网络（Network）标签
- 开始认证流程，搜索
https://services.sheerid.com/rest/v2/verification/- 从请求载荷中获取
programId，从响应中获取verificationId- 手动组成链接：
https://services.sheerid.com/verify/{programId}/?verificationId={verificationId}- 使用
/verify5命令提交该链接
💡 ChatGPT 军人认证思路：
本项目提供了 ChatGPT 军人 SheerID 认证的实现思路和接口文档。军人认证流程与普通学生/教师认证不同，需要先执行
collectMilitaryStatus接口设置军人状态，然后再提交个人信息表单。详细实现思路和接口说明请查看military/README.md文档。用户可根据该文档自行集成到机器人中。
- 🚀 自动化流程：一键完成信息生成、文档创建、认证提交
- 🎨 智能生成：自动生成学生证/教师证 PNG 图片
- 💰 积分系统：签到、邀请、卡密兑换等多种获取方式
- 🔐 安全可靠：使用 MySQL 数据库，支持环境变量配置
- ⚡ 并发控制：智能管理并发请求，确保稳定性
- 👥 管理功能：完善的用户管理和积分管理系统
- 语言：Python 3.11+
- Bot框架：python-telegram-bot 20.0+
- 数据库：MySQL 5.7+
- 浏览器自动化：Playwright
- HTTP客户端：httpx
- 图像处理：Pillow, reportlab, xhtml2pdf
- 环境管理：python-dotenv
git clone https://github.com/PastKing/tgbot-verify.git
cd tgbot-verifypip install -r requirements.txt
playwright install chromium复制 env.example 为 .env 并填写配置：
# Telegram Bot 配置
BOT_TOKEN=your_bot_token_here
CHANNEL_USERNAME=your_channel
CHANNEL_URL=https://t.me/your_channel
ADMIN_USER_ID=your_admin_id
# MySQL 数据库配置
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=tgbot_verifypython bot.py# 1. 修改 .env 文件配置
cp env.example .env
nano .env
# 2. 启动服务
docker-compose up -d
# 3. 查看日志
docker-compose logs -f# 构建镜像
docker build -t tgbot-verify .
# 运行容器
docker run -d \
--name tgbot-verify \
--env-file .env \
-v $(pwd)/logs:/app/logs \
tgbot-verify/start # 开始使用（注册）
/about # 了解机器人功能
/balance # 查看积分余额
/qd # 每日签到（+1积分）
/invite # 生成邀请链接（+2积分/人）
/use <卡密> # 使用卡密兑换积分
/verify <链接> # Gemini One Pro 认证
/verify2 <链接> # ChatGPT Teacher K12 认证
/verify3 <链接> # Spotify Student 认证
/verify4 <链接> # Bolt.new Teacher 认证
/verify5 <链接> # YouTube Premium Student 认证
/getV4Code <id> # 获取 Bolt.new 认证码
/help # 查看帮助信息/addbalance <用户ID> <积分> # 增加用户积分
/block <用户ID> # 拉黑用户
/white <用户ID> # 取消拉黑
/blacklist # 查看黑名单
/genkey <卡密> <积分> [次数] [天数] # 生成卡密
/listkeys # 查看卡密列表
/broadcast <文本> # 群发通知-
获取认证链接
- 访问对应服务的认证页面
- 开始认证流程
- 复制浏览器地址栏中的完整 URL（包含
verificationId）
-
提交认证请求
/verify3 https://services.sheerid.com/verify/xxx/?verificationId=yyy -
等待处理
- 机器人自动生成身份信息
- 创建学生证/教师证图片
- 提交到 SheerID 平台
-
获取结果
- 审核通常在几分钟内完成
- 成功后会返回跳转链接
tgbot-verify/
├── bot.py # 机器人主程序
├── config.py # 全局配置
├── database_mysql.py # MySQL 数据库管理
├── .env # 环境变量配置（需自行创建）
├── env.example # 环境变量模板
├── requirements.txt # Python 依赖
├── Dockerfile # Docker 镜像构建
├── docker-compose.yml # Docker Compose 配置
├── handlers/ # 命令处理器
│ ├── user_commands.py # 用户命令
│ ├── admin_commands.py # 管理员命令
│ └── verify_commands.py # 认证命令
├── one/ # Gemini One Pro 认证模块
├── k12/ # ChatGPT K12 认证模块
├── spotify/ # Spotify Student 认证模块
├── youtube/ # YouTube Premium 认证模块
├── Boltnew/ # Bolt.new 认证模块
├── military/ # ChatGPT 军人认证思路文档
└── utils/ # 工具函数
├── messages.py # 消息模板
├── concurrency.py # 并发控制
└── checks.py # 权限检查
| 变量名 | 必填 | 说明 | 默认值 |
|---|---|---|---|
BOT_TOKEN |
✅ | Telegram Bot Token | - |
CHANNEL_USERNAME |
❌ | 频道用户名 | pk_oa |
CHANNEL_URL |
❌ | 频道链接 | https://t.me/pk_oa |
ADMIN_USER_ID |
✅ | 管理员 Telegram ID | - |
MYSQL_HOST |
✅ | MySQL 主机地址 | localhost |
MYSQL_PORT |
❌ | MySQL 端口 | 3306 |
MYSQL_USER |
✅ | MySQL 用户名 | - |
MYSQL_PASSWORD |
✅ | MySQL 密码 | - |
MYSQL_DATABASE |
✅ | 数据库名称 | tgbot_verify |
在 config.py 中可以自定义积分规则：
VERIFY_COST = 1 # 验证消耗的积分
CHECKIN_REWARD = 1 # 签到奖励积分
INVITE_REWARD = 2 # 邀请奖励积分
REGISTER_REWARD = 1 # 注册奖励积分在使用机器人之前，请务必检查并更新各模块的验证配置！
由于 SheerID 平台的 programId 可能会定期更新，以下服务在使用前必须更新配置文件中的验证资料：
one/config.py- Gemini One Pro 认证（需更新PROGRAM_ID）k12/config.py- ChatGPT Teacher K12 认证（需更新PROGRAM_ID）spotify/config.py- Spotify Student 认证（需更新PROGRAM_ID）youtube/config.py- YouTube Premium Student 认证（需更新PROGRAM_ID）Boltnew/config.py- Bolt.new Teacher 认证（建议检查PROGRAM_ID）
如何获取最新的 programId：
- 访问对应服务的认证页面
- 打开浏览器开发者工具（F12）→ 网络（Network）标签
- 开始认证流程
- 查找
https://services.sheerid.com/rest/v2/verification/请求 - 从 URL 或请求载荷中提取
programId - 更新对应模块的
config.py文件
提示：如果认证一直失败，很可能是
programId已过期，请按上述步骤更新。
- 📺 Telegram 频道：https://t.me/pk_oa
- 🐛 问题反馈：GitHub Issues
- 📖 部署文档：DEPLOY.md
欢迎进行二次开发！但请遵守以下规则：
-
保留原作者信息
- 在代码和文档中保留原仓库地址
- 注明基于本项目进行的二次开发
-
开源协议
- 本项目采用 MIT 开源协议
- 二次开发的项目也必须开源
-
商业使用
- 个人使用免费
- 商业使用请自行优化并承担责任
- 不提供任何技术支持和担保
本项目采用 MIT License 开源协议。
MIT License
Copyright (c) 2025 PastKing
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...
- 感谢 @auto_sheerid_bot GGBond 提供的旧版代码基础
- 感谢所有为本项目做出贡献的开发者
- 感谢 SheerID 平台提供的认证服务
- ✨ 新增 Spotify Student 和 YouTube Premium Student 认证（YouTube 为半成品，需参考 youtube/HELP.MD 使用）
- 🚀 优化并发控制和性能
- 📝 完善文档和部署指南
- 🐛 修复已知 BUG
- 🎉 初始版本发布
- ✅ 支持 Gemini、ChatGPT、Bolt.new 认证
⭐ 如果这个项目对你有帮助，请给个 Star 支持一下！
Made with ❤️ by PastKing
