Marketing Agent

Performance trend

Search Console clicks + impressions

Clicks Impressions

Pick a client to see the trend.

Traffic by channel

Google Analytics sessions · last 90 days

Pick a client to see traffic.

Leads & conversions

Form leads, funnel & conversions by channel · last 90 days

Pick a client to see leads.

Loading auth status...

Issues only

Google reindex: … Nudges Google to re-crawl. 200/day shared quota. Tip: pair with a date refresh (✦ button per row) for real ranking lift.

	Title	Type	Status	Meta	Impressions (90d)	Clicks (90d)	CTR	Pos	Issues	Date	Words	GSC Suggestion

Categories & Tags

▼

Insights

Your highest-priority issues & opportunities

SEO Audit

High-value conversion items — default view

No audit data yet. Run an audit to check your site's SEO health.

Audit History

▼

Off-Page SEO

Find every Reddit / Quora / GitHub / forum mention of this client. Plan next-up posts without duplicating what you've already done.

No audit run yet for this client.

Audit History

▼

OFF-PAGE COACH

Ahrefs

Per-client API key. Domain rating, organic keywords, backlinks, referring domains, keyword gap. Cached 24h. Hard caps: $5/day, $15/week, $30/month per client.

GSC Insights

Pulled from Google Search Console — 90-day window

Use Pull GSC at the top of Performance — pulls analytics + indexing + auto-runs Claude analysis.

Loading GSC status…

Search performance trend

Daily clicks + impressions

Clicks Impressions

Pick a client to see the trend.

Marketing Agent AI

Your client's strategist. Ask anything about content, GSC, audits, or planning.

Enter to send · Shift+Enter for newline

Legacy strategy form (planning wizard)

Your content landscape — what you already have + what's performing

Loading…

Upload strategy — drop a doc, paste, or create below

Strategy name (optional)

Upload file (.md / .txt — pdf/docx: paste text below)

Or paste strategy content (becomes the new active strategy for this client)

1. Brief

Campaign name *

Primary goal *

Seed topic / primary keyword

Target audience

Funnel stage

Tone

Content type

List size (for "top N" posts)

Geography

Scope

Country

Local SEO (enable state + city targeting)

Your unique angle / personal take (injects into every post prompt)

Number of blogs to plan

Intent mix

80% transactional · 20% other (click suggest)

2. Research checklist

Pick what to pull. Each runs a sub-task and feeds the gap matrix.

Analyze my existing blogs — group my cached posts into clusters, flag internal gaps Research competitors — paste blog index URLs below to scrape titles + outlines Find content gaps — gap matrix: us vs each competitor, per subtopic

Competitor URLs (up to 5 — blog index pages preferred)

Previous strategy runs

▼

Content Calendar

sorted by date

Quick hide:

View MD source

Competitor Analysis

Competitor research feeds the Strategist's competitive-landscape context so it can broaden topic-proposal scope. Add competitors manually, or auto-research up to 5.

