Admin Configuration
All SEO Agents settings are at Admin → SEO Agents → Settings.
Frontend Mode
SaaS mode
When enabled, the module intercepts two public routes:
| Route | Default behaviour | SaaS mode behaviour |
|---|---|---|
GET / | Marketplace homepage | SEO Agents landing page |
GET /pricing | All products | SEO subscription plans |
Product store URLs (/products/…) redirect to /pricing so visitors always land on the subscription page rather than the marketplace.
Checkout, cart, account, and order routes are untouched — the purchase flow continues to work normally.
Use case: Enable SaaS mode when SEO Agents is your platform's primary or only product and you want a dedicated product website rather than a generic marketplace.
SERP API
Serper.dev API Key
Required for live search data in Keyword Research, Competitor Analysis, and Content Brief agents.
- Get a free key at serper.dev (100 free queries/month on the free plan)
- Enter the key and click Save Settings
- The key is encrypted before storage and is never visible in plain text after saving
Test Connection
After saving a key, click Test Connection to send a live request to the SERP API. The button:
- Turns green with "Connection successful" if the key is valid
- Shows the HTTP error code with a description if the key is invalid or rate-limited
- Indicates a timeout if your server cannot reach the SERP API endpoint
Without a SERP key
The three SERP-dependent agents still run. They note in their output that live search data was unavailable and base their analysis on the LLM's training data instead. Users are not blocked or shown an error.
Changing the SERP provider
The default provider is Serper.dev. To switch to ValueSERP, set the following in your .env file:
SEO_SERP_API_PROVIDER=valueserpThen enter your ValueSERP API key in the admin settings field. The key field and test button work identically for both providers.
Registered Agents panel
The left column on the settings page lists all agents currently registered in the global registry. If an agent is missing (e.g. after an install error), it will not appear here and will not be accessible to users.
Each agent shows its slug (used as the URL segment) and its tags.