tavily-register

KO | EN

gitlite — search

#javascript #react #ai #typescript #golang #go #rust #macos #java #windows #awesome #cli #vue #open-source

tavily-register

(★ 59)

Intelligent automation tool for Tavily API Key acquisition

tavily-register Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Tavily API Key 自动化获取工具

[English](README_EN.md) | 中文

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

</details>

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

## 快速开始

### 环境要求

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

### 安装

```bash
# 克隆项目
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`:
   ```python
   EMAIL_PREFIX = "your_prefix"  # 替换为您的2925.com邮箱前缀
   ```

2. **设置邮箱登录**
   ```bash
   python email_login_helper.py
   ```
   按提示完成2925.com邮箱登录并保存cookies。

### 运行

```bash
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地址

</details>

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

### 等待时间配置
```python
WAIT_TIME_SHORT = 2       # 短等待时间
WAIT_TIME_MEDIUM = 5      # 中等等待时间
WAIT_TIME_LONG = 10       # 长等待时间
```

### 邮箱配置
```python
EMAIL_DOMAIN = "2925.com"
EMAIL_PREFIX = "user123"  # 您的邮箱前缀
```

</details>

## 技术栈

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

## 免责声明

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

## 许可证

MIT License

tavily-register

tavily-register Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

tavily-register

tavily-register Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README