geooptimizer/php-geo-optimizer

A PHP library for Generative Engine Optimization (GEO) — llms.txt, Schema.org structured data, and AI search readiness tooling.

v2.2.2 2026-07-03 23:29 UTC

Requires

• php: >=7.4
• guzzlehttp/guzzle: ^7.0
• psr/log: ^1.0|^2.0|^3.0
• spatie/schema-org: ^3.0
• symfony/cache: ^5.0|^6.0
• symfony/console: ^5.0|^6.0
• twig/twig: ^3.0

Requires (Dev)

• brain/monkey: ^2.6
• friendsofphp/php-cs-fixer: ^3.0
• mockery/mockery: ^1.0
• php-stubs/wordpress-stubs: ^6.0
• phpstan/phpstan: ^1.0
• phpunit/phpunit: ^9.0|^10.0
• squizlabs/php_codesniffer: ^3.0

Suggests

• laravel/framework: Required to use the Laravel service provider and facade.
• symfony/framework-bundle: Required to use the Symfony bundle integration.

MIT

• GeoOptimizer

• geo
• seo
• optimization
• llm
• generative-engine-optimization
• ai-search

Published on Packagist.org on 2026-07-03 23:29 UTC

README

Generative Engine Optimization (GEO) for PHP — generate llms.txt files, Schema.org structured data, and citation-ready markup so AI search engines (ChatGPT, Claude, Perplexity, Google AI Overviews) can find and cite your site accurately.

• Website: geooptimizer.dev
• Repository: github.com/tedrubin80/geolibrary
• WordPress plugin: Download latest zip

What is GEO?

Generative Engine Optimization is the practice of structuring web content so AI-powered search systems represent your business correctly. GeoOptimizer handles formatting, industry templates, structured data, and readiness scoring — without requiring deep AI expertise.

Features

• llms.txt generation — AI-oriented site summaries following the emerging llms.txt convention
• Structured data — Schema.org markup for local business, services, FAQs, and more
• Content analysis — GEO readiness scoring with actionable recommendations
• Industry templates — Pre-built baselines for 12+ industries
• Citation tracking — Monitor mentions across major AI platforms (optional API keys)
• WordPress plugin — Admin UI, automatic llms.txt endpoint, structured data in wp_head
• Framework integrations — Laravel service provider, Symfony bundle
• REST API — Automation endpoints with optional API key auth and rate limiting
• Premium WordPress tier — Dashboard, bulk analysis, and competitor comparison with license key

Requirements

• PHP 7.4+ (PHP 8.2+ recommended for development tooling)
• Composer

Installation

PHP library (Composer)

composer require geooptimizer/php-geo-optimizer

WordPress plugin

Download the release zip (includes bundled dependencies):

https://github.com/tedrubin80/geolibrary/releases/latest/download/geooptimizer-wordpress-plugin.zip

In wp-admin: Plugins → Add New → Upload Plugin, upload the zip, activate, then open Settings → GEO Optimizer. The plugin is not on WordPress.org yet.

From source

For local development from this repository:

git clone https://github.com/tedrubin80/geolibrary.git
cd geolibrary
composer install

Quick start

<?php
require 'vendor/autoload.php';

use GEOOptimizer\GEOOptimizer;

$geo = new GEOOptimizer();

$results = $geo->optimize([
    'business_name' => 'Acme Coffee',
    'description'   => 'Specialty coffee roaster and café.',
    'industry'      => 'restaurant',
    'location'      => 'San Francisco, CA',
    'services'      => ['Espresso', 'Pour Over', 'Retail Beans'],
]);

file_put_contents('public/llms.txt', $results['llms_txt']);

Project layout

src/                          PHP library (PSR-4: GEOOptimizer\)
wordpress-plugin/geooptimizer/ WordPress plugin distribution
public/                       Static site (geooptimizer.dev)
docs/                         Usage and development guides
tools/build.php               Build library / plugin zip artifacts

WordPress plugin

Same download as above:

https://github.com/tedrubin80/geolibrary/releases/latest/download/geooptimizer-wordpress-plugin.zip

For local development from the repo:

cd wordpress-plugin/geooptimizer
composer install

Build a distributable zip:

php tools/build.php --plugin
# → dist/geooptimizer-wordpress-plugin.zip

Premium features unlock with a license key under Settings → GEO Optimizer (demo key: GEO-DEMO-9444).

Dashboard and API

Serve the citation dashboard from public/dashboard/ and run the REST API with:

php bin/geo-api
# or: GEO_API_KEY=secret php bin/geo-api

See integrations.md for REST endpoints and framework setup.

Development

composer test          # PHPUnit
composer phpstan       # Static analysis
composer audit         # Dependency security audit
php tools/build.php    # Package artifacts into dist/

See docs/development.md for build, CI, and security notes.

Documentation

• Development guide
• Publishing guide
• Framework integrations
• Usage guide
• How to build
• Project plan

License

This project is licensed under the MIT License.