# KByte SEO Workbench

Production-ready SEO scoring, metadata controls, schema, AI-assisted SEO generation, sitemaps, robots.txt tools, monitoring, and editor integrations for WordPress.

- Version: `1.1.0`
- Plugin website: `https://github.com/rytisp/SEO-Analyzer`

## Download

- Download the latest ZIP from the [repository](https://github.com/rytisp/SEO-Analyzer).
  
## Requirements

- WordPress 6.5+
- PHP 8.0+

## Installation

### Install from ZIP (recommended for manual installs)

1. In WordPress admin go to `Plugins` -> `Add New Plugin`.
2. Click `Upload Plugin`.
3. Upload the `kbyte-seo-workbench` plugin zip file.
4. Click `Activate`.

### Install by uploading the folder

1. Upload the `kbyte-seo-workbench` folder to:
   - `wp-content/plugins/kbyte-seo-workbench/`
2. In WordPress admin go to `Plugins`.
3. Activate `KByte SEO Workbench`.

### Install with WP-CLI (if available)

```bash
wp plugin install /path/to/kbyte-seo-workbench.zip --activate
```

## Setup

1. Go to `Tools -> KByte SEO Workbench` in the WordPress admin menu.
2. Review `Settings -> KByte SEO Workbench` for defaults, templates, sitemap/robots features, and editor integrations.
3. If you want AI SEO generation:
   - Enable `OpenAI-powered SEO generation` in the settings.
   - Add your `OpenAI API key`.
   - Choose the AI model, tone, content length, FAQ preference, internal link suggestions, and token budget.

## Usage

- Edit any supported post/page to open the SEO panel:
  - Update title/meta description, focus keyphrase, social data, schema and robots directives.
  - Use `Generate SEO pack` to generate keyphrases, meta descriptions, slug suggestions, and optimization notes.
- Use taxonomy edit screens to override archive SEO titles, descriptions, social data, canonical URLs, and noindex settings.
- Use `SEO Tools` for content suggestions, keyword research, competitor comparisons, robots.txt checking, reports, bulk editing, rank tracking, backlink monitoring, Yoast migration, and other utilities.

## Highlights

- AI-assisted SEO generation for titles, descriptions, keyphrases, social copy, slug ideas, and optimization notes
- Configurable AI controls for tone, length, FAQ suggestions, internal links, and output size
- Search appearance templates for posts, pages, taxonomies, authors, dates, media, search, and 404 pages
- Schema support for article, webpage, FAQ, local business, and product content
- XML sitemaps for post types, taxonomies, and author archives
- Breadcrumbs shortcode and block with primary-term support
- FAQ, HowTo, and Breadcrumbs Gutenberg blocks
- Admin bar SEO summary and dashboard widget
- Bulk editor for SEO titles and meta descriptions
- Redirect manager with automatic redirects
- Dynamic robots.txt generation and robots.txt auditing
- Rank tracking with SerpApi-based scheduled or on-demand checks
- Backlink monitoring with large-page handling, reversed-entry detection, and estimated domain strength
- Yoast SEO metadata import/export tools
- Branded HTML reports, monthly email reporting, and REST API endpoints
- REST API report and audit endpoints

## AI Features

- OpenAI-powered SEO pack generation inside the editor
- Configurable model selection and token limits
- Tone and length controls for generated output
- Optional FAQ and internal linking suggestions
- `llms.txt` generation for AI and LLM discovery workflows

## External Requests

- Broken outbound link checking is disabled by default. If you enable it, your site sends HEAD/GET requests to up to five external URLs found in the content during analysis.
- OpenAI is used only when you enable AI generation and request an SEO pack.
- SerpApi is used only when you add a SerpApi key and run or schedule Google rank checks.
- IndexNow is used only when you enable IndexNow notifications.

## Tools Included

- Technical SEO audit dashboard
- Content suggestions based on live SEO checks
- Keyword research from your existing site content
- Competitor page comparison reports
- Bulk SEO editor
- Google rank tracking
- Backlink monitoring
- Yoast SEO migration
- Branded report export and monthly email reporting

## Changelog

### 1.1.0

- Added primary term support for hierarchical taxonomies
- Added taxonomy archive SEO controls and frontend output
- Added taxonomy and author sitemap coverage
- Added FAQ, HowTo, and Breadcrumbs blocks
- Added admin bar SEO summary and dashboard widget
- Added bulk SEO editor
- Expanded documentation for AI, migration, reporting, and monitoring features
- Improved backlink monitoring and added estimated domain strength
- Updated plugin website metadata and links

### 1.0.0

- Initial stable release

## Uninstall

Uninstalling from the WordPress `Plugins` screen runs the plugin uninstall routine, which removes plugin options and stored post meta created by KByte SEO Workbench.

## License

This project is licensed under **GPL v2 or later**.
