world-game/site/plugins/kirby-seo/docs/1_features/04_ai-assist.md
isUnknown 58c31ea391
All checks were successful
Deploy / Deploy to Production (push) Successful in 22s
feat: intégration plugin Kirby SEO
- Ajout de tobimori/kirby-seo via Composer
- snippet('seo/head') dans header.php (remplace les meta manuels)
- snippet('seo/schemas') dans footer.php pour JSON-LD
- Onglet SEO ajouté dans site.yml et tous les blueprints de pages
- Configuration SEO dans config.php (sitemap, robots, canonicalBase TODO)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-25 12:59:18 +01:00

3 KiB

title intro
AI Assist Let AI draft your meta titles and descriptions

Writing meta titles and descriptions for every page gets tedious fast. AI Assist can generate them for you based on the actual content of each page. It reads the page, looks at your existing meta fields, and drafts a title or description that fits.

AI Assist works for these fields:

  • Meta title
  • Meta description
  • Open Graph description
  • Site-level meta description
  • Site-level Open Graph description

The generated text matches the language of your page and respects your title template length, so titles don't get cut off in search results.

Setting up a provider

AI Assist needs an API key from an AI provider. Sign up with one of the supported providers and create an API key in their dashboard. Kirby SEO supports OpenAI, Anthropic, Google Gemini, and OpenRouter out of the box. OpenRouter is a good starting point because it gives you access to many models through a single API, including models with free tiers.

AI providers charge based on usage. These costs are separate from your Kirby SEO license. For generating short texts like meta titles and descriptions, costs are typically very low.

Here's an example using OpenRouter:

// site/config/config.php
return [
  'tobimori.seo' => [
    'ai' => [
      'provider' => 'openrouter',
      'providers' => [
        'openrouter' => [
          'config' => [
            'apiKey' => 'sk-or-...',
            'model' => 'google/gemini-3-flash-preview',
          ],
        ],
      ],
    ],
  ],
];

For generating meta titles and descriptions, you don't need the most powerful model. Small, fast models work well and keep costs low. Our recommendation is Google Gemini 3 Flash via the built-in Gemini provider: it's fast, capable, and has a generous free tier.

You can change the model for any provider via the model key in the config, as shown in the example above.

For config options for all providers, see Customizing AI Assist for details.

Using AI Assist in the Panel

The provider config is a one-time setup by the developer. Once it's in place, editors just use the buttons in the Panel.

You'll see new buttons next to the meta title and description fields in the SEO tab.

The Generate button drafts a new value from scratch based on the page content. If the field already has a value, it changes to Regenerate. If you want more control, click Customize to add your own instructions before generating, like "keep it under 50 characters" or "focus on the pricing".

Already have a value but want to tweak it? The Edit button lets you revise the current text with instructions like "make it shorter" or "add the brand name".

The result appears word by word. You can stop it early if you want.

Custom providers and prompts

You can add your own providers or override the built-in prompts. See Customizing AI Assist for details.