SEOデスクトップアプリ

PythonとPyQt5で作ったネイティブのデスクトップアプリです。CLIやMCPサーバーと同じコアの上で動き、同じローカルプロジェクトと保存済みスキャンを開けます。Webビューも、ホスト型アカウントもありません。

できること

1つのウィンドウにすべて

アプリには2つのモードがあります。プロジェクトは、AIエージェントと進める作業用で、目標、タスク、受信箱、スキャン、変更前後の比較、レポートを扱います。クローラーは手早く確認するためのモードで、プロジェクトなしでURLを入力し、開始を押すだけです。どちらも監査レジストリを読むため、検出結果の意味はCLIと同じです。

  • フィルター付きのURL一覧、URLごとの詳細、リンクグラフ、スキャンの比較
  • サーバーログのインポート、手法のプレイブック、リダイレクトジェネレーター、スニペットのタスクエディター
  • ライト、ダーク、ハイコントラストのテーマ
  • 英語とロシア語のインターフェース

インストールと対応プラットフォーム

現時点では、Python 3.11以降があるシステムなら、ソースからアプリを実行できます。互換性のあるコアも付属します。macOS用のインストーラーパッケージもビルドできます。SpiderHead.appをアプリケーションに、seoheadコマンドのラッパーを/usr/local/binに配置します。WindowsとLinuxのバンドルはビルドスクリプトに用意してありますが、クリーンなマシンでの動作確認はまだです。

  • ソース:仮想環境にインストールして、seohead-desktopを実行
  • macOS:PyInstallerのバンドルと.pkg。ローカルで署名済み、公証は未実施
  • WindowsとLinux:ビルドスクリプトはありますが、パッケージ版の動作は未検証
  • アプリが、マシンにあるグローバルなseoheadに切り替わることはありません

同じコア、同じファイル

アプリは独自のクローラーを持ちません。エージェントが使うのと同じCLIとローカルMCPの契約でコアを呼び出します。そのため、ターミナルで始めたスキャンはアプリに表示され、その逆も同じです。エージェントがウィンドウを操作することもできますが、ローカル操作を許可した場合に限られます。

  • アプリから始めたスキャンは、キュー付きの別プロセスとして実行されます
  • アプリ内のMCPサーバーのスイッチは、seohead mcpと共通です
  • seohead-desktop-agentによるローカル操作は、有効にするまでオフです

3ステップで、スキャンを1件保存

  1. ローカルプロジェクトを開く

    アプリでプロジェクトフォルダを指定します。CLIと同じローカルプロジェクトと保存済みスキャンが開きます。

  2. クロールするか、保存済みスキャンを開く

    アプリからクロールを実行するか、すでにあるスキャンを開いて、結果を1つのウィンドウで確認します。

  3. 問題を順に確認

    検出結果はすべて、監査レジストリが出どころです。URL一覧をフィルターし、URLを開いて詳細を見られます。

この機能のチェック項目

チェック項目意味重要度根拠
REDIRECT_LOOPリダイレクトチェーンが、すでにたどったURLに戻っていますCriticalリダイレクトの経路
TITLE_MISSINGページにtitle要素がありませんCriticalページのURL
REDIRECT_CHAIN最終URLに着くまでに、リダイレクトが2ホップ以上ありますImportantすべてのホップとステータス
CANONICAL_MISSINGインデックス可能なページに、canonical URLがありませんImportantページのURL
ORPHAN_PAGEページを指す内部リンクがありませんImportantページのURL
HREFLANG_MISSING_RETURN_LINKほかのページのhreflangはこのページを指していますが、このページから相互の指定がありませんImportantページのURLと、hreflangのセット

コマンド1つで実行

bash
seohead-desktop --project ./shop

先にインストールします: インストールガイド。どのコマンドも、AIエージェント向けのMCPツールとして実行できます。

必要なもの

  • 既存のローカルプロジェクトフォルダ(読み取り専用で開きます)。クローラーモードならURLだけで始められます
  • ソースから実行する場合は、Python 3.11以降
  • 互換性のあるコア。アプリと一緒にインストールするか、macOSパッケージに同梱されています
  • ネイティブのクロールに、ライセンス版のScreaming Frog CLIは不要です

制限事項

  • パッケージ版のビルドのスモークテストを行っているのは、macOSだけです。WindowsとLinuxでの動作確認は未完了です
  • ビルド済みのインストーラーは、まだ公開していません。リポジトリからビルドします
  • 100万URL規模でのウィンドウの動作は保証していません。非常に小さいウィンドウサイズも、確認中です
  • 内蔵のヘルプガイドは、現在はロシア語表記です

よくある質問

使うのにコマンドラインは必要ですか?
ソースからインストールするなら必要です。ターミナルで数個のコマンドを実行します。そのあとはマウス操作で使えます。macOSパッケージには、初回の起動時に「コマンドラインツールをインストール」ボタンも表示されます。管理者権限を求められるのは、このボタンを押したあとだけです。
アカウントは必要ですか?データはサーバーに送られますか?
ホスト型アカウントはありません。プロジェクトとスキャンは、CLIやMCPサーバーと共通のローカルストレージに保存され、手元のマシンの外には出ません。
デスクトップアプリは、CLIと同じ結果を表示しますか?
同じ結果です。アプリは同じコアの上で動き、同じ保存済みスキャンを開くため、ターミナルで作成したスキャンもアプリに表示されます。
クロールでサイトに変更が加わりますか?
加わりません。クロールは読み取り専用のリクエストです。生成されたリダイレクトルールはファイルとして出力されるので、確認とデプロイは自分で行います。
どのシステムで動きますか?
Qtで書かれており、ソースからのインストールはmacOS、Windows、Linuxを想定しています。パッケージ版のビルドでスモークテストに合格したのは、これまでのところmacOSだけです。Linuxでは、Qtに追加のシステム表示ライブラリが必要になる場合があります。
ライセンスは何ですか?
デスクトップアプリはGPL-3.0-or-laterです。PyQt5がこれを要求するためです。同じリポジトリにあるコアのツールキットは、MITです。