Scrawly MCP Server

io.github.IliasSamiv1.0.0Updated Oct 8, 2026

MCP server for the Scrawly SEO crawler: query local audits and propose confirmation-gated fixes.

Overview

AI-generated overview

Lets an assistant query local Scrawly SEO crawl audits and propose confirmation-gated fixes for a site's technical issues.

What it does
Connects an AI assistant to the Scrawly SEO crawler so it can work with audits run on the local machine. Scrawly crawls a site and runs 250 technical SEO, GEO and agentic-web checks covering crawlability, redirects, titles and meta, canonicals, structured data, internal linking, performance and AI-search readiness. Through the MCP server the assistant can query those findings and propose fixes, which are gated behind user confirmation.
When to use it
Useful when you already run Scrawly audits and want an assistant to read the findings, explain affected pages, or draft fixes without leaving the chat. Best for technical SEO work on your own or client sites, including AI-search and GEO readiness reviews. Not needed if you only want a one-off crawl without assistant involvement.
Requirements
Runs as a local process on the user's machine over stdio, installed from the PyPI package sentinelseo; desktop only, with no web executable. The Scrawly desktop app itself needs Python 3.11 or newer and git for a manual install, and downloads a crawler browser of about 150 MB once. No account, API key, environment variable or header is declared for the MCP server.
Before you install
Fixes are write actions: on WordPress sites the connector can change titles, meta descriptions, canonicals and redirects, so rely on the confirmation prompt and rollback snapshot before approving anything. Audits and reports stay on the local machine, but the app contacts the sites you choose, GitHub for updates, and any services you configure, such as PageSpeed Insights, Google Search Console or an AI provider. No credentials are declared by the MCP server itself.

Installation

In SourceWeft

  1. Open Scrawly MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Scrawly logo]

Scrawly: the free, open-source SEO crawler and site audit tool

Free technical SEO, GEO and AI-search audits for any website.
A free alternative to Screaming Frog and Sitebulb. No account, no page cap, no subscription.

[MIT License] [macOS, Windows and Linux] [250 SEO checks] [Latest release]

Scrawly is a free, open-source desktop SEO crawler and technical site audit tool for macOS, Windows and Linux. It crawls a website, runs 250 technical SEO, GEO (Generative Engine Optimization) and agentic-web checks on every page, maps the site's architecture, and explains in plain language what to fix. For WordPress sites it can also apply safe, reversible fixes. Scrawly is created by Ilias Sami and released for the SEO community under the MIT License.

In one sentence: Scrawly is a free desktop app that audits any website for the technical issues that affect Google rankings and AI-search visibility (ChatGPT, Perplexity, Google AI Overviews), with no account and no page limit.


Contents

Install in one line

Scrawly installs itself, adds an app icon (Applications on macOS, the Start Menu on Windows, your app menu on Linux), and keeps itself up to date.

macOS or Linux (Terminal):

bash
curl -fsSL https://raw.githubusercontent.com/IliasSami/scrawly-seo-crawler/main/install.sh | bash

Windows (PowerShell):

powershell
irm https://raw.githubusercontent.com/IliasSami/scrawly-seo-crawler/main/install.ps1 | iex

Then open Scrawly like any other app. There is nothing to sign up for.

Prefer to install by hand?

You need Python 3.11 or newer and git. (Node.js is not needed: releases ship the interface prebuilt.)

bash
git clone https://github.com/IliasSami/scrawly-seo-crawler.git Scrawlycd Scrawlypython3 scripts/install.py        # Windows: py scripts\install.py

The installer creates a private Python environment, downloads the crawler browser (about 150 MB, once), and adds Scrawly to your apps. Full guide, Linux notes and troubleshooting: docs/DESKTOP.md.

What Scrawly checks

Scrawly runs 250 checks grouped into 23 areas. Every finding comes with why it matters, how to fix it, and the exact pages affected.

AreaExamples
Crawlability and indexabilityrobots.txt rules, meta robots and X-Robots-Tag, noindex conflicts, orphan pages, crawl depth
Response codes and redirects4xx and 5xx pages, redirect chains and loops, temporary vs permanent redirects
Titles, meta and headingsmissing, duplicate, too long or too short titles; pixel-width truncation; meta descriptions too thin for AI; H1 and heading order
Canonicalizationmissing, conflicting, cross-domain or non-indexable canonicals
Content qualitythin and duplicate content, near-duplicates, readability
Structured dataJSON-LD, Microdata and RDFa, with schema validation
Internal linking and architecturelink graph, internal PageRank ("authority"), broken links, generic anchors
Performance and Core Web VitalsPageSpeed Insights lab and field (CrUX) data, TTFB, page weight
AI search readiness (GEO)which AI crawlers you allow or block, llms.txt, AI citation readiness
Agentic webhow well AI agents can read and operate your site
And moreimages and alt text, hreflang, XML sitemaps, security and TLS, mobile, JavaScript rendering, pagination, WordPress specifics

