Tavily API Key 自动化获取工具

English | 中文

历史更新

• 2025-08-19：引入同窗口复用（EmailChecker.attach_to + managed_externally），在同一浏览器上下文完成注册、邮箱验证与 API 获取，保持登录态与缓存，降低重登与元素失效导致的不稳定；优化弹窗处理监听与日志。

基于深层HTML分析的智能自动化解决方案，实现Tavily API Key的端到端自动获取。

快速开始

环境要求

• Python 3.7+
• 网络连接
• 2925.com邮箱账户

安装

# 克隆项目
git clone https://github.com/yatotm/tavily-register.git
cd tavily-register

# 自动安装依赖
python setup.py

# 或手动安装
pip install -r requirements.txt
playwright install firefox

配置

1. 设置邮箱前缀

   编辑 config.py:

   EMAIL_PREFIX = "your_prefix"  # 替换为您的2925.com邮箱前缀

2. 设置邮箱登录

   python email_login_helper.py

   按提示完成2925.com邮箱登录并保存cookies。

运行

python main.py

选择运行模式：

• 智能自动化模式 (推荐): 高效稳定的自动化流程
• 测试模式: 传统方式，用于调试和HTML信息收集

项目结构

tavily-register/
├── main.py                          # 主程序入口
├── intelligent_tavily_automation.py  # 智能自动化核心
├── email_checker.py                 # 邮件验证和登录
├── email_login_helper.py            # 邮箱登录助手
├── tavily_automation.py             # 传统自动化模块
├── config.py                        # 配置文件
├── utils.py                         # 工具函数
├── requirements.txt                 # 依赖列表
├── setup.py                         # 安装脚本
├── api_keys.md                      # API Key保存文件
└── email_cookies.json               # 邮箱cookies

使用流程

• 支持同一浏览器窗口的端到端流程复用（注册→邮箱验证→登录→API 获取），避免二次登录，提升稳定性

1. 注册阶段: 自动填写Tavily注册表单
2. 邮件验证: 智能检测验证邮件并点击验证链接（复用当前页面）
3. 登录阶段: 自动登录Tavily账户
4. API获取: 智能识别并获取API Key
5. 数据保存: 保存账户信息和API Key到文件

输出格式

API Key保存在 api_keys.md 文件中：

user123-abc123@2925.com,TavilyAuto123!,tvly-dev-xxxxxxxxxx,2025-01-01 12:00:00;

格式: 邮箱,密码,API_Key,时间

故障排除

常见问题

浏览器启动失败

• 运行: playwright install firefox
• 检查网络连接

邮箱登录问题

• 重新运行: python email_login_helper.py
• 确保2925.com邮箱服务正常

找不到验证邮件

• 检查邮箱前缀设置是否正确
• 手动访问2925.com检查邮件

API Key获取失败

• 检查是否成功登录Tavily
• 查看生成的截图文件

遇到人机验证

• 如果IP纯净度或环境因素导致触发人机验证
• 选择前台模式 (浏览器模式选择1)
• 手动完成人机验证后程序会自动继续
• 建议使用干净的网络环境和IP地址

配置选项

浏览器配置

HEADLESS = False          # 是否无头模式
BROWSER_TYPE = "firefox"  # 浏览器类型

等待时间配置

WAIT_TIME_SHORT = 2       # 短等待时间
WAIT_TIME_MEDIUM = 5      # 中等等待时间
WAIT_TIME_LONG = 10       # 长等待时间

邮箱配置

EMAIL_DOMAIN = "2925.com"
EMAIL_PREFIX = "user123"  # 您的邮箱前缀

技术栈

• Python 3.7+
• Playwright: 网页自动化
• BeautifulSoup4: HTML解析

免责声明

本工具仅用于学习和研究目的。使用时请遵守相关网站的服务条款。

许可证

MIT License