README

Laravel-free-seo-api is a plug-and-play SEO generator and competitor analyzer package for Laravel 12+ with a built-in React SPA dashboard. It automatically generates SEO meta data for your pages and analyzes top competitors — no frontend or backend coding needed.

Features

• Generate SEO meta tags (title, meta description, keywords) for any URL.
• Analyze top competitors for a keyword and compare their SEO meta data.
• React SPA Admin Dashboard:
  • View all pages with SEO meta
  • View competitor reports
  • Fully interactive and responsive
• Artisan commands:
  • seo:generate {url}
  • seo:compare {url} {keyword} {--top=N}
• Fully plug-and-play with Laravel 12+.
• Free and open source — no external paid APIs.

Installation

1. Install Laravel 12 project (if needed)

composer create-project laravel/laravel:^12.0 laravel-seo-test
cd laravel-seo-test

2. Install the package

Add the package locally in composer.json:

"repositories": [
  {
    "type": "path",
    "url": "../packages/laravel-free-seo-api"
  }
],
"require": {
  "yourname/laravel-free-seo-api": "*"
}

Then run:

composer require yourname/laravel-free-seo-api

3. Publish migrations & run

php artisan vendor:publish --tag=freeseo-migrations
php artisan migrate

4. Publish frontend assets (React SPA)

php artisan vendor:publish --tag=freeseo-frontend
cd vendor/yourname/laravel-free-seo-api/resources/frontend
npm install
npm run build

Usage

Generate SEO meta

php artisan seo:generate https://example.com/page

Analyze competitors

php artisan seo:compare https://example.com/page "your keyword" --top=5

Access Admin Dashboard

http://127.0.0.1:8000/admin/seo

• View all pages and SEO meta
• View competitor reports
• Fully interactive React SPA

Database Tables

• seo_meta — stores URL, title, meta description, keywords.
• seo_competitor_reports — stores URL, keyword, and competitor list.

Requirements

• PHP ≥ 8.2
• Laravel 12+
• Node.js & npm (for building React SPA)
• GuzzleHttp (included via Composer)
• Optional: php-text-analysis for keyword analysis

License

MIT License — free to use, modify, and distribute.