Back to Homepage
Documentation

Learn how to use SeoLens

Everything you need to know about the platform — from getting started to mastering every tool. Comprehensive guides, integration walkthroughs, and best practices.

What is SeoLens?

SeoLens is an AI-powered SEO platform that connects directly to your Google Analytics 4 and Google Search Console data. Instead of relying on third-party estimates, it uses your real performance data to deliver actionable insights, content recommendations, and executive reports.

Whether you are a solo marketer, an in-house SEO team, or a digital agency managing dozens of clients, SeoLens gives you a single workspace to track rankings, discover opportunities, plan content, and demonstrate ROI — all powered by AI.

The platform supports multiple AI providers including OpenAI (GPT-4o), Anthropic (Claude), and Google Gemini. You can choose your preferred provider or let the AI Router automatically select the best model for each task, ensuring optimal results and cost efficiency.

Core Capabilities

Google-first data — direct GA4 & Search Console integration

No third-party scrapers or estimated data

AI Insights Engine — automatic opportunity detection

Low CTR, content decay, cannibalization, near-page-1

Content Planner — data-driven briefs and AI drafts

Outlines, entities, FAQs, schema recommendations

SEO Audit — website crawler with health scoring

Technical, content, performance, and links analysis

Keyword Clusters — semantic topic grouping

AI-powered clustering for content strategy

Competitor Analysis — domain comparison

Keyword overlap, traffic estimates, competitive gaps

White-label Reports — branded executive PDFs

Custom logo, colors, and footer text

AI Visibility Monitor — track brand in AI search

ChatGPT, Perplexity, and Gemini mentions

SEO Workboard — Kanban task management

Assign, prioritize, and track SEO tasks

Multi-client Workspaces — role-based access

Owner, Admin, Member, Client Viewer roles

AI Chat — conversational SEO assistant

Ask questions about your data in natural language

Internal Links — AI link suggestions

Improve crawlability and link equity distribution

Getting Started

Follow these four steps to go from sign-up to your first AI-powered insights.

1

Create your account

Sign up for free in seconds. No credit card required. You'll receive a confirmation email and can start immediately.

  • Go to the registration page and enter your name, email, and password.
  • Verify your email address via the confirmation link.
  • You're automatically enrolled in the Free plan with 50 AI credits per month.
2

Set up a workspace & project

Create a workspace for your organization, then add a project for each website you want to track.

  • Workspaces represent your organization or agency. You can have multiple workspaces.
  • Each project corresponds to a single website domain you want to monitor.
  • Invite team members and assign roles: Owner, Admin, Member, or Client Viewer.
3

Connect Google data

Link your Google Analytics 4 and Google Search Console accounts via OAuth. SEOLENS only reads data — it never modifies your Google accounts.

  • Navigate to Project Settings and click 'Connect Google Account'.
  • Authorize read-only access to your GA4 and Search Console properties.
  • Select the specific property and site you want to track.
  • Data syncing begins automatically and takes a few minutes for the initial load.
4

Explore AI-powered tools

Once data syncs, use the dashboard, insights, content planner, keyword tracker, and more to grow your organic traffic.

  • Start with the Dashboard for a high-level overview of your SEO performance.
  • Run an SEO Audit to identify technical issues and quick wins.
  • Generate AI Insights to discover hidden opportunities in your data.
  • Use the Content Planner to create optimized content briefs.

Complete Tools Reference

Detailed documentation for every major tool in the platform. Click each card to see full feature details.

Dashboard & KPIs

Your command center for organic performance. See clicks, impressions, CTR, and average position at a glance with interactive charts pulled from real Google data.

Key Features:

  • Real-time KPI cards with trend indicators (28-day comparison)
  • Interactive traffic charts showing clicks and impressions over time
  • Top performing queries and pages at a glance
  • GA4 session data including users, bounce rate, and conversions
  • Device and country breakdown of your organic traffic

AI Insights Engine

Automatically detects actionable SEO opportunities by analyzing your real Google data. Prioritized recommendations you can act on immediately.

Key Features:

  • Low CTR Detection — pages ranking well but getting few clicks
  • Near Page 1 — keywords on positions 11-20 that are close to breaking through
  • Content Decay — pages losing traffic that need refreshing
  • Keyword Cannibalization — multiple pages competing for the same queries
  • Each insight includes priority level, estimated impact, and suggested action

SEO Audit

Crawl your website and get an AI-powered health score across four categories: Technical, Content, Performance, and Links.

Key Features:

  • Automated website crawler that checks up to 100 pages per scan
  • Technical SEO checks: meta tags, headings, canonical URLs, robots.txt, sitemap
  • Content quality analysis: word count, readability, keyword density, duplicates
  • Performance indicators: page load signals, image optimization, Core Web Vitals hints
  • Link health: broken links, redirect chains, orphan pages, internal linking structure
  • Overall score (0-100) with category breakdown and specific fix recommendations
  • Download audit results as a branded PDF report

