Run your first crawl
A crawl is how you see your website the way a search engine does. This guide takes you from an empty app to a finished report, in a few minutes.
Rather than open pages one at a time, the crawler starts at a URL, follows every internal link it finds, records what each page contains, and returns one report covering the SEO issues across the whole site. Everything runs on your Mac, and the crawl only reads your pages, so it never changes anything on your site.
What a crawl actually does
Under the hood, a crawl is a loop. The crawler fetches your start page, reads the links in its HTML, adds the internal ones it has not seen to a queue, and fetches those next. It repeats until the queue is empty or it hits your page limit.
Along the way it stores, for every page, the response and status code, the title and meta description, the headings, the word count, the images and their alt text, the links in and out, the canonical and robots directives, any structured data, and the response time. Those stored facts are what every check in your report is built from.
This is the same discovery process search engines use, which is why a crawl surfaces the problems that actually cost you traffic: pages that cannot be indexed, pages nothing links to, broken links, and duplicate or missing tags.
Before you start
You need three things:
- Crawlpit Monster installed and open. If not, see Install on Mac.
- A site you own or have explicit permission to crawl.
- The site's URL. A live site, a staging site, or a local site all work.
Step 1: Create a project
A project holds one site and its full crawl history.
- Click New project.
- Name it, usually after the site or brand.
- Enter the start URL.
- Click Create.
Step 2: Choose the right start URL
The start URL decides where discovery begins, and a poor choice can skew a whole crawl. Follow four rules:
- Start at the homepage unless you deliberately want to audit one section. The homepage links out widely, so the crawler discovers the most from it.
- Use your canonical host. If your site lives at
https://example.com, do not start athttp://example.comorhttps://www.example.comif those redirect. Starting on a redirected version spends the first hop bouncing rather than crawling. - Include the protocol, always
https://on a modern site. - Match the trailing-slash form your site actually uses, so the crawler is not immediately redirected.
Tip If you are not sure which host is canonical, open your homepage in a browser and copy the URL from the address bar after it settles. That is the version to use.
Step 3: Start the crawl
- With the project open, click Start crawl.
- The crawler begins at your start URL and follows internal links to discover the rest of the site.
- A live view shows pages found and pages finished as it works.
Crawl time depends on three things: the number of pages, your connection speed, and whether JavaScript rendering is on. A small site finishes in seconds; a large one takes longer, up to 50,000 pages, and every crawl is a full crawl rather than a sample. You can keep working in the app while it runs, and clicking Stop keeps the partial results.
Step 4: Read the report
When the crawl finishes you land on the dashboard, which has four parts:
- The health score, a single weighted number for the whole site.
- Issue groups, counts of each kind of problem.
- The page table, every URL with its status and issues.
- The page detail view, one click deeper, with everything about a single URL.
The full tour is in The dashboard.
Step 5: Fix issues in priority order
The biggest mistake on a first audit is fixing the easy things first because there are a lot of them. Work by impact instead. This order clears the problems that cost the most traffic for the least effort:
| Priority | Issue type | Why it matters | Typical fix |
|---|---|---|---|
| 1 | Indexability | A blocked or noindex page earns nothing at all | Remove stray noindex, fix robots rules and canonicals |
| 2 | Broken links and bad status codes | 404s waste crawl effort and lose users and link value | Fix or redirect to a live URL |
| 3 | Duplicate or missing titles | Titles drive rankings and clicks from search | Write a unique, descriptive title per page |
| 4 | Missing meta descriptions | They shape the click, even if not a direct ranking factor | Write a unique description per important page |
| 5 | Headings, alt text, structured data, internal links | On-page polish that compounds over time | Work through by page |
The checks reference explains each issue and how to fix it in detail.
Step 6: Crawl again and compare
After you make changes, crawl again and compare the two runs. The health score should rise and the issue counts should fall. Because every crawl is saved, you can show a clear before and after. See Compare crawls with crawl history.
Common first-crawl mistakes
- Starting on a redirected URL, which fills the first results with redirects instead of pages.
- Expecting every page when the site builds links with JavaScript. Turn on rendering and re-crawl.
- Chasing low-impact issues first because they are numerous, while a
noindexquietly hides a key page. - Crawling a site you do not have permission to crawl. Only audit sites you own or are authorized to.
Frequently asked questions
How long does a crawl take?
Seconds for a small site, longer for large ones. Page count, connection speed, and JavaScript rendering are the main factors.
Why did the crawl find fewer pages than my site has?
Most often the site builds links with JavaScript, so they are not in the raw HTML. Turn on JavaScript rendering and crawl again. Robots rules and orphan pages with no internal links pointing to them are the other common causes.
Will crawling change or harm my site?
No. The crawler only reads pages, the way a browser or search engine does, and stores the results locally.
Do I need a sitemap to crawl?
No. The crawler discovers pages by following internal links. A sitemap can help surface pages that are poorly linked, but it is not required.
Can I crawl a staging or local site?
Yes, that is a core strength of a local crawler. See Crawl settings for access and localhost setup.
Can I crawl a site I do not own?
Only with permission. The crawler fetches real pages from a real server. See the Terms of use.
