🎬 ArabSeed Scraper & Decrypter API

High-Performance Python Web Scraper, Stream Extractor & Base64 Link Decrypter

A fast, interactive Python utility engineered to search, scrape, and automatically decrypt direct streaming links and high-speed download mirrors from ArabSeed and its active mirror network.

---

✨ Key Features

1. Automated Base64 Decryption: Automatically detects and decrypts obfuscated Base64-encoded stream links into direct, high-speed playback URLs.
2. Comprehensive Stream & Download Extraction: Extracts all upstream embedded streaming providers alongside multi-resolution download servers (1080p, 720p, 480p, 360p).
3. Full TV Series & Season Traversal: Automatically traverses seasons, lists all episodes interactively, and extracts media links per episode.
4. Resilient Domain Failover: Cycles through configured fallback mirror domains if the primary domain is blocked or unreachable.
5. Dual Interface Design:
   • Programmatic API (ArabSeedAPI): Clean Python API designed for seamless integration into FastAPI, Flask, or automated scraping pipelines.
   • Interactive CLI: Rich terminal user interface with colored menus and interactive search.

---

🛠️ Installation & Setup

1. Install Dependencies

Install the required packages using pip:

pip install -r requirements.txt

Or install directly from PyPI:

pip install arabseed-scraper

2. Run the Interactive CLI

Launch the interactive terminal search tool:

python arabseed_scraper.py

Or via the package command entrypoint:

arabseed-scraper

---

📦 Programmatic Usage (API Integration)

Easily import and integrate ArabSeedAPI into your own applications:

from arabseed_scraper import ArabSeedAPI

# 1. Initialize the scraper client
api = ArabSeedAPI()

# 2. Search for movies, series, or media
results = api.search("Inception")

for idx, item in enumerate(results):
    print(f"[{idx}] {item['title']} - Type: {item['type']}")

# 3. Extract streaming and download links for the top result
if results:
    url = results[0]['url']
    
    print("\n📺 Streaming Servers:")
    watch_links = api.get_watch_links(url)
    for w in watch_links:
        print(f"  Server: {w['server']} -> Stream URL: {w['direct_link']}")
        
    print("\n📥 Direct Download Servers:")
    download_links = api.get_download_links(url)
    for d in download_links:
        print(f"  Server: {d['server']} | Quality: {d['quality']} -> URL: {d['direct_link']}")

---

👨‍💻 Author & Maintainer

• Hussain Ibrahim Ahmed (Gaoc3)
  Systems & Backend Software Engineer | Distributed Infrastructure & DevOps
  PyPI Profile • LinkedIn • GitHub • Email

---

📄 License

Distributed under the MIT License.