---
title: "Technical SEO site crawl | SEO Skill"
description: "Crawl your site with seo crawl on your own machine and list technical issues such as broken pages, redirects, titles, canonicals and noindex tags."
canonical: "https://seoskill.dev/docs/crawl"
language: "en"
---

# seo crawl

Crawl your site from your own machine and list technical issues. CLI only.

Use it to get a technical baseline: before a release, after one, or when you suspect something broke across many pages. A crawl fetches a lot of pages, so it runs on your machine with the [CLI](https://seoskill.dev/docs/cli), not on the hosted server.

## Run a crawl

Install the CLI and run setup if you have not yet:

```sh
npm i -g seo && seo start
```

Then ask your agent to crawl the site, or run it yourself:

```sh
seo crawl https://example.com --save
```

`--save` keeps the crawl on your machine. The crawl stops at 500 pages unless you raise `--max-pages` (up to 10,000). For a large site, start with a quick sitemap pass that checks status codes and redirects without reading every page:

```sh
seo crawl --sitemap-url https://example.com/sitemap.xml --health
```

## What comes back

The crawl fetches your pages and lists what it finds, such as pages that return errors, redirects, missing or duplicate titles and descriptions, canonical and robots tags, and broken internal links. With `--save`, it keeps the crawl on your machine so you can compare the next one against it.

A `noindex` tag or a canonical pointing elsewhere is reported as what the page says. It is only a problem if you did not mean it.

To see which pages lost search clicks rather than which pages have issues, use [`seo index`](https://seoskill.dev/docs/indexing).