# Digispot AI Docs
Documentation for Digispot AI — SEO Insights (free Chrome extension), SEO Spider (desktop app), and the Cloud Platform for teams.
---
# Introduction
URL: https://docs.digispot.ai/docs/
Digispot AI comes as three products — SEO Insights (free Chrome extension), SEO Spider (desktop app), and the Cloud Platform for teams.
Digispot AI is three distinct products sharing one account. Start free in your
browser, move to the desktop app when you need whole-site crawls, and move to
the cloud when a team needs to work on audits together.
## Which product is right for you? [#which-product-is-right-for-you]
| | SEO Insights | SEO Spider | Cloud Platform |
| -------------------- | ---------------------------------------------- | --------------------------------------- | -------------------------------- |
| **Type** | Chrome extension | Desktop app | Cloud |
| **Best for** | Page-level audits and quick competitive checks | Whole-site crawling on your own machine | Teams auditing at scale together |
| **Audience** | Anyone | Freelancers & consultants | SEO teams & agencies |
| **Scope** | One page at a time | Whole site — up to unlimited pages | Shared projects across a team |
| **Checks** | 150+ per page | 300+ per page | 300+ per page |
| **Runs on** | Chrome & Chromium | Mac & Windows | Any browser, no install |
| **Where audits run** | Your browser | Your machine — data stays local | Digispot's servers |
| **Price** | Free forever | Free to start, paid plans from Scout | Free plan, paid from Starter |
Both **SEO Spider** and the **Cloud Platform** support the MCP server and work
with AI agents.
Not sure where to start? The [Chrome extension](/docs/chrome-extension/) is free
and takes under a minute to install — no signup needed.
## Three products, one account [#three-products-one-account]
The same Digispot account activates all three surfaces. Connect it to the
Chrome extension to unlock managed AI and premium lookups, activate the desktop
Spider with a plan or a free trial, and sign in to the Cloud Platform from any
browser.
## Start here [#start-here]
---
# Connecting an AI Model
URL: https://docs.digispot.ai/docs/chrome-extension/ai-setup/
Bring your own API key (BYOK) to enable AI recommendations, prompt automation, and AI Chat in the extension.
The extension uses **BYOK**, short for Bring Your Own Key. You connect your own
AI provider API key. There are no extension-imposed usage limits, and you pay
only for what you use, typically around **$0.01–0.05 per page**.
Every audit check works without AI. Connecting a key adds recommendations,
one-click fixes, prompt automation, and AI Chat.
Keys are stored in your browser's encrypted storage. They never leave your
device and never touch Digispot's servers. Calls go directly from your
browser to the provider.
## Supported providers [#supported-providers]
Connect any one of four providers with your own key: **OpenAI**, **Anthropic**,
**Google (Gemini)**, and **DeepSeek**. One provider is enough.
Each offers a range of models. There is a flagship tier for the deepest
analysis, a balanced tier, and a fast, economical tier for high-volume auditing.
Since you pay the provider directly, the model you pick sets your cost and speed.
Providers add and retire model versions over time. For that reason, the
extension's model dropdown, not a fixed list, is the source of truth for
exactly which models you can select today.
Create a key in your provider's console: OpenAI, Anthropic, Google AI Studio,
or DeepSeek. Any one provider is enough.
Open the extension's settings, choose your provider, and paste the key.
Select any model from your provider's dropdown. Since you pay your provider
directly, cost and speed depend on which model you choose. The **Output
Capacity** slider sets how long each response runs, with four levels: Brief,
Balanced, Detailed, and Comprehensive. Use it to trade depth against token
cost.
## AI Chat [#ai-chat]
Once a key is connected, AI Chat opens alongside your audit results with full
context of the page's SEO data. That covers all 150+ results, including
metadata, headings, content, schema, links, and Core Web Vitals.
Because it sees the actual audit output, answers are page-specific rather than
generic:
* "What are the top issues hurting my rankings?"
* "Rewrite my meta description for higher CTR"
* "Suggest internal linking opportunities"
* "How do I fix this schema error?"
In SERP Intelligence mode, AI Chat answers questions about the search landscape
and competitors instead.
## Prompt automation [#prompt-automation]
All 150+ audit results feed automatically into prompt templates you define. This
lets you run repeatable analyses on any page with one click, without writing
code or wiring up an external automation tool.
### Template placeholders [#template-placeholders]
Templates use placeholders that are replaced with the current page's data:
| Placeholder | Inserts |
| --------------- | --------------------- |
| `{{content}}` | Page content |
| `{{keywords}}` | Detected keywords |
| `{{headings}}` | H1–H6 structure |
| `{{metadata}}` | Title and description |
| `{{schema}}` | Structured data |
| `{{images}}` | Image analysis |
| `{{links}}` | Link data |
| `{{pagespeed}}` | Core Web Vitals |
Each audit type has its own applicable placeholders. Write a template once, then
reuse it across pages.
Good first templates: generate meta descriptions from page content, check
search-intent match, or draft the missing schema for a page.
## PageSpeed API key (optional) [#pagespeed-api-key-optional]
Core Web Vitals come from Google PageSpeed Insights. The extension works without
a key. Adding a free one from the Google Cloud Console removes rate limits and
gives faster, more detailed analysis.
Like AI keys, it is stored encrypted locally and used only for direct calls to
Google.
API keys are credentials tied to your billing. Treat them accordingly: do not
paste them into shared machines, and rotate any key you suspect is exposed.
---
# Managed AI (Extension Key)
URL: https://docs.digispot.ai/docs/chrome-extension/extension-key/
Connect a free Digispot account with an Extension Key to run AI through Digispot instead of your own key, and unlock server-side field data, PageSpeed, and domain age.
The extension's AI features can run through your own provider or through Digispot.
[Bring your own key (BYOK)](/docs/chrome-extension/ai-setup/) connects a provider
you already pay for. The free **Digispot Extension Key** is the other option. It
runs AI through your Digispot account. It also unlocks a few server-side data
lookups the browser cannot fetch on its own.
Both are optional. Every audit check works without either.
## BYOK vs Extension Key [#byok-vs-extension-key]
| | BYOK | Extension Key |
| ------------------- | ---------------------------------------- | ------------------------------------------------ |
| **You provide** | Your own provider API key | A free Digispot account |
| **Where AI runs** | Direct from your browser to the provider | Through your Digispot account |
| **AI billing** | You pay your provider directly | Managed by Digispot |
| **Premium lookups** | — | CrUX field data, PageSpeed lab tests, domain age |
When an Extension Key is connected, **Digispot AI (managed)** becomes your
active provider and your own BYOK providers are turned off. Disconnect the
Extension Key to switch back to your own key.
## Connect an Extension Key [#connect-an-extension-key]
Sign in at [app.digispot.ai](https://app.digispot.ai), go to **Settings →
Chrome extension**, and select **Generate Key**. Copy the value. It starts
with `ext_`.
Open the extension's **Config → Account** panel, paste the key into the
**Extension Key** field, and select **Connect**. The extension validates it and
switches AI to the managed provider.
## Premium lookups [#premium-lookups]
Some signals need a server call that a browser extension cannot make directly.
With an Extension Key connected, the extension can fetch them through Digispot,
on demand. They are fetched only when you ask for them. Domain age, for
example, shows a **Check domain age** button rather than fetching automatically.
The two performance lookups live under **Speed → Performance Analysis**. They
sit alongside a **Live** tab that the extension can always measure locally. That
way you can compare a browser-measured page load against real field data and a
fresh lab run in one place.
### Live measurement (no key needed) [#live-measurement-no-key-needed]
The **Live** tab measures Core Web Vitals from your own browser on the current
page load, so it works without an Extension Key. It is the local baseline that
the premium tabs are compared against.
### CrUX field data [#crux-field-data]
**CrUX field data** is aggregated real-user Core Web Vitals from Google's Chrome
User Experience Report over the last 28 days. It is a server lookup the browser
cannot make on its own. Results are cached for 24 hours.
### PageSpeed lab test [#pagespeed-lab-test]
The **Lab Test** tab triggers a fresh Lighthouse run on Google's servers for
desktop and mobile. This is a synthetic, controlled page load. It is useful for
diagnosing what each render pass costs when field data is unavailable.
### Domain age [#domain-age]
**Domain age** is an E-E-A-T trust signal for the site. It runs only on your
click, via a **Check domain age** button, rather than fetching automatically.
Core audits are fully local. Managed AI and premium lookups are different: they
make requests through Digispot's servers. That is the trade-off for not
managing your own API keys or vendor access. See
[Privacy](/docs/chrome-extension/privacy/).
---
# FAQ
URL: https://docs.digispot.ai/docs/chrome-extension/faq/
Common questions about Digispot AI SEO Insights — pricing, privacy, browser support, AI keys, and how it differs from SEO Spider.
Common questions about SEO Insights: pricing, privacy, browser support, AI keys,
and how the extension relates to the desktop SEO Spider. For setup, see
[Install the extension](/docs/chrome-extension/install/).
## Is it really free forever? [#is-it-really-free-forever]
Yes. The core extension is free, with no trial period and no signup. That
includes 150+ SEO checks, schema validation, Core Web Vitals monitoring, and
export.
Optional premium features and platform integrations may be added in future, but
the base extension will remain free.
## Do I need an account or credit card? [#do-i-need-an-account-or-credit-card]
No. Install from the Chrome Web Store and start immediately. No registration, no
email, no credit card.
## Which browsers are supported? [#which-browsers-are-supported]
Google Chrome and all Chromium-based browsers: Microsoft Edge, Brave, Opera,
and Vivaldi. All install from the same Chrome Web Store listing.
## Does it work on any website? [#does-it-work-on-any-website]
Yes, on any public website — your own, competitors', clients', or prospects'.
Browser-internal pages such as `chrome://` cannot be audited.
## How does it work? [#how-does-it-work]
Select the extension icon on any page. It runs 150+ checks in under 60 seconds
and groups results by category with pass/fail indicators and recommendations.
The extension renders pages in a real browser engine, like Googlebot. As a
result, it detects JavaScript-rendered content and schema.
## What makes it different from other SEO extensions? [#what-makes-it-different-from-other-seo-extensions]
Most free SEO extensions offer basic checklists. This one adds schema graph
visualization, AI-powered content analysis, industry-specific recommendations
across 38+ sectors, live heading editing, Core Web Vitals integration, video SEO
audits, and export.
## Do I need an AI API key? [#do-i-need-an-ai-api-key]
No. Every audit check works without one. A key adds AI recommendations,
one-click fixes, prompt automation, and AI Chat. See
[Connecting an AI model](/docs/chrome-extension/ai-setup/).
## Are my API keys safe? [#are-my-api-keys-safe]
Yes. All API keys, from AI providers and Google PageSpeed alike, are stored in
your browser's encrypted storage. They never leave your device and never reach
Digispot's servers. They are used only for direct calls from your browser to the
respective service.
## How is my data encrypted? [#how-is-my-data-encrypted]
API keys and settings are encrypted using browser-native standards and stored in
Chrome's secure storage APIs. All connections use HTTPS/TLS.
The extension follows Chrome Web Store security best practices, undergoes
regular security reviews, and has no external dependencies that could leak data.
Your information stays on your device, encrypted at rest and in transit.
## Do you collect my data? [#do-you-collect-my-data]
No. Digispot does not collect, store, or transmit usage data, API keys, audit
results, or browsing activity. The extension operates entirely locally. Analysis
happens on your device or goes directly to services you choose, such as OpenAI
or Google.
Digispot does not track which pages you audit or how you use the extension.
## Do I need a PageSpeed API key? [#do-i-need-a-pagespeed-api-key]
It is optional. Core Web Vitals work without one. Adding a free key from the
Google Cloud Console removes rate limits and gives faster, more detailed
analysis.
## Can I export reports? [#can-i-export-reports]
Yes, in TXT format, as a human-readable summary. You can also screenshot
Visualize Mode to document issues visually on the page.
## Can I edit headings in the extension? [#can-i-edit-headings-in-the-extension]
Yes, with no CMS needed. The live heading editor shows your H1–H6 structure,
offers AI rewrite suggestions, and lets you edit directly with a real-time
preview.
## What is AEO? [#what-is-aeo]
Answer Engine Optimization. It means optimizing for AI platforms such as
ChatGPT, Perplexity, Claude, and Gemini. The extension checks structured content
formatting, question-answer patterns, entity recognition, topical authority
signals, and scannability.
## How is the extension different from SEO Spider? [#how-is-the-extension-different-from-seo-spider]
The extension is a free SEO assistant for **page-level** audits. Use it for
quick checks, learning, and competitive analysis. It runs 150+ checks on
whatever page you are viewing.
**Digispot AI SEO Spider** is for operating at scale. It runs **300+ checks per
page** across an entire site, crawled in **mobile, tablet, and desktop** modes.
Findings are weighted by Google Search Console and GA4, so you fix what is
actually costing traffic. It also adds content gap discovery, internal linking,
backlink monitoring, and scheduled crawls.
Optimizing a few pages? The extension is enough. Competing for organic revenue
at scale? You want Spider.
## When do I need SEO Spider? [#when-do-i-need-seo-spider]
Consider it if you are auditing 50+ pages weekly, manually comparing mobile
versus desktop, regularly exporting reports for multiple clients, or need
systematic content gap discovery.
Solo? [SEO Spider](/docs/desktop/) runs unlimited crawls on your own machine.
On a team? The [Cloud Platform](/docs/cloud/) adds shared projects, GSC and
GA4, and audits that run on Digispot's servers.
---
# Chrome Extension
URL: https://docs.digispot.ai/docs/chrome-extension/
How to install and use Digispot AI — SEO Insights, the Chrome extension for on-page audits and SERP analysis.
**SEO Insights** has two modes. The **on-page auditor** checks the page you're
currently viewing. **SERP Intelligence** reads a Google results page instead. It
breaks the results down by organic listings, AI Overview citations, competitors,
and rich results. Both modes can use an optional AI model. The model adds
recommendations, one-click fixes, and a chat panel.
This section covers installation, each mode, and the full list of checks. To
start straight away, install it from the
[Chrome Web Store](https://chromewebstore.google.com/detail/digispot-ai-seo-insights/njjbmbinhpipcdocojjniahjgdoljohg)
or read about
[Digispot AI — SEO Insights, the free Chrome extension](https://digispot.ai/tools/google-chrome-extension-seo-insights).
It is free, with no account and no card.
Works in Google Chrome and all Chromium-based browsers: Microsoft Edge,
Brave, Opera, and Vivaldi.
## Two modes [#two-modes]
The extension operates in two distinct modes. Each has its own AI chat.
Audits the page you are currently viewing.
* 150+ browser engine checks across 11 audit categories
* Real browser rendering, like Googlebot, so JavaScript-rendered content
and schema are detected
* Content and keyword analysis with AI
* AI recommendations and 1-click fixes
* AI Chat: ask anything about the page's on-page SEO
Decodes a Google search results page.
* AI Overview citation analysis
* Competitor ranking signals
* Local pack and map results
* Featured snippets and rich results
* Breaks down organic results, ads, AI-cited sources, forums, shopping, and
video results
* AI Chat: ask about the SERP landscape and competitors
See [SERP Intelligence](/docs/chrome-extension/serp-intelligence/).
## Three viewing modes [#three-viewing-modes]
Switch based on what you are doing. Most people start in Popup for a quick
check. They switch to Visualize to demonstrate issues to someone. They use
Fullscreen for detailed analysis.
| Mode | What it does | Best for |
| -------------- | ------------------------------------------------------ | ------------------------------------------------- |
| **Popup** | Quick audit in a small window without leaving the page | Fast spot checks |
| **Visualize** | Overlays issues directly on the webpage | Showing clients or developers exactly what to fix |
| **Fullscreen** | Deep analysis with side-by-side page comparison | Detailed audits and full reports |
Light and dark themes are both supported.
## What it audits [#what-it-audits]
150+ checks across 11 categories. Each has its own panel in the results.
| Category | Covers |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Content Intelligence** | Search intent detection, industry recommendations (38+ sectors), keyword stuffing, readability, competitor comparison |
| **Metadata Audit** | Title length and keyword placement, meta description, canonical, robots directives, SERP preview |
| **Heading Structure** | H1–H6 hierarchy, AI rewrite suggestions, live editing, keyword distribution, missing levels |
| **Schema Markup** | Interactive schema graph, Google requirements validation, competitor schema, missing schema, developer export |
| **Keyword Intelligence** | Density analysis (1/2/3-word), related keywords and entities, significance scoring, authority correlation |
| **Image SEO** | Alt text, WebP/AVIF recommendations, lazy loading, file size, LCP impact |
| **Video SEO** | Platform detection (YouTube, Vimeo, Wistia), VideoObject schema, thumbnails, transcripts, rich result eligibility |
| **Link Architecture** | Internal link depth, anchor text, broken links, redirect chains, link equity flow |
| **Social Optimization** | Open Graph, Twitter Cards, live social preview, image dimensions |
| **Local SEO** | NAP consistency, LocalBusiness schema, Google Maps, Place ID, location keywords |
| **Core Web Vitals & Speed** | LCP, INP, CLS, mobile vs desktop, large images, render-blocking resources |
Need this across your whole site? The extension audits one page at a time, in
your browser's viewport. **Digispot AI SEO Spider** runs **300+ checks per
page** across an entire site, in **mobile, tablet, and desktop** modes, with
Google Search Console and GA4 data weighting what to fix first.
## Explore the docs [#explore-the-docs]
## Privacy [#privacy]
The extension runs entirely locally in your browser. Digispot does not collect,
store, or transmit your usage data, API keys, audit results, or browsing
activity. Analysis happens on your device, or goes directly to services you
choose, such as OpenAI or Google.
---
# Install the Extension
URL: https://docs.digispot.ai/docs/chrome-extension/install/
Install Digispot AI — SEO Insights from the Chrome Web Store and run your first on-page audit or SERP analysis in under a minute — no account, no card.
**SEO Insights** is Digispot's free browser extension. It audits the page you
are on with 150+ checks and analyzes Google results pages. Everything runs
in-browser using Chrome's own rendering engine. There is **nothing to install
beyond the extension**, no account to create, and nothing to pay for.
The extension has two modes that switch automatically: the **On-Page SEO
Auditor** on any normal page, and **SERP Intelligence** on a Google results
page. Core auditing needs no signup. AI features and server-side lookups are
optional add-ons covered in the last two steps.
## Before you begin [#before-you-begin]
| What | Do you need it? |
| -------------------------------------------- | --------------------------------------------------------------------------- |
| **This extension** | A Chromium browser is all you need to start |
| **[SEO Spider desktop app](/docs/desktop/)** | Optional. Escalate a single page to a whole-site crawl. **Free Scout tier** |
| **[Cloud Platform](/docs/cloud/)** | Optional. Run audits on Digispot's servers and share them with a team |
All three share one Digispot account if you later connect one, but the extension
works fully on its own.
***
## Step 1 — Install and run your first audit [#step-1--install-and-run-your-first-audit]
Open the [Digispot AI — SEO Insights listing](https://chromewebstore.google.com/detail/digispot-ai-seo-insights/njjbmbinhpipcdocojjniahjgdoljohg)
directly, or search **digispot ai chrome extension**. The Chrome Web Store
listing ranks at the top.
[Digispot AI — SEO Insights, the free Chrome extension](https://digispot.ai/tools/google-chrome-extension-seo-insights)
covers features and screenshots before you install.
On the listing, select **Add to Chrome**, then confirm. Chromium-based browsers
install from the same listing: Edge, Brave, Opera, and Vivaldi.
Select the extensions icon in the toolbar, then pin Digispot so the icon stays
visible. You will be clicking it often.
Navigate to any page and select the Digispot icon. The extension runs 150+
checks across 11 categories in under 60 seconds, then groups the results with
pass/fail indicators. It renders the page the way Googlebot does, so it catches
JavaScript-injected content that source-only tools miss.
## Step 2 — Learn the viewing modes [#step-2--learn-the-viewing-modes]
The same audit data renders three ways. Most people start in **Popup** for a
quick check. They switch to **Visualize** to show an issue in context on the
page. They use **Fullscreen** for a deep audit with charts and AI side by side.
See [Viewing modes & overlays](/docs/chrome-extension/viewing-modes/) for the
on-page badge system that marks headings, images, and links directly on the page.
## Step 3 — Analyze a Google results page (SERP Intelligence) [#step-3--analyze-a-google-results-page-serp-intelligence]
On any of the 17 supported Google country domains, the extension switches
automatically to **SERP Intelligence**. It reads the results page and breaks it
down by result type: organic, ads, local pack, and AI Overview. This shows you
what already ranks for a query.
See [SERP Intelligence](/docs/chrome-extension/serp-intelligence/) for the full
breakdown of ranking signals and competitor analysis.
## Step 4 — Add AI (optional) [#step-4--add-ai-optional]
Connect an AI provider to unlock AI recommendations, one-click fixes, and AI
Chat with full page context. This is optional, since every audit check works
without it. You have two paths:
* **Bring your own key (BYOK):** paste an OpenAI, Anthropic, Google, or DeepSeek
key. Requests go directly from your browser to that provider, never through
Digispot.
* **Digispot Extension Key:** a free managed option that also unlocks
server-side CrUX, PageSpeed, and Domain Age lookups.
See [Connecting an AI model](/docs/chrome-extension/ai-setup/) for BYOK setup and
[Managed AI](/docs/chrome-extension/extension-key/) for the Extension Key.
## Requirements [#requirements]
| | |
| --------------------- | -------------------------------------------------------------------------- |
| **Browser** | Google Chrome, or any Chromium-based browser (Edge, Brave, Opera, Vivaldi) |
| **Account** | None for core auditing |
| **Payment** | None |
| **AI API key** | Optional. Only for AI features, or use a free Extension Key |
| **PageSpeed API key** | Optional. Removes rate limits on Core Web Vitals |
The extension works on any public website: your own, a competitor's, a
client's, or a prospect's. It is equally useful for auditing pages you do not
control.
## Verify it is working [#verify-it-is-working]
Open any content-heavy page and select the extension icon. You should see
results grouped into categories such as Metadata Audit, Heading Structure, and
Core Web Vitals.
If nothing appears, confirm the extension is enabled at `chrome://extensions`.
Also confirm you are on an `http://` or `https://` page. Browser-internal pages
like `chrome://` cannot be audited.
## When to reach for the other products [#when-to-reach-for-the-other-products]
The extension audits one page at a time. Sometimes a single-page finding turns
out to be site-wide, such as a broken template or a missing schema type across
every product page. In that case, escalate:
* **[SEO Spider desktop app](/docs/desktop/)** crawls the whole site on your own
machine, applying the same checks across every URL. The **Scout** tier is free:
100 pages per crawl, no card.
* **[Cloud Platform](/docs/cloud/)** runs those crawls on Digispot's servers and
shares the reports with a team.
---
# Privacy & Data
URL: https://docs.digispot.ai/docs/chrome-extension/privacy/
How the extension handles your data — audits run locally, no signup, no tracking, and API keys are stored encrypted on your device.
The extension runs entirely on your device. Core audits are local,
there is no account to create, and Digispot does not receive any data about what
you audit unless you explicitly opt into a feature that requires it.
## Audits run locally [#audits-run-locally]
When you audit a page, the extension reads the live page in your browser. It runs
all 150+ checks on your machine. Digispot does not collect, store, or transmit
your audit results, API keys, browsing activity, or which pages you audit. The
analysis never leaves the browser session.
## No account or signup required [#no-account-or-signup-required]
The core extension works with **no signup, no email, and no credit card**. Install
from the Chrome Web Store and audit any page immediately. Creating a Digispot
account is optional. It unlocks managed AI and premium server-side lookups, but
none of those fire unless you actively connect a key.
## How API keys are stored [#how-api-keys-are-stored]
If you connect an AI provider (BYOK) or a PageSpeed API key, those keys are
stored in Chrome's **encrypted browser storage**. This uses `chrome.storage.sync`
with AES-GCM encryption, falling back to `chrome.storage.local` on overflow. The
keys never reach Digispot's servers. When you make an AI request, it goes directly
from your browser to the provider you chose — OpenAI, Anthropic, Google, or
DeepSeek. It does not pass through any Digispot infrastructure.
API keys are credentials tied to your billing account. Do not paste them on
shared machines. If a key is exposed, rotate it immediately in your provider's
dashboard. The extension has no record of it to revoke.
## Permissions the extension uses [#permissions-the-extension-uses]
| Permission | Why it's needed |
| -------------- | ------------------------------------------------------------------------------ |
| `activeTab` | Read the current page's DOM to run checks — only fires when you click the icon |
| `scripting` | Inject overlay badges and apply live heading edits |
| `storage` | Save your settings, API keys, and cached results locally |
| `contextMenus` | Add the right-click "Open in Fullscreen" entry |
An **optional** broad host permission (`https://*/*`) is requested lazily. It only
fires when a feature that needs full-page access runs for the first time on a given
site: Fullscreen mode, Live CWV, or heading Apply. It is never requested in
Popup mode. You can deny it without losing any other functionality.
## When data does leave your device [#when-data-does-leave-your-device]
Everything is opt-in. Three scenarios involve requests leaving the browser:
| Scenario | Where the request goes | Opt-in required |
| ------------------------------------------ | --------------------------------------------------------------------- | ------------------------------------------------------------ |
| **BYOK AI audit or chat** | Directly to your AI provider (OpenAI / Anthropic / Google / DeepSeek) | Connect an API key in Config → AI Provider |
| **Managed AI via Extension Key** | Through your Digispot account | Connect an `ext_…` key in Config → Account |
| **CrUX, PageSpeed, or Domain Age lookups** | Through your Digispot account | Extension Key required; lookups are on-demand, not automatic |
All on-page SEO checks run entirely on your device, with none of the above. This
covers every panel in the extension.
---
# SERP Intelligence
URL: https://docs.digispot.ai/docs/chrome-extension/serp-intelligence/
Decode any Google search results page — who ranks, which sources AI Overviews cite, and what content gaps you can exploit.
Open a Google search results page and the extension switches automatically. It
moves from auditing a single page to decoding the **entire result set**: every
organic result, ad, local listing, and AI Overview citation on the page.
## Automatic activation [#automatic-activation]
SERP mode turns on by itself the moment you land on a Google search results
page. There is nothing to toggle. It works across **17 Google country domains**:
| | | | |
| ------------ | ------------- | ------------ | ------------- |
| google.com | google.co.uk | google.ca | google.com.au |
| google.co.in | google.de | google.fr | google.es |
| google.it | google.com.br | google.co.jp | google.co.kr |
| google.nl | google.pl | google.ru | google.se |
| google.ch | | | |
On any other page, including non-Google search engines, the extension stays in
on-page audit mode. See [On-Page Panels](/docs/chrome-extension/audit-categories/).
## What it extracts [#what-it-extracts]
SERP mode parses the whole page in a single pass, deduplicates results, and
classifies each one:
* **Organic results**: who ranks, with rich snippets, sitelinks, and breadcrumbs
* **AI Overview citations**: which sources Google's AI Overview references
* **Ads**: text and shopping ads
* **Local pack**: map listings, ratings, hours, and phone numbers
* **Featured snippets** and knowledge panels
* **People Also Ask**
* **Video carousels** and **top stories**
* **Discussions**: forums such as Reddit and Quora
* **Shopping** carousels
* **Related searches**
## Overlay badges [#overlay-badges]
SERP mode draws numbered badges directly onto the live search page so you can
see the result composition at a glance. Badges are color-coded and numbered by
type. Organic results, AI citations, local pack, ads, video, discussions, and
shopping each get their own sequence. They persist as you scroll and survive
Google's lazy-loading.
Use the overlay toggle to turn the on-page badges on or off at any time.
## Statistics [#statistics]
A statistics view summarizes the makeup of the result page in real time. It
counts organic results, AI Overview citations (with unique URLs and domains),
ads, local pack, video, shopping, and featured snippets. This lets you read the
competitive shape of a query immediately.
## Results table [#results-table]
Every result is also listed in a sortable, searchable table with position,
title, URL, type, and SERP features. Rows are numbered to match the on-page
badges, for example `V` for video, `D` for discussion, `S` for shopping, and
`AI` for AI-cited results. AI-cited results are flagged.
## Export to CSV [#export-to-csv]
Export the full result set to a **CSV** file. The file is UTF-8, Excel-compatible,
and named after the query and date (for example
`serp-best-running-shoes-2026-08-11.csv`). The export includes every classified
result and its type, with duplicates filtered.
## Asking the AI [#asking-the-ai]
With an [AI model connected](/docs/chrome-extension/ai-setup/), AI Chat analyzes
the whole SERP landscape rather than a single page. Useful questions:
* "What content gaps can I exploit?"
* "Why are these pages ranking and mine isn't?"
* "What schema markup are top results using?"
It surfaces opportunities the top-ranking pages miss and explains how to build
content that fills them. One search query becomes a competitive strategy.
## Optimizing for AI search (AEO / GEO) [#optimizing-for-ai-search-aeo--geo]
AI search engines increasingly decide what users see: ChatGPT, Perplexity,
Google Gemini, and Claude. The goal shifts from ranking in blue links to **being
the source those engines cite**.
AI Chat helps in both modes:
Evaluates your page's readiness to be cited:
* Entity clarity
* Question-and-answer formatting
* Topical authority signals
* Structured data completeness
Try: *"Is my content structured for AI citations?"* or *"How can I improve
my chances of being referenced by ChatGPT?"*
Analyses which pages AI Overviews actually reference, and why.
Try: *"Which results are AI-cited?"* or *"What content format do AI engines
prefer for this query?"*
Pair the two: run SERP mode to see which competitors get cited, then run
On-Page mode on your own page to find what it is missing by comparison.
---
# Viewing Modes & Overlays
URL: https://docs.digispot.ai/docs/chrome-extension/viewing-modes/
Popup, Visualize, and Fullscreen modes — plus visual on-page overlays that mark headings, images, videos, and links directly on the page.
The extension has three viewing modes. Most people start in **Popup** for a quick
check, switch to **Visualize** to show an issue in context on the page itself,
and use **Fullscreen** for a deep audit with side-by-side content.
## The three modes [#the-three-modes]
| Mode | How to open | Best for |
| -------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| **Popup** | Click the toolbar icon | Fast spot checks without leaving the page |
| **Visualize** | Click **Inspect** in the popup | Showing clients or developers exactly where issues are |
| **Fullscreen** | Click the external-link icon in the popup, or right-click → "Open SEO Insights in Full Screen" | Detailed audits with full category breakdown, charts, and AI |
Light and dark themes are supported in all three modes.
## Popup [#popup]
The popup opens in a compact window over the current page without navigating
away. It shows the score, the category panels, and quick filters. All 150+ checks
run here. The other modes just display the same data differently.
## Visualize (on-page overlays) [#visualize-on-page-overlays]
Visualize mode collapses the popup to a compact sidebar (\~80px). It then injects
badges directly onto the live page, so problems show up in context rather than
buried in a list. Four overlay types each have their own toggle:
* **Headings (H1–H6)**: level badges on every heading. A missing H1 or a
skipped level is visible at a glance, without reading source code
* **Images**: flags missing alt text and other image issues at the image itself
* **Videos**: markers on embedded and hosted video
* **Links**: indicators on internal and external links, including nofollow
Toggle each type independently. **Keyword highlighting** marks where your focus
keyword appears on the page with a green indicator. Collapse the sidebar further
to keep the page fully visible while you work.
On-page badges are the fastest way to show a developer or client exactly which
element has a problem: no spreadsheet, no scrolling through a list. Screenshot
the page with overlays on to create instant visual evidence for a brief.
## Fullscreen [#fullscreen]
Fullscreen opens in a dedicated browser tab and adds:
* The **Overview** tab: a full-site score rollup, SERP preview, quick wins, and
a **Full Audit** that runs one AI review across all panels at once
* Side-by-side **AI Chat** panel
* Expanded charts and visualizations
* Access to the complete **Config** (AI, prompts, cache, account)
Fullscreen can also be opened directly from the right-click context menu on any
page. There is no need to open the popup first.
## Visual on-page overlays [#visual-on-page-overlays]
When Visualize mode is on, a sidebar shows **OVERLAYS** controls: per-type
toggles (H1-H6, IMGS, VIDS, LINKS) and a **CLEAR/RESET** button. The overlays
persist as you scroll, and they survive page interactions.
---
# Workflows
URL: https://docs.digispot.ai/docs/chrome-extension/workflows/
Practical ways to use the extension — competitor analysis, pre-publish checks, client audits, and exporting reports.
The extension works on any public website, which makes it as useful for pages
you do not control as for your own.
## Competitor analysis [#competitor-analysis]
Navigate to a competitor's page and select the extension icon. You see their
full on-page strategy: schema markup, Core Web Vitals, content structure,
heading hierarchy, meta tags, and internal linking patterns.
Export each report to compare competitors side by side and work out why they
outrank you.
In SERP Intelligence mode, run the audit on the search results page first. This
shows who ranks and which results earn AI Overview citations. Then audit the
individual pages that win.
## Pre-publish checks [#pre-publish-checks]
Run the audit on staging before publishing. It catches missing meta tags, broken
schema, slow Core Web Vitals, intent mismatches, and heading structure problems
while they are still cheap to fix.
Fixing these before launch avoids the far slower cycle of publishing, watching
rankings suffer, diagnosing, and re-earning the position.
## Client and agency work [#client-and-agency-work]
* Run quick audits during discovery or a pitch
* Use **Visualize Mode** on a call to overlay issues directly on the client's
page. It is far more persuasive than a spreadsheet
* Export reports to share findings with clients, developers, or stakeholders
Managing several clients? Spider gives each one an isolated project with its
own crawls, history, and Google connections. Save a workflow once and run it
across every site you manage.
## Exporting [#exporting]
Reports export in **TXT format**. This gives you a human-readable summary suited
to sharing with clients, developers, or stakeholders.
You can also screenshot **Visualize Mode** to document issues visually, directly
on the page.
## Other workflow features [#other-workflow-features]
| Feature | What it does |
| ---------------------------- | -------------------------------------------- |
| **Multi-tab batch audits** | Audit several open tabs in one pass |
| **Right-click context menu** | Start an audit without opening the popup |
| **Local caching** | Repeat audits on the same page return faster |
| **Competitor intelligence** | Compare schema and structure against rivals |
## When to move up to SEO Spider [#when-to-move-up-to-seo-spider]
Most people are well served by the free extension for spot checks and occasional
audits. **Digispot AI SEO Spider** is worth considering if you find yourself:
* Auditing 50+ pages weekly
* Manually comparing mobile versus desktop
* Exporting reports for multiple clients regularly
* Needing systematic content gap discovery
| | Chrome Extension | SEO Spider |
| ------------------ | --------------------- | --------------------------------------- |
| **Scope** | One page at a time | Whole site — 10,000+ pages |
| **Checks** | 150+ per page | 300+ per page |
| **Device modes** | Your current viewport | Mobile, tablet, and desktop per crawl |
| **Prioritisation** | Severity only | Weighted by GSC and GA4 traffic at risk |
| **Automation** | Manual, per page | Scheduled crawls and workflows |
| **Price** | Free forever | Paid, with a free tier |
Working solo? [SEO Spider](/docs/desktop/) runs unlimited crawls locally on Mac
or Windows. Working as a team? The [Cloud Platform](/docs/cloud/) adds shared
projects and GSC and GA4 integration. Its audits run on Digispot's servers
rather than your laptop.
Everything on this page is a manual, page-by-page workflow. Spider turns each
of them into a repeatable crawl you can schedule, re-run, and compare over
time.
---
# Keys & connections
URL: https://docs.digispot.ai/docs/cloud/api-access/
Manage MCP server keys, Chrome-extension keys, and Spider desktop licenses and seats from your cloud account.
Your cloud account is where you connect the rest of the Digispot ecosystem: AI
agents, the browser extension, and the desktop Spider. These screens are
Admin-only.
## MCP server [#mcp-server]
Create and manage **MCP API keys** so AI assistants can query your cloud data:
projects and remaining credits, audit results and top issues, keyword and
backlink data, Google metrics, and content opportunities. Revoke a key at any
time.
This is the cloud MCP server. The desktop [Spider also runs a local MCP
server](/docs/desktop/mcp/) for querying on-machine crawl data.
## Chrome extension keys [#chrome-extension-keys]
Generate **Extension Keys** that tie the [Chrome extension](/docs/chrome-extension/)
to your organization. Page audits in the browser then draw on your account's
managed AI. Create and revoke keys as needed.
## Spider desktop license [#spider-desktop-license]
Manage your **SEO Spider** desktop licenses and **seats**:
* Activate the desktop app with a license key
* See how many seats are used against your plan's limit
* Revoke a seat to free it for another machine
* Start a **7-day trial** seat
See the [desktop plans](/docs/desktop/plans/) for what each tier unlocks.
---
# Plans & Billing
URL: https://docs.digispot.ai/docs/cloud/billing/
How Digispot Cloud billing works — plans, the two credit pools (AI and Data), usage tracking, and payments.
The Cloud Platform is subscription-based, with a free tier and paid plans. Usage
of AI and research features is metered through two separate credit pools.
## Two credit pools [#two-credit-pools]
Your account carries two independent pools of credits:
| Pool | Spent on |
| ---------------- | ------------------------------------------------------------------------ |
| **AI credits** | Ask Digispot, AI summaries, and Content Studio articles and infographics |
| **Data credits** | Keyword lookups and backlink analysis |
The pools are not interchangeable. Running out of one does not affect the other.
The server is authoritative and charges credits when an action is recorded.
## Plans [#plans]
The Cloud Platform has four plans. A **free** plan lets you get started. Paid
plans raise limits and unlock gated features (for example, Content Studio is not
available on free). Plans also set resource caps such as the number of projects,
team members, and audits, and how long data is retained.
| Plan | Monthly (USD) |
| ----------- | ------------- |
| **Free** | $0 |
| **Starter** | $19 |
| **Pro** | $49 |
| **Agency** | $199 |
Quarterly and yearly intervals are also available (yearly is discounted), and
prices are shown in **USD or INR** depending on your region.
This is the Cloud Platform's own tier ladder. It is separate from the desktop
[SEO Spider](/docs/desktop/plans/) plans (Scout / Tracker / Leader). The two
are not the same subscription.
## Usage & analytics [#usage--analytics]
A usage dashboard breaks down both credit pools and shows usage by source (web,
extension, and desktop). It also displays your fixed allocations for the current
billing period: projects, team members, and audits. A credits badge in the app
header shows your remaining balance at a glance.
## Payments [#payments]
Billing is handled through **Razorpay**, in **USD or INR**. You can choose a
monthly, quarterly, or yearly interval. You can also upgrade or downgrade,
schedule a plan change, or cancel at the end of the period. Billing history
lists both subscription charges and credit purchases.
---
# Content opportunities
URL: https://docs.digispot.ai/docs/cloud/content-opportunities/
Content opportunities finds the gaps in your topical coverage — pages worth writing, mapped to clusters and search intent.
Content opportunities points at what to write next. It surfaces the topics the site
doesn't cover yet, mapped to the clusters they extend and the search intent they
serve. It reads the analysis from an audit run, so the gaps reflect the site's real
structure rather than a generic keyword list. Each gap carries enough detail to hand
straight to Content Studio.
This screen is tied to an **audit run**. It needs a completed run to analyze. If
no run exists yet, the page prompts you to create one before it can surface gaps.
## Two views of the same data [#two-views-of-the-same-data]
A toggle switches between a **graph** and a **dashboard** view of the same
opportunity set.
* **Graph** — an interactive cluster map showing the site, its topic clusters, the
pages under each, and the gaps hanging off them. Coverage and holes are visible
spatially
* **Dashboard** — the same clusters and gaps as sortable, filterable lists
## What the dashboard breaks down [#what-the-dashboard-breaks-down]
The dashboard organizes opportunities across four tabs.
* **Cluster analysis** — how the site's topics group, and which clusters are thin
* **Content gaps** — the missing pages, each with a **priority** (high, medium,
low), a suggested title, target keywords, key points to cover, and the intended
audience; filterable by priority and by cluster
* **Search intent alignment** — coverage across the funnel stages **awareness,
consideration, decision, and retention**, backed by the query intents
(informational, navigational, commercial, transactional)
* **Pages** — how existing pages map into the cluster structure
When every gap has been addressed, the screen shows an "all gaps addressed" state.
Each gap has a **Write** action that opens
[Content Studio's Create screen](/docs/cloud/content-studio/create/) pre-filled
with the gap's title, keywords, audience, intent, and a length scaled to its
priority. It is the shortest path from spotting a gap to drafting the page that
fills it.
---
# Dashboard
URL: https://docs.digispot.ai/docs/cloud/dashboard/
The dashboard is the platform's home — a site-wide view of health, search performance, traffic, and the actions worth taking next.
The dashboard is the first screen after signing in. It is a site-wide view that
pulls the latest audit run together with connected Google data. The framing is
around what to do next rather than raw numbers. It scopes to the **active
project**. A run-status banner at the top tracks any audit in progress and
refreshes the widgets when it completes.
The dashboard needs at least one completed audit run to populate. A fresh project
shows onboarding states prompting a first crawl; the search and traffic widgets
additionally require Google Search Console and GA4 to be connected.
## Metrics and performance [#metrics-and-performance]
The upper widgets summarize where the site stands.
* **Top-level metrics** — site health, page score, and headline search performance
* **Business performance** and **CXO analytics** — higher-level roll-ups framed for
reporting rather than debugging
* **Traffic & engagement** — users and sessions by device, a traffic-source
breakdown, and Search Console **clicks, impressions, CTR, and position**
## Actions and warnings [#actions-and-warnings]
The action-oriented widgets turn findings into a worklist.
* **Top actions** — the issues worth fixing first, each tagged **Critical**,
**Quick win**, or **Easy fix** so effort and impact are visible at a glance
* **Warnings breakdown** — findings grouped by category and severity
* **Team performance** — activity across the workspace's members
* A **notification center** for run completions and alerts
## AI analysis [#ai-analysis]
A **Website health summary** runs across the dashboard. An AI analysis panel
breaks the site down by crawlability, content quality, brand presence, content
gaps, keyword data, backlinks, and international SEO. Each dimension gets a
plain-language read rather than a score alone.
Start each session at the **Top actions** strip. It's already ranked by
leverage, so the Critical and Quick-win items are the shortest path from the
dashboard to a measurable gain. Drill into a category only when an action needs
context.
---
# Getting Started
URL: https://docs.digispot.ai/docs/cloud/getting-started/
Sign up, create your organization, walk through the project wizard, and run your first cloud audit — plus where to install the free Chrome extension and SEO Spider.
The **Cloud Platform** is Digispot's team product. It provides shared projects,
audits that run on Digispot's servers, and Google Search Console and GA4
dashboards. It works in any browser. **Nothing to install** for the cloud
itself.
If you are brand new to Digispot, here is the full path from sign-up to your
first audit. The other Digispot products run on the same account, and both are
**free to start** (paid plans unlock more later).
***
## Before you begin [#before-you-begin]
| What | Do you need it? |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------- |
| **Cloud Platform** (this guide) | A browser and a Digispot account |
| **[SEO Insights extension](/docs/chrome-extension/)** | Optional — audit any single page free, no signup |
| **[SEO Spider desktop app](/docs/desktop/)** | Optional — crawl whole sites on your Mac or PC; **free Scout tier** (100 pages/crawl) |
All three share one Digispot account once you sign up.
***
## Step 1 — Create an account [#step-1--create-an-account]
Go to [app.digispot.ai](https://app.digispot.ai) and sign up with **email and
password**, or **Continue with Google**.
* Signing up creates your **organization** (your company or agency workspace) and
makes you its **Admin**.
* Email/password sign-ups must click the **confirmation link** in their inbox
before the first login.
* Google sign-in skips email verification.
After login, if you have no projects yet, the dashboard prompts you to
**Create Your First Project**.
***
## Step 2 — Create your first project [#step-2--create-your-first-project]
A **project** is one website you audit: your own site, a client's, or a brand
you manage. Creating a project opens a short **4-screen wizard**. Plan about
**3 minutes** if you fill fields manually, or **\~1 minute** if you use
**Auto-fill**.
You can reopen the wizard anytime from **Settings → Projects → New project**.
### Screen 1 — Project setup (\~30 seconds) [#screen-1--project-setup-30-seconds]
Give the project a name your team will recognize.
| Field | Required? | What to enter |
| ----------------------- | --------- | ------------------------------------------------------------------------ |
| **Project name** | Yes | 3–50 characters — e.g. `Acme Marketing Site` or `Client — Bright Dental` |
| **Project description** | No | Internal notes — goals, stakeholders, or scope |
Click **Let's Start** to continue.
### Screen 2 — Website details (\~1 minute) [#screen-2--website-details-1-minute]
Tell Digispot which site this project covers.
| Field | Required? | What to enter |
| ------------------- | --------- | ------------------------------------------------------------------ |
| **Website URL** | Yes | The homepage URL — e.g. `https://example.com` |
| **Business domain** | Yes | Your industry vertical (Technology, Healthcare, Ecommerce, etc.) |
| **Sitemap URL** | No | Your XML sitemap if you know it — use **Verify** to check it loads |
**Auto-fill (recommended):** After you paste the website URL, click the
**Auto-fill** button (wand icon). Digispot reads your site and fills in the
business domain, sitemap, brand keyword, target country, competitors, keywords,
and a short business summary. Fields marked **AI-filled** stay editable.
Auto-fill requires a paid plan that includes AI features. On the free plan you
enter these fields manually — it only takes an extra minute.
When Auto-fill finishes, the wizard usually **jumps ahead to Screen 3** so you
can review what it found. Otherwise click **Continue**.
### Screen 3 — Brand & market (\~30 seconds) [#screen-3--brand--market-30-seconds]
These fields shape keyword research, competitor tracking, and how reports are
labeled.
| Field | Required? | What to enter |
| ----------------------- | --------- | ---------------------------------------------------------------------------------- |
| **Brand keyword** | Yes | Your primary brand name — e.g. `Digispot` |
| **Location country** | Yes | The market you optimize for — e.g. United States, India, United Kingdom |
| **Primary competitors** | No | One competitor website URL per line |
| **Target keywords** | No | Comma-separated phrases you care about |
| **Business details** | No | A short summary of what the business does — expand **Edit** to change the AI draft |
Click **Continue**.
### Screen 4 — Instant audit (\~15 seconds) [#screen-4--instant-audit-15-seconds]
The last screen confirms what happens right after the project is saved.
| Option | Default | What it does |
| ---------------------------------- | ------- | ---------------------------------------------------------------------------------- |
| **Local SEO** | Off | Enable if you serve customers in a geographic area (map pack, NAP, location pages) |
| **International SEO** | Off | Enable for multi-country or hreflang sites |
| **Start analyzing my website now** | On | Creates a default audit config and **starts the first crawl immediately** |
Every audit always includes core checks: content, meta tags, performance,
links, schema, images, video, and AI/LLM crawler visibility. It also adds
backlinks and content-gap reports. Device type defaults to **Mobile** (Google's
mobile-first index). Page limit depends on your plan.
* Toggle **Start analyzing…** off if you only want to save the project and
configure the audit later.
* Click **View & edit full configuration** for advanced settings (device type,
max pages, individual toggles).
Click **Create project & start audit** (or **Create project** if you turned off
the instant run).
**Where you land next:**
* Audit started → **Audit run** page with live progress
* Project only → **Dashboard** or **Audit runs** list
***
## Step 3 — Connect Google (recommended) [#step-3--connect-google-recommended]
After the project exists, connect **Google Search Console**, **GA4**, and
optionally **Google Business Profile** under **Settings → Integrations**.
This is what makes cloud audits useful at scale: issues are **ranked by the
traffic they put at risk**, not just listed alphabetically.
See [Google Insights](/docs/cloud/google-insights/) for the full setup walkthrough.
***
## Step 4 — Invite your team (optional) [#step-4--invite-your-team-optional]
Add teammates from **Settings → Team**. Each person gets an email invite and
one of two roles:
* **Specialist** — run audits and view reports for assigned projects
* **Admin** — manage billing, integrations, and project settings
See [Teams & roles](/docs/cloud/teams/).
***
## Step 5 — Review your first audit [#step-5--review-your-first-audit]
When the crawl finishes, open the run from **Audit runs** on the dashboard.
Reports are grouped by category: crawlability, content, performance, schema,
local SEO, and more. Each category carries a grade and a prioritized issue
list.
To run another crawl or change scope, create or edit an **audit configuration**
first. See [Audits & reports](/docs/cloud/audits/).
***
## Install our other products (optional) [#install-our-other-products-optional]
The Cloud Platform does not replace every workflow. Many teams use all three
Digispot products on the same account:
### SEO Insights — Chrome extension (free) [#seo-insights--chrome-extension-free]
Audit **one page at a time** while you browse. 150+ checks, no signup required
for core features.
| | |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Install guide** | [Install the extension](/docs/chrome-extension/install/) |
| **Chrome Web Store** | [Digispot AI — SEO Insights](https://chromewebstore.google.com/detail/digispot-ai-seo-insights/njjbmbinhpipcdocojjniahjgdoljohg) |
| **Price** | Free — optional paid features via a Digispot Extension Key |
### SEO Spider — desktop app (free to start) [#seo-spider--desktop-app-free-to-start]
Crawl your **whole site** on your Mac or PC. Data stays on your machine, which
is good for client work and large sites.
| | |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Install guide** | [Install SEO Spider](/docs/desktop/install/) |
| **Download page** | [digispot.ai/products/digispot-ai-seo-spider](https://digispot.ai/products/digispot-ai-seo-spider) |
| **Free tier** | **Scout** — 100 pages per crawl, mobile rendering, no credit card |
| **Paid unlock** | **Tracker** and **Leader** raise page limits, add tablet/desktop modes, AI, MCP, and Google integrations — [see plans](/docs/desktop/plans/) |
Cloud Platform plans and Spider plans are separate. A cloud subscription does
not automatically unlock Spider desktop features, and vice versa. One account
works for both. Each product has its own billing.
***
## Cloud plan limits [#cloud-plan-limits]
The cloud **free plan** covers core auditing with limits on pages, AI features,
and some modules (such as Content Studio). Paid plans raise crawl limits and
unlock AI-assisted project setup, Content Studio, and higher research credits.
See [Plans & billing](/docs/cloud/billing/).
---
# Cloud Platform
URL: https://docs.digispot.ai/docs/cloud/
Digispot AI Cloud Platform — shared projects, GSC and GA4 integration, and long audits that run on Digispot's servers instead of your laptop.
**Digispot AI Cloud Platform** is the team product. It provides shared
projects and Google Search Console and GA4 integration. Long audits run on
Digispot's servers rather than tying up your machine.
No install — it runs in any browser.
Working solo? [SEO Spider](/docs/desktop/) gives you unlimited local crawls on
your own machine, with your data never leaving it.
## Built for teams [#built-for-teams]
* **Shared projects** — your whole team works from the same crawls and history.
See [Teams & roles](/docs/cloud/teams/).
* **Multi-project workspaces** — each client isolated, with separate crawls and
Google connections
* **Audits run on Digispot's servers** — long crawls do not tie up a laptop.
See [Audits & reports](/docs/cloud/audits/).
* **Role-based access** — Specialist and Admin roles
## What the cloud adds [#what-the-cloud-adds]
* **Google Insights** — dashboards built on your Search Console, GA4, and
Business Profile data. See [Google Insights](/docs/cloud/google-insights/).
* **Keyword, SERP, and backlink research** — powered by Data credits.
See [Research](/docs/cloud/research/).
* **Content Studio** — AI article and infographic generation, plus the
**Ask Digispot** assistant. See [Content Studio](/docs/cloud/content-studio/).
* **Content Opportunities** — systematic content gap discovery
* **Keys & connections** — MCP server keys, Chrome-extension keys, and Spider
desktop seats, managed from one place. See [Keys & connections](/docs/cloud/api-access/).
## Integrations [#integrations]
Connected through one-click OAuth:
* **Google Search Console** — queries, impressions, index coverage, and live URL
Inspection verdicts
* **Google Analytics 4** — traffic and engagement per URL
* **Google Business Profile** — local SEO alignment
These connections let findings be ranked by traffic at risk rather than
severity alone.
## For agencies [#for-agencies]
Each client gets an isolated project with its own crawl history and Google
connections. Invite your team with scoped [roles](/docs/cloud/teams/) and run the
same audits across every site you manage.
## Explore the docs [#explore-the-docs]
---
# Settings
URL: https://docs.digispot.ai/docs/cloud/settings/
Manage your account, projects, and integrations — and reach the team, billing, and API-key screens — from one Settings hub.
Settings is the hub for everything outside the audit itself. It covers your
account, your projects and their connections, and the team, billing, and
API-key screens.
## Account [#account]
The **Account** screen holds your profile and security settings: your details and
a password change. It's available to every member regardless of role.
## Projects & integrations [#projects--integrations]
The **Projects & Integrations** screen is where you manage the sites you audit and
the data sources you connect:
* **Projects** — create, edit, and delete projects; set the **active project** that
the rest of the console scopes to; and use AI-assisted auto-fill to populate a new
project from its site rather than typing every field
* **Sitemap verification** for a project, so crawls start from the right URL set
* **Integrations** — connect **Google Search Console** and **Google Analytics 4**
over OAuth, with **Google Ads** and **Bing Webmaster** connection screens also
available
Connecting a data source is per-project. Switch the active project and the
integration state follows it. Connected Google data powers the
[Google Insights](/docs/cloud/google-insights/) dashboards and weights audit
findings by real traffic.
Search Console gates its reports by the permission granted on the connected
property. **Search Analytics** and **URL Inspection** each unlock different
Google Insights sections. Connecting the account isn't the same as granting
both. A locked section usually means the missing scope, not missing data.
## Other settings screens [#other-settings-screens]
The rest of the Settings area is documented with the features it controls:
* **User Management** — see [Teams & roles](/docs/cloud/teams/)
* **Billing & Subscription** and **Usage & Analytics** — see [Plans & billing](/docs/cloud/billing/)
* **Chrome Extension**, **MCP Server**, and **Spider License** — see [Keys & connections](/docs/cloud/api-access/)
Some Settings screens are Admin-only: Billing, User Management, and the
API-key screens. See [Teams & roles](/docs/cloud/teams/).
---
# Teams & Roles
URL: https://docs.digispot.ai/docs/cloud/teams/
Organizations, role-based access (Specialist, Admin), inviting members, and switching between organizations.
The Cloud Platform is multi-tenant. Everyone works inside a shared
**organization**. What each person can do is governed by their role.
## Roles [#roles]
There are two roles:
| Role | Can do |
| -------------- | -------------------------------------------------------------------------------------- |
| **Specialist** | Create and manage projects and audits. Can view user management, with limited editing. |
| **Admin** | Full access, including user management and billing. |
Some areas are Admin-only: user management, billing, and the API-key screens
(MCP, Chrome extension). Specialists can view user management but not make
changes there.
## Inviting members [#inviting-members]
Admins invite teammates by email from **User Management**. An invited user is
**pending** until they accept the emailed invite and set a password (or link
Google). You can resend or revoke a pending invite. You can also edit a member's
role or active status later.
A few guardrails apply. The organization owner can't be deleted. Only Admins
can grant the Admin role or toggle a member's active status. You can't change
your own role or status.
## Multiple organizations [#multiple-organizations]
You might belong to more than one organization, for example as a consultant
across several clients. You can switch the active organization in-session with
the organization switcher, without logging out.
---
# AI Features
URL: https://docs.digispot.ai/docs/desktop/ai/
AI analysis across pages, crawls, and projects, plus an AI copilot — powered by your own key (BYOK) or Digispot-managed credits.
Spider's AI turns raw crawl data into prioritized, plain-English guidance. It's a
paid feature, available on **Tracker** and **Leader**. It reads directly from your
crawl, so the output is grounded in your actual audit rather than generic advice.
AI also powers [Content gaps](/docs/desktop/content-gaps/),
[Image Studio](/docs/desktop/image-studio/), and the AI steps in
[Recipes](/docs/desktop/recipes/). All of them need a provider connected here
first.
## Two ways to power AI [#two-ways-to-power-ai]
You connect a provider once, one of two ways. Then you choose the provider and
model at runtime for each task.
| | Bring your own key (BYOK) | Managed credits |
| --------------------- | --------------------------------------------- | ----------------------------- |
| **Provider** | OpenAI, Anthropic, Google Gemini, or DeepSeek | Digispot handles it |
| **Where requests go** | Straight to the provider | Through your Digispot account |
| **Billing** | You pay the provider directly | A shared Digispot credit pool |
| **Keys to manage** | Your own key | None |
BYOK suits anyone who already has a provider account and wants to control cost
and data flow. Managed credits suit anyone who would rather not manage keys at
all.
## AI analysis tasks [#ai-analysis-tasks]
Spider offers a library of AI tasks scoped to different levels of a crawl:
* **Page** — explain a page's issues, summarize what to fix, and how
* **Crawl** — summarize a whole run and its most important findings
* **Project** — track trends and priorities across runs over time
Each task has a built-in default prompt, and you can save your own custom
templates.
## AI copilot [#ai-copilot]
The AI copilot is a chat assistant that can query your crawl data directly using
built-in SEO tools. Ask questions like "what are my highest-impact issues?" or
"which pages regressed since the last crawl?" The answers are grounded in your
actual audit, not generic advice.
## Usage and cost [#usage-and-cost]
Spider tracks AI usage: tokens, latency, and cost. You can see what each analysis
costs, whether you're on BYOK or managed credits.
---
# Backlinks
URL: https://docs.digispot.ai/docs/desktop/backlinks/
The Backlinks module shows your referring domains and link profile, backed by cloud link data.
The Backlinks module shows who links to your site and how strong that link profile
is. This is the off-page half of SEO that a crawl alone can't see. A local crawl
reads your own pages. Backlinks are what other sites do, so this data comes from
Digispot's cloud rather than from anything Spider fetches on your machine.
Backlinks is a paid module, available on the **Tracker** and **Leader** plans.
The free Scout tier shows an upgrade prompt. Link data comes from Digispot's
cloud and spends data credits. Each live refresh draws down the credit pool,
which is why it is metered separately from the AI features. See
[Plans & tiers](/docs/desktop/plans/).
## What it shows [#what-it-shows]
* **Metric cards** — referring domains, total backlinks, and authority signals,
the top-line summary of how much external link equity the site has
* A **backlinks table** — one row per link, so you can see which sites contribute
the most authority and where they point
Authority here is a domain-strength signal, not Google's internal PageRank. It's
useful for comparing referring domains against each other and for judging the
overall weight of the profile.
Each row carries the detail that decides whether a link is worth anything:
* **Referring domain** — the site that links to you
* **Target** — the page on your site the link points to
* **Anchor text** — the clickable text of the link, a relevance signal for the target
* **Rank** — the referring domain's authority, so strong links stand out from weak ones
* **Nofollow** — whether the link passes authority or is marked `nofollow`
Sort by rank to find your strongest referring domains. Read the target column to
see which pages already attract links, and which important pages attract none.
## Data states [#data-states]
Because the data is cloud-backed and credit-metered, each row carries a status so
you can tell live data from a state that needs attention:
* **Not connected** — cloud link data isn't linked to the project yet
* **No data** — the domain has no backlinks on record
* **Out of credits** — the data credit pool is exhausted; top up to refresh
---
# Checks & Scores
URL: https://docs.digispot.ai/docs/desktop/checks-and-scores/
SEO Spider runs 300+ checks across 25 categories and produces three distinct scores — Page, Device, and Site.
Every crawl runs **300+ checks across 25 categories** on each page, then rolls
the results into three separate scores. The checks are the raw findings. The
scores are how those findings roll up, so you can judge a page, a device render,
or the whole site at a glance.
## The 25 categories [#the-25-categories]
Checks are grouped into categories covering the full surface of technical and
on-page SEO, including:
* **Content**, **Metadata**, and **Headings**
* **Links** and **URL structure**
* **Images** and **Video SEO**
* **Schema markup** and **industry schema**
* **Canonical URLs**, **meta robots**, and **robots.txt**
* **XML sitemap** and **crawlability**
* **Performance** and **mobile responsiveness**
* **Security** and **HTML validation**
* **Internationalization (hreflang)** and **local SEO**
* **Social media**, **accessibility**, and **brand mentions**
* **LLMs.txt / LLM optimization** and **answer engine optimization (AEO)**
## Severity [#severity]
Each finding maps to one fixed **severity**, so the same problem always carries
the same weight and you can work top-down without re-judging each one:
| Severity | What it means |
| ------------ | ----------------------------------------------------- |
| **Critical** | Blocks indexing or ranking — fix before anything else |
| **High** | A real ranking or crawl problem, not fatal on its own |
| **Medium** | Worth fixing, meaningful but not urgent |
| **Low** | Minor polish with limited impact |
The [Issues board](/docs/desktop/issues/) uses these same severities to order the
fix-first queue, and the **quick wins** panel pulls the high-impact, low-effort
findings to the front.
## Three scores [#three-scores]
Spider reports three distinct scores. Keeping them separate tells you whether a
problem is on one page, one device, or the whole site.
| Score | What it measures |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Page score** | A single page's health, 0–100 with an A–F grade. Indexability-aware — a page that can't be indexed is scored down hard. |
| **Device score** | The average of a device's page scores, so you can compare mobile vs desktop vs tablet. |
| **Site score** | A site-level composite built from site-wide checks such as SSL/HTTPS, robots.txt, the XML sitemap, and llms.txt. |
Indexability problems outrank everything else. A page that can't be indexed
can't rank, no matter how good the rest of its SEO is. That's why the page
score weights them heavily.
---
# Competitors
URL: https://docs.digispot.ai/docs/desktop/competitors/
Track rival domains, see where you stand across the field, and read one rival head-to-head. Profiling reads each site's sitemap and robots files, and never crawls their pages.
Competitors is where you track rival domains and measure yourself against them. It
profiles each rival from their published sitemap and robots files, ranks the field
by where you stand, and opens any single rival head-to-head. It never crawls a
competitor's pages. Every figure comes from each site's own published files.
Scout tracks one competitor and cannot refresh cloud data. Tracker and Leader
track up to four and can pull live backlink and search-visibility data. Backlink
and market-standing lookups draw on data credits. See
[Plans & tiers](/docs/desktop/plans/).
## Tracking a competitor [#tracking-a-competitor]
Add a competitor by its domain. Spider profiles it immediately from its sitemap,
so you see the read back at once rather than a pending row. Profiling is
sitemap-only. It runs no crawl, uses no AI, and costs nothing.
A competitor stays tracked even when the read returns little. Each outcome is
recorded as data, not as a failure:
* **Profiled** — the sitemap was read, so you get its self-declared URL count and sections.
* **No sitemap published** — none was found, so size and structure are unknown, not zero.
* **Couldn't check** — the read was refused, and the HTTP status is shown beside the label. Size is unverifiable, not small.
* **Couldn't reach** — the site could not be reached, so size is unverifiable, not small.
* **Not profiled yet** — no read has run. This is not the same as an empty site.
## Where you stand [#where-you-stand]
The Competitors screen opens on the whole field. Three tiles summarize it:
* **Biggest threat** — the rival that leads on the most sections, and how many of those you have no pages under.
* **Your strongest position** — the section where you publish more than any rival read.
* **Most contested** — the section where you and a rival publish at a similar depth.
Below the tiles, the **Rivals** table sets search performance beside each site's
published footprint. Search performance comes from Digispot's cloud and covers
estimated monthly search visits, keywords, top-10 count, momentum, and the keyword
gap. The footprint comes from each sitemap and covers URL count, sections,
referring domains, when it was last profiled, and a verdict of ahead or behind on
sections. An **AI Insights** panel ranks the sections and topics a rival publishes
that you do not, in the order worth building.
Each figure carries its limits on the screen. Topics are inferred from URL wording,
not a crawl. Search visits are the provider's estimate of monthly organic clicks,
not your analytics. Positions are a distribution across ranking keywords, not rank
tracking.
## Comparing one rival [#comparing-one-rival]
Opening a rival shows the head-to-head detail. A summary table compares you and the
rival on search visits, keywords, sitemap URLs, referring domains, and age, with a
standing column for who leads. The rest of the detail is organized into tabs.
### Head to head [#head-to-head]
The Overview tab lists every signal both sides could be read on, with who leads and
the evidence behind it. There is no blended score, because the signals are not
commensurable. Typical rows are the sections you lack, publishing cadence, and
markets served. A comparison that is not sound is called out rather than forced. A
rival with far more URLs but a large share matched to no topic is not counted as a
coverage lead. An **AI rival brief** summarizes where the rival is ahead and
behind, and **Next moves** turns the section and keyword gaps into concrete steps.
### The content gap [#the-content-gap]
The Content tab measures the sections a rival publishes that your last crawl did
not find. It sets their largest cluster aside first, because that cluster is often
templated pages, and a lead built on templates is a different problem from one
built on articles. Each section shows their page count against yours, a share bar,
and a verdict of "they publish more", "they have it, you don't", or "you publish
more". Expanding a section lists the specific pages, and pages with no match on
your site are marked as drafts you could commission.
Two warnings sit on this tab. The gap is matched against the pages in your last
crawl, not your whole sitemap, so it can overstate a gap but never understate it.
Matches are on URL wording only, so open the pages and verify before commissioning
anything.
### AI readiness and markets [#ai-readiness-and-markets]
The AI & markets tab reads from robots.txt and llms.txt directly, so it is
available even when a sitemap is not. It compares whether each side publishes an
`llms.txt` and its completeness score, and how each robots file treats named AI
crawlers. The markets section lists the locales each site declares through hreflang
alternates in its sitemap.
### Off-page authority [#off-page-authority]
The Backlinks tab pulls the rival's referring-domain profile from Digispot's cloud.
It reports referring domains, dofollow counts, and domain authority. This data is
credit-metered, so a live pull runs only when you ask for it. A missing or failed
lookup reads as unmeasured with a reason, never as zero authority.
## Search visibility and keyword gap [#search-visibility-and-keyword-gap]
Search performance and the keyword gap come from Digispot's cloud as market
standing. They cover estimated organic and paid visibility and the keywords a rival
ranks for that you do not. Like backlinks, this is billable and pulled on request.
Use **Refresh standing** to update it. A rival you have never looked up shows no
standing until you request it.
## Plans and limits [#plans-and-limits]
| | Scout | Tracker | Leader |
| ------------------- | ----- | ------- | ------ |
| Competitors tracked | 1 | 4 | 4 |
| Refresh cloud data | No | Yes | Yes |
| Backlink gap | No | Yes | Yes |
| Market standing | No | Yes | Yes |
---
# Content gaps
URL: https://docs.digispot.ai/docs/desktop/content-gaps/
Content gaps surfaces new pages worth writing — AI-discovered topics your site doesn't cover yet, mapped to the clusters they extend.
Content gaps points at what to write next. It finds topics your site doesn't cover
yet but should, discovered by AI from your crawl and market. Each topic is mapped
to the topic cluster it extends. Where [Keywords](/docs/desktop/keywords/) works at
the term level, content gaps works at the page level: it answers "what page is
missing?" rather than "what word should this page target?"
Content gaps is an AI feature, available on the **Tracker** and **Leader**
plans. On the free Scout tier it shows an upgrade prompt. Because it runs AI, it
needs a provider connected first: your own key (BYOK) or managed credits. See
[AI features](/docs/desktop/ai/) and
[Plans & tiers](/docs/desktop/plans/).
## The workbench [#the-workbench]
Content gaps has a **list** view and a **map** view. They are two angles on the
same analysis:
* The **list** ranks candidate pages worth creating, so you start from the
highest-value gap rather than the top of an unordered list
* The **map** shows how each gap extends your existing topic clusters, so you
can see where a new page reinforces a cluster you already have versus opening a
new one
* A **Regenerate** action re-runs the analysis as your site and market change,
since a gap you fill this month shouldn't keep showing up next month
Results are grounded in your [Knowledge](/docs/desktop/knowledge/) store, so the
suggestions reflect your actual products, locations, and audience rather than
generic topics inferred from page text alone. A thin Knowledge store yields
generic gaps. A complete one yields gaps specific to what you sell and who you
sell to.
---
# The Crawler
URL: https://docs.digispot.ai/docs/desktop/crawler/
How SEO Spider crawls a site — HTTP and JavaScript rendering, multi-device crawling, concurrency, and cloaking detection.
Spider crawls a whole site from your own machine. It discovers URLs through links
and the sitemap, then audits every page it finds.
## Two fetch modes [#two-fetch-modes]
Each crawl can run in one of two modes:
* **HTTP** — fetches the raw HTML directly. Fast, and closest to how a source-only
crawler sees the page.
* **JavaScript rendering** — loads each page in a real Chromium browser
(Playwright), so client-rendered content, injected schema, and
JavaScript-dependent issues are all captured.
Rendering mode is the right choice for modern single-page apps and any site where
content is assembled in the browser.
## Multi-device crawling [#multi-device-crawling]
Spider can crawl in **desktop, mobile, and tablet** modes in a single pass.
Site-level checks run once per crawl. Per-page checks run for each device, so you
can compare how the same page scores across viewports. This is useful for Google's
mobile-first indexing.
Multi-device crawling needs a paid plan. The free **Scout** tier is
mobile-only. See [Plans & tiers](/docs/desktop/plans/).
## Cloaking detection [#cloaking-detection]
Spider can fetch a page both as an HTTP request and as a rendered browser view,
then compare the two. Large differences between what a site serves a bot versus a
real browser produce a **cloaking score**, flagging pages that may be showing
search engines something different from users.
## Concurrency and page caps [#concurrency-and-page-caps]
Spider crawls several URLs at once. Both the number of simultaneous requests
(concurrency) and how many pages a single crawl can cover are set by your plan:
| Plan | Pages per crawl | Concurrency |
| ---------------- | --------------- | ----------- |
| **Scout** (free) | 100 | 1 |
| **Tracker** | 10,000 | 2 |
| **Leader** | Unlimited | 4 |
A crawl configured above your plan's limits is clamped down to them rather than
rejected. A request for more pages or higher concurrency simply runs at the cap.
You can start, pause, resume, and stop a crawl at any time without losing what has
already been collected.
Crawling consumes bandwidth on the target site. Lower the crawl rate before
crawling a production site you do not own.
## Scope and authentication [#scope-and-authentication]
Restrict a crawl to a domain, include subdomains, or limit it to a path such as
`/blog`. For sites behind a login, pass authentication as **custom HTTP headers**
under **Advanced → Network**. An `Authorization` header (Bearer or Basic) or a
`Cookie` header is sent with every request. Custom headers require the **Tracker**
plan. The headers are stored in the project configuration on your machine and are
sent only to the site being crawled.
---
# Device comparison
URL: https://docs.digispot.ai/docs/desktop/devices/
When a crawl runs across desktop, mobile, and tablet, the Devices view compares scores and issues between them.
When a crawl covers more than one device, the **Devices** view puts them side by
side. You can see where a page behaves differently on mobile than on desktop,
which matters because Google indexes and ranks the mobile version. A page that
scores well on desktop but drops content, links, or structured data on mobile is
being judged on the weaker render.
Spider can crawl in **desktop, mobile, and tablet** modes in one pass. **Mobile
is always the lead**: it's crawled first because Google indexes mobile-first.
Desktop and Tablet are added to compare for indexing gaps. Each device runs as its
own crawl, so one audits while the others queue for a free slot.
## What runs once vs per device [#what-runs-once-vs-per-device]
Not everything is device-specific. Site-level foundation is shared across every
device; the on-page audit runs separately for each viewport.
| Layer | Scope | Examples |
| ------------------------ | ------------------------------------- | --------------------------------------------------------- |
| **Site architecture** | Once per crawl, shared by all devices | SSL, robots.txt, sitemaps, `llms.txt`, crawlability |
| **On-page / page score** | Per device | Content, headings, links, schema, images, Core Web Vitals |
This split is why a site can show one **Site Architecture** score but different
**page scores** per device. The foundation is sound, yet the mobile render drops
content the desktop render keeps.
## What it compares [#what-it-compares]
* **Category score deltas** — each category scored per device, with the
difference between renders highlighted so parity gaps stand out
* **Mobile-specific issues** — findings that appear only on the mobile render,
such as content or links present on desktop but missing on mobile
* **Performance comparison** — Core Web Vitals side by side, where mobile
typically lags desktop and is the version Google measures
The deltas to act on are the large ones. Small score differences between
renders are normal; a category that is several grades worse on mobile usually
means content or markup is being dropped from the render Google actually
indexes.
## How each device is crawled [#how-each-device-is-crawled]
Each device uses its own user agent and viewport: Chrome Mobile for the mobile
render, Chrome Desktop for desktop. If a page or `robots.txt` returns a 403,
Spider retries once as the device-specific Googlebot before reporting it blocked.
These defaults are set per project and can be overridden under **Advanced →
Per-device user agent & viewport**. See [The crawler](/docs/desktop/crawler/) for
the full option set.
Multi-device crawling needs a paid plan. The free **Scout** tier is mobile-only,
so device comparison is a Tracker/Leader feature. See
[Plans & tiers](/docs/desktop/plans/).
---
# Run Your First Crawl
URL: https://docs.digispot.ai/docs/desktop/first-crawl/
Crawl a site end to end with the Digispot SEO Spider desktop app, then read the Page, Device, and Site scores and work the issues by severity.
This is the path from a fresh install to a finished crawl you can act on. The
Spider applies 313 checks across 25 categories to every page. It keeps all data
on your machine. It follows one core loop: **Discover → Prioritize → Understand
→ Act**.
This guide assumes the app is installed and your plan is activated. If not,
start with [Install the desktop app](/docs/desktop/install/) — the free
**Scout** tier crawls up to 100 pages with no card.
## Before you begin [#before-you-begin]
| What | Do you need it? |
| -------------------------------------- | ------------------------------------------------------------------ |
| **SEO Spider installed and activated** | Yes — see [Install](/docs/desktop/install/) |
| **A site you can crawl** | Yes — your own, a client's, or any site you're authorized to audit |
| **A Google account (GSC / GA4)** | Optional — connect it to weight issues by real traffic |
***
## Step 1 — Create a project [#step-1--create-a-project]
Select **New Project**. This opens the **Create New Project** wizard: *"Set up a
website to audit. Each project keeps its runs, so you can track SEO improvements
over time."* It has three steps: **Basics**, **Local SEO & Languages**, and
**Advanced**. Only the first is required. The other two have working defaults. A
step rail on the left tracks progress, and you can move back to any completed
step.
### Basics [#basics]
The essentials of what to crawl. Most projects only need this step.
| Field | Required? | What to enter |
| ------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Website URL** | Yes | The site's root URL, e.g. `https://example.com`. It's validated on entry and **cannot be changed after the project is created** |
| **Industry** | Yes | Your vertical — drives AI recommendations and industry benchmarks |
| **Devices** | — | Desktop, Mobile, Tablet pills. **Scout (free) crawls mobile-only**; Desktop and Tablet need Tracker or Leader |
| **Pages per audit** | Yes | Default 100, up to your plan's cap. Paid plans add **Crawl every page in my sitemap** to auto-detect the count |
| **Project name** | No | Auto-fills from the domain — leave blank or set 3–50 characters |
| **Description** | No | A short note about the site; feeds AI recommendations |
| **What we check** | Yes | **Essentials** (recommended — critical, high, and medium issues) or **Also capture low-priority issues** (thorough, paid) |
After entering the URL, use **Read my site** to pre-fill the industry,
description, and other fields from your homepage. On Scout this read is
deterministic; paid plans add an AI-written summary.
### Local SEO & Languages [#local-seo--languages]
Skip this step unless the site serves a physical location or multiple languages.
Enabling **Local Business SEO** reveals three fields. Enter the **Official
Business Name** and match your Google Business Profile exactly. Add an optional
**Google Business Profile URL** and one or more **business locations**. A
**target languages/regions** selector drives international checks.
### Advanced (optional) [#advanced-optional]
Sensible defaults are set for every field here. Open it only to tune the crawl.
The settings are grouped into six areas. **Crawler engine & discovery** compares
raw HTML vs rendered page, discovers links for orphan pages, and runs post-crawl
AI summaries. **Crawl tuning** sets concurrency, delay, and failure and
identical-page thresholds. **URL include / exclude filters** limit what gets
crawled. **Per-device user agent & viewport** includes a Googlebot fallback on
403\. **Network** holds proxy and custom headers. **Stealth crawling** is the last
group. Most of these are Tracker features. See
[The crawler](/docs/desktop/crawler/) for what each option does.
Click **Create Project** on the last step.
## Step 2 — Start the audit [#step-2--start-the-audit]
Right after the project is created, a welcome screen confirms the scope:
**"Here's what we'll audit on \[your site]"**. It reads back the industry,
devices, page budget, and crawler settings, alongside a **What happens when you
click Start** summary. Select **Start audit now**, or **Adjust settings first**
to reopen the configuration.
Before the crawl begins, a **Ready to audit?** dialog runs a quick check of your
machine: network, memory, CPU, and power. Crawl speed and performance metrics
are most accurate on a healthy host. The check is advisory and never blocks.
Review any warnings, then select **Start audit**.
## Step 3 — Watch the crawl [#step-3--watch-the-crawl]
Progress appears live. The run page shows the current status and the **pages
audited against those discovered**. It shows the **Site Architecture** score as
soon as it's computed. You can **pause or cancel** the run at any point. Each
device you selected **runs as its own crawl**. One audits while the others show
**Queued · waiting for a free slot**, since Mobile is always crawled first as the
lead.
Crawling consumes bandwidth on the target site. Lower the concurrency and raise
the delay in the project's **Advanced** settings before crawling a production
site you do not own.
## Step 4 — Read the scores [#step-4--read-the-scores]
When the crawl finishes you land on the project **Overview**. The left sidebar
carries the core loop — **Overview**, **Audits**, **Issues**, **Pages**, and
**Compare Audits** — alongside growth and setup sections. The Overview leads with
two gauges, **Site Architecture** and **Page Score**. Below them sit a severity
breakdown and the top burning issues.
The Spider reports three distinct scores, so a single number never hides a
device- or page-specific problem:
| Score | Answers | Where it shows |
| ---------------- | ----------------------------------------- | -------------------------- |
| **Page score** | How healthy is this one URL? | Per-page reports |
| **Device score** | How does the site render per device type? | Overview, device breakdown |
| **Site score** | How healthy is the whole site? | Overview rollup |
The audit-run **Overview** breaks each score into its contributing categories:
content quality, crawl readiness, performance, link strategy, schema, and more. A
**What to fix first** panel orders issues by impact rather than count. For how
each score is calculated and what a good number looks like, see
[Checks & scores](/docs/desktop/checks-and-scores/).
## Step 5 — Work the issues [#step-5--work-the-issues]
Open **Issues**. Findings are grouped by severity, so work top-down: errors
first, then warnings, then notices. Each issue lists every affected URL, so a
single fix to a shared template can clear the finding across hundreds of pages
at once.
Work the list by severity:
| Severity | Meaning | Act when |
| ----------- | -------------------------------------------- | --------------- |
| **Error** | Actively blocking indexing or breaking pages | Immediately |
| **Warning** | Hurting quality or rankings | This sprint |
| **Notice** | Worth knowing, not urgent | When convenient |
Start with errors on your highest-traffic pages. Connect GSC (below) so the
Spider can sort issues by the clicks actually at risk, not just severity.
## Crawling gated sites [#crawling-gated-sites]
For staging or members-only sites behind a login, add authentication under the
project's **Advanced → Network** settings as **custom HTTP headers**. An
`Authorization` header (Bearer or Basic) or a `Cookie` header is passed with
every request. Custom headers are a **Tracker** feature.
Credentials live in the project configuration on your machine and are sent only
to the site being crawled. They never reach Digispot's servers.
## Next steps [#next-steps]
* **Weight issues by real traffic** — connect Search Console and GA4 under the
project's Google integrations. See [Google integrations](/docs/desktop/google/).
* **Compare runs over time** — re-crawl after fixes and use the comparison view
to confirm issues dropped. See [Issues](/docs/desktop/issues/).
* **Let an AI agent query the crawl** — the Spider ships an MCP server so Claude
or Cursor can read this data directly. See [MCP server](/docs/desktop/mcp/).
* **Need to share with a team?** The [Cloud Platform](/docs/cloud/) runs the same
crawls on Digispot's servers with shared projects.
---
# Google Integrations
URL: https://docs.digispot.ai/docs/desktop/google/
Connect Google Search Console and GA4 so Spider ranks findings by the traffic actually at risk.
Connect your Google data and Spider stops treating every issue equally. It
weights findings by the traffic and rankings actually at stake. A crawl tells you
what is wrong. Google's data tells you which of those wrongs is costing you real
traffic. Together they turn a flat issue list into a priority order.
Google integrations are a paid feature, available on **Tracker** and
**Leader**. See [Plans & tiers](/docs/desktop/plans/).
## What you can connect [#what-you-can-connect]
* **Google Search Console** — clicks, impressions, CTR, and position by query,
country, device, and URL
* **Google Analytics 4** — traffic and engagement data
You connect with a one-click OAuth sign-in. Tokens are stored encrypted on your
machine. The connection syncs directly with Google.
## The indexing gap [#the-indexing-gap]
Search Console's page-indexing (coverage) report is the one dataset the API
can't hand over directly. Import it as a CSV or ZIP. Spider then correlates it
against your crawled pages to surface the **indexability gap**: pages you expect
to rank that Google isn't indexing.
## Traffic-aware insights [#traffic-aware-insights]
With Google connected, Spider can highlight:
* **High-traffic pages at risk** — pages with issues that are also earning
meaningful traffic
* **Query cannibalization** — multiple pages competing for the same query
* **Striking-distance queries** — near-page-one queries worth a push
* **Period-over-period trends** — what improved or slipped since last time
Connect Search Console before working the [Issues board](/docs/desktop/issues/).
With traffic data attached, the board can rank a template issue affecting your
highest-traffic pages ahead of a critical finding on a page nobody visits.
---
# Image Studio
URL: https://docs.digispot.ai/docs/desktop/image-studio/
Image Studio manages the reference images and generated images used by a project's AI content workflows.
Image Studio is where a project's images live. That covers the brand and
reference images you provide, plus the images your AI content workflows generate.
It is the image half of the content pipeline. When a
[recipe](/docs/desktop/recipes/) writes a blog post and produces a cover image,
that image lands here.
Image Studio is an AI feature, available on the **Tracker** and **Leader**
plans. The free Scout tier shows an upgrade prompt. Generating images runs
through the same AI provider as the other AI features, using your own key
(BYOK) or managed credits. See [AI features](/docs/desktop/ai/) and
[Plans & tiers](/docs/desktop/plans/).
## Two tabs [#two-tabs]
* **References** — brand and reference images you upload, so generated images stay
on-brand rather than drifting to a generic look
* **Generated** — every image produced by the project's workflow runs, kept with
the project so you can reuse or refine them
## The reference loop [#the-reference-loop]
The two tabs feed each other. That is what keeps output consistent over time:
* **Generate with** a reference — produce a new image guided by one you have
marked as on-brand
* **Save** a generated image back as a reference — promote a result you like so
future runs match its style
Over several runs this narrows generated images toward a house style instead of
each run starting from scratch.
---
# Desktop App
URL: https://docs.digispot.ai/docs/desktop/
Digispot AI SEO Spider runs real-browser crawls on your own machine — 300+ checks per page in mobile, tablet, and desktop modes.
**Digispot AI SEO Spider** is the desktop application. It crawls entire sites
from your own machine using a real Chromium browser, running **300+ checks per
page** in **mobile, tablet, and desktop** modes.
Crawls stay local by default. Your crawl data does not leave your machine, which
matters for client work under NDA.
One Digispot AI account activates both the desktop app and the
[cloud platform](/docs/cloud/). There is no separate license.
## How it differs from the extension [#how-it-differs-from-the-extension]
| | [Chrome Extension](/docs/chrome-extension/) | SEO Spider |
| ------------------ | ------------------------------------------- | --------------------------------------- |
| **Scope** | One page at a time | Whole site |
| **Checks** | 150+ per page | 300+ per page, across 25 categories |
| **Device modes** | Current viewport | Mobile, tablet, and desktop per crawl |
| **Prioritisation** | Severity | Weighted by GSC and GA4 traffic at risk |
| **Price** | Free forever | Free to start, with paid plans |
The desktop Spider is **free to start**. The **Scout** tier runs the crawler
with a 100-page cap. Paid **Tracker** and **Leader** plans raise the limits and
unlock AI, MCP, and Google. A **7-day free trial** is available. See
[Plans & tiers](/docs/desktop/plans/).
## What it does [#what-it-does]
* **Whole-site crawling** in a real Chromium browser, with an HTTP mode and a
JavaScript-rendering mode. It catches issues source-only crawlers miss.
See [The crawler](/docs/desktop/crawler/).
* **300+ checks across 25 categories**, producing separate
[Page, Device, and Site scores](/docs/desktop/checks-and-scores/).
* **Cloaking detection** — compares what a page serves to a bot versus a browser.
* **Project dashboard, Visualizer, per-page reports, and audit comparison**
over time. See [Reports & dashboards](/docs/desktop/reports/).
* **Pages, issues, and device views** for slicing a crawl — see
[Pages list](/docs/desktop/pages/), [Issues](/docs/desktop/issues/), and
[Device comparison](/docs/desktop/devices/).
* **Keyword research, backlinks, and content gaps**, plus a
[Knowledge](/docs/desktop/knowledge/) store that grounds the AI.
* **AI analysis and an AI copilot** — see [AI features](/docs/desktop/ai/).
* **MCP server** — lets Claude Code, Cursor, and Windsurf query your crawl data.
See [MCP server](/docs/desktop/mcp/).
* **SEO Recipes** — a workflow engine for repeatable, multi-step audits.
See [SEO Recipes](/docs/desktop/recipes/).
* **Google Search Console and GA4 sync** via one-click OAuth, so findings are
ranked by traffic actually at risk.
See [Google integrations](/docs/desktop/google/).
## Explore the docs [#explore-the-docs]
## Requirements [#requirements]
| | |
| ----------- | ----------------------- |
| **macOS** | Apple Silicon and Intel |
| **Windows** | 64-bit Windows 10 or 11 |
---
# Install the Desktop App
URL: https://docs.digispot.ai/docs/desktop/install/
Download, install, and activate Digispot AI SEO Spider on macOS or Windows — then run your first crawl.
**SEO Spider** is Digispot's native desktop crawler. It runs on your own machine
and keeps all crawl data local, which is why it suits client and NDA work. It
installs like any native app. The only online step is activating your plan.
## Before you begin [#before-you-begin]
| | |
| ----------- | --------------------------------------------------------------------------- |
| **macOS** | Apple Silicon or Intel, macOS 12+ (`.dmg`) |
| **Windows** | 64-bit Windows 10 or 11 (`.exe`) |
| **Linux** | Not shipped — use the [Cloud Platform](/docs/cloud/) instead |
| **Account** | A Digispot account (free) — the same one works on the [cloud](/docs/cloud/) |
| **Payment** | None to start — the **Scout** tier is free |
Pick your platform below.
Get the `.dmg` from the
[SEO Spider download page](https://digispot.ai/products/digispot-ai-seo-spider).
Apple Silicon (M-series) and Intel Macs use different builds — if you are
unsure, open the Apple menu and select **About This Mac**.
Open the downloaded `.dmg` and drag **Digispot AI SEO Spider** into your Applications
folder.
The first launch shows a Gatekeeper prompt. Open **System Settings →
Privacy & Security**, then select **Open Anyway**.
Get the `.exe` installer from the
[SEO Spider download page](https://digispot.ai/products/digispot-ai-seo-spider).
Spider supports 64-bit Windows 10 and 11.
Open the downloaded file and follow the prompts. If SmartScreen appears,
select **More info → Run anyway**.
Open Digispot AI SEO Spider from the Start menu.
Spider checks for updates on launch. You can always reinstall over an
existing installation — your projects and crawl history are preserved.
## Activate your plan [#activate-your-plan]
Sign in with your Digispot AI account. The same account works across the desktop
app and the [cloud platform](/docs/cloud/). There is no separate Spider license
to buy.
The desktop crawler is **free to start** on the **Scout** tier, with a 100-page
cap. Paid **Tracker** and **Leader** plans, or the **7-day free trial**, raise
the limits and unlock AI, MCP, and Google. The number of machines (seats) you can
activate depends on your plan. See [Plans & tiers](/docs/desktop/plans/).
Activation needs an internet connection, even though crawling itself works
offline.
## Next step [#next-step]
With the app installed and activated, run a crawl end to end and read the
results — see [Run your first crawl](/docs/desktop/first-crawl/).
Prefer not to install anything, or need to share audits with a team? The
[Cloud Platform](/docs/cloud/) runs the same crawls on Digispot's servers in any
browser.
---
# Issues
URL: https://docs.digispot.ai/docs/desktop/issues/
The Issues board is the fix-first queue — every finding across the crawl, grouped by severity and category, weighted by the traffic at risk.
The Issues board is where you decide what to fix first. It aggregates every
finding across the crawl by the problem itself, not page by page. A
template-level issue shows up once, with every affected page behind it. That
grouping is the point. A missing meta description repeated across 400 URLs is one
fix in a template, not 400 separate tasks, and the board shows it that way.
## Triage boards [#triage-boards]
The crawl **Overview** opens with three triage boards — issues **by severity**,
**by category**, and **by type** — plus a **quick wins** panel. Each board deep-
links into the full issues view, pre-filtered. You can jump straight from a
count to the exact findings behind it.
* **By severity** — Critical, High, Medium, and Low, the same fixed
severities every check maps to in [Checks & Scores](/docs/desktop/checks-and-scores/)
* **By category** — which part of SEO the findings sit in, from Content and
Metadata to Schema and Performance
* **By type** — the specific check that fired, so recurring template problems
cluster together
* **Quick wins** — findings that are both high-impact and low-effort, the
shortlist to clear before deeper work
## The issues view [#the-issues-view]
The dedicated issues view groups findings by severity and lets you filter by:
* **Severity** — critical and high by default
* **Pattern** — for example, mobile-only issues
* A **single issue** — focus one finding and see every page it affects
Each row explains **what** the issue is, **why** it matters, and **how** to fix it,
with a link to every page that has it. A finding carries its own remediation
rather than sending you elsewhere to look up what to do.
When Search Console is connected, issues are weighted by the traffic actually
at risk, so the highest-impact problems rise to the top. See
[Google integrations](/docs/desktop/google/).
---
# Keywords
URL: https://docs.digispot.ai/docs/desktop/keywords/
The Keywords module researches, plans, and organizes the terms your site targets — with opportunities, topics, and a sortable table view.
The Keywords module is where you research and organize the terms your site should
target. Discovery, planning, and theme organization all live in one workbench.
The terms you optimize for stay grounded in real search demand rather than guesses.
Keywords is a paid module, available on the **Tracker** and **Leader** plans.
The free Scout tier shows an upgrade prompt. Keyword data is enriched from
Digispot's cloud and spends data credits. Enrichment and discovery draw down
the credit pool, so the volume and difficulty figures are a metered resource.
See [Plans & tiers](/docs/desktop/plans/).
## Views [#views]
The module presents the same keyword set three ways. Each view suits a different
stage of the work.
* **Opportunities** — terms worth pursuing, ranked, so you can start from the
highest-value gaps rather than reading the whole list
* **Topics** — keywords grouped into the themes they belong to, which maps
directly to the pages and clusters you would build to cover them
* **Table** — a sortable list with **intent** and **source** filters, for
slicing by search intent (informational, commercial, and the like) or by where
a term came from
## What each term carries [#what-each-term-carries]
Every keyword in the table is enriched with the signals you sort and filter on:
* **Volume** — average monthly searches, the demand behind the term
* **Difficulty** — how hard the term is to rank for, so effort lands where it can pay off
* **Intent** — informational, commercial, transactional, or navigational
* **Trend** — whether demand is rising or falling over recent months
* **Position** — the site's current rank for the term, where it already appears
Sort by any column to work a slice at a time. High volume with low difficulty is
the usual starting point. A term already sitting in striking distance (position
just off page one) is often a faster win than a brand-new topic.
## Building your keyword set [#building-your-keyword-set]
There are three ways to populate the module, and they compose. Discover a base
set, extend it with an existing plan, then enrich the whole set.
* **Discover** new keywords from the cloud, scoped to your market
* **Import** a keyword plan via CSV to bring in terms you already track
* **Enrich** terms with cloud data for volume and difficulty
CSV **import** brings keyword plans in. There is no CSV **export**. Export is
disabled across the app, so the Keywords workbench is where the data lives and
is worked, not a staging area for spreadsheets.
---
# Knowledge graph
URL: https://docs.digispot.ai/docs/desktop/knowledge-graph/
A connected map of your site's pages, topics, entities and verified facts. It is the compact context layer AI agents read over the MCP server.
The knowledge graph is a connected map of what your site says. It holds your
pages, topics, entity hubs, keywords, search queries, competitors and your
verified business facts. It is the context layer AI agents read through the
[MCP server](/docs/desktop/mcp/). An agent works from this structured map
instead of re-crawling the site or guessing from raw page text.
The graph is built inside the desktop app. Reading it from an AI agent uses
the MCP server, which is available on Tracker and Leader.
## What it maps [#what-it-maps]
Every node comes from data the audit already produced:
* **Pages**, connected by their internal links and sized by inbound links.
* **Topics**, the clusters your pages fall into, each with its pillar page.
* **Entity hubs**, the people, places and organizations the site is about.
* **Keywords** and **search queries**, mapped onto the pages they target.
* **Competitors** tracked against the same topics.
* **Content gaps**, topics the site does not yet cover.
* **Verified Knowledge**, the business facts you have approved.
## How it is built [#how-it-is-built]
The graph is assembled from your latest completed audit. Its layout is
deterministic, so no AI calls are needed to generate or position it. It rebuilds
automatically when the audit or your Knowledge changes. This keeps it fast to
produce and inexpensive to keep current.
## What an AI agent reads [#what-an-ai-agent-reads]
Over MCP, the graph is served as a single brief. The brief summarizes the whole
site in a few hundred lines. An agent reads that summary instead of ingesting a
full crawl. Answers stay grounded in real structure, and they cost fewer tokens.
Use **Connect AI agent** on the graph page to point a client at the MCP server.
## Grounded in verified facts [#grounded-in-verified-facts]
The graph reads from your [Knowledge](/docs/desktop/knowledge/) store. Every fact
carries a reviewed state. AI can propose entries it infers from the site, but a
proposal becomes grounding truth only after you approve it. The context stays
accurate as it grows.
## Closing the gaps [#closing-the-gaps]
The graph flags topics with no verified knowledge and lists content gaps. These
are the places where an AI answer would otherwise guess. From there you produce a
fix and apply it yourself. Draft a Knowledge entry, generate a JSON-LD block, or
write an MDX page draft.
Fill in [Knowledge](/docs/desktop/knowledge/) before relying on the graph over
MCP. The more verified facts behind it, the more specific and correct an
agent's answers become.
---
# Knowledge
URL: https://docs.digispot.ai/docs/desktop/knowledge/
Knowledge is the store of business facts — products, locations, people, policies — that grounds every AI feature and the generated llms.txt.
Knowledge is where you record the facts about your business that Spider's AI can't
infer from a crawl. It is the durable context that every AI feature and the generated
`llms.txt` are grounded in. It is authored once and reused everywhere, so you
describe your business a single time rather than re-explaining it in every prompt.
## What it holds [#what-it-holds]
You author facts grouped by category, such as:
* **Products** and services
* **Locations** and service areas
* **People** — the team, authors, and their credentials
* **Policies** — shipping, returns, guarantees, and the like
## Reviewed state [#reviewed-state]
Each entry carries a **reviewed state**, which keeps the store trustworthy over
time. Facts can also be **proposed** by AI. An analysis or an agent working
through the [MCP server](/docs/desktop/mcp/) can suggest an entry it inferred from
your site. Those proposals wait for you to accept them before they count as
Knowledge. Nothing an AI proposes becomes grounding truth until a human reviews
it, so the store stays accurate even as it grows automatically.
## Why it matters [#why-it-matters]
AI analyses, content generation, and the site's `llms.txt` all read from Knowledge.
The more complete it is, the more specific and correct the AI output becomes,
instead of guessing from page text alone. The `llms.txt` file it generates is the
emerging standard for guiding AI crawlers to your most important content. It
is only as accurate as the facts behind it.
Fill in Knowledge before running [Content gaps](/docs/desktop/content-gaps/) or
AI content workflows. Both read from it directly, so a complete store is the
difference between suggestions specific to what you sell and generic topics
inferred from page text.
---
# MCP Server
URL: https://docs.digispot.ai/docs/desktop/mcp/
Connect Claude Code, Cursor, or Windsurf to Spider's crawl data — 64 project-scoped tools, 8 packaged SEO skills, and a hard single-project boundary.
Spider runs a built-in **MCP server** so AI coding assistants can query crawl
data directly. They read audit results, issues, Google metrics, and site
structure without anything being copied out by hand.
MCP is paid-only. Scout is denied outright rather than throttled. Tracker and
Leader get unlimited calls. See [Plans & tiers](/docs/desktop/plans/).
## Project binding [#project-binding]
Every server process is locked to exactly one project. The `--project` argument
is mandatory and the server refuses to start without it. There is no mode that
reaches every project.
The binding is enforced two ways:
* **Injected, not accepted** — the bound project id is inserted into every
project-scoped tool. Tools take no `projectId` parameter, so an agent has no
field through which to name a different project.
* **Ownership-validated** — any `crawlId` or `pageId` an agent supplies is
checked server-side first. A real id belonging to another project is refused.
Call `get_mcp_scope` at the start of a session to confirm which project the
server is attached to.
## Connecting a client [#connecting-a-client]
Spider generates a ready-to-paste configuration per client. Open a project's
**Connect AI agent** action, or Settings → MCP Server, to copy the exact
snippet.
| Client | Where the config goes | Wrapper key |
| ----------------- | ----------------------------------------------------------------- | ------------ |
| Claude Code | `claude mcp add` (no file to edit) | — |
| Cursor | `~/.cursor/mcp.json` | `mcpServers` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `mcpServers` |
| VS Code (Copilot) | `.vscode/mcp.json` in the repo | `servers` |
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` | `mcpServers` |
Claude Desktop has one global config and no per-project scope, so a binding
there applies to every Claude Desktop conversation.
The desktop app must be running. The access check fails closed, so if the app
is starting or busy the tools report that the connection could not be verified
rather than silently returning empty results.
## Packaged SEO skills [#packaged-seo-skills]
The server registers 8 skills as MCP prompts. Each drives the tools below in a
set sequence, so an assistant runs a whole workflow from one instruction
instead of calling tools individually and stitching results together.
| Skill | What it produces |
| ----------------------- | ---------------------------------------------------------------------------- |
| `seo-audit` | A graded baseline and a fix plan ranked by traffic-at-risk × severity × ease |
| `seo-quick-wins` | The highest-impact, lowest-effort fixes to ship first |
| `seo-striking-distance` | A rank-gain plan from near-page-one queries |
| `seo-competitor` | A page compared head-to-head against a competitor's |
| `seo-content-strategy` | Content gaps, topic clusters, and cannibalization |
| `seo-create-content` | A draft grounded in the crawl and the Knowledge base |
| `seo-internal-linking` | Orphans, weak anchors, and a source → target link plan |
| `seo-progress-report` | Two crawls compared to prove fixes worked |
## Tool reference [#tool-reference]
The server exposes **64 tools**. They are read and safe-write only: the only
tools that change anything are the crawl controls, `run_workflow`, and the two
Knowledge proposals. No tool deletes a project or its data.
### Projects and crawls [#projects-and-crawls]
Entry points for finding a project and its crawl history.
* `list_projects` — every SEO project in Spider
* `get_project` — one project's detail and recent crawls
* `list_crawls` — crawl history with status and scores
* `get_crawl_summary` — site-wide scores, metrics, and Core Web Vitals spread
* `get_crawl_status_summary` — page counts grouped by each status enum
* `get_crawl_logs` — crawl events, warnings, and discovered URLs for debugging
### Crawl control [#crawl-control]
Start and steer a crawl. Stopping keeps everything already crawled.
* `start_crawl` — begin an audit; devices come from the project config
* `pause_crawl` — pause and keep progress
* `resume_crawl` — continue a paused crawl
* `stop_crawl` — end a crawl, retaining crawled data
* `wait_for_crawl` — block until a crawl finishes, then return final status
* `list_active_crawls` — check before starting another crawl
### Pages [#pages]
Page-level detail, from a whole report down to a single tab.
* `list_pages` — crawled pages with scores, search, sorting, pagination
* `get_page_report` — the full report for one page
* `get_page_section` — one section (metadata, headings, links, schema…)
* `get_page_category_detail` — the per-tab payload as the app renders it
* `get_page_screenshot` — the URL of a page's rendered screenshot
* `get_site_graph` — structure, depth, orphans, indexability
### Issues [#issues]
Aggregated findings, plus the catalog behind them.
* `list_issues` — issues across the site, filterable by category and severity
* `get_critical_issues` — critical and high-severity findings first
* `get_issue_pages` — every page affected by one issue type
* `get_page_issues` — every issue on one page, with fixes
* `get_quick_wins` — high-impact, low-effort improvements by ROI
* `get_broken_links` — broken links with error types and source pages
* `get_redirects` — redirects by type, including chains
* `get_duplicates` — duplicate titles, descriptions, H1s, or content
* `get_issue_definition` — one issue's severity, impact, and recommended fix
* `list_issue_definitions` — the full catalog, independent of any crawl
### Site-level checks [#site-level-checks]
Whole-site signals rather than per-page ones.
* `get_site_analysis` — robots.txt, sitemap.xml, SSL/TLS, llms.txt compliance
* `get_robots_blocked_urls` — the actual blocked URLs and top blocked paths
* `get_sitemap_coverage` — orphans, and in-sitemap-but-not-crawled URLs
* `get_project_health` — an A+–F grade blending scores, issue load, and trend
### Google data [#google-data]
Live OAuth connections and imported Search Console data.
* `get_google_metrics` — per-URL GSC or GA4 performance
* `get_gsc_import_top_pages` — top pages by clicks or impressions
* `get_gsc_import_top_queries` — top queries, site-level
* `get_gsc_sitemaps` — Google's own view of submitted sitemap health
* `get_url_inspection` — live URL Inspection: indexed state and coverage
* `list_gsc_imports` — Page-Indexing CSV imports and exclusion reasons
* `get_ga4_sections` — GA4 KPIs and section breakdowns in one call
* `get_google_search_incidents` — Search Status Dashboard incidents
### Prioritization [#prioritization]
Where traffic data turns a list of issues into an order of work.
* `get_issues_with_traffic` — issues ranked by traffic at risk
* `get_high_traffic_at_risk` — high-traffic pages that also have issues
* `get_google_opportunities` — four-layer audit, GSC, GA4 correlation
* `get_link_insights` — which pages should link to under-linked pages
* `get_content_opportunities` — new pages worth writing, with outlines
* `get_backlinks` — backlink profile and referring domains
* `get_keywords` — the keyword universe mapped onto site topics
### Trends and comparison [#trends-and-comparison]
Change over time, and across devices.
* `get_project_trends` — score trends across crawls
* `compare_audits` — two crawls side by side
* `get_audit_deltas` — new versus fixed issues since the last audit
* `get_device_comparison` — metrics across desktop, mobile, and tablet
* `get_device_url_gaps` — per-URL score gaps between devices
### Workflows [#workflows]
Spider's recipes, run from the agent. Generated images need the download tool.
* `list_workflows` — available workflows and their input specs
* `run_workflow` — run one by id; returns a `runId`
* `get_workflow_run` — poll for status and results
* `list_image_references` — Image Studio reference images and their ids
* `download_workflow_image` — save a generated image locally
Workflow image URLs carry an auth secret only the server holds. An agent must
use `download_workflow_image` rather than fetching the URL directly.
### Knowledge base [#knowledge-base]
Owner-authored business facts that ground every AI feature. Writes are
review-first by design.
* `get_knowledge` — documents, or the exact context block AI calls receive
* `propose_knowledge` — propose one document; it lands as an inactive draft
* `activate_knowledge` — activate a draft the user confirmed verbatim in chat
* `add_competitor` — track and profile a competitor from their sitemaps
`activate_knowledge` is off by default and enabled per project under Knowledge
→ "Allow AI to activate knowledge". It refuses unless the body passed matches
the stored draft exactly, so an agent cannot activate text the owner has not
seen.
### Connection [#connection]
Diagnostics. `get_mcp_status` and `get_mcp_scope` are free and never count
against usage.
* `get_mcp_status` — connection status and usage
* `get_mcp_scope` — the project this server is locked to
* `get_mcp_diagnostics` — detailed environment and connection diagnostics
---
# Pages list
URL: https://docs.digispot.ai/docs/desktop/pages/
The Pages tab lists every crawled URL with toggleable score columns and faceted filters, so you can slice a crawl any way you need.
After a crawl, the **Pages** tab lists every URL Spider found, as a sortable grid
you can filter down to exactly the pages you care about. It is the working list
for a crawl. Sort by the score that matters, filter to the pages that need
attention, and open any row for its full page report.
## Columns [#columns]
A column picker toggles which scores and stats appear, so you can build the view
that fits the task. Every column is sortable, so you can lead with the worst
pages on any axis. Sort **Content** ascending to surface the thinnest pages, or
**Depth** descending to find pages buried too far from the homepage.
* Per-category scores — **Indexability**, **Content**, **Headings**, **Media**,
**Links**, **Schema**, **Social**, **Performance**, **Local SEO**
* **Word count**, **Depth** (clicks from the homepage), **Response time**, and
**Page size**
Each category cell shows the same 0–100 score and A–F grade used across
[Checks & Scores](/docs/desktop/checks-and-scores/). A red cell points
straight at the category to open in the page report.
## Filters [#filters]
A faceted filter rail narrows the list to a subset before you start working it:
* **Severity** — critical, high, medium, low
* **Indexability** — indexable, noindex, canonicalized, robots-blocked, unreachable
* **HTTP status** — 2xx, 3xx, 4xx, 5xx
Filters combine, so you can isolate a precise cut. For example, indexable pages
returning 2xx that still carry a critical issue. Select any page to open its
[full report](/docs/desktop/reports/).
Start from the **Indexability** filter, not the scores. A page marked
`noindex`, `robots-blocked`, or `canonicalized` can't rank regardless of its
other columns. Clearing unintended exclusions comes before tuning content
or performance.
---
# Plans & Tiers
URL: https://docs.digispot.ai/docs/desktop/plans/
Scout, Tracker, and Leader — what each Digispot plan unlocks in SEO Spider, including page limits, devices, AI, MCP, and Google integrations.
Digispot has three plans. The desktop Spider is **free to start** — the **Scout**
tier runs the full crawler with a 100-page cap. Paid **Tracker** and **Leader**
raise the limits and unlock AI, MCP, and Google integrations. From Scout you can
also start a **7-day free trial** to try the paid features.
The 7-day free trial is a time-boxed **Tracker** plan you start from the free
Scout tier. When it ends you drop back to Scout unless you upgrade.
## What each plan unlocks [#what-each-plan-unlocks]
| | Scout (Free) | Tracker (Paid) | Leader (Paid) |
| ------------------------------------------------------ | ----------------------- | ----------------------- | ----------------------- |
| **Desktop Spider** | ✓ | ✓ | ✓ |
| **Pages per crawl** | 100 | 10,000 | Unlimited |
| **Concurrency** | 1 | 2 | 4 |
| **Device modes** | Mobile only | Mobile, tablet, desktop | Mobile, tablet, desktop |
| **AI analysis & copilot** | — | ✓ | ✓ |
| **MCP server** | — | ✓ | ✓ |
| **Google (GSC / GA4 / GBP)** | — | ✓ | ✓ |
| **Local-SEO business locations** | 1 | 5 | 20 |
| **Competitors tracked** | 1 · read-only | 4 | 4 |
| **Competitor cloud data** (backlinks, market standing) | — | ✓ | ✓ |
| **Free trial** | ✓ — start a 7-day trial | Included | — |
Tracker's 10,000-page cap is a finite limit. **Leader** is the only plan with
unlimited pages, higher concurrency, and the most business locations.
## Seats [#seats]
Your plan determines how many machines (seats) you can activate. A license is
bound to the hardware it is activated on; moving to a new computer frees and
re-binds a seat.
---
# SEO Recipes
URL: https://docs.digispot.ai/docs/desktop/recipes/
Build repeatable, multi-step SEO audits with Spider's workflow engine — crawl, analyze, and act in one automated run.
**SEO Recipes** is Spider's workflow engine — think "n8n for SEO." Instead of
running each step by hand, you chain crawler and AI steps into a single
repeatable workflow you can run again and again.
**Before you start:** recipes that include AI steps need an AI provider
connected first. Use either your own key (BYOK) or Digispot-managed credits. See
[AI features](/docs/desktop/ai/) to set that up. AI is available on the
**Tracker** and **Leader** plans. See [Plans & tiers](/docs/desktop/plans/).
## How it works [#how-it-works]
A recipe is a graph of steps that run in order, passing results from one to the
next. For example: crawl a site, pull the critical issues, run an AI summary,
and produce a prioritized action list. Runs are durable, so a long workflow can
resume rather than start over if it is interrupted.
## Step types [#step-types]
Steps fall into a few families, and a recipe mixes them freely:
* **Crawler steps** — crawl a site or a single page, then pull the audit data,
crawl insights, broken links, or duplicates from the result
* **AI steps** — summarize a crawl, audit or compare pages, rewrite copy, draft a
blog post, or generate a cover image
* **Data steps** — pull Google Search Console data, keyword data, or internal-link
structure into the run
* **Logic and output steps** — branch on conditions, transform values, and shape
the final output
Because steps pass their results forward, an AI step reasons over the exact data
the crawler step just produced, not a generic prompt.
## Templates and your own workflows [#templates-and-your-own-workflows]
* **Template gallery** — start from pre-built recipes for common jobs
* **My Workflows** — save and re-run your own
* **Run view** — see the workflow graph, step-by-step results, and any errors,
and compare results between runs
Recipes automate the steps *within* a single run you start: crawl, analyze,
act. They are not scheduled or triggered automatically. You run a recipe when
you want it, the same as any other crawl.
## Running from an AI agent [#running-from-an-ai-agent]
Recipes can also be run through the [MCP server](/docs/desktop/mcp/), so an AI
assistant can list and trigger your workflows and read back the results.
---
# Developers
URL: https://docs.digispot.ai/docs/developers/
Automate Digispot with the MCP server — query crawl data, trigger crawls, and wire SEO findings into AI agents and coding assistants.
Digispot exposes its crawl data programmatically through the **MCP server**.
AI agents and coding assistants query audits, start crawls, and read findings
without copy-paste.
MCP is the supported programmatic interface today. The desktop Spider and the
Cloud Platform each run their own server.
## MCP server [#mcp-server]
The MCP server lets Claude Code, Cursor, Windsurf, and any other MCP-compatible
client work directly against your crawl data. An agent can answer questions
about a site, pull the top issues from a finished audit, and generate fixes
grounded in real findings.
It comes in two forms:
* **Desktop Spider** — a local stdio server, bound per project, with 64
project-scoped tools. The agent talks straight to the on-machine crawl
database, so nothing leaves the machine.
* **Cloud Platform** — an HTTP server managed with keys created in Settings. It
reaches cloud crawls and reporting, which suits shared team projects.
See [MCP server](/docs/developers/mcp/) for setup and the tool reference.
## Which server to use [#which-server-to-use]
| Goal | Use |
| ---------------------------------------------------- | -------------- |
| Query crawl data that stays on your machine | Desktop Spider |
| Have Claude Code generate fixes from real audit data | Desktop Spider |
| Reach audits shared across a team | Cloud Platform |
| Work on client sites under NDA | Desktop Spider |
## Keys and connections [#keys-and-connections]
Cloud MCP keys are created and revoked in the Cloud Platform under Keys &
connections.
The same screen manages Chrome-extension keys and Spider desktop licenses. See
[Keys & connections](/docs/cloud/api-access/).
---
# MCP Server
URL: https://docs.digispot.ai/docs/developers/mcp/
Connect AI agents to Digispot crawl data over the Model Context Protocol — the client list, the config each one expects, and what the server exposes.
The Digispot MCP server exposes crawl data to any MCP-compatible AI client. A
connected agent queries findings, starts crawls, and drafts fixes without
anything being copied between tools.
Configuration is generated for you. Open a project in Spider and use **Connect
AI agent**, or Settings → MCP Server, then pick your client. The snippets below
show the shape so you know what you are pasting.
## Two server variants [#two-server-variants]
| | Desktop Spider | Cloud Platform |
| ------------- | --------------------------------- | ---------------------- |
| **Transport** | stdio (local process) | HTTP (remote) |
| **Scope** | One project, enforced | Cloud account |
| **Tools** | 64 | Varies by plan |
| **Auth** | `--project ` binding | API key from Settings |
| **Requires** | Spider running, Tracker or Leader | Cloud Starter or above |
Use the Desktop Spider server when crawl data lives on your machine and must
stay there. Use the Cloud server when crawls run on Digispot's servers or a
team shares access.
## Desktop Spider: local stdio server [#desktop-spider-local-stdio-server]
The server is a native binary shipped inside the app. Its filename is
architecture-specific (`mcp-macos-arm64`, `mcp-macos-x64`, `mcp-win-x64.exe`,
`mcp-linux-x64`), and the app resolves the right one for the current machine.
Every server is bound to one project. The `--project` argument takes a
**project id** and is mandatory — the server refuses to start unbound, and no
tool accepts a project id as a parameter, so an agent cannot reach another
project.
### Clients [#clients]
Each client reads a different file, and VS Code uses a different wrapper key.
| Client | Where the config goes | Wrapper key |
| ----------------- | ----------------------------------------------------------------- | ------------ |
| Claude Code | `claude mcp add` (no file to edit) | — |
| Cursor | `~/.cursor/mcp.json` | `mcpServers` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `mcpServers` |
| VS Code (Copilot) | `.vscode/mcp.json` in the repo | `servers` |
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` | `mcpServers` |
For the JSON clients the entry is the same shape. Only the wrapper key changes:
```json title="~/.cursor/mcp.json"
{
"mcpServers": {
"digispot-spider": {
"command": "/path/to/mcp-macos-arm64",
"args": ["--project", ""]
}
}
}
```
Claude Code registers stdio servers through the CLI instead of a pasted file:
```bash
claude mcp add digispot-spider --scope local -- /path/to/mcp-macos-arm64 --project
```
The `--` matters. It separates Claude's own flags from the binary's arguments;
without it `--project` is parsed by `claude` and the command fails. Run it from
inside the repo so `local` scope binds the server to that folder. Use
`--scope project` to write a committed `.mcp.json` the team shares.
Claude Desktop has a single global config with no per-project scope, so a
binding there applies to every Claude Desktop conversation. Prefer a
repo-scoped client when you work across several projects.
The server exposes **64 tools** covering crawls, pages, issues, Google data,
prioritization, workflows, and the Knowledge base, plus **8 packaged SEO
skills** registered as MCP prompts. See
[Spider's MCP server](/docs/desktop/mcp/) for the full reference.
## Cloud Platform: HTTP server [#cloud-platform-http-server]
The cloud server is reached over HTTP with a key instead of a local binary. It
queries cloud data: projects and remaining credits, audit results and top
issues, keyword and backlink data, Google metrics, and content opportunities.
Create and revoke keys under **API access** in the Cloud Platform, which also
shows the connection details for your account. See
[Keys & connections](/docs/cloud/api-access/).
A cloud key reaches your whole account. Keep it in an environment variable or
a secrets manager, never in version control.
## Why connect an agent instead of auditing with one [#why-connect-an-agent-instead-of-auditing-with-one]
A language model reading raw HTML cannot run an instrumented audit. Spider
applies **313 checks across 25 categories** to every page inside a real
Chromium browser. Much of that is measurement, not reading.
* **Rendered-DOM checks** need JavaScript to execute first. Fetched source
shows the pre-hydration markup, which is a different document.
* **Core Web Vitals** are timings. LCP, CLS, and TBT come from instrumenting a
live page load, and no amount of markup inspection produces them.
* **Device parity** means rendering the same URL at mobile, tablet, and desktop
viewports and comparing the results.
* **Site-level checks** compare pages against each other — duplicate titles,
canonical conflicts, orphan pages, crawl depth. They need the whole graph,
not one page at a time.
An agent pointed at a site fetches pages one at a time and re-derives what it
can on every run. A mid-sized site exhausts the context window before the
analysis starts, and results drift between runs because each samples a
different subset of pages.
Spider does that work first and hands over the finished report. The crawler
renders every page, runs the checks, and stores the results, so the agent
starts from a complete and settled dataset rather than assembling one.
That leaves the model doing what it is actually good at:
* **Findings arrive as structured data** — severity, affected URLs, and Google
metrics are fields to reason over, not HTML to parse.
* **One call replaces a crawl** — a single tool returns what would otherwise
take hundreds of page fetches.
* **Results are deterministic** — the checks are identical on every run, so an
agent's conclusions are reproducible.
The division of labour is the point. Spider measures; the model interprets. It
decides what to fix first, explains why a cluster of pages fails together, and
writes the fix.
## What to ask an agent [#what-to-ask-an-agent]
With a project bound, the agent works against real crawl data:
* "What are the top 10 issues by severity?"
* "Which pages fail Core Web Vitals on mobile?"
* "Show pages missing a meta description and draft one for each."
* "Start a crawl and tell me when it finishes."
* "Which pages get the most traffic but fail structured-data checks?"
The last one is where MCP earns its place. The agent pulls traffic data,
cross-references failing checks, and returns a prioritized plan in one response.
Answering it without MCP would mean exporting two reports and joining them by
hand.
---
# Integrations
URL: https://docs.digispot.ai/docs/integrations/
Connect Digispot to Google Search Console, GA4, and the MCP server so findings are ranked by real traffic and queryable by AI agents.
Digispot integrates with external data sources so findings are not just graded by
severity — they are ranked by the traffic, rankings, and coverage that actually
matter to the site.
## Google Search Console [#google-search-console]
Search Console is the highest-leverage integration. Once connected, every page's
issues are weighted by the queries and clicks that flow through it, so a broken
page on a top-ranking URL rises above a broken page on an orphan.
**What it unlocks:**
* **Clicks, impressions, CTR, and position** by query, URL, country, and device
* **URL Inspection** verdicts — live indexing status per page
* **Indexability gap** — pages that Search Console isn't indexing, correlated
against the crawl
* **High-traffic pages at risk** and **striking-distance queries**
* **Query cannibalization** detection
**How to connect on the Desktop Spider:**
1. Open the Spider app and load a project.
2. Go to **Google integrations** in the project sidebar.
3. Click **Connect Search Console** and complete the OAuth flow in the browser window
that opens. Grant at least Read permissions for the property you want to track.
4. Select the GSC property matching your project's domain. Data loads on the next crawl.
**How to connect on the Cloud Platform:**
1. Go to **Settings → Projects & Integrations**.
2. Select your project and click **Add integration → Google Search Console**.
3. Complete the OAuth flow. The property appears in the project's Google Insights
section after the next scheduled crawl.
***
## Google Analytics 4 [#google-analytics-4]
GA4 adds the engagement layer to technical findings. A page with 10,000 monthly
sessions and a broken heading structure is a higher-priority fix than the same
issue on a page with 10 sessions.
**What it unlocks:**
* **Sessions, users, and engagement** per URL
* **Traffic sources** — organic vs direct vs referral breakdown
* **Mobile vs desktop** split, so device-specific issues are prioritized against
real device traffic
**How to connect on the Desktop Spider:**
1. In the Spider project, open **Google integrations**.
2. Click **Connect GA4** and complete the OAuth flow.
3. Select the GA4 property and the data stream matching your site. The Spider
imports up to 16 months of historical data on first sync.
**How to connect on the Cloud Platform:**
1. Go to **Settings → Projects & Integrations → Integrations**.
2. Click **Add integration → Google Analytics 4**.
3. Complete the OAuth flow and select the GA4 property.
***
## Google Business Profile [#google-business-profile]
Google Business Profile (GBP) data powers the **Local SEO** checks in both the
Spider and the extension. Connecting it lets Digispot verify NAP (name, address,
phone) consistency, detect duplicate listings, and confirm opening-hours markup
against the live profile.
GBP connection is managed through the same Google OAuth flow as Search Console.
On the Desktop Spider, go to **Google integrations** and click **Connect GBP**.
On the Cloud Platform, add it under **Settings → Projects & Integrations**.
***
## MCP server [#mcp-server]
The MCP server is the integration for AI assistants and coding tools. It lets
Claude Code, Cursor, or Windsurf query your crawl data directly — so an agent
can pull the top issues, start a crawl, or surface content opportunities without
any copy-paste.
The MCP server comes in two forms:
* **Desktop Spider** — a local stdio server, bound per project, with 64 tools.
See [MCP server docs](/docs/desktop/mcp/).
* **Cloud Platform** — an HTTP server with API keys managed under Settings.
See [Keys & connections](/docs/cloud/api-access/).
For setup instructions and a tool reference, see [MCP server](/docs/developers/mcp/).
***
## Which integrations are available per product [#which-integrations-are-available-per-product]
| Integration | Chrome extension | Desktop Spider | Cloud Platform |
| ----------------------- | --------------------------------------- | ----------------------- | ----------------------- |
| Google Search Console | Via Extension Key (CrUX/PageSpeed only) | Full OAuth, per project | Full OAuth, per project |
| Google Analytics 4 | — | Full OAuth, per project | Full OAuth, per project |
| Google Business Profile | — | Full OAuth, per project | Full OAuth, per project |
| MCP server | — | stdio, 64 tools | HTTP, via API key |
---
# Guides
URL: https://docs.digispot.ai/docs/guides/
Task-focused walkthroughs for common SEO work in Digispot — on-page fixes, crawl errors, structured data, and Core Web Vitals across all three products.
Practical walkthroughs for the SEO tasks you run most often. Each guide notes
which product to use for each step and when it makes sense to escalate from
a single-page check to a whole-site crawl.
## Choosing the right tool for the task [#choosing-the-right-tool-for-the-task]
| Task | Best surface |
| --------------------------------- | --------------------------------------------------------------------------- |
| Audit a single page quickly | [Chrome extension](/docs/chrome-extension/) |
| Check a competitor's page | [Chrome extension](/docs/chrome-extension/) |
| Find issues across a whole site | [SEO Spider](/docs/desktop/) |
| Prioritize by real traffic | [SEO Spider + GSC](/docs/desktop/google/) or [Cloud Platform](/docs/cloud/) |
| Share audits with a team | [Cloud Platform](/docs/cloud/) |
| Query crawl data from an AI agent | [MCP server](/docs/developers/mcp/) |
***
## On-page SEO fixes [#on-page-seo-fixes]
On-page issues — missing title tags, duplicate meta descriptions, thin content,
broken heading structure — appear at the page level in all three products. The
workflow below applies wherever you find them.
**1. Spot the issue.**
In the Chrome extension, open a page and click the **Metadata/Technical** or
**Content** panel. The panel lists every check in that category with a pass/fail
badge and a one-line reason. On the Spider or Cloud Platform, open a page report
and navigate to the relevant category tab.
**2. Understand the impact.**
Before fixing, check the **Overview** tab. If the extension is connected to a
Digispot account, or the Spider has GSC linked, pages with failing checks are
ranked by organic traffic so you fix the highest-impact ones first.
**3. Make the fix.**
For headings, the Chrome extension lets you edit live: click **Apply** next to
any heading change to update the element in the DOM and see the revised score
immediately. For title and description changes, the edit happens in your CMS or
HTML — the extension shows a real-time preview in the **SERP preview** section.
**4. Confirm the change.**
After deploying, reload the page and run the extension again. The score for that
category should update to reflect the fix. On the Spider, run a re-crawl or
re-audit of the affected URL to verify.
**5. Sweep the site.**
A fix on one page rarely stands alone. On the Spider, use **Issues → filter by
check name** to find every other page with the same problem and batch the work.
On the Cloud Platform, the audit report groups identical issues across all URLs
in one view.
***
## Fixing crawl errors [#fixing-crawl-errors]
Crawl errors fall into three types: broken links (4xx), redirect problems (chains
or loops), and blocked pages (robots.txt, noindex). The Spider is the primary
tool here because it finds these across an entire site in one pass.
**Broken links (404s)**
1. Run a Spider crawl with JS rendering enabled so dynamically inserted links are
caught. After the crawl, open **Issues → Links → Broken links (4xx)**.
2. Each broken link shows the source page and the broken destination URL. Fix by
updating the link in your CMS, or add a 301 redirect on the server if the
destination URL has changed permanently.
3. After fixing, re-crawl to confirm the issue count drops. The Spider's
**Comparison** view overlays two crawls so regressions are visible at a glance.
**Redirect chains and loops**
1. In **Issues → Links → Redirect chains**, the Spider lists every multi-hop
redirect. A chain of three or more hops loses link equity at each hop and
slows page load.
2. Collapse each chain to a single 301 pointing directly to the final URL.
3. Redirect loops (A→B→A) appear in **Issues → Links → Redirect loops** — they
cause crawlers to abort and users to see a browser error. Fix by correcting
one of the redirect rules on the server.
**Blocked pages**
1. Open **Issues → Technical → Blocked by robots.txt** and **Blocked by noindex**.
These are pages the crawler found but that Googlebot cannot index.
2. Cross-reference with GSC data (if linked) to find blocked pages that are
actually receiving traffic — a sign of a misconfigured rule rather than an
intentional block.
3. Fix robots.txt errors by editing the rule in your server config. Fix noindex
errors by removing the meta tag or the `X-Robots-Tag` header.
***
## Structured data [#structured-data]
Structured data (schema markup) helps search engines understand page content and
enables rich results — FAQ accordions, product ratings, recipe cards, and
breadcrumbs in the SERP. The extension validates markup at the page level; the
Spider sweeps the site.
**Validate a single page**
1. Open the page in Chrome, click the extension icon, and open the **Schema**
panel. The panel lists every detected schema type (e.g. `Article`,
`Product`, `FAQPage`) with a pass/fail status for each required and
recommended property.
2. Warnings in orange are missing recommended properties — rich results are
possible but may not show. Errors in red are missing required properties —
the type is invalid and will not produce a rich result.
3. Use the one-click **AI Audit** on the Schema panel to get a specific,
actionable fix for each error, including the corrected JSON-LD snippet.
**Find schema errors across a site**
1. On the Spider, run a crawl and open **Issues → Schema**. Errors are
grouped by check — for example, "Article: missing `datePublished`" — across
all affected pages.
2. Fix the template or CMS field that generates the markup rather than editing
pages one by one. After deploying, re-crawl to confirm.
3. For sites with many schema types (e.g. an e-commerce site with thousands of
`Product` pages), use the Spider's AI tab to generate a bulk fix plan
targeting the highest-priority issue first.
**Verify in Search Console**
After fixing, submit updated URLs through Google Search Console's URL Inspection
tool to request re-indexing and confirm the rich result is eligible.
***
## Core Web Vitals [#core-web-vitals]
Core Web Vitals (CWV) — **LCP** (Largest Contentful Paint), **CLS**
(Cumulative Layout Shift), and **INP** (Interaction to Next Paint) — are
Google's user-experience ranking signals. Poor scores can suppress rankings even
when technical SEO is otherwise clean.
**Diagnose a single page**
1. Open the page and click the **PageSpeed** panel in the Chrome extension. The
panel shows both **Lab data** (Lighthouse, run on demand) and **Field data**
(CrUX, real-user data from Chrome).
2. Field data requires a Digispot Extension Key — it reflects actual user
experience. Lab data is available without a key and is useful for debugging
but does not match what Google sees in the field.
3. Each failing metric shows the contributing elements: the LCP element (usually
a hero image or above-fold text), the CLS-causing shift (often a banner,
late-loading font, or ad slot), or the INP trigger (a slow event handler).
**Fix LCP**
* Preload the LCP element using `` for images.
* Serve images in modern formats (WebP, AVIF) sized to the render dimensions.
* Use a CDN to reduce server response time. Target LCP under 2.5 s.
**Fix CLS**
* Set explicit `width` and `height` attributes on all `` elements.
* Reserve space for ad slots, embeds, and banners using `min-height`.
* Avoid inserting content above existing content after page load. Target CLS under 0.1.
**Fix INP**
* Break up long tasks (over 50 ms) using `setTimeout` or the Scheduler API.
* Defer non-essential JavaScript. Target INP under 200 ms.
**Find CWV failures across a site**
On the Spider (Tracker or Leader plan), the **Devices** report shows CWV scores
per page, per device type. Filter by **Failing** to see the full list. The Cloud
Platform surfaces the same data aggregated with GSC traffic so the most-visited
failing pages sort to the top.
---
# Troubleshooting
URL: https://docs.digispot.ai/docs/troubleshooting/
Fixes for common problems across the Chrome extension, SEO Spider desktop app, and Cloud Platform.
Problems are grouped by product. If the issue crosses products — for example,
a Google connection problem — check both the desktop and cloud sections.
## Chrome extension [#chrome-extension]
### The extension shows no results [#the-extension-shows-no-results]
Check that you are on an `http://` or `https://` page — browser-internal pages
like `chrome://` and `edge://` cannot be audited. Confirm the extension is
enabled at `chrome://extensions`.
### The extension asks to allow access [#the-extension-asks-to-allow-access]
The extension needs one-time host permission for the site. Select **Allow &
analyze** in the prompt. In fullscreen mode this appears the first time per
domain; in popup mode it is handled automatically.
### AI Audit button says "Unlock AI Audit" [#ai-audit-button-says-unlock-ai-audit]
No AI provider is connected. Go to **Config → AI Provider**, select a provider,
paste your API key, and save. See [Connecting an AI model](/docs/chrome-extension/ai-setup/).
### CrUX, PageSpeed, or Domain Age says "Connect to unlock" [#crux-pagespeed-or-domain-age-says-connect-to-unlock]
These lookups require a Digispot Extension Key. Go to **Config → Account** and
connect your key. See [Managed AI](/docs/chrome-extension/extension-key/).
### SERP mode does not activate on Google [#serp-mode-does-not-activate-on-google]
Check that you are on one of the 17 supported Google country domains (`.com`,
`.co.uk`, `.de`, and others). Other search engines are not supported.
See [SERP Intelligence](/docs/chrome-extension/serp-intelligence/).
***
## SEO Spider — desktop app [#seo-spider--desktop-app]
### Crawl finds only one page [#crawl-finds-only-one-page]
The site is blocking crawlers in `robots.txt`, or the homepage has no crawlable
internal links. Open the Technical tab on the homepage report and check the
robots.txt and crawlability signals.
### Crawl is very slow [#crawl-is-very-slow]
Lower the concurrency in crawl settings. Some servers rate-limit aggressive
crawlers, which shows up as slow responses rather than errors.
### Desktop app will not open on macOS [#desktop-app-will-not-open-on-macos]
Gatekeeper blocks the first launch. Open **System Settings → Privacy &
Security** and select **Open Anyway**. See [Install the desktop app](/docs/desktop/install/).
### License will not activate [#license-will-not-activate]
Activation requires an internet connection even though crawling itself works
offline. If you are behind a corporate proxy, allow `api.digispot.ai`. Also
confirm the system clock is correct — clock skew fails the license signature
check.
### AI features show a lock or upgrade prompt [#ai-features-show-a-lock-or-upgrade-prompt]
AI analysis requires the **Tracker** or **Leader** plan. The free **Scout** tier
does not include AI. See [Plans & tiers](/docs/desktop/plans/).
### MCP server will not start [#mcp-server-will-not-start]
The server requires a project binding. Copy the configuration from the Spider
app — **Connect AI agent** or **Settings → MCP Server** — rather than writing
it by hand. See [MCP server](/docs/desktop/mcp/).
***
## Cloud Platform [#cloud-platform]
### Audit run stays queued or fails immediately [#audit-run-stays-queued-or-fails-immediately]
Check the audit configuration has a valid root URL and at least one reachable
page. If the root URL returns a 4xx or 5xx, the run will fail to start.
See [Audits & reports](/docs/cloud/audits/).
### Google Insights shows no data [#google-insights-shows-no-data]
The Google integration may need reconnecting. Go to **Settings → Projects &
Integrations → Integrations** and check the connection status. If it shows
"Credentials invalid", re-run the OAuth flow.
See [Settings](/docs/cloud/settings/).
### Content Studio is not available [#content-studio-is-not-available]
Content Studio requires the **Starter** plan or above — it is blocked on the
**Free** plan. See [Plans & billing](/docs/cloud/billing/).
### AI credits ran out mid-task [#ai-credits-ran-out-mid-task]
AI and Data credits are separate pools. Running out of AI credits stops AI
generation but not keyword or backlink lookups. Check both balances under
**Settings → Usage & Analytics**. See [Plans & billing](/docs/cloud/billing/).
### Invited team member cannot see a screen [#invited-team-member-cannot-see-a-screen]
Check the member's role. **Specialist** can create and manage projects and
audits. Admin-only screens — Billing, User Management, Chrome Extension, MCP
Server, and Spider License — are hidden from Specialists.
See [Teams & roles](/docs/cloud/teams/).
---
# Content
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/content/
The Content panel measures the depth, readability, and topical relevance of a page's writing across three sub-tabs.
The Content panel assesses how well a page's writing serves its intent. It looks
at length, readability, and topical coverage across three sub-tabs. A title and
metadata audit can't tell you whether the page has enough substance, whether it
reads clearly, and whether it stays on topic enough to satisfy the query and earn
a ranking. This panel does. Thin or off-topic copy is a common reason a
technically clean page still fails to rank.
## Content analysis [#content-analysis]
The default sub-tab reports the fundamentals: **word count**, **reading time**,
**readability** (Flesch reading ease and grade level), and paragraph and sentence
metrics. It then grades the page against the length bands below.
| Band | Word count | What it means |
| ------------------ | ---------- | ------------------------------------------------------------------------------------------------ |
| **Extremely thin** | under 100 | Flagged as **Critical: Extremely thin content** — too little text to establish topical relevance |
| **Thin** | under 300 | Flagged as **Warning: Thin content detected** — usually below what ranks for a competitive query |
| **Adequate** | 300–600 | Passes the minimum, but often short of the depth top results carry |
| **Optimal** | 600–2,500 | The target range for most informational and commercial pages |
| **Long** | over 5,000 | Long-form; check that it stays focused rather than padded |
Word count is not a ranking factor on its own. The goal is enough depth to cover
the topic. Use the flags to spot pages too thin to compete. Then add the sections,
examples, and answers a searcher expects, rather than padding to hit a number.
**Readability** reports the Flesch reading ease score and its grade level. A lower
grade level (roughly grade 8–10 for a general audience) widens the readership.
Very high grade levels signal dense sentences worth breaking up.
## Keywords & focus [#keywords--focus]
The second sub-tab surfaces what the page is about. This makes any mismatch
between the intended topic and the terms actually emphasized visible.
* **Industry detection** — primary and secondary industries with a confidence score
* **Focus keywords** — target terms pulled from the title, URL, headings, and meta
* **Content relevance** — n-gram analysis toggled between unigrams, bigrams, and
trigrams, with frequency, relevance, and density
* **Related keywords & entities** — business entities, people, and locations
Keyword density has its own dedicated panel with deeper analysis. See
[Keywords](/docs/chrome-extension/audit-categories/keywords/).
## Authority & SERP [#authority--serp]
The third sub-tab covers trust and ranking potential. These are the signals that
decide whether a page is treated as a credible answer, not just a relevant one.
* **Performance metric cards** — a snapshot of the page's content scores
* **Content topics & coverage** — the subtopics the page addresses versus those a
query typically expects, so gaps are visible
* **Authority & trust** — an E-E-A-T assessment (experience, expertise,
authoritativeness, trust) that flags missing author, source, or credibility
signals
* **Featured-snippet opportunities** — passages structured well enough to win a
snippet, and how to tighten them
Work the sub-tabs in order. Fix length and readability first (Content
analysis). Next, confirm the page targets the right terms (Keywords & focus).
Then close topic and trust gaps (Authority & SERP). Adding depth to a page that
already targets the wrong topic wastes the effort.
---
# Headings
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/headings/
The Headings panel validates the H1–H6 outline and can rewrite headings with AI, applying accepted changes live on the page.
The Headings panel maps the page's H1–H6 outline, flags structural problems, and
can generate AI rewrites you apply directly on the live page. Headings are how
search engines and screen readers parse a page's structure, and how a searcher
scans it. A broken outline weakens topical signals and accessibility at once, so
it is one of the faster on-page fixes to make.
## Headings overview [#headings-overview]
The panel opens with a **Headings Overview**: a count of how many headings sit at
each level H1–H6, an overall **Structure** score, and a list of the issues found.
Each level is marked **Good**, **Multiple**, or **None**, so a missing H1 or a
stack of H1s stands out at a glance.
The structural faults it flags:
* **Missing H1**, **multiple H1s**, or **skipped levels**. Every page should have
exactly one H1, and levels should descend in order (an H2 followed by an H4
skips a level and breaks the outline)
* **Empty** or **duplicate** headings. Headings with no text carry no signal, and
identical headings blur the page's structure
* **Over-optimized** headings: keyword stuffing, which reads as spam rather than
as a clear label
* **Keyword distribution** across the outline, so the topic is reinforced in
headings rather than buried in body text
## Heading structure [#heading-structure]
Below the overview, every heading is listed in its natural order of appearance,
with its level, position, and text.
Headings are also checked for length. A heading past the warning threshold is long
enough to read as a sentence rather than a label. Past the error threshold, it is
almost certainly too long to scan.
| Level | Warning above | Error above |
| ------ | ------------- | ----------- |
| **H1** | 50 chars | 100 chars |
| **H2** | 60 chars | 120 chars |
| **H3** | 70 chars | 140 chars |
| **H4** | 80 chars | 160 chars |
| **H5** | 90 chars | 180 chars |
| **H6** | 100 chars | 200 chars |
## AI recommendations [#ai-recommendations]
Switching on **AI headings recommendations** turns the panel from an audit into a
rewrite tool. Pick the detected **industry** (with a confidence badge) and
**intent**, then generate optimized alternatives. They appear side by side with
the originals.
* **Accept** or **Reject** each suggestion. You can also drive this from the
on-page badges
* **Apply selected** writes the accepted headings **live into the page** (this
needs one-time access to the current site)
* **Accept all**, **Reject all**, or **Reset** to restore the originals
* Export the headings and recommendations as **CSV**
Applying a heading edits the live page in your browser for preview. It does
not change the published site. To make it permanent, update your CMS.
---
# Images
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/images/
The Images panel audits alt text, formats, file size, and lazy loading, with filters for the images that need attention.
The Images panel lists every image on the page and flags the issues that hurt
accessibility, search, and load speed. Images are usually the largest bytes on a
page, so they drive load time and Largest Contentful Paint. Their alt text is both
an accessibility requirement and the main way image search understands them. This
panel finds the images working against all three.
## Overview [#overview]
The panel opens with an **Images Overview**: scorecards that summarize the page's
image health before you drill into individual files.
* **Alt text**: how many images carry alt text
* **Dimensions**: how many declare explicit width and height, since missing ones
cause layout shift
* **Optimized**: how many use a modern, appropriately compressed format
* **SEO Health**: an overall score that rolls the cards above together
The total **page weight** contributed by images is reported here too, so the size
cost and its effect on **LCP** is visible at a glance.
## Filtering and export [#filtering-and-export]
Filter tabs, each with a count, narrow the list. **Export CSV** includes the
URL, alt, type, element tag, width, height, file size, format, status, and
lazy-loaded flag for a full audit trail.
* **All**: every image on the page
* **No ALT**: images missing alt text
* **No size**: images with no explicit width or height (a cause of layout shift)
* **Large**: oversized files for their dimensions
## Per-image detail [#per-image-detail]
Each image card shows a thumbnail and the checks that matter.
* **Alt** text, with a **Missing!** flag when absent. Alt text is required for
accessibility and is how image search reads the image. Decorative images should
carry empty alt, and content images descriptive alt
* **Size** and **Format**. WebP and AVIF compress far smaller than JPEG or PNG at
the same quality, so the panel recommends them over older formats
* A green **Lazy** badge when lazy loading is used, which defers off-screen images
so they don't block the initial load
* An overall **Error / Warning / OK** status and the specific issues
File size is judged by **bytes per pixel**. A large image is only flagged when
it's heavy for its dimensions, rather than by absolute size. Modern formats are
held to a stricter bar than legacy ones.
| Format | OK | Warning | Error |
| ----------------- | ------------------ | ------- | -------- |
| **WebP / AVIF** | under 0.8 bytes/px | 0.8–1.5 | over 1.5 |
| **JPEG / legacy** | under 1.0 bytes/px | 1.0–2.0 | over 2.0 |
Fix the largest images above the LCP fold first. Converting a hero image to WebP
or AVIF and setting explicit width and height often improves both LCP and CLS in
one change.
---
# Audit categories
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/
The on-page auditor groups 150+ checks into categories — one panel per area of SEO. This section documents each category, plus the cross-cutting checks.
When you audit a page, the 150+ checks are grouped into categories, one panel per
area of SEO. Open a category to see its checks, filters, and export options. Every
panel also has a one-click **AI Audit** that turns its raw results into
prioritized recommendations.
The AI Audit button is optional, and every check runs without it. The button
reads **Unlock AI Audit** until you [connect an AI model](/docs/chrome-extension/ai-setup/).
After that, it becomes the category-specific action (for example *AI Schema Audit*).
These 150+ checks run on the page you are viewing. **SEO Spider** extends the
same audit to **300+ checks per page** across every URL on a site. A
template-level problem then shows up everywhere it occurs, not just where you
looked.
## Each category in detail [#each-category-in-detail]
***
# Cross-cutting checks [#cross-cutting-checks]
These are audited too. They surface within the categories above rather than as
panels of their own.
## Indexability & discoverability [#indexability--discoverability]
Whether search engines can reach and index the page at all:
* **robots.txt validation** — blocked pages, disallowed paths, syntax errors
* **sitemap.xml detection** — presence and accessibility
* **Meta robots tags** — `noindex`, `nofollow`, `noarchive`
* **Canonical URLs** — ensures Google indexes the right version
* **X-Robots-Tag HTTP headers** — server-level directives
* **User-agent blocking** — detects if Googlebot or other crawlers are blocked
* **Crawl accessibility** — JavaScript-dependent content that may not be crawled
Indexability problems outrank everything else in severity. A page that cannot
be indexed cannot rank, however good the rest of its SEO is.
## Mobile SEO [#mobile-seo]
* Viewport meta tags
* Mobile-friendly fonts and touch-target sizes
* Core Web Vitals on mobile
* Responsive image optimization
* Mobile usability issues affecting Google's mobile-first index
Comparing mobile against desktop by hand, page by page, gets slow fast. **SEO
Spider** crawls in **mobile, tablet, and desktop** modes in a real Chromium
browser. It reports scores for each mode per crawl.
## AEO — answer engine optimization [#aeo--answer-engine-optimization]
AEO is optimization for AI platforms such as ChatGPT, Perplexity, Claude, and
Gemini. The extension checks:
* Structured content formatting
* Clear question-and-answer patterns
* Entity recognition
* Topical authority signals
* Content scannability
---
# Keywords
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/keywords/
The keyword analysis surfaces the terms a page ranks for — density across one-, two-, and three-word phrases, related entities, and authority correlation.
Keyword analysis shows which terms a page actually emphasizes and how they relate
to what already ranks. It lives in the Content panel's **Keywords & focus**
sub-tab. It turns the raw text into ranked phrases. This makes the gap between the
term a page is meant to rank for and the term it actually reinforces visible,
before that gap costs a ranking.
## Keyword density [#keyword-density]
Density is analyzed across **unigrams (1-word)**, **bigrams (2-word)**, and
**trigrams (3-word)** phrases. Each phrase shows its frequency, relevance, and
density, so both primary terms and long-tail phrases are visible. Toggle the
n-gram length to move between broad head terms (unigrams) and the specific phrases
searchers type (bigrams and trigrams).
Density matters in both directions. Too low, and the page reads as off-topic for
its target term. Too high, and it reads as stuffed, which no longer helps and can
hurt. There is no single ideal percentage. Read density alongside relevance
rather than chasing a fixed number.
Density is a diagnostic, not a target to hit. Modern ranking weighs topical
coverage and entities over exact-match repetition. Use these numbers to catch a
page that never mentions its own topic, not to tune to a percentage.
## Focus keywords [#focus-keywords]
The panel combines your focus terms with where they come from: **title tag**,
**URL**, **headings (H1–H6)**, and **meta description**. This makes a target
term's presence across every high-weight element visible at a glance. A term that
appears in the body but is missing from the title or H1 is under-reinforced.
Adding it to those elements is one of the higher-leverage on-page fixes.
## Related keywords & entities [#related-keywords--entities]
Beyond exact phrases, the panel detects **related keywords**, **LSI variations**,
and named **entities** — organizations, people, and locations. Each comes with an
entity count and relevance percentage. Covering the entities and related terms a
topic implies is how a page demonstrates depth to search engines and reinforces
E-E-A-T signals, rather than repeating one keyword.
## Authority & SERP correlation [#authority--serp-correlation]
Significance scoring ranks each term by likely impact. Authority signals show how
the page's coverage compares against what ranks for the query. The significance
grade sorts terms into four bands, so effort lands on the phrases that move
rankings.
| Grade | Meaning |
| ------------- | ---------------------------------------------------------------- |
| **Excellent** | Highest-significance terms; the page's strongest topical signals |
| **Good** | Solid supporting terms that reinforce the topic |
| **Fair** | Present but weak; worth strengthening if it's a target term |
| **Low** | Minor or incidental terms; usually noise, not a priority |
---
# Links
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/links/
The Links panel breaks down internal, external, and other links with anchor text, rel attributes, and CSV export.
The Links panel inventories every link on the page and how it is built: anchor
text, rel attributes, and destination. This puts internal structure and outbound
signals in one place. Links carry ranking equity between pages and tell search
engines how a site is organized. Anchor text tells them what the linked page is
about. Getting this right spreads authority to the pages that need it.
## Link stats [#link-stats]
A summary bar shows the totals: **internal**, **external**, and **other** links
(mailto, tel, anchors). It also gives a follow versus **nofollow** breakdown for
internal and external links separately.
Reading the split matters. Internal links should almost always be followed, so
they pass equity through the site. A **nofollow** on an internal link usually
wastes that equity. External nofollows are normal and appropriate for untrusted
or paid destinations.
## Filtering and export [#filtering-and-export]
Filter tabs, each with a count, narrow the list. **Export CSV** saves the full
set for a spreadsheet or a developer handoff.
* **All**: every link on the page
* **Internal links**: same-site destinations
* **External links**: off-site destinations
* **Other links**: mailto, tel, and in-page anchors
## Per-link detail [#per-link-detail]
Each row shows the specifics that matter for SEO.
* **Anchor text**, or a **No text** flag when it is missing. Descriptive anchor
text is a ranking signal for the destination. Generic anchors ("click here") and
empty ones waste it
* The full **URL**, with an external-link marker
* **rel** and **target** attributes, and a **nofollow** badge. This makes a link
that silently blocks equity easy to spot
* **Link depth** (for internal links) and **HTTPS / HTTP**. An HTTP link on an
HTTPS page is a mixed-content and trust problem
Scan for internal links carrying a nofollow badge and for internal links with
no anchor text first. Both quietly waste link equity you have already paid for,
and both are cheap to fix.
---
# Local SEO
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/local-seo/
The Local SEO panel checks NAP consistency, LocalBusiness schema, and location signals — and only applies its advice to genuinely local pages.
The Local SEO panel audits the signals that affect local pack and map visibility.
Those are the results that appear with a map and pins above the standard listings
for a location-based query. The panel is relevance-gated. Global or SaaS pages are
not scored against local-only criteria, so they don't collect irrelevant warnings.
## Relevance gate [#relevance-gate]
The panel first decides whether local advice even applies, which keeps its scoring
honest.
* Pages with no local signals show a **Local SEO data unavailable** state rather
than failing checks that don't apply
* Borderline pages get a soft "possibly local" banner. It explains the positive and
negative signals behind the call, and you can override it when the classification
is wrong
## Snapshot [#snapshot]
For pages that are local, the panel opens with a **Local SEO Snapshot**: status
cards that summarize local readiness at a glance before the detailed checks below.
* **NAP** — whether Name, Address, and Phone are complete
* **Maps** — whether a map is embedded and linked
* **Schema** — whether LocalBusiness schema is present
* **Reach** — the service area detected for the page
## What it checks [#what-it-checks]
Below the snapshot, the detailed checks follow the order the panel presents them.
* **Business information (NAP)** — Name, Address, and Phone, plus email and hours,
with a consistency check. NAP consistency is a core local ranking factor. The
same details must match across the site, schema, and Google Business Profile, or
the signal is diluted
* **Google Business & Maps** — Place ID and map signals (business profile, map
embed, and Maps link) that tie the page to a verified listing
* **Local keywords** — city and state terms, service-area keywords, and their
coverage across the title, headings, and body
* **LocalBusiness schema** — hours, price range, service area, and geo coordinates.
These help Google connect the page to a physical location and can drive rich
results
NAP consistency is the highest-leverage fix here. Before adding keywords or
schema, confirm the name, address, and phone match exactly across the page, the
LocalBusiness schema, and the Google Business Profile. A mismatch undercuts
every other local signal.
---
# Metadata
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/metadata/
The Metadata panel audits the title, description, and technical tags that decide how a page is indexed and shown in search results.
The Metadata panel covers the tags that control how a page is indexed and how it
appears in search. This includes the title and description a user sees in the
results, plus the technical directives that decide whether the page can be
indexed at all. It's the first place to look when a page ranks poorly despite
good content. A single wrong tag here can suppress everything else.
## AI Audit [#ai-audit]
The **AI Metadata Audit** button sits at the top of the panel. Until you connect
a provider, it reads **Unlock AI Audit**.
Run it, and it reviews your metadata and returns three sections:
* **What's working**
* **Needs improvement**
* **Quick wins**
Below the review, it suggests **SERP rewrites**: alternative titles and meta
descriptions. Each one has a live character count and a one-click copy. Paste a
fix straight into your CMS.
## Basic meta [#basic-meta]
The core card lists each tag with a **pass / warning / fail** status and a
character count. Read it top to bottom, in the order the panel presents it. The
title and description carry the most weight, since they're what a searcher
actually sees.
At the very top sits **Domain age**: how long the domain has been registered,
shown as an E-E-A-T trust signal (for example, *2y 8m, Established*). Fetching it
is a server-side lookup, available with a free
[Extension Key](/docs/chrome-extension/extension-key/).
### Title and description [#title-and-description]
| Tag | Optimal length | Why it matters |
| -------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Title** | 50–60 characters | The strongest on-page ranking signal and the clickable headline in results. Too long and Google truncates it; too short and you waste the space. |
| **Meta description** | \~120–160 characters | Doesn't rank the page, but a sharp description lifts click-through. Google rewrites weak or missing ones, so you lose control of the snippet. |
The panel also checks **keyword placement**: whether the primary term appears
near the front of the title, where it carries the most weight.
### Canonical and URL [#canonical-and-url]
* **URL**: flagged for length and readability
* **Canonical URL**: the panel marks it as **self-referencing** (the healthy
default), **different**, or **missing**. A **different** canonical means the
page points elsewhere. That is correct for duplicates, but a problem if it's
unintentional. A wrong canonical is one of the most common causes of a page
silently dropping out of the index.
### Language and internationalization [#language-and-internationalization]
* **Language**: the declared `lang` attribute checked against the language
actually detected on the page, plus BCP-47 validity. This catches a mismatch,
for example `en` markup on French content.
* **Alternate pages (hreflang)**: the locale count and sample codes, including
`x-default`
### Everything else [#everything-else]
* **Character set**, **Author & publisher**, and **Mobile optimization** (the
viewport tag, required for mobile-first indexing)
* **Built with**: the detected technology stack, including frameworks, CMS,
analytics, CDN, and more
* **Site icon (favicon)**: type, sizes, and any issues. The favicon now shows
next to your result on mobile.
Expanding **All meta tags** lists every tag the page declares, verbatim: viewport,
charset, description, keywords, robots, Open Graph, and the rest. Use it to spot a
stray or conflicting directive that the summarized rows above don't call out.
## Indexation [#indexation]
A dedicated card states plainly whether the page is **indexable**. It breaks the
verdict into the two signals that decide it:
* **Meta robots**: the `` directive (`index`/`noindex`,
`follow`/`nofollow`)
* **X-Robots-Tag**: the same controls, but set as an HTTP header at the server
Seeing them separately matters. A page can look fine in its HTML while an
`X-Robots-Tag: noindex` header quietly blocks it. That's a problem you can't spot
by viewing source.
Indexation outranks everything else on this panel. A page set to `noindex`
cannot rank, no matter how strong its title, content, or links are. Clear any
unintended `noindex` before optimizing anything else.
## Discovery files [#discovery-files]
Checks the files that tell crawlers what exists and what to fetch: **robots.txt**
(crawl rules), **sitemaps** (the list of URLs to discover), and **llms.txt /
llms-full.txt / ai.txt**. The last group is the emerging set of files that guide
AI crawlers to your most important content.
## Crawlability & bot access [#crawlability--bot-access]
Shows which crawlers can actually reach the page: **Googlebot**, **Bingbot**,
**GPTBot**, **Claude-Web**, **PerplexityBot**, and others. Each one is marked
**allowed**, **blocked**, or **restricted**.
This is where you catch a page that's accidentally blocking AI crawlers in
`robots.txt`. That's increasingly costly as ChatGPT, Perplexity, and Gemini send
real traffic and citations.
Work this panel in order of leverage: fix indexation blockers first, then the
title, then the canonical, then the description. The first three decide whether
the page ranks. The description decides whether people click.
---
# PageSpeed
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/pagespeed/
The PageSpeed panel reports Core Web Vitals from three sources — live in-browser, lab, and real-user field data — plus resource hints.
The PageSpeed panel (labelled **Speed**) reports Core Web Vitals and performance.
It splits the data across four sub-tabs, so you can compare the numbers a lab, a
browser, and real users each report side by side. Core Web Vitals are a confirmed
ranking factor. More importantly, they measure the load and interaction experience
that decides whether a visitor stays. The three data sources answer different
questions: what one test just measured, what real users experience, and what a
controlled synthetic run finds.
## Live [#live]
The default sub-tab measures Core Web Vitals **live in the browser** using the
Performance API: **FCP**, **LCP**, **INP**, **CLS**, and **TTFB**. It works on
any URL. Measuring the current page needs one-time access to the site. Each metric
is rated against Google's thresholds below.
| Metric | Good | Needs improvement | Poor |
| -------------------------- | -------- | ----------------- | --------- |
| **LCP** (loading) | ≤ 2.5 s | 2.5–4.0 s | > 4.0 s |
| **INP** (interactivity) | ≤ 200 ms | 200–500 ms | > 500 ms |
| **CLS** (visual stability) | ≤ 0.1 | 0.1–0.25 | > 0.25 |
| **FCP** (first paint) | ≤ 1.8 s | 1.8–3.0 s | > 3.0 s |
| **TTFB** (server response) | ≤ 800 ms | 800–1800 ms | > 1800 ms |
LCP, INP, and CLS are the three Core Web Vitals Google uses. FCP and TTFB are
supporting diagnostics that usually explain a poor LCP. Live is a single sample on
the current device and connection. Treat it as a fast directional read rather
than the number Google scores the page on.
## CrUX [#crux]
The **CrUX** sub-tab shows real-user field data (28-day, 75th-percentile) for
**mobile** and **desktop**, drawn from the Chrome User Experience Report. This is
the closest view to what Google actually scores, because it reflects real visitors
on real devices rather than one test. It requires a connected Digispot account.
See [Managed AI](/docs/chrome-extension/extension-key/).
## Lab test [#lab-test]
The **Lab test** sub-tab runs a Lighthouse test through PageSpeed Insights. It
returns mobile and desktop performance scores with the full metric set. Lab data
is reproducible and useful for debugging a fix. Lighthouse simulates a
throttled mid-range mobile device. A low mobile score next to a high desktop score
usually reflects the simulated conditions, not two broken pages. Lab test also
requires a connected Digispot account.
## Resource hints [#resource-hints]
The **Resource hints** sub-tab scans the page's HTML, with no external call, for
the hints that speed up resource loading. It also adds a script analysis and
performance insights.
* **`preload`**: fetches a critical resource (a hero image or font) early to
improve LCP
* **`preconnect`**: opens a connection to a third-party origin ahead of need
* **`dns-prefetch`**: resolves a third-party domain's DNS early
* **`prefetch`**: fetches a resource likely needed on the next navigation
The script analysis flags render-blocking and heavy third-party scripts. These are
the usual cause of a poor INP or a delayed LCP.
When Live and CrUX disagree, trust CrUX. An example is a fast Live LCP against a
slower CrUX mobile LCP. CrUX is the p75 of real users over 28 days. Live is one
sample on the current machine.
INP replaced FID as a Core Web Vital in March 2024. Older tools may still show
FID; INP is the metric Google now uses for responsiveness.
---
# Schema
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/schema/
The Schema panel detects structured data, validates it against Google's requirements, and visualizes it as an interactive graph.
The Schema panel finds the structured data on a page, checks it against Google's
requirements, and shows how the entities connect. Structured data is what makes a
page eligible for rich results such as star ratings, FAQ dropdowns, product prices,
and breadcrumbs. It also increasingly shapes how AI answer engines cite a page.
Valid schema doesn't guarantee those results, but its absence rules them out
entirely.
## Detection and validation [#detection-and-validation]
The panel reads the page's JSON-LD and reports what's present and whether it's
complete enough to qualify.
* **25+ schema types** — Organization, Product, Article, FAQPage, LocalBusiness,
VideoObject, and more
* **Valid** vs **valid-with-warnings** status per block. Valid means it meets
every requirement. Valid-with-warnings means it works but is missing recommended
properties that would strengthen it
* **Required** and **recommended** properties, with missing ones highlighted.
Missing a required property disqualifies the block from its rich result. Missing
a recommended one only weakens it
* **Rich-result eligibility** per type, so it's clear which results a page can
actually win
A block can be valid JSON-LD and still be ineligible for a rich result if a
required property is missing. Read the required-property list, not just the
valid/invalid status, before assuming a page qualifies.
## Graph and list views [#graph-and-list-views]
A toggle switches between two views. The interactive **graph** is a D3
visualization of the schema entities with node dragging, which makes broken or
orphaned entity references easy to see. The **list** view can show the **raw
JSON**.
## Export [#export]
**Export** saves the structured data as a JSON-LD file. **Copy JSON** copies
it to the clipboard. Either output is ready to hand to a developer for
implementation or to paste into Google's Rich Results Test for a second check.
---
# Social
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/social/
The Social panel validates Open Graph and Twitter Card tags and renders a live preview of how the page looks when shared.
The Social panel checks the tags that control how a page looks when shared on
social platforms, and previews the result before you post it. Open Graph and
Twitter Card tags don't affect Google rankings. They do decide whether a shared
link shows a rich card with an image and title or a bare URL, and that difference
drives click-through on every share. A missing image tag can quietly halve the
appeal of every link to the page.
## Tag validation [#tag-validation]
The panel audits both tag sets and highlights what is missing.
* **Open Graph** — title, description, image, URL, and type. These are the minimum
set for a rich card, so missing any one is a must-fix
* **Twitter Card** — the card type and its required fields
* A **required tags** section listing the gaps in one place
* **Image optimization** — dimensions and aspect ratio checks. A share image
that will crop or render small is caught before it ships
The image and card-type recommendations follow these bands.
| Tag | Recommended | Notes |
| ------------------ | --------------------- | --------------------------------------------------------------------- |
| **og:image** | 1200×630 px, 1.91:1 | 600×315 is the minimum; below that, or the wrong ratio, is a must-fix |
| **twitter:card** | `summary_large_image` | Plain `summary` uses a small square thumbnail and underperforms |
| **og:title** | up to \~60 chars | Can differ from the page `` — optimize it for feed clicks |
| **og:description** | \~150–200 chars | Can be more promotional than the meta description |
## Live preview [#live-preview]
Below the checks, the panel renders a **Facebook preview** and a **Twitter
preview** from the page's actual tags. Cropping, a missing image, or a
truncated title show up as they will in a real feed, not as a list of values.
---
# Videos
URL: https://docs.digispot.ai/docs/chrome-extension/audit-categories/videos/
The Videos panel detects embedded and hosted video, validates VideoObject schema, and separates real content from decorative background video.
The Videos panel finds every video on the page, both embedded players and hosted
files. It then checks whether each is set up to earn video rich results. A video
with valid VideoObject markup can win a thumbnail in search and appear in the
Google video tab. Without it, the same video is invisible to search. This panel
shows which videos are eligible and what's missing on the ones that aren't.
## Overview [#overview]
The panel opens with a **Videos Overview**: scorecards that summarize how the
page's videos are set up before you drill into individual ones.
* **Schema markup**: how many videos carry valid VideoObject markup
* **Thumbnails**: how many declare a poster image
* **Dimensions**: how many declare an explicit width and height
* **UX quality**: playback behavior such as autoplay-with-sound, scored as an
overall signal
## Filtering and export [#filtering-and-export]
Filter tabs, each with a count, narrow the list. **Export CSV** includes the
platform, background flag, dimensions, duration, format, poster, and playback
attributes.
* **All** — every video on the page
* **HTML** — native HTML5 `