AI Search — Current Implementation

Leadmetrics already has a substantial SEO and analytics foundation that AI Search visibility features can build directly on top of.

Connected Channels (SEO / Analytics)

Google Search Console

• Provider: packages/providers/google/src/google-search-console.ts
• OAuth route: GET /google-search-console/connect, /callback, /page/select
• API methods: getStats() (clicks/impressions/CTR/avg position by date), getKeywordStats() (top 10k queries), getStatsByKeyword() (per-keyword daily trend), getPageStats(), getSearchFilter()
• Dashboard UI: apps/dashboard/src/app/(dashboard)/channels/[id]/GoogleSearchConsoleChannelDetail.tsx
  • Stat cards: clicks, impressions, CTR, average position (current vs prior period with delta %)
  • Daily performance line chart
  • Top keywords table with position column
  • Date range picker + AI Insights tab
• API route: GET /tenant/v1/channels/:id/analytics — serves all GSC data

Google Analytics (GA4)

• Provider: packages/providers/google/src/google-analytics.ts
• API methods: getOrganicTrafficMetrics(), getOverviewMetrics(), getDailyMetrics(), getTrafficSources(), getTopPages(), getOrganicStats(), getCountryStats(), getAudienceInsights()
• Dashboard UI: apps/dashboard/src/app/(dashboard)/channels/[id]/GoogleAnalyticsChannelDetail.tsx
  • Sessions, users, pageviews, bounce rate, engagement stat cards
  • Daily performance chart
  • Traffic sources breakdown, top pages, organic traffic tab, country/city tabs
  • AI Insights tab

Bing Webmaster Tools

• Provider: packages/providers/microsoft (BingWebmasterService)
• API methods: Query stats — clicks, impressions, CTR, position by keyword
• Dashboard UI: apps/dashboard/src/app/(dashboard)/channels/[id]/BingWebmasterToolsChannelDetail.tsx
  • Stat cards: clicks, impressions, CTR, position
  • Top keywords table
• OAuth route: GET /bing-webmaster/connect, /callback, /page/select

AI Agent Workers (SEO)

All workers are in packages/agents/src/workers/ and use the shared createContentWorker pipeline (BullMQ + Claude, system prompts seeded in DB).

AI Insight Workers (Analytics)

Both workers are in packages/agents/src/workers/insights/.

On-Page SEO

The blog post detail page (apps/dashboard/src/app/(dashboard)/blog/[id]/BlogPostDetail.tsx) includes a live SEO score widget:

• Keyword in title check
• Meta description present + length check
• Word count check
• Slug check
• Rendered as a donut chart with per-item breakdown

Target keywords are displayed as tags on each blog post.

Strategy Integration

The deliverable planner includes keyword_cluster and content_brief in its deliverable catalogue, both available on the Free plan. Claude will proactively recommend and schedule these when generating a monthly marketing plan.

AI Search Visibility (Phase 1 — Live, April 2026)

DB Models

Added to packages/db/prisma/schema.prisma:

• Competitor — per-tenant structured competitor list (name, domain, isActive, notes)
• AIVisibilityPlatform — global platform registry seeded with chatgpt/gemini/perplexity/claude; managed by superadmin
• TenantAIVisibilityPlatform — per-tenant platform on/off toggle
• AIVisibilityPrompt — monitored prompts per tenant (prompt text, intent, category, isActive)
• AIVisibilitySnapshot — per-prompt per-platform result (isMentioned, sentiment, rawExcerpt, citedSources[], competitors[])
• GSCKeywordSnapshot — daily keyword position snapshots for GSC (keyword, position, clicks, impressions, CTR, snapshotDate)

BullMQ Workers

Workers live in packages/agents/src/workers/ (seeder + monitor) and packages/agents/src/workers/insights/ (brand-narrative) and packages/agents/src/workers/jobs/ (gsc-keywords-snapshot).

API Routes

apps/api/src/routers/ai-visibility.ts — registered at /tenant/v1/ai-visibility in both app.ts and index.ts.

apps/api/src/routers/competitors.ts — registered at /tenant/v1/competitors.

Dashboard Pages

• /settings/competitors — list competitors, add/edit/delete. Available to DMs and clients.
• /ai-search — overview page with per-platform score cards, prompt results table, “Run Now” trigger. (Phase 1 — in progress)

Env Vars Added

GOOGLE_GENERATIVE_AI_KEY=   # direct Gemini API (separate from GSC/GA4 OAuth)
PERPLEXITY_API_KEY=         # Perplexity API
ANTHROPIC_API_KEY=          # already existed; now also used by monitor worker

Known Gaps in Current Implementation