The full catalogue, with severity and fix tier for every check, is in docs/CHECK_MANIFEST.yaml.

Also included: JavaScript rendering, custom extraction, saved crawl profiles, a 3D site graph and depth tree, crawl-to-crawl comparison, scheduled audits with regression alerts, Google Search Console and GA4 data, branded HTML and PDF reports, an AI writer for titles and meta descriptions (bring your own AI key), and an MCP server so AI assistants can work with your audits (docs/MCP.md).

A free alternative to Screaming Frog and Sitebulb

Screaming Frog SEO Spider and Sitebulb are excellent tools. Scrawly is a free, open-source option for people who want a deep technical audit without a licence, plus checks for AI search.

Screaming Frog / SitebulbScrawly
PricePaid licence or subscription (limited free tier or trial)Free and open-source (MIT)
Account or licence keyNeeded for full useNone
Page limitThe free tier is cappedNo cap: you set the limit
AI search (GEO) and agentic-web checksSome, depending on versionA dedicated set: AI crawler access, llms.txt, citation and agent readiness
FixesReport onlySafe, reversible fixes on WordPress
Source codeClosedOpen: read, audit, contribute

Scrawly is independent and not affiliated with Screaming Frog Ltd or Sitebulb.

GEO and AEO: auditing for AI search

Search now includes AI answer engines that read your pages and decide whether to cite you. Scrawly audits for Generative Engine Optimization (GEO) and Answer Engine Optimization (AEO):

  • AI crawler access: a matrix of which AI bots (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, OAI-SearchBot and others) your robots.txt and firewall allow or block.
  • llms.txt: whether you publish a curated index for AI systems, and its quality.
  • Meta as AI context: a description is often the first thing an AI reads about a page, so Scrawly flags descriptions too thin to understand and can draft an entity-rich one from the page's own content.
  • Entities and structured data: the schema and named entities that help search engines and AI understand what a page is about.

Fix WordPress issues safely

Connect a WordPress site with the lightweight Scrawly Connector plugin and Scrawly can fix titles, meta descriptions, canonicals and redirects for you:

  • a rollback snapshot is saved before every change, and every fix can be undone;
  • changes to the live site always ask for your confirmation first;
  • higher-risk issues are never auto-applied; they're flagged for a person to review.

See docs/WORDPRESS_CONNECTOR.md. Every other site (Shopify, Wix, Webflow, Next.js, custom) gets the full read-only audit.

Privacy: your audits stay on your computer

Scrawly has no accounts and no analytics. Your crawls, findings and reports are stored on your computer only. Scrawly connects to:

  • the websites you choose to audit;
  • GitHub, to check for updates (turn off with SCRAWLY_AUTO_UPDATE=0);
  • services you configure, such as PageSpeed Insights, Google Search Console or your AI provider;
  • the feedback service, only when you click Send on a feedback note.

The app's local engine only accepts requests from the Scrawly window itself, so other websites can't use it. Report security issues as described in SECURITY.md.

Frequently asked questions

What is Scrawly? Scrawly is a free, open-source SEO crawler and technical site audit tool that runs as a desktop app on macOS, Windows and Linux. It checks every page of a website for 250 technical SEO, GEO and agentic-web issues and explains how to fix them.

Is there a free alternative to Screaming Frog? Yes. Scrawly is a free, open-source alternative to Screaming Frog SEO Spider and Sitebulb. It has no page cap and no licence, and it adds AI-search (GEO) checks and safe WordPress fixes.

Is Scrawly really free? Yes. Scrawly is free and open-source under the MIT License, with no account, subscription or usage limit. Audits run on your own computer, so there is no per-crawl cost.

Do I need to create an account? No. Install it and start auditing. There is no sign-up, login or approval.

Does Scrawly work on websites that aren't WordPress? Yes. The audit works on any website. Only the one-click fixes are WordPress-specific.

Can Scrawly check AI search and GEO readiness? Yes. It checks AI crawler access, llms.txt, whether titles and descriptions give AI enough context, structured data, and how well AI agents can use the site.

How many pages can Scrawly crawl? There is no fixed cap. You choose the limit per audit; how far you can go depends on your computer and the website.

Who made Scrawly? Scrawly was created by Ilias Sami, an SEO consultant, as a free contribution to the SEO community. Contact: [email protected].

Documentation

Contributing and feedback

Scrawly gets better from community input:

  • In the app: click the speech-bubble icon (Send feedback) at the bottom of the left bar. No GitHub account needed.
  • On GitHub: open an issue or a pull request. See CONTRIBUTING.md.

License and credits

Scrawly is released under the MIT License. Copyright (c) 2026 Ilias Sami ([email protected]). If you use Scrawly in research or writing, see CITATION.cff.

Built for the SEO community. If Scrawly helps you, a star on GitHub helps others find it.

Source: README.md at commit 123b766

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 8, 2026