Getting Started

From install to first insights
in under 10 minutes

This guide walks you through every step to get Vexifa SEO set up and running your first crawl and audit.

🕐 ~25 minutes 📋 19 steps 🖥️ Windows

Setup

🤖
Step 1 — Settings

Set up your AI provider

Vexifa uses AI to generate meta tags, score content quality, and prioritise audit issues. You have two options — use one or both.

Option A — Ollama (free & offline)

Ollama runs AI models entirely on your machine. No API costs, no internet required after setup.

  1. Download Ollama from ollama.com/download
  2. Run ollama serve in a terminal to start the server
  3. Pull a model: ollama pull llama3
  4. In Vexifa → AI Assistant → select Ollama (Local) → click Save Settings

Option B — OpenRouter (cloud models)

OpenRouter gives access to 200+ AI models including GPT-4o and Claude on a single API key.

  1. Sign up at openrouter.ai and create an API key
  2. In Vexifa → AI Assistant → select OpenRouter
  3. Paste your key, choose a model (e.g. google/gemini-flash-1.5), click Save Settings
💡

AI is optional — every other Vexifa feature works without it. But setting it up first means you get AI-powered insights as soon as you run your first audit.

🔑
Step 2 — Settings

API integrations (optional)

API keys unlock richer data on top of what the crawler already collects. None are required to start — add them as you need them. All keys are encrypted and stored locally.

Recommended: Keywords Everywhere

Adds real search volume, CPC, and competition data to every keyword. Get a key at keywordseverywhere.com — typically $10 for 100,000 lookups.

Rank Tracking: SerpApi or Zenserp

SerpApi — accurate paid SERP data (serpapi.com). Zenserp — 50 free searches/month (zenserp.com). Either gives you real live Google positions.

Backlink Authority: Ahrefs or Moz

For Domain Rating (DR) and Domain Authority (DA) scores. Ahrefs requires a paid subscription. Moz has a free tier.

Keyword Volume: DataForSEO

An alternative to Keywords Everywhere that also provides keyword difficulty scores. Credentials are in login:password format.

Core Web Vitals: PageSpeed Insights

Uses Google's free PageSpeed Insights API. An optional key increases the daily quota from 25 to 25,000 requests.

→ Click Settings in the sidebar to add any of these keys. Paste in the value and click Save next to the relevant row.

Your First Project

📁
Step 3 — Projects

Create a project

A project represents one website. Everything in Vexifa — pages, keywords, issues, rankings — belongs to a project. You can have unlimited projects.

  1. Click + New Project in the header bar
  2. Enter a project name and your site's URL
  3. Choose a project type:
    Live Website — crawl a public URL
    Local Folder — audit a site on your hard drive before it goes live
  4. Click Create Project
📁
Working on a site before launch?

Choose Local Folder as the project type and point Vexifa at a folder on your computer. You can audit and fix the site completely offline — no public URL needed — then switch to the live domain once it publishes.

🕷️
Step 4 — Site Crawler

Crawl your website

The Site Crawler discovers every page on your site — titles, meta descriptions, headings, word counts, status codes, response times, and more.

  1. Click Site Crawler in the sidebar
  2. Confirm your URL or folder path is correct
  3. Set a page limit if needed (leave blank for unlimited)
  4. Click Start Crawl

Crawling runs in the background with real-time progress. Pages appear as they are discovered. When it finishes, all other tools — Audit, Keywords, PageRank — have the data they need.

💡

Run a crawl first. Most Vexifa features depend on crawled data — the audit, link graph, link whisperer, and content optimizer all use what the crawler finds.

🔍
Step 5 — Site Audit

Run your first audit

After crawling, go to Site Audit and click Run Full Audit. Vexifa checks every page for:

  • Missing or duplicate titles and meta descriptions
  • Broken links and redirect chains
  • Missing H1 tags and thin content
  • Images without alt text
  • Slow pages and Core Web Vitals issues
  • Missing schema markup
  • Orphan pages with no internal links

Issues are ranked by severity: Critical → High → Medium → Low. Fix Critical issues first — they have the most impact on rankings.

