# SeoScope

Standalone **Google Search Console** analytics for shared hosting (**PHP + MySQL**). Self‑hosted: data is stored in your database on your server.

## Requirements

- PHP **8.0+**
- MySQL **5.7+** / MariaDB **10.3+**
- PHP extensions: **PDO MySQL**, **cURL**, **JSON**, **mbstring**, **OpenSSL**
- Optional (recommended): **ZipArchive** (required only for the in‑app updater)
- Web server: Apache (mod_rewrite) or nginx equivalent (pretty URLs)
- HTTPS: recommended (OAuth redirect URIs require HTTPS in Google Cloud Console)

## Installation (quick)

1. Upload and unzip the package.
2. Point your domain/subdomain **document root** to the package `public/` directory.
3. Open your site in a browser and run the installer at `/install`.
4. After the installer completes, activate the license at `/license` using your Envato purchase code.
5. Open **Settings → Google** to add OAuth credentials and connect your Google account.
6. Open **Settings → Automation** to schedule the cron URL (recommended: every 5 minutes).

## Documentation

- Buyer documentation is bundled in the package at **`Documentation/index.html`**.
- Live documentation: `https://seoscope.cloud/documentation/` (videos are hosted online to keep the download size reasonable)

## Outbound connections (transparency)

SeoScope may connect to external services for the following purposes:

- **Google OAuth + Search Console API**: required only if you connect a Google account. Used to authorize access and fetch Search Console performance data.
  - `https://accounts.google.com/`
  - `https://oauth2.googleapis.com/`
  - `https://www.googleapis.com/`
- **License validation**: required to activate/validate your Envato purchase code.
  - `https://licensing.seoscope.cloud/`
- **Update metadata**: used only for the optional in‑app updater to check what versions are available.
  - `https://seoscope.cloud/releases.json`
- **SEO AI Assistant** (optional): only when enabled in **Settings → AI** and you click **Generate insight** on the Dashboard or a report screen. Your API key is stored encrypted on your server; calls go from your installation to the provider you chose.
  - `https://api.openai.com/` (OpenAI)
  - `https://api.anthropic.com/` (Anthropic)

If you don’t connect Google, don’t use the in‑app updater, and don’t enable SEO AI insights, only license validation is required.

## License

SeoScope application code: **proprietary** (distribution via CodeCanyon). Third‑party components and licenses are listed in **`THIRD-PARTY-LICENSES.md`** and in bundled license files.
