RankfinityDocs Open the app

DocsSite

Site audit

How the site crawl works, what the health score means, how to find and fix every issue, compare crawls, schedule them and hand fixes to an AI.

7 min read·Markdown

Ask an AI about this page

ChatGPT and Claude open with the question copied — paste it with Ctrl+V (⌘V).

What the site audit does#

Site audit (SEO tools in the left menu) crawls your website the way a search engine does: it follows links from the homepage, reads every page it finds and runs a set of checks — broken links, missing titles and descriptions, duplicate titles, redirects, slow pages, indexing rules, structured data, security headers and more. The result is a health score, a list of problems and a prioritised Action Plan.

The crawl uses Rankfinity's own crawler. It respects your site's robots.txt and stops at the page and size limits shown before you start. Pages per crawl by plan: Free 500, Solo 1,000, Business 2,000, Pro 5,000, Agency 10,000.

Running a crawl#

  1. Open Site audit. The domain comes from the project.
  2. Click Run site crawl. The price is on the button: 2 credits per started 100 pages. A crawl on a schedule is included in your plan.
  3. A progress bar shows pages crawled. You can leave the screen; the crawl continues.

To stop a crawl, click Stop. You are charged only for the pages already crawled. A crawl stopped by its size or time limit is marked "Stopped early".

To check one page without crawling the whole site, use the Page audit tab.

The tabs#

Summary · Action Plan · Checks · Pages · Page audit · Changes · Core Web Vitals · Indexing · Performance

Summary#

  • Health score — a 0–100 circle with one sentence explaining it, and the change since the previous crawl.
  • Progress since the last crawl: fixed and new problems.
  • Fix these first — the most important problems in plain language: title, how many pages, and "See all … and how to fix".
  • Technical details (folded) — response codes, redirects, canonical tags, server headers and crawl cards.
  • Crawl details (folded) — crawl mode, requests, robots.txt, llms.txt, size.
  • Your lookups — past crawls with date, pages, health score, and errors / warnings / notices. Click one to open its summary.

Errors are critical and high-severity problems, warnings are medium, notices are low. These are counts of failed checks, not of pages.

Action Plan#

The problems ordered by impact and effort, so you know what to do first. Each item shows how many pages it affects and the effort to fix.

Checks#

Every check, passed or failed, with its plain name and an ⓘ that explains it. Basic checks (broken links, titles, speed, mobile) are at the top; technical ones (response codes, redirects, canonical, server headers) further down.

The issue page#

Click any problem — from Summary, Action Plan, Checks, Compare, Changes or a link in an email — and its page opens directly:

  • What it is and Why it matters.
  • Pages affected and pages checked.
  • How to fix and It passes when.
  • Copy fix prompt for your AI for just this problem.
  • Export CSV.
  • Every affected page with details, 50 per page (Show 200 per page), with a filter.
  • The history of this check across crawls.
  • Back to <tab> returns where you came from. The browser's Back button works too, and the address can be bookmarked.

Pages#

Every crawled page with status code, title, word count, issues and, when Search Console or Google Analytics is connected, clicks and sessions. A dash means the value was not measured, not zero. Click a page for URL details.

Changes and Compare#

Changes lists what changed since the previous crawl: fixed, new and still failing, pages new or gone, status codes changed. Compare puts any two crawls of the same site side by side. Both are free.

Core Web Vitals, Indexing, Performance#

  • Core Web Vitals — real-user and lab speed per page, free within limits. See Core Web Vitals.
  • Indexing — submit pages to search engines and check Google's index status. See Indexing and IndexNow.
  • Performance — a paid lab speed test per URL.

Copy fix prompt for your AI#

Click Copy fix prompt for your AI on the Summary or an issue page. Choose who will do the fixes:

  • ChatGPT / Claude
  • Cursor / code editor
  • WordPress site

Pick the issues to include, check the Prompt preview, then Copy or Download .md. The prompt lists the problems in Action Plan order with the affected pages and what "fixed" means. It is free.

Scheduling crawls#

