CrawlensをClaudeなどのAIツールと連携する
CrawlensにはMCPサーバーが組み込まれています。連携すると、いつも使っているAIアプリがクロールと監査のデータを読み込み、課題の説明、修正の優先順位付け、チケットの作成を行えます。お使いのAIのサブスクリプションをそのまま使うので、APIキーの設定は不要です。
Crawlensアプリの画面は現在英語のみです。アプリ内で探しやすいように、このガイドではボタン、設定、エラーメッセージを英語のまま記載しています。
できること
MCP(Model Context Protocol)は、AIアプリが外部のツールを使うための標準的な仕組みです。AIアプリがCrawlensのデータを必要とすると、あなたのPC上でCrawlensのMCPサーバーを起動します。サーバーは保存済みのクロールと監査結果を読み込み、コンパクトでページ分割された結果を返します。
- 読み取り専用。クロールの開始、設定の変更、削除はできません。
- ローカルで動作。あなたのPC上で動き、ネットワークポートは開きません。Crawlens自体は何もアップロードしません。
- Crawlensを開いておく必要はありません。AIアプリが必要なときに、Crawlensに内蔵のランタイムでサーバーを起動します。Node.jsのインストールは不要です。
1. Crawlensで有効にする
共有は初期設定でオフです。有効にするまで、AIツールからは何も見えません。
- Crawlensを開き、Settings → Integrations → AI tools (MCP)に移動します。
- Share audits with AI toolsをオンにします。
- Projects AI tools can readで、All projectsのままにするか、Only these projectsを選びます。
- 任意:Hide Search Console and Analytics dataをオンにすると、クリック数、表示回数、セッション、URL検査の結果をAIツールに見せないようにできます。
監査済みのクロールがあるプロジェクトが、少なくとも1つ必要です。まだクロールしていない場合は、先にクロールしてください。それまではAIが読めるデータがありません。
2. AIツールと連携する
同じ設定カードに、アプリごとのCopy setup forボタンがあります。このボタンを使ってください。あなたの環境に合った正確なパスが入ります。以下のスニペットは、設定がどのようになるかを、仮のパスで示したものです。
Claude Desktop
- Add to Claude Desktopをクリックします。
- Claude Desktopを終了して、もう一度開きます。ウィンドウを閉じるだけでは不十分なので、システムトレイから終了してください。
- 新しいチャットでツールのメニューを開くと、
crawlensが表示されているはずです。
Crawlensはclaude_desktop_config.jsonに自分自身を追加し、他のMCPサーバーの設定はそのまま残します。ファイルがすでにある場合は、先に日付付きのバックアップを同じ場所に保存します。通常版とMicrosoft Store版のどちらのClaude Desktopにも対応しています。
設定ファイルを自分で編集したい場合
%APPDATA%\Claude\claude_desktop_config.jsonに次の内容を追加し、すでにあるmcpServersとまとめてください。
{
"mcpServers": {
"crawlens": {
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}Claude Code
- Copy setup for → Claude Codeをクリックします。
- コマンドをターミナルに貼り付けて実行します。
claudeを起動して/mcpを実行し、crawlensが接続されていることを確認します。
このコマンドはCrawlensをユーザーアカウント単位で登録する(--scope user)ため、すべてのプロジェクトで使えます。
claude mcp add crawlens --scope user --env ELECTRON_RUN_AS_NODE=1 -- "C:\path\to\Crawlens.exe" "C:\path\to\resources\mcp\server.mjs" --user-data "C:\Users\you\AppData\Roaming\Crawlens"Codex
1回の設定で、Codex CLI、IDE拡張機能、アプリのすべてに対応します。
- Copy setup for → Codexをクリックします。
~/.codex/config.tomlの末尾に貼り付けます(ファイルがなければ作成してください)。- Codexを再起動します。
[mcp_servers.crawlens]
command = 'C:\path\to\Crawlens.exe'
args = ['C:\path\to\resources\mcp\server.mjs', '--user-data', 'C:\Users\you\AppData\Roaming\Crawlens']
[mcp_servers.crawlens.env]
ELECTRON_RUN_AS_NODE = '1'コピーした設定には、同じ内容のcodex mcp add …コマンドもコメントとして含まれているので、そちらを実行しても構いません。
Cursor
- Copy setup for → Cursorをクリックします。
~/.cursor/mcp.jsonを開いて貼り付けます。すでにサーバーが登録されている場合は、既存のmcpServersの中にcrawlensの項目を追加してください。- Cursor Settings → MCPで、
crawlensが有効になっていることを確認します。
{
"mcpServers": {
"crawlens": {
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}VS Code
- Copy setup for → VS Codeをクリックします。
- ワークスペースの
.vscode/mcp.jsonに貼り付けます。コマンドパレットからMCP: Add Serverを実行する方法もあります。 - Copilot Chatをエージェントモードで開き、ツールの一覧に
crawlensがあることを確認します。
{
"servers": {
"crawlens": {
"type": "stdio",
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}その他のMCPアプリ:stdio方式のMCPサーバーに対応していれば使えます。上と同じコマンド、引数、環境変数ELECTRON_RUN_AS_NODE=1を指定してください。
3. 接続をテストする
Crawlensに戻ってTest connectionをクリックします。CrawlensはAIアプリとまったく同じ方法でサーバーを起動し、見つかった内容を表示します。たとえば次のようになります。
テストは成功するのにAIアプリにCrawlensが表示されない場合、問題はアプリ側にあります。アプリを再起動し、トラブルシューティングをご覧ください。
質問の例
プロジェクトは、名前かドメインで指定してください。うまく機能する質問の例です。
example.comの最新のCrawlens監査を要約して、優先順位付きの修正リストを作って。
titleがないページに、新しいtitleを書いて。
リダイレクトチェーンについて、開発者向けに説明して。
前回のクロールから何が悪化した?
検索でクリックされているのに、エラーを返しているかnoindexになっているページは?
11〜20位にあるインデックス可能なページを探して、1ページ目に上げる方法を提案して。
ツールとプロンプト
AIアプリから見えるのは次のものです。大きなサイトで会話があふれないように、結果はページ分割されます(初期設定で50行)。
| ツール | 返す内容 |
|---|---|
list_projects | Crawlensから共有されているプロジェクトと、その最新のクロール。 |
list_crawls | プロジェクトのクロールを新しい順に、ヘルススコアと課題の数とともに返します。 |
get_overview | 監査済みクロールの概要:ヘルススコア、重大度別の課題、主な課題、レスポンスコード、インデックス可否、Core Web Vitals、そして利用できる場合はSearch Console、Analytics、サーバーログの合計値。 |
list_issues | 課題のあるすべてのチェックについて、意味、修正方法、対象のURL数を返します(重大なものから順)。 |
get_issue_urls | 1つの課題の対象となるURLと、各URLの詳細。 |
query_urls | URLの表と同じように、クロールしたURLを絞り込み、並べ替え、ページ送りします。Search Console、GA4、カスタム抽出の列も含みます。 |
get_url_details | 1つのURLのすべて:SEOの項目、課題、リンク、リダイレクト、ヘッダー、構造化データ、元のHTMLとレンダリング後のHTML、Core Web Vitals、検索データ。 |
compare_crawls | 2つのクロールの間で変わったこと:ヘルススコア、チェックごとの新しい課題と解決した課題、URLの変化。 |
対応しているAIアプリでは、プロンプトやスラッシュコマンドのメニューに、用意されたプロンプトが表示されます。
| プロンプト | 内容 |
|---|---|
| Summarise the audit & prioritise fixes | 最新の監査のエグゼクティブサマリーと、影響と工数の比で並べた修正計画。項目ごとの担当者と、URLの例も示します。 |
| Rewrite titles & meta descriptions | titleやdescriptionに課題があるページについて、新しいtitle(30〜60文字)とdescription(70〜160文字)を、各ページの言語で作成します。 |
| Explain an issue for developers | 1つの課題を、このサイトの実際のURLと値を使って説明します。原因、確認方法、修正方法、チェックリストです。 |
プライバシーと安全性
- 有効にするまでオフで、いつでもオフに戻せます。オフにすると、サーバーはすべてのリクエストを拒否します。
- 読み取り専用。サーバーはデータを読み取り専用モードで開きます。クロール、設定の変更、削除はできません。
- ネットワークポートなし。あなたのPC上で、標準入出力を通じてAIアプリとだけ通信します。
- 見せる範囲はあなたが選べます。すべてのプロジェクトか一部か、Search ConsoleとAnalyticsのデータを含めるかどうかを選べます。
Crawlensは何もアップロードしませんが、AIアプリは読み込んだ内容を、会話の一部として自社のAIサービスに送ります。その扱いはAIアプリのプライバシー規約に従うため、クライアントのデータを共有する前に確認してください。
トラブルシューティング
- AIアプリにCrawlensが表示されない
- 設定を追加した後、アプリを完全に再起動してください。Claude Desktopはシステムトレイで動き続けるので、そこから終了します。CursorとVS Codeでは、貼り付けた後もJSONが正しいか確認してください。カンマが1つ抜けているだけで、ファイル全体が読み込めなくなります。
- “Sharing audits with AI tools is turned off”
- Settings → Integrations → AI tools (MCP)で、Share audits with AI toolsをオンにしてください。
- “No shared project matches …”
- そのプロジェクトがAIツールに読ませる一覧に入っていないか、名前が一致していません。エラーには利用できるプロジェクトが表示されます。Projects AI tools can readにプロジェクトを追加するか、表示された名前で質問してください。
- “This project has no audited crawl yet”
- 先にCrawlensでサイトをクロールしてください。AIは監査結果を読むので、完了して監査済みのクロールが少なくとも1つ必要です。
- “This data was saved by an older Crawlens”
- Crawlensでそのプロジェクトを一度開いてください。データが更新され、AIアプリが再び読めるようになります。
- Crawlensを移動または再インストールしたら動かなくなった
- 設定には
Crawlens.exeへのパスが含まれています。Crawlensから設定をもう一度コピーして(またはAdd to Claude Desktopをもう一度クリックして)、パスを最新にしてください。Crawlensの中でデータフォルダを移動するのは問題ありません。サーバーが自動で追従します。 - “… is not valid JSON, so Crawlens left it untouched”
claude_desktop_config.jsonにもともと構文エラーがあったため、Crawlensは変更しませんでした。ファイルを修正するか削除してから、もう一度Add to Claude Desktopをクリックしてください。
Crawlensをまだお持ちでない場合
ダウンロードしてサイトをクロールしてから、このページに戻ってAIツールと連携してください。