Metadata-Version: 2.4
Name: local-seo-browser
Version: 0.2.1
Summary: Plan read-only Google Maps, Trustpilot, and Yelp listing research sessions. CLI: seo-browser
Project-URL: Homepage, https://pypi.org/project/local-seo-browser/
Project-URL: Documentation, https://pypi.org/project/local-seo-browser/
Project-URL: Repository, https://github.com/multilogin-automation
Project-URL: Changelog, https://pypi.org/project/local-seo-browser/
Author: local-seo-browser contributors
License-Expression: MIT
License-File: LICENSE
Keywords: gmaps-browser,google-maps-research,local-listing-qa,local-seo-browser,local-seo-session,maps-listing-browser,reputation-research,seo-session-plan,trustpilot-browser,trustpilot-research,yelp-browser,yelp-listing-research
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Requires-Dist: click>=8.1
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# local-seo-browser

**Local SEO session planner** — read-only Google Maps, Trustpilot, and Yelp listing research.

[![PyPI version](https://img.shields.io/pypi/v/local-seo-browser.svg)](https://pypi.org/project/local-seo-browser/)
[![Python versions](https://img.shields.io/pypi/pyversions/local-seo-browser.svg)](https://pypi.org/project/local-seo-browser/)
[![License: MIT](https://img.shields.io/pypi/l/local-seo-browser.svg)](https://pypi.org/project/local-seo-browser/)
[![GitHub](https://img.shields.io/badge/org-multilogin--automation-181717?logo=github)](https://github.com/multilogin-automation)

```bash
pip install local-seo-browser
seo-browser plan --platform gmaps --business "Acme LLC"
```

CLI: **`seo-browser`** · Python **3.10+** · planner only

> **Coupon hubs:** `SAAS50` — [anti-detect.github.io](https://anti-detect.github.io/) · [SaaSVerdict](https://saasverdict.com/). [Affiliate disclosure](docs/AFFILIATE.md).

## Problem

Local SEO research across Maps/Trustpilot/Yelp needs geo-matched MLX profiles and repeatable session cadence — not one-off manual browsing.

## Install

```bash
pip install local-seo-browser
```

## Quick start

```bash
seo-browser template --platform trustpilot
seo-browser plan --from examples/yelp-session.yaml --format shell -o research.sh
seo-browser validate examples/gmaps-session.yaml
```

## CLI

| Command | Purpose |
|---------|---------|
| `seo-browser schema FILE` | Pydantic schema check only |
| `seo-browser init -d DIR` | Create starter `.seo-browser/session.yaml` |
| `seo-browser template -o FILE` | Write starter session YAML/JSON |
| `seo-browser plan` | Markdown, shell, or JSON plan (`--from FILE`) |
| `seo-browser validate FILE --format json` | JSON validation report |
| `seo-browser default` | Default YAML to stdout |
| `seo-browser template` | Starter YAML file |
| `seo-browser validate FILE` | Validate session YAML |
| `seo-browser list` | Supported platforms |
| `seo-browser list --format json` | Platforms + step counts JSON |
| `seo-browser catalog --format json` | Example session index |
| `seo-browser steps` | Default steps (`--format json`) |
| `seo-browser dry-run` | Preview steps (`--format json`) |
| `seo-browser --show-deal` | Opt-in `SAAS50` |

**Toolkit pipeline:** `proxy-lane check` → `seo-browser plan` → MLX browse

## Limitations

Planner only — no automated posting or fake reviews.

## Production

[proxy-lane-checker](https://pypi.org/project/proxy-lane-checker/) → `seo-browser plan` in MLX profile. [docs/FAQ.md](docs/FAQ.md)

## Related tools (on PyPI)

| Package | CLI | Role |
|---------|-----|------|
| [proxy-lane-checker](https://pypi.org/project/proxy-lane-checker/) | `proxy-lane` | Geo proxy check |
| [profile-yaml-factory](https://pypi.org/project/profile-yaml-factory/) | `profile-factory` | Profile YAML |
| [antibot-profile-lint](https://pypi.org/project/antibot-profile-lint/) | `bot-lint` | Checkout lint |
| [mlx-id-token-kit](https://pypi.org/project/mlx-id-token-kit/) | `mlx-token` | MLX IDs |

## License

MIT

---

**Partner:** Multilogin · `SAAS50` · [github.com/multilogin-automation](https://github.com/multilogin-automation)
