AgriciDaniel/jev-seo

Live SEO audit for any website from one homepage URL, judged by Jev. PDF, XLSX and Markdown reports.

jev‑seo とは？

jev‑seo は、ホームページの URL だけで任意のウェブサイトのライブ SEO 監査を実行する Python ツールです。サイトをクロールし、52 の Google 推奨ルールに照らしてチェックし、PageSpeed Insights を介して Core Web Vitals を測定し、次に Jev（TypeSafe の「System One」LLM）に各ページについての型付き質問（ページタイプ、検索意図、有用性など）を一連送信します。回答はスコアリングされ、優先順位が付けられ、共有可能な 3 つのレポートに変換されます。

PDF – 表紙、エグゼクティブサマリー、スコアカード、チャート、実用的な推奨事項を含む、クライアント向けのドキュメント。
XLSX – 各修正に ID、優先度、影響、労力、ソースがある、編集可能なアクショントラッカー。
Markdown – チャートが埋め込まれた GitHub/Obsidian フレンドリーなバージョン。

このツールは、Claude Code スキル（/jev‑seo https://example.com）またはコマンドラインから実行できます。

仕組み（ハイレベルなパイプライン）

クロール – 丁寧に、robots.txt を尊重し、サイトマップに従い、リダイレクト、壊れたリンク、canonical タグ、構造化データを記録し、Playwright で JavaScript のみのページをレンダリングできます（オプション）。
ルールチェック – クローラビリティ、インデックス、オンページ要因、構造化データ、パフォーマンス、セキュリティ、AI クローラーアクセスをカバーする 52 の SEO ルールを適用します。
Core Web Vitals – Google PageSpeed Insights（無料 API）から Lighthouse スコアを取得します。
Jev の判断 – TypeSafe Jev モデル（1 ページあたり約 0.00015 米ドル）に型付きプロンプトを送信し、13 のページレベルと 5 のサイトレベルの質問に対する確率的な回答を取得します。
（オプション）フルモード – DataForSEO（サイトあたり約 0.30 米ドル）からのキーワードランキング、トラフィック見積もり、競合他社、バックリンク、ライブ SERP データで監査を強化します。
スコアリングとランキング – ルール結果、Jev の確率、オプションの SEO データを組み合わせて、数値スコアと優先順位付けされた修正リストを作成します。
レポート生成 – 単一の audit.json が PDF（WeasyPrint 経由）、Excel ワークブック、Markdown 出力を駆動します。

主な機能

機能	重要性
ライブクロール（静的テンプレートではない）	監査がサイトの現在の状態（JavaScript でレンダリングされたコンテンツを含む）を反映することを保証します。
Jev 駆動の判断	ページの意図、有用性、信頼性などの LLM ベースの評価を追加し、透明性のために確率を保存します。
ランク付けされ、説明可能な修正	各推奨事項には ID、優先度、影響、労力、証拠、ソースリンクが含まれ、開発者やコンテンツチームに簡単に引き継げます。
単一ソースからの 3 つの出力形式	クライアント向け PDF、プロジェクト追跡用 XLSX、バージョン管理されたドキュメント用 Markdown。
コスト管理された API 使用	組み込みの上限（`--jev-budget`、`--dfs-budget`）とレポート内のコスト台帳により、支出を予測可能にします。
オプションの DataForSEO 強化	より深い SEO 全体像のために、キーワード機会、競合分析、バックリンクデータを追加します（有料）。
オフラインテストスイート	ユニットテストはネットワーク呼び出しなしで実行され、API クレジットを消費せずにコアロジックが機能することを保証します。

誰が使うか

SEO コンサルタント – クライアントと共有するための迅速で再現可能な監査が必要な方。
ウェブ開発者 / プロダクトチーム – 具体的で優先順位付けされた技術 SEO 修正リストを探している方。
コンテンツストラテジスト – キーワードと SERP の洞察に関心がある方（--full モード経由）。
AI に精通したマーケター – LLM（Jev）がサイト品質をどのように評価するかを確認し、その判断をワークフローに組み込みたい方。

はじめに（クイックステップ）

# クローンして仮想環境をセットアップ
git clone https://github.com/AgriciDaniel/jev-seo.git
cd jev-seo
python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt

# TypeSafe API キーを追加（Jev にはオプション、フルモードには必須）
cp .env.example .env   # .env を編集して TYPESAFE_API_KEY を設定

# 基本監査を実行
bin/jevseo run https://example.com

オプション: JavaScript レンダリング用に Playwright をインストールし、強化モード用に DataForSEO の認証情報をインストールします。

制限と注意事項

サンプリング – 大規模なサイトはデフォルトで 60 ページの上限に制限されます。レポートはサンプリングが発生したときに注記します。
Jev のキャリブレーション – LLM のしきい値は、人間の SEO 専門家に対してまだベンチマークされていません。
PageSpeed のばらつき – Lighthouse スコアは実行ごとに変動する可能性があります。
トラフィックやランキングの追跡はありません – このツールは証拠のスナップショットであり、ランクトラッカーや分析プラットフォームではありません。

ライセンス

MIT ライセンス。PDF にバンドルされているフォントは SIL Open Font License の下にあります。

上記のすべての情報は、リポジトリの README から直接取得したものです。外部の仮定は追加されていません。