→ The AI Issue Prioritiser (if AI is set up) re-ranks issues by estimated business impact, not just technical severity. Well worth running after your first audit.
🤖
Step 6 — Automation

Auto-Pilot & scheduled crawls

Auto-Pilot — one-click full pipeline

Auto-Pilot runs your entire SEO workflow in a single click: crawl → audit → AI content scoring → AI meta generation → WordPress CSV export. Each step feeds the next automatically.

  1. Click Auto-Pilot in the sidebar (under Technical)
  2. Click 🚀 Run Auto-Pilot
  3. Watch live progress for each pipeline stage
  4. When complete, click ⬇ Download Report to export a full CSV of results
💡

When using Ollama (local AI), each page can take 30–300 seconds depending on your hardware. Auto-Pilot caps AI scoring at 100 pages by default. If you have a GPU or want to remove the cap, switch to OpenRouter in Settings — cloud models are 10–50× faster with no page cap.

Scheduled crawls (unattended)

Schedule Vexifa to crawl automatically on a recurring basis — even when the app is closed.

  1. Go to Settings → Scheduled Crawls
  2. Click Add Schedule
  3. Choose a cron frequency (e.g. daily at 2 am) using the visual builder
  4. Click Save

Vexifa registers the job with Windows Task Scheduler. It runs in the background without you needing to open the app. Completed crawls appear in the Crawl History section below your schedules.

📥
Step 7 — Import

Migrate data from other tools

Already using Screaming Frog, Ahrefs, Semrush, or Moz? Import your existing exports directly into Vexifa instead of re-crawling from scratch.

  1. Click Import Data in the sidebar
  2. Upload a CSV or Sitemap XML
  3. Vexifa auto-detects the file format and maps columns
  4. Choose Merge (add to existing data) or Replace (overwrite)

All imports are fully transactional — if anything fails, the database rolls back with no partial data left behind.

Growing Your Data

🔑
Step 8 — Keywords

Research your keywords

Go to Keywords and enter seed keywords in the input box — broad terms related to your business, comma-separated.

  1. Click Research Keywords to generate keyword ideas
  2. Click Google Trends to add trend sparklines (free)
  3. Click Keywords Everywhere to add real search volumes (requires KE key)
  4. Click Enrich (DataForSEO) for volume + difficulty + CPC

The Topical Cluster tool groups your keyword list into semantic clusters and shows which topic areas your site covers — and which you're missing.

📈
Step 9 — Rankings

Track your rankings

Go to Rankings to see where your keywords rank in Google.

  • All your keywords are listed here with their current position
  • Click Track Rankings for a basic position check
  • Click Refresh from SERP API for real live positions (requires SerpApi or Zenserp key)

Position changes (↑↓) are tracked every time you refresh. Historical trend charts show you what's moving and why.

📍
Step 10 — Map Grid

Track local rankings on a geographic grid

The Map Grid shows where your Google Maps listing appears across a grid of geographic points around your business address — essential for businesses that depend on local search visibility.

  1. Click Map Grid in the sidebar (under Search Strategy)
  2. Enter a Keyword (e.g. "plumber near me"), your Business Name, and your Address
  3. Set a Radius and Grid Size — a 5×5 grid at 5 km is a good starting point for most local businesses
  4. Click 📍 Run Grid Scan

Each grid cell shows your rank at that geographic point. Green cells (rank 1–3) mean you're highly visible there; red cells mean competitors are outranking you. Use this to identify exactly where your local presence needs work.

🔑

Map Grid requires a SerpApi key (Settings → API Keys). A free SerpApi plan includes 100 searches/month — enough for around four 5×5 scans.

🎯
Step 11 — Competitors

Benchmark against competitors

The Competitors tool crawls rival domains and generates a side-by-side comparison against your own project — so you can see exactly where they are ahead and where you have an edge.

  1. Click Competitors in the sidebar (under Search Strategy)
  2. Enter a competitor domain and click + Add Competitor
  3. Click Crawl next to the competitor — Vexifa fetches up to 50 of their pages
  4. Click Compare to see a side-by-side breakdown: page count, average word count, title length, H1 coverage, and missing meta descriptions versus your site