Comma-separated list. Root domains only (no https://, no www.). Auto-research is a fallback when you don't have a list — it picks competitors based on the client's industry profile.

Currently viewing

—

Claude's knowledge applies to all clients · Client knowledge scopes to this one

Scope

Sections

Select a section

Train Claude on this knowledge

Type anything — a rule, a client fact, a style preference. Claude classifies it as global or client-scoped and updates the right section.

Keyword library Cross-client corpus seeded with GPX KW research + every Ahrefs/Gemini lookup the Strategist runs. Showing top by volume.

Search (keyword substring) Category Min volume Scope

Keyword	Volume	KD	Source	Fetched
Loading…

Site QA

Manual-only — start a check with Run now.

Loading last run…

Past runs —

Loading…

Findings

Select a run from the left to view findings.

Compliance

Blogs sorted by score — lowest first. Fix the red, review the amber, ship the green.

Score	Title	Violations	Top fail reasons	Created	Actions
Loading…

Pages and products currently aren't scored — written before current quality checks — re-run to score. Adding non-blog content scoring is on the roadmap.

Product roadmap

v5.0 scope is blog writing only. Pages, products, and integrations are queued below with build specs so future Claude Code sessions have full context.

Coming soon — site mutations (read-only today)

Marketing Agent is intentionally read-only right now. It can detect problems, sync content, and generate drafts — but it does not publish to or edit your live sites. The capabilities below are wired in the UI but gated behind the Safety panel (all OFF by default). Flip a toggle in Admin → Settings → Safety when you are ready to let Manager write.

Publish blog to WordPress

Flag: allow_wp_publish

Apply SEO fixes in place (WP)

Meta titles, descriptions, alt text, JSON-LD. Flag: allow_wp_in_place_fix

Publish to Shopify

Flag: allow_shopify_publish

Open PR against React site

Flag: allow_react_pr

White-label client portal

Per-client read-only login — each client sees only their dashboard + GSC + campaigns + reports. Uses existing users + user_clients tables. UI-only build.

Deactivated features Built — toggle to activate

These modules are fully built but turned off to keep the workspace simple. Flip the toggle to surface them in the Performance tab.

Phase 6 — Integrations (upcoming)

Catalog endpoint and per-client integrations table already exist. Individual data-fetch modules (GA4, Semrush, PSI, CRM, email, reviews) are not yet wired. The cards below define the scope — each has a Claude Code build spec so future sessions have full context.

Coming-soon integrations

Live from the integrations catalog. Each is currently disabled in Settings; they light up as soon as their config lands.

Loading…

Now — shipped

Next — v5.4 / v5.5

Later

Phase 7 — Governance

AI Credentials

Choose how each client pays for AI calls. By default, every client uses the admin's shared Claude subscription and Gemini API quota. Switch to client-owned keys to bill against their own accounts. Keys are encrypted at rest (AES-256-GCM) and only the last 4 characters are ever visible after save.

Admin · Global sharing

Loading…

● ON

Show per-client overrides

Loading…

Current client

No client selected — pick one from the sidebar

Platform & Connection

▼

Platform

WordPress URL

Username

App Password

Show

Must be a WordPress Application Password (24 alphanumeric chars in 6 groups of 4 with spaces, e.g. Ab12 cdE3 45fG H678 ijkL 9mnO). Generate at /wp-admin/profile.php → Application Passwords. Not your login password.

Default Category

Team & Users — admins see everything, users see assigned clients

▼

Email *

Name

Initial password — leave empty to email an invite

Role

admin sees every client and can manage users; user sees only the clients you assign below. After "Add user", click Clients on the new row to assign access. History shows login attempts + per-user activity.

Role filter

Loading team…

Integrations — connect Search Console, Analytics and your keyword data

▼

API token usage — current month, all 3 apps

▼

Filter by client:

Loading…

By app (current month)

—

By provider

—

By client

—

Safety — write actions (read-only by default)

▼

Marketing Agent is read-only out of the box. Toggle a flag below to let the corresponding button actually mutate the site. Each flip is logged. Per-client overrides coming soon — today these apply globally.

Loading…

Admin users only. History of every flip lives in Admin → History (db_history table).

History (Admin — restore prior versions)

▼

Click a table filter above or Refresh.

Brand Configuration

▼

Brand Name

Industry

Target Audience

Brand Voice

Writing quality — the engine behind the Strategist, the writer and the analysis tools

▼

Pick the Claude model the app uses by default. Built-in options always appear. Add any future model ID (e.g. claude-opus-4-9) the day it ships — switch with one click, no deploy.

Current default

Add custom model ID

API keys — admin only · a rotated key takes effect immediately; scheduled jobs pick it up on their next run

▼

Rotating a key auto-backs-up /home/umer/aeo-agent/.env (timestamped). The in-process value is updated immediately so Gemini / Ahrefs fetch() calls pick up the new key on the next request. Child processes (Claude CLI subprocesses) only refresh after the next pm2 restart aeo-agent --update-env.

Gemini fallback key — image-gen / vision fallback only

▼

Claude (default model selectable above — currently claude-opus-4-8) is the primary for every pipeline (research, draft, critique, rewrite, Strategist, competitor analysis, coaches) and runs through the shared Anthropic subscription — no key needed here. Gemini is only used for image-gen prompt construction + vision diffs, and shows up as a fallback when Claude CLI is unavailable.

Gemini API key

Show

Legacy 6-step prompts — these are read by the Content Writer iframe (the v518 engine inside the Writer tab). The Marketing Agent's native 4-step pipeline (v534, used by the Workbench / Calendar / Page-set planner / Compliance re-run) has its prompts hard-coded in src/v534-pipeline-v2.js and is NOT affected by edits below.

Writing pipeline — the six steps behind every article

▼

Google Search Console

▼

Client Management

▼

Onboard a new client

4-step wizard: brand → GSC → Ahrefs budget → overrides.md + user link.

▸ Manual entry (fallback) — prefer the AI Intake Wizard at the top of the page

Client Name

Platform

Activity Logs

▼

Timestamp	Client	Action	Detail

Categories & Tags

Insights

SEO Audit

Audit History

Off-Page SEO

Audit History

Ahrefs

GSC Insights

Previous strategy runs

Content Calendar

Drafted post ideas (0)

Competitor Analysis

AI Credentials

Platform & Connection

Team & Users — admins see everything, users see assigned clients

Integrations — connect Search Console, Analytics and your keyword data

API token usage — current month, all 3 apps

Safety — write actions (read-only by default)

History (Admin — restore prior versions)

Brand Configuration

Writing quality — the engine behind the Strategist, the writer and the analysis tools

API keys — admin only · a rotated key takes effect immediately; scheduled jobs pick it up on their next run

Gemini fallback key — image-gen / vision fallback only

Writing pipeline — the six steps behind every article

Google Search Console

Client Management

Activity Logs

Writer Coach — History

Knowledge proposals (0)

Threads (0)

Uploads (0)

Archived threads

Categories & Tags

Insights

SEO Audit

Audit History

Off-Page SEO

Audit History

Run Off-Page Audit

Ahrefs

GSC Insights

Previous strategy runs

Content Calendar

Drafted post ideas (0)

Competitor Analysis

AI Credentials

Platform & Connection

Team & Users — admins see everything, users see assigned clients

Integrations — connect Search Console, Analytics and your keyword data

API token usage — current month, all 3 apps

Safety — write actions (read-only by default)

History (Admin — restore prior versions)

Brand Configuration

Writing quality — the engine behind the Strategist, the writer and the analysis tools

API keys — admin only · a rotated key takes effect immediately; scheduled jobs pick it up on their next run

Gemini fallback key — image-gen / vision fallback only

Writing pipeline — the six steps behind every article

Google Search Console

Client Management

Activity Logs

Edit Content

Add New Client (manual)

New client intake — AI assisted

Client created

Writer Coach — History

Knowledge proposals (0)

Threads (0)

Uploads (0)

Archived threads Show archived

Ahrefs settings

Onboard new client — step 1 of 4

Archived threads