Content Planner

Generate data-driven content briefs complete with outlines, target entities, FAQs, and AI-drafted copy. Plan new content or optimize existing pages.

Key Features:

  • AI-generated content outlines with H2/H3 heading structure
  • Target entity extraction for semantic SEO optimization
  • Automatically generated FAQ sections based on related queries
  • Schema markup recommendations (FAQ, HowTo, Article)
  • Full AI article draft generation with customizable tone and length
  • Competitive gap analysis — what topics your competitors cover that you don't

Keyword Clusters

AI groups your keywords into semantic topic clusters, helping you plan content silos and understand which pages should target which terms.

Key Features:

  • Automatic grouping of keywords by semantic similarity using AI
  • Cluster visualization showing topic relationships
  • Volume and ranking data for each keyword within a cluster
  • Identify content gaps — clusters without a dedicated page
  • Map clusters to existing pages for optimization opportunities

Competitor Analysis

Track and analyze competitor domains to understand their SEO strategy. Discover keyword overlap, traffic estimates, and competitive gaps.

Key Features:

  • Add competitor domains to track their organic performance
  • Keyword overlap analysis — see which terms you share and where you differ
  • Estimated traffic comparison based on ranking positions
  • Discover competitor-only keywords you're missing
  • Overlap score calculation for competitive positioning

Internal Links

AI analyzes your site structure and suggests internal linking opportunities to improve crawlability and distribute link equity.

Key Features:

  • AI-powered suggestions for internal link placement
  • Recommended anchor text for each link opportunity
  • Source and target page pairing with relevance scoring
  • Identify orphan pages that need more internal links
  • Improve topical authority by connecting related content

SEO Workboard

Turn insights into actionable tasks. Kanban-style board with assignment, priorities, and deadlines — all inside the platform.

Key Features:

  • Three-column Kanban board: Open, In Progress, Done
  • Auto-create tasks from AI insights with one click
  • Assign tasks to team members with due dates and priorities
  • Comment threads on each task for team collaboration
  • Filter and sort by priority, assignee, or due date

Monthly Reports

Generate executive-ready PDF reports with AI summaries, performance charts, and actionable recommendations. White-label ready for agencies.

Key Features:

  • AI-written executive summary highlighting key wins and concerns
  • Performance charts: clicks, impressions, CTR, position trends
  • Top queries and pages performance tables
  • Comparison with previous period (month-over-month)
  • Custom branding with logo, colors, and footer text (Agency plan)
  • Email delivery with PDF attachment to stakeholders
  • Schedule automated weekly or monthly report generation

AI Visibility Monitor

Track how AI assistants like ChatGPT, Perplexity, and Gemini mention your brand. Understand your visibility in AI-generated search results.

Key Features:

  • Check brand mentions across ChatGPT, Perplexity, and Google Gemini
  • Industry-specific query testing for your niche
  • Visibility score (0-100) tracking over time
  • Competitor mention comparison in AI responses
  • AI-generated recommendations to improve your AI visibility
  • Download visibility reports as branded PDFs

AI Chat Assistant

Chat with an AI that has full context of your SEO data. Ask questions, get analysis, and receive recommendations in natural language.

Key Features:

  • Natural language queries about your SEO performance
  • Data-aware responses using your real Google Analytics and Search Console data
  • Multi-turn conversations with context preservation
  • Ask for content suggestions, keyword analysis, or strategy advice
  • Conversation history saved for future reference
  • Choose your preferred AI model (GPT-4o, Claude, or Gemini)

Google Integration Guide

SeoLens connects directly to your Google accounts using secure OAuth 2.0 authentication. We request read-only access — your data is never modified.

Google Search Console

  1. 1Ensure your website is verified in Google Search Console.
  2. 2In your project settings, click 'Connect Google Account'.
  3. 3Sign in with the Google account that has access to your Search Console property.
  4. 4Select the property (domain or URL prefix) you want to track.
  5. 5Data will begin syncing automatically — initial sync takes 2-5 minutes.