Open SEO tools › Site audit. On the Summary tab, right under the Run site crawl button, is the Schedule card:

  • Frequency — Off, Daily, Weekly, Every 2 weeks, Monthly. Every plan offers every option; your plan's limit decides the shortest interval you can save, and a greyed-out option says what the limit is.
  • Day — for example Wednesday, or Any day (not shown for Daily). Monthly with a day means the first such day of the month.
  • Time — a full hour in the project owner's time zone (Account › Profile), or Any time.
  • Pages — how many pages each scheduled crawl reads, up to your plan's limit per crawl (Free 500, Solo 1,000, Business 2,000, Pro 5,000, Agency 10,000).

Click Save. The card shows the next crawl ("Wed, Sep 30 · 09:00") and the cost: scheduled crawls are included in your plan and cost no credits; a manual crawl (Run site crawl) costs 2 credits per started 100 pages. A scheduled crawl always covers the whole site from the project's domain. A crawl finished today counts as today's crawl; a failed crawl is retried the next hour.

The same setting is also in Settings › Project › Advanced settings › Automation › Crawl the site.

From Claude or ChatGPT (MCP): with the Rankfinity connector, ask for example "run the site audit every Wednesday at 9 for 200 pages". The AI reads the schedule with site_audit_schedule and changes it with set_site_audit_schedule — same options, same plan limits and the same prices as the card. Changing it needs Allow changes on the connection (Account › MCP). See Connect Claude or ChatGPT (MCP).

The crawl report email#

After every finished crawl (manual or scheduled), everyone who turned it on gets an email "New crawl for <project>": pages analysed, site health and its change, errors / warnings / notices, and What's new — each check with its count now and the change (red +N, green −N) with a View link straight to the issue page. Turn it on or off per project in the project menu ⋮ (next to the project name, or on the project card in All projects) › Email me › Crawl report — or ask the MCP connector (set_site_audit_schedule with email on). It is off by default and personal: turning it on does not change it for the rest of the team. For all projects at once, use your email preferences. See Alerts and emails.

Download sheet (XLSX)#

A shared client report with a site audit section has a Download sheet button. It gives a spreadsheet of the crawl with two sheets: Issues (one row per address and problem, with severity, area, what was found, how to fix it and the check id) and Pages (status, title and the other columns the table sorts by). Use it when a PDF of two thousand pages is too long to read. It is free, like Download PDF.

Your AI client can give you the same file for the latest crawl: ask for the site audit as a spreadsheet, and it returns a download link that works for a few minutes (see Connect Claude or ChatGPT).

Common questions#

Why did my health score drop when I changed nothing? A new check may have been added (for example duplicate titles), or the crawl found pages it did not reach before. The Changes tab shows exactly what is new.

A redirected address is listed as an issue. Is that a problem? Redirects are normal; we list them for completeness. Chains and redirect loops are the problems to fix. Redirected addresses are not counted as separate pages.

Why is a check "not measured"? We could not test it — for example the security check could not reach the server. That is not a fail.

Does the crawl see JavaScript-only content? Pages that show text only after scripts run may look nearly empty. If important pages appear empty, make sure their main content is in the HTML.

Can a client run a crawl? Clients can view results. Running crawls and changing the schedule is for the agency.

Fix it in WordPress with the agent#

If the site runs on WordPress, Site audit can hand the fixes to Agent to WordPress: Fix with Agent to WordPress on an issue or a page, or Fix all with Agent to WordPress for every fixable issue. You see the price first, approve each change, and a re-check of only the changed pages marks the issue Fixed by the agent · verified or Still failing. The bar at the top says whether WordPress is connected. With the Rankfinity Connector plugin 1.3.0 the agent also fixes broken (404) and mistyped addresses with a redirect, canonical problems and noindex settings. On plans with the AI assistant, every issue — also the ones the agent cannot fix — has Ask the AI assistant, which opens the assistant with the issue already written. See Agent to WordPress for the full loop.

Still stuck? Write to office@rankfinity.app.