Skip to main content

A high-performance, async Yahoo Mail login automator.

Project description

yahoomail

⚡ A fast and stealthy Python login checker for Yahoo Mail accounts bypasses multi-step login flow, device fingerprint challenges, and delivers accurate status in milliseconds.


🚀 Features

  • 🔁 Fully asynchronous (via httpx.AsyncClient)
  • 🔍 Fast-path + fallback HTML form parsing
  • 🔐 Bypasses Yahoo's anti-bot login system
  • 🎯 Precise detection: SUCCESS, INVALID, 2FA, ERROR, UNKNOWN
  • 🧠 Regex-based turbo form extraction (1-pass)
  • 🌐 Proxy support: http, socks5, with multiple formats
  • 📡 Optimized headers & fingerprint handling
  • 🧪 Debug-ready (optional HTML dumps at every step)
  • 📦 Includes batch checker with configurable concurrency

📦 Installation

pip install yahoomail Or clone locally:

git clone https://github.com/youruser/yahoomail.git
cd yahoomail-checker
pip install -r requirements.txt

⚙️ Usage

✅ Basic login check

from yahoomail import login

status, message, duration_ms = login("user@yahoo.com", "password123")
print(f"[{status}] {message} ({duration_ms}ms)")

🌍 Set a proxy

from yahoomail import set_proxies
set_proxies("user:pass@host:port")  # or "host:port"

Supports formats :

  • user:pass@host:port
  • host:port
  • host,port,user,pass
  • host:port:user:pass

🚀 Batch checking (async)

import asyncio
from yahoomail import run_batch

creds = [
    ("email1@yahoo.com", "pass1"),
    ("email2@yahoo.com", "pass2"),
]

results = asyncio.run(run_batch(creds, concurrency=10))
for email, status, message in results:
    print(f"{email}{status}: {message}")
Code Meaning
SUCCESS Valid login detected (your accounts is mostly valid!)
Invalid Bad account
2FA 2-Factor Authentification (or means other errors)
Error Proxy / network / internal error (Or just Yahoo maybe implemented another level cap of security (ya need to check).
Unkown I fucked up...

🧰 Advanced

Enable debug HTML saves: Uncomment or modify the global flag in your script:

ENABLE_DEBUG_FILES = True

It will save HTML dumps per stage for inspection (eg: new security...)

🧠 How it works

This module emulates Yahoo Mail login behavior by reproducing:

  • Initial tokenized form loads
  • Username + password flow separation
  • Dynamic fingerprinting step
  • Cookie-based login validation
  • Full proxy routing with timeout handling
  • No Selenium. No headless browser. Just pure, clean HTTP emulation.

📜 License

Creative Commons Attribution-NonCommercial-ShareAlike 4.0 (CC BY-NC-SA 4.0)

  • ✅ You can use, study, modify, and share this project.
  • Commercial use (resale, SaaS integration, paid API, etc.) is strictly prohibited.
  • 🧠 You must give credit to the original author.
  • 🔁 If you modify it, you must release your version under the same license.

🔗 Read the full license terms here

☕ A note

This project was born from one simple idea: "If there's no public API... then I become the API." I have enough of these restrictions of stupid developer mode restriction Built for speed. Tuned for accuracy. Tested against reality.

Enjoy.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yahoomail-1.0.0.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yahoomail-1.0.0-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file yahoomail-1.0.0.tar.gz.

File metadata

  • Download URL: yahoomail-1.0.0.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.0

File hashes

Hashes for yahoomail-1.0.0.tar.gz
Algorithm Hash digest
SHA256 0875c7eee0babee2338501534819c87f0cd625ce8b6b6e3f1b07bf4b4001977b
MD5 28a4995f762eac73eaf846ed5a85ab84
BLAKE2b-256 68411b4023e16bf40588fbd2494d9d56ad4700bdeacb788d0b09e98191e5c9c6

See more details on using hashes here.

File details

Details for the file yahoomail-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: yahoomail-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.0

File hashes

Hashes for yahoomail-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c2678206dc276be16fadb2330ae85809c353b599a666dcda66a17abef5b7203d
MD5 2c71d3e2e5ddbb97c6cd094c5b125733
BLAKE2b-256 105eb38ddcd88ad80a1adf324a0f90d3385b0eafb3020a7898fb885b53f268a6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page