AI-Powered SEO Automation for Laravel

use Refinder\LaravelSdk\Facades\Refinder;

// Execute SEO analysis — one line of code
$result = Refinder::seo()->execute([
    'content' => 'Your article content here...',
    'content_type' => 'article',
    'language' => 'en',
]);

// Access strongly-typed output
echo $result->output->metaTitle;           // "Optimized SEO Title"
echo $result->output->metaDescription;     // "Meta description..."
echo $result->output->seoScore->overall;   // 85

// Keywords are fully structured
$result->output->keywords->primary;    // ['seo', 'optimization']
$result->output->keywords->longTail;    // ['best seo practices 2026']

use Refinder\LaravelSdk\DTOs\SeoInput;
use Refinder\LaravelSdk\Facades\Refinder;

$input = new SeoInput(
    content:        $article->body,
    url:            route('articles.show', $article),
    contentType:    'article',
    language:       'en',
    depth:          'technical',
    targetKeywords: ['AI tools', 'SEO automation'],
    brandName:      'MyBrand',
    industry:       'Technology',
);

$result = Refinder::seo()->execute($input);

// Update your model with SEO data
$article->update([
    'seo_title' => $result->output->metaTitle,
    'seo_score' => $result->output->seoScore->overall,
]);

use Refinder\LaravelSdk\Exceptions\RateLimitException;
use Refinder\LaravelSdk\Exceptions\ValidationException;
use Refinder\LaravelSdk\Facades\Refinder;

try {
    $result = Refinder::seo()->execute(['content' => $text]);

    return response()->json([
        'seo'    => $result->output,
        'tokens' => $result->usage->totalTokens,
    ]);

} catch (ValidationException $e) {
    return response()->json(['error' => $e->errors], 422);

} catch (RateLimitException $e) {
    return response()->json([
        'error'   => 'Rate limit reached',
        'limit'   => $e->limit,
        'current' => $e->current,
    ], 429);
}