Metadata-Version: 2.4
Name: advanced-keyword-scraper
Version: 1.5.1
Summary: Advanced multi-source keyword research, SEO intelligence, and resilient SERP analysis CLI.
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: rich>=13.0.0
Requires-Dist: fake-useragent>=1.5.0
Requires-Dist: beautifulsoup4>=4.12.0

# Advanced Keyword Scraper v1.5.1

A local-first keyword research CLI with multi-source discovery, heuristic intelligence, optional SERP analysis, resilient HTTP handling, and export workflows.

## Requirements

- Python 3.10 or newer
- Windows, macOS, or Linux

## Install

Recommended on Windows:

```cmd
py -m pip install --upgrade pip
py -m pip install -e .
```

If `py` is unavailable, use `python` instead.

## Verify the package

```cmd
python -m unittest discover -s tests -t . -v
```

The repository includes a `tests/__init__.py` bootstrap so tests also work directly from this source-layout checkout before an editable install.

## Run keyword research

```cmd
keyword-scraper "saree" "kurti" --depth 2 --format all
```

Or without installing the console script:

```cmd
python -m keyword_scraper.cli "saree" "kurti" --depth 2 --format all
```

## Run SERP research

```cmd
keyword-scraper "saree" --mode serp --format excel
```

## Workflow modes

These modes create local action-oriented CSV plans from the supplied keywords; they do not claim exact search volume or guaranteed rankings.

```cmd
keyword-scraper "budget smartphone" --mode youtube --mode-output youtube.csv
keyword-scraper "wireless earbuds" --mode ecommerce --mode-output ecommerce.csv
keyword-scraper "best accounting software" --mode seo --mode-output seo.csv
keyword-scraper "project management software" --mode copywriting --mode-output copywriting.csv
```

## Notes

- SERP providers may change markup, throttle requests, or restrict automated access.
- Opportunity scores are heuristics, not search-engine ranking scores.
- The project does not attempt to bypass provider controls.
