screaming-frog-mcp

ClaudeからScreaming Frog SEO Spiderのヘッドレスクロールを実行し、データのエクスポートやクロールストレージの管理をGUIを開かずに可能にするMCPサーバーです。

ClaudeにURLを入力するだけで、Screaming Frogがバックグラウンドで実行され、データが返されます。

bzsasson/screaming-frog-mcp v0.1.0をフォークし、バグ修正を行ったものです。オリジナル版には、クロールがハングアップするパイプのデッドロック、初回実行後にすべてをブロックしてしまう誤ったGUI検出、クロールデータベース全体を削除してしまう可能性のある削除コマンドなど、実用上の問題がありました。これらはすべて修正済みです。

修正内容

要件

• Screaming Frog SEO Spider（有料ライセンスが必要。ヘッドレスクロールにはライセンスが必須です）

• Python 3.10以上

• uv（推奨）またはpip

インストール

Mac

uvx --from git+https://github.com/marykovziridze/screaming-frog-mcp screaming-frog-mcp

~/Library/Application Support/Claude/claude_desktop_config.json に追加してください：

{
  "mcpServers": {
    "screaming-frog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/marykovziridze/screaming-frog-mcp", "screaming-frog-mcp"]
    }
  }
}

Windows

まずuvをインストールしてください：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

C:\Users\[name]\AppData\Roaming\Claude\claude_desktop_config.json に追加してください：

{
  "mcpServers": {
    "screaming-frog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/marykovziridze/screaming-frog-mcp", "screaming-frog-mcp"],
      "env": {
        "SF_CLI_PATH": "C:\\Program Files (x86)\\Screaming Frog SEO Spider\\ScreamingFrogSEOSpiderCli.exe"
      }
    }
  }
}

設定を編集した後、Claude Desktopを再起動してください。

ツール

設定

既知の制限事項

• Windowsでの古いクロールパス — 自動クリーンアップはMacで動作します。Windowsで中断後にクロールが失敗する場合は、SFインストールディレクトリ内のcrawl.seospiderファイルを確認し、手動で削除してください。

• クロール進捗率の非表示 — SFのヘッドレスCLIはクロール中の進捗を報告しません。開始と終了のみがわかります。

• 大規模サイト — 約160ページまでのサイトでテスト済みです。1万ページを超えるサイトでの負荷テストは行っていません。

ライセンス

MIT — LICENSEを参照してください。

クレジット

オリジナルのMCPサーバーはBoaz Sassonによるものです。