This project automates the registration of duck.com email addresses. It uses OpenRouter AI's API to solve CAPTCHAs, simulates user behavior to avoid detection, and saves registered accounts to a CSV file.
- Python 3.10+
- Libraries listed in
pyproject.toml - An OpenRouter API key
- Proxies
- A Gmail account with configured forwarding to the target domain and credentials saved in
data/client_secret.jsonanddata/gmail_token.json. This Gmail account will be used to retrieve verification codes. - Wordlists for username generation (included in the
data/wordlistdirectory)
-
Clone the repository:
git clone https://github.com/xxspell/email-autoreg.git cd email-autoreg -
Create and activate a virtual environment (recommended):
python3 -m venv .venv source .venv/bin/activate # On Linux/macOS .venv\Scripts\activate # On Windows
-
Install dependencies:
pip install poetry poetry install
-
Set up your environment variables:
- Create a
.envfile in the root directory of the project. - Add your OpenRouter API key to the
.envfile:
OPENROUTER_API_KEY=your_openrouter_api_key- Create a
datadirectory and place yourgmail_token.jsonandclient_secret.jsonfiles inside as specified in thecore/mail/main.pyfile.
- Create a
-
Prepare proxy list (Optional): Create a
proxies.txtfile in the root directory and add your proxies, one per line, in the formatprotocol://login:password@ip:port(e.g.,socks://admin:[email protected]:8080).
The script supports three modes of email generation and can be run with command-line arguments or interactively.
- Domain Mode: Generates new email addresses using a specified domain
- Dots Mode: Generates variations of existing email addresses by adding dots in different positions
- Tags Mode: Generates variations of existing email addresses by adding tags
⚠️ Important Note: Duck.com currently does not support registration with tagged email addresses (e.g.,[email protected]). This mode is included for future compatibility if the policy changes or for use with other services.
-
Tags Mode Limitation: Duck.com does not currently allow registration using email addresses with tags (format:
[email protected]). While this mode is included in the script, it won't work with Duck.com registration. Consider using domain mode or dots mode instead. -
Rate Limiting: To avoid detection and blocking, it's recommended to use reasonable delays between requests and not create too many accounts at once.
-
Proxy Quality: The success rate heavily depends on the quality of your proxies. Using residential proxies is recommended.
# Domain Mode
python main.py --domain_mode --domain your_domain.com --num_accounts 10 --max_connections 5 --proxy_path proxies.txt
# Dots Mode
python main.py --dots_mode --emails_file dots_emails.txt --num_accounts 10 --max_connections 5 --proxy_path proxies.txt
# Tags Mode
python main.py --tags_mode --emails_file tags_emails.txt --num_accounts 10 --max_connections 5 --proxy_path proxies.txtArguments:
--domain_mode,--dots_mode,--tags_mode: Select the email generation mode--domain: Domain for new email addresses (used in domain mode)--emails_file: File containing existing email addresses (used in dots and tags modes)--num_accounts: Number of accounts to create--max_connections: Maximum concurrent connections--proxy_path: Path to proxy list file--export: Export duck.com email from accounts.csv to a specified file
Run without arguments for interactive mode:
python main.pyThe script will prompt you to:
- Select the generation mode
- Provide necessary information based on the selected mode
- Specify number of accounts and connections
-
Emails File (for dots and tags modes):
-
Proxies File:
socks5:\\login@pass:pool-proxies.com
- Registered accounts are saved to
accounts.csvin the project root - Logs are written to both the console and
application.log