💡

Pair this with the Keyword Gap tool (Agency & AI section) to find keywords your competitors rank for that you don't — those are your highest-priority content targets.

🔗
Step 12 — Backlinks

Discover your backlinks

Go to Backlinks and click Analyse Backlinks. Vexifa discovers links pointing to your site and shows:

  • Source URL and anchor text
  • Domain Rating if Ahrefs key is set
  • dofollow vs nofollow status
  • Date first seen

Filter by domain rating or follow status to focus on your most valuable links.

🤖
Step 13 — AI Assistant

Use AI to improve your SEO

The AI Assistant has three tools:

  • Title & Meta Generator — generates optimised title tags and meta descriptions for pages missing them. Click Apply to write them directly to the page record.
  • Content Quality Scorer — scores each page 0–100 with improvement tips.
  • Issue Prioritiser — re-ranks your audit issues by estimated business impact.
→ Click AI Assistant in the sidebar. Make sure your AI provider is configured first (Step 1).

Advanced Features

✨
Step 14 — AI Visibility

Check if AI search engines cite your site

AI search engines like Perplexity are increasingly where people find answers. AI Visibility checks whether your site appears in AI-generated answers for your tracked keywords.

  • Perplexity AI — requires a Perplexity API key (set in Settings → API Integrations)
  • OpenRouter models — uses your existing OpenRouter key

Results show which keywords cite your site and which do not — so you can create content that AI engines reference.

âš¡
Step 15 — PageRank

Visualise your internal link graph

Go to Link Graph and click Compute PageRank. Vexifa runs the actual PageRank algorithm on your internal link structure and scores every page.

  • The interactive D3.js graph shows how link equity flows through your site
  • Orphan pages (no inbound links) appear isolated — add links to bring them into the flow
  • Sink pages (no outbound links) are flagged — they trap equity instead of passing it on
🤝
Step 16 — Link Weaver

Fix internal linking automatically

Orphan pages — pages with no internal links pointing to them — are invisible to Google and hard for visitors to find.

Link Weaver scans your crawled content and suggests exactly where to add internal links for each orphan page. It shows:

  • Which page to link from (the donor)
  • Which orphan page to link to
  • A suggested anchor text and the reason for the match
→ Click Link Weaver in the sidebar after a crawl. Run it after any significant content addition to catch new orphans.
📝
Step 17 — Content Optimizer

Create content that ranks

Go to Content Optimizer, enter a target keyword, and Vexifa pulls the top 10 competitors from the SERP and generates a content brief:

  • Recommended word count
  • Semantic keywords to include
  • Heading structure suggestions
  • Readability score

The Freshness Scanner flags pages that have gone stale and need updating — crucial for maintaining existing rankings.

🏷️
Step 18 — White Label

Send branded reports to clients

Go to White Label and set up your agency branding:

  • Agency name — appears in the report header and footer
  • Logo — paste a URL or upload a file from your computer
  • Letterhead — optional full-width 8.5×11 header image
  • Accent colour — or choose No Accent Colour for a neutral look

Click Download HTML for a shareable web file, or Download as PDF to open your browser's print dialog for a pixel-perfect PDF.

💾
Step 19 — Backup

Protect your data

All Vexifa data is stored locally on your computer — which means it's important to back it up regularly.

Go to Backup in the sidebar to:

  • Run a manual backup — creates a compressed ZIP of the full database instantly
  • Schedule automatic backups — Vexifa registers a Windows Task Scheduler job that runs even when the app is closed
  • Restore — select any previous backup to roll back to it

Each backup covers all projects, crawl data, settings, and history in one file.

⚠️

Set up a backup schedule before you do any significant work. Months of crawl data on a single hard drive with no backup is a risk not worth taking.

🎉

You're ready to go

That covers everything you need to get the most out of Vexifa SEO.
A few things to remember as you get started:

  • Run a crawl first — most features depend on it
  • Fix Critical audit issues before anything else
  • Set up a backup schedule so you never lose data
  • The community forum is a great place to ask questions