Metadata-Version: 2.4
Name: advanced-keyword-scraper
Version: 0.2.0
Summary: A multithreaded multi-platform keyword scraper with intent classification, depth search, and rich UI.
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

তোর এই প্রিমিয়াম লেভেলের প্রজেক্টের জন্য একটি স্ট্যান্ডার্ড, প্রফেশনাল এবং বিস্তারিত `README.md` ফাইল নিচে দেওয়া হলো। এটি একই সাথে একটি কমপ্লিট "User Manual" হিসেবে কাজ করবে, যাতে পৃথিবীর যেকোনো প্রান্তের ইউজার খুব সহজেই তোর টুলের সবগুলো ফিচার ব্যবহার করতে পারে।

তোর প্রজেক্টের `README.md` ফাইলে থাকা পুরোনো লেখাগুলো মুছে নিচের এই পুরো কোডটি কপি করে পেস্ট করে দে:

```markdown
# 🚀 Advanced Keyword Scraper v0.2.0

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:

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

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

Extract standard keywords for a blog or website:

```bash
keyword-scraper "smart watch" --country us --threads 12

```

### 2. E-commerce Keyword Research (Amazon)

Perfect for finding buying-intent keywords for product listings:

```bash
keyword-scraper "cotton kurti" "party wear saree" "western gown" --engine amazon --format all

```

### 3. YouTube Tag & Title Generation

Find out exactly what users are typing in the YouTube search bar:

```bash
keyword-scraper "how to drape saree" "makeup tutorial" --engine youtube --country in

```

### 4. Advanced Deep Search with Filters (Level 2)

Perform a massive recursive search while excluding irrelevant terms like "free" or "cheap":

```bash
keyword-scraper "digital marketing" --depth 2 --exclude "free,cheap,pdf,download" --threads 15

```

### 5. Using Custom Proxies

If you are scraping thousands of keywords and want to avoid IP bans:

```bash
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*

