Installation

Prerequisites

• ChargePanda v1.3.0 or later
• AiAgentsCore module installed and activated first
• A queue worker running (inherited from AiAgentsCore setup)
• At least one LLM provider configured in AiAgentsCore settings

---

1. Upload the module

1. Go to Admin → Modules and click Upload & Install.
2. Select SeoAgents.zip.
3. If AiAgentsCore is not yet installed, upload a bundle ZIP containing both AiAgentsCore.zip and SeoAgents.zip. The installer resolves the dependency order automatically.
4. Click Upload. ChargePanda validates the manifest and copies the files.
5. The module appears in the list with status Inactive.

---

2. Activate the module

Click Activate next to SEO Agents. Activation:

• Runs database migrations (none — SEO Agents uses AiAgentsCore's tables)
• Fires the setup seeder, which creates the default product and three subscription plans
• Registers all six agents into the global agent registry

---

3. Verify the default product was created

Go to Admin → Products and look for SEO Agents. Open the product and confirm:

• Three pricing tiers exist (Starter, Pro, Agency or similar)
• Each tier has a seo_agents plan entitlement with the monthly run limit

To adjust limits:

1. Open the product → Plans tab → click a plan → Features tab
2. Find the seo_agents entitlement row and change the Value (e.g. 50 for 50 runs/month; blank = unlimited)

---

4. Configure the SERP API (optional but recommended)

Three agents (Keyword Research, Competitor Analysis, Content Brief) fetch live search results. Without a SERP API key they still run, but they cannot retrieve live data and will note this in their output.

Supported providers:

• Serper.dev (default) — free plan available at serper.dev
• ValueSERP — configure via SEO_SERP_API_PROVIDER=valueserp in .env

To add your key:

1. Go to Admin → SEO Agents → Settings
2. Enter your API key in the Serper.dev API Key field
3. Click Save Settings
4. Click Test Connection to verify the key works

---

5. Verify the queue worker is running

SEO Agents relies on AiAgentsCore's queue worker. If you haven't already, start it:

php artisan queue:work --queue=agents

For production, use Supervisor. See AiAgentsCore Installation for the full Supervisor configuration.

---

6. Test the user experience

Visit /app (or the URL your account nav links to) and confirm:

• Agents you have plan access to appear unlocked
• Agents not in your plan show a lock icon with an upgrade link
• Running an agent dispatches it and polls for completion