Google Analytics 4

  1. 1Make sure you have a GA4 property set up for your website.
  2. 2During the Google connection flow, GA4 access is requested alongside Search Console.
  3. 3Select the GA4 property and data stream for your website.
  4. 4Session, user, bounce rate, and conversion data will sync alongside Search Console data.
  5. 5Historical data (up to your plan's retention limit) loads during the first sync.

Important Security Note

SeoLens only requests read-only access to your Google data. We never modify, delete, or write anything to your Google accounts. All OAuth tokens are encrypted at rest using AES-256 encryption. You can revoke access at any time from your Google Account permissions page.

Team Roles & Permissions

SeoLens uses a workspace-based multi-tenancy model. Each workspace can have multiple projects and team members with different roles.

Owner

Full access. Can manage billing, delete workspace, and transfer ownership.

Admin

Full project access. Can manage team members and projects, but not billing.

Member

Can use all SEO tools, create tasks, and generate reports. Cannot manage team.

Client Viewer

Read-only access to dashboards and reports. Ideal for client stakeholders.

Permission Matrix

ActionOwnerAdminMemberViewer
View dashboards & reports
Use SEO tools (audit, insights, content)
Create & manage tasks
Generate AI content & reports
Manage projects
Invite & manage team members
Connect Google accounts
Manage billing & subscription
Delete workspace

AI Credits System

AI credits are consumed when you use AI-powered features. Each action has a different credit cost based on complexity. Credits reset monthly on your billing date.

ActionCredits
AI Chat message1 credits
AI Insights generation2 credits
Internal Link suggestions2 credits
SEO Audit (with crawler)3 credits
Content Brief generation3 credits
Competitor Analysis3 credits
Monthly Report3 credits
Full Content Draft (AI article)5 credits
30-Day SEO Plan5 credits
Keyword ClustersFree
Tasks / WorkboardFree
Settings & ConfigurationFree

50

Free plan credits/month

1,000

Pro plan credits/month

5,000

Agency plan credits/month

Pricing Plans Comparison

Choose the plan that fits your needs. All plans include core SEO tools, Google data integration, and AI-powered insights.

FeatureFreeStarter
$29/mo
Pro
$79/mo
Agency
$199/mo
Projects131030
Team Members131050
AI Credits / month502001,0005,000
Data Retention30 days90 days180 days365 days
SEO Audit
AI Insights
Keyword Clusters
Tasks / Workboard
Weekly Insights Email
Monthly Reports
Priority Support
API Access
White-Label Reports
Client Portal
Custom Domain

Troubleshooting

Common issues and how to resolve them. If your problem isn't listed here, contact our support team.

My Google data isn't syncing

Check that your Google account still has access to the Search Console and GA4 properties. Go to Project Settings and try disconnecting and reconnecting. If the issue persists, check the Sync Log in settings for specific error messages.

I see 'No data available' on my dashboard

Data sync can take a few minutes after initial connection. If it's been more than 10 minutes, check your sync status in Project Settings. Also ensure your website has enough traffic — very new sites may not have Search Console data yet.

My SEO Audit score seems low

The audit score is based on industry best practices across four categories. Common issues include missing meta descriptions, broken links, missing alt text, and slow page load times. Click on each category to see specific issues and fix recommendations.

AI insights seem generic

Insights are generated from your real data. For best results, ensure your Google data has synced completely and you have at least 30 days of data. The more data available, the more specific the insights become.

I can't invite team members

Check your plan's team member limit. Free plans allow 1 member, Starter allows 3, Pro allows 10, and Agency allows 50. Upgrade your plan if you need more team seats.

PDF reports won't download

PDF generation may take a few seconds. Ensure your browser allows pop-ups from the application. If using a mobile device, try on desktop for the best PDF experience.

I'm running out of AI credits too fast

Check your credit usage in the workspace billing section. Content drafts (5 credits) and SEO plans (5 credits) consume the most. Consider upgrading to a higher plan for more monthly credits, or focus on the most impactful actions first.

Best Practices

Get the most out of SeoLens with these proven workflows and tips.

1Weekly SEO Workflow

  1. Monday:Check your Dashboard for KPI changes. Review any new AI Insights.
  2. Tuesday:Run an SEO Audit on your most important pages. Fix critical issues.
  3. Wed:Use the Content Planner to generate briefs for new or underperforming content.
  4. Thursday:Review Keyword Clusters and check for cannibalization. Implement internal links.
  5. Friday:Check Competitor Analysis. Update your Workboard with new tasks for next week.

2Maximize AI Credit Value

  • Start with AI Insights (2 credits) — they surface the highest-impact opportunities across your data.
  • Use Keyword Clusters (free) to group your terms before generating content briefs.
  • Reserve full Content Drafts (5 credits) for your most important content pieces.
  • Use the AI Chat (1 credit) for quick data queries instead of running full analyses.

3Agency Tips

  • Set up separate workspaces for each client to keep data isolated.
  • Use the Client Viewer role to give clients access to dashboards without tool access.
  • Enable white-label branding to remove SeoLens branding from all client-facing reports.
  • Schedule automated monthly reports to save time and keep clients informed.
  • Use the Workboard to assign tasks across your team and track delivery across client projects.

4Data & Privacy

  • All Google OAuth tokens are encrypted at rest with AES-256.
  • Data is stored in isolated database tables per workspace — no cross-workspace data leaks.
  • You can export all your data at any time from the workspace settings.
  • Revoke Google access anytime from your Google Account permissions page.

Keyboard Shortcuts

Quick keyboard shortcuts to navigate the platform faster.

Open quick search / command paletteCtrl + K
Toggle sidebar navigationCtrl + /
Send AI chat messageCtrl + Enter
Close dialogs and modalsEsc

Ready to get started?

Create your free account and connect your Google data in minutes. No credit card required.