Guides
Step by step help for every part of SiteAud!tLint, from the first crawl to scheduled audits that post to Slack.
Getting started
Install the app, run your first crawl and choose the right crawl settings.
- Install SiteAud!tLint on WindowsDownload, unzip and start the desktop SEO auditor on Windows 10 or 11, including the first-run Python setup and the installer version.
- Install on macOS and LinuxOpen the macOS .dmg on Apple Silicon or Intel Macs, or run the Linux AppImage or tar.gz package, and fix first-launch blocks.
- Run your first site auditEnter a start URL, watch the crawl, and read the Dashboard, Issues and Action Plan to find what to fix first on your website.
- Crawl settings explainedWhat each crawl setting does, from maximum pages, parallel requests and delay to click depth, subdomains, sitemaps, robots.txt and the user agent.
- Editions, page limits and licensesCompare the Free, Starter, Professional, Agency and Unlimited editions, activate a license key, and see which Full Package features each unlocks.
- Where your audits are storedFind the local SQLite audit database on Windows, macOS and Linux, back it up, move it to a new computer, and see where connection secrets are kept.
Reading your results
Site health scores, severity levels, the Action Plan, Compare and the HTML report.
- How the site health score worksHow SiteAud!tLint turns issues into 0 to 100 category scores and an overall site health score, and why one broken page still costs points.
- Severity levels and coloursWhat Critical, Warning, Opportunity and Info mean in SiteAud!tLint, how impact and effort rank the Action Plan, and what each colour stands for.
- Dashboard, pages and navigationA tour of the Crawl, Fix, Compare and Improve pillars, the Overview dashboard, URL health, click depth, Pages views and URL details.
- Action Plan and CompareUse the ranked Action Plan to decide what to fix first, then Compare audits to prove which issues were fixed, which are new and how site health moved.
- HTML report and CSV exportsExport a standalone HTML SEO audit report for clients, plus Pages, Issues, Action Plan, Comparison and Broken Link Opportunities CSV files.
Crawling help
Rate limits, JavaScript rendering, robots.txt, external links and custom source search.
- Rate limiting, HTTP 429 and ShopifyWhy hosts like Shopify return 429 Too Many Requests, how SiteAud!tLint backs off and retries, and the crawl settings that give a complete audit.
- JavaScript rendering with ChromiumWhen to render JavaScript in a site audit, how to install Playwright and Chromium, and what rendering adds to tracking and consent checks.
- robots.txt, AI crawlers and llms.txtHow SiteAud!tLint reads robots.txt, reports blocked URLs, checks which AI crawlers like GPTBot and ClaudeBot are allowed, and looks for llms.txt.
- External link checkingHow outbound links are checked for 404, 410, 5xx and dead hosts, why social media links show as could not verify, and the time limit on large sites.
- Custom source code searchFind pages whose HTML contains or does not contain a text string or regular expression, such as a missing script, an old tracking code or a disclaimer.
- Duplicate content, URLs and anchor textHow SiteAud!tLint finds exact and near-duplicate pages with MinHash, flags URL structure problems and reports non-descriptive anchor text.
Integrations and automation
Slack alerts, scheduled audits, Linear tickets, backlink imports and AI visibility.
- Slack notifications for auditsCreate a Slack incoming webhook, connect it in Settings > Connections, and choose when audit summaries are posted and how much detail they include.
- Full issues CSV in Slack (bot token)Add a Slack bot token with chat:write, files:write and files:read scopes so each audit uploads the complete issues CSV into the message thread.
- Scheduled auditsRun daily or weekly site audits with no window open using Windows Task Scheduler, a site list file and headless command line options.
- Linear tickets from auditsConnect a Linear personal API key so each audit keeps one ticket per issue type up to date, closes fixed issues and reopens ones that come back.
- Import backlinks from Search Console, Ahrefs or SemrushImport a backlink CSV to find broken pages that have backlinks, backlinked pages that are not indexable, and broken link building opportunities on competitor sites.
- AI visibility: mentions and citationsCheck whether ChatGPT, Gemini, Claude and Perplexity mention and cite your brand for the questions customers ask, and which sites they cite instead.
Tracking and pixels
GA4, Google Tag Manager, ad pixels, events and consent checks.
- Tracking and pixels auditFind every GA4, Google Tag Manager, Meta, TikTok and other analytics tag, pixel and event across a site, and fix double counting and missing tags.
- Consent checks and tracking before consentDetect consent management platforms and Google Consent Mode, and find pixels and tracking cookies that fire before a visitor accepts cookies.
- Audit a Google Tag Manager containerRead the published GTM container to list every tag, trigger, event and parameter, and find tags with no trigger, paused tags and pixels hard-coded outside GTM.
Troubleshooting
Fix start-up problems, security warnings and failed scheduled runs.
- The app does not openFix SiteAud!tLint start-up problems on Windows, including missing Python, a failed first-run setup, and how to get the error message to send to support.
- SmartScreen and Gatekeeper warningsWhat the Windows protected your PC and developer cannot be verified messages mean for SiteAud!tLint, and how to open the app safely.
- A scheduled audit did not runDiagnose skipped or failed scheduled audits using exit codes, the scheduled-audits log, Windows Task Scheduler and Slack failure messages.
- Slack or Linear not workingFix Slack test messages that fail, missing CSV uploads, expired bot tokens, and Linear teams that do not load or tickets that do not update.
- Audit incomplete, slow or emptyWhy an audit finds too few pages, stops early, shows no score or takes a long time, and the crawl settings that fix each case.