Metadata-Version: 2.4
Name: advanced-keyword-scraper
Version: 0.3.0
Summary: A multithreaded multi-platform keyword scraper with N-Gram analysis, SEO scoring, and topic clustering.
Author-email: LORD SRIJWN <your.email@example.com>
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: rich>=13.0.0
Requires-Dist: fake-useragent>=1.1.0

# 🚀 Advanced Keyword Scraper

A highly advanced, multithreaded CLI tool designed for SEO professionals, digital marketers, and e-commerce sellers. It extracts long-tail autocomplete search suggestions from multiple search engines, classifies their search intent, and exports them into beautiful Excel, CSV, or JSON reports.

**Developed with 🔥 by LORD SRIJWN**

---

## ✨ Key Features
* **Multi-Platform Support:** Scrape keywords from **Google, YouTube, Amazon, and Bing**.
* **Recursive Deep Search (Level 2):** Dig deeper into initial results to find thousands of hidden, low-competition long-tail keywords.
* **Smart Intent Classification:** Automatically categorizes keywords into *Transactional (Buying)*, *Commercial (Research)*, *Informational*, and *General* intents.
* **Negative Keyword Filter:** Exclude unwanted words (e.g., "free", "crack", "download") on the fly.
* **Rich Terminal UI:** Enjoy a beautiful, colorful animated progress bar while scraping.
* **Anti-Ban Protection:** Built-in proxy support and randomized User-Agent rotation.
* **Multi-Format Export:** Save your reports in `Excel (.xlsx)`, `CSV`, or `JSON` formats.

---

## ⚙️ Installation

Install the package globally using pip:

    pip install advanced-keyword-scraper

*(Note: Requires Python 3.8 or higher)*

---

## 📖 User Manual & Usage Guide

Once installed, you can run the tool from anywhere in your terminal using the `keyword-scraper` command.

### Basic Syntax
    keyword-scraper [KEYWORDS] [OPTIONS]

### Command Line Arguments (Options)

| Argument | Default | Description |
| :--- | :--- | :--- |
| `keywords` | **Required** | One or more base keywords (use quotes for multiple words). |
| `--engine` | `google` | Target platform. Choices: `google`, `youtube`, `bing`, `amazon`. |
| `--country`| `in` | 2-letter country code (e.g., `in` for India, `us` for USA). |
| `--lang` | `en` | Language code (e.g., `en`, `bn`, `hi`). |
| `--depth` | `1` | Search depth. `1` = Normal search, `2` = Deep recursive search. |
| `--exclude`| `None` | Comma-separated list of words to ignore (e.g., `free,cheap,old`). |
| `--format` | `excel` | Output format. Choices: `excel`, `csv`, `json`, `all`. |
| `--threads`| `10` | Number of concurrent workers. Higher means faster scraping. |
| `--output` | `SEO_Keywords` | Directory name where the reports will be saved. |
| `--proxies`| `None` | Path to a `.txt` file containing proxies (format: `http://ip:port`). |

---

## 💡 Practical Examples

### 1. Basic Google SEO
    keyword-scraper "smart watch" --country us --threads 12

### 2. E-commerce Keyword Research (Amazon)
    keyword-scraper "cotton kurti" "party wear saree" "western gown" --engine amazon --format all

### 3. YouTube Tag & Title Generation
    keyword-scraper "how to drape saree" "makeup tutorial" --engine youtube --country in

### 4. Advanced Deep Search with Filters (Level 2)
    keyword-scraper "digital marketing" --depth 2 --exclude "free,cheap,pdf,download" --threads 15

### 5. Using Custom Proxies
    keyword-scraper "laptop" --proxies my_proxies.txt

---

## 📁 Output Structure

The tool will automatically create a folder named `SEO_Keywords` in your current directory. 
If you choose the `excel` format, the generated file will contain multiple clean sheets:
1. **All Keywords:** The master list of every scraped term.
2. **Transactional:** Keywords explicitly showing buying intent.
3. **Commercial:** Keywords used for product research (best, top, vs).
4. **Informational:** "How to" and query-based keywords.
5. **Intent Summary:** A mathematical pivot table summarizing your data.

---

## 🤝 Contributing
Found a bug or want to add a new engine? Feel free to fork the repository, make your changes, and submit a pull request!

## 📜 License
This project is licensed under the MIT License.

*Crafted by LORD SRIJWN*
