LV24 SEO

lv24-seo-optimizer

人間とAIエージェントのための、無料を優先したSEOコントロールプレーンです。

ダッシュボードを使わずに、サイトのSEOを管理できます。 Search Console、Yandex Webmaster、Metrika、Bing、 CrUX、自前のクロール結果をひとつの履歴にまとめ、週次差分をメールで受け取り、エージェントが実際に使えるMCPサーバーとCLIを利用できます。有料プラットフォームも、SERPスクレイピングも、ベンダーアカウントも不要です。

🚀 始める	🧠 使う	🛠 運用する
インストール · 動作を見る · ドキュメント	CLI · MCP ツール · スキル	スケジュール設定 · データの制限 · セキュリティ

Google Search Console、Yandex Webmaster、Yandex Metrika、Bing Webmaster、 Chrome UX Report、PageSpeed Insights からデータを取得して単一の正規化モデルにまとめ、技術的なSEOの回帰を検出するためにサイトをクロールし、すべてをスケジュールされたメールレポート、MCP ツール、 CLI コマンド、エージェントスキルに変換するツールです。

有料のSEOプラットフォームは不要です。標準の利用方法で使う機能はすべて無料枠で利用できます。

┌──────────── data sources (free) ────────────┐      ┌──── surfaces ────┐
│ GSC · Yandex Webmaster · Metrika · Bing ·    │ ───▶ │ CLI (--json)     │
│ CrUX · PSI · your own crawl + nginx logs     │      │ MCP server       │
└──────────────────────────────────────────────┘      │ Skills / AGENTS  │
                                                      │ Email / Telegram │
                                                      │ SQLite history   │
                                                      └──────────────────┘

新しいSEOツールが必要な理由

• 無料を優先したデータ統合。 既存のMCPサーバーはそれぞれひとつのベンダーをラップし、ベンダー固有の生データをモデルに渡します。このツールはプロパティごとにGSC、Bing、Yandex、Metrikaのデータを統合し、APIから取得できない情報も明示します（Yandexではクエリ×ページを結合できず、GSCは1日あたり50k行が上限で、データは2～3日遅れます）。 すべてのレスポンスに truncated、total、data_age、limitations[] が含まれます。
• ダッシュボードではなく差分。 レポートは最後に保存されたスナップショットと比較し、重要な変化（トラフィックの減少、新しいインデックス登録エラー、サイトマップの問題、TLS証明書の期限切れ）があった場合にのみメールを送信します。
• エージェントを前提とした設計。 小規模で安定したMCPツール群（デフォルトでは読み取り専用）、すべてのCLIコマンドで使えるJSONエンベロープ、実際のリポジトリでの監査 → 計画 → 修正 → 検証を定義したスキルを備えています。
• 費用ゼロ。 パブリックリポジトリのCI、SQLiteストレージ、SMTP／Telegramによる配信を利用し、標準の利用方法ではSaaSを使いません。 有料プロバイダー（Ahrefs、Semrush、DataForSEO、SerpApi）は任意のアダプターとして利用でき、ご自身のキーを使います。

ステータス

アルファ版（v0.1.0 作業中）。 現在利用できる機能：6つのプロバイダーアダプター（GSC、Yandex Webmaster、Yandex Metrika、Bing／IndexNow、CrUX、PSI）、30個のルールを備えたクローラー、SQLite履歴、分析（差分、機会、インデックス登録のトリアージ、複数エンジンの統合、nginxログの統計）、レポートビルダーとHTML／テキスト／Markdownレンダラー、 冪等性を備えたSMTP／Telegram配信、完全なCLI、MCPサーバー（10個のツール、3個のリソース、 3個のプロンプト）、スケジューラー生成機能です。

v0.1.0 を安定版として宣言する前に、以下の機能が必要です：GSCのサービスアカウント認証（現在はOAuthトークンのみ）、サイトマップ／再クロールの書き込み操作（IndexNowは接続済みで、それ以外は正直に WRITE_DISABLED を返します）、実際のプロパティを使ったエンドツーエンドの実行。進捗については docs/plans/2026-11-10-implementation-plan.mdをご覧ください。

インストール

# Python (recommended)
uvx --from lv24-seo lv24-seo doctor
pipx install lv24-seo                 # or: uv tool install lv24-seo

# Node users: thin launcher over the same CLI
npx @lv24/seo doctor --json

lv24-seo init --property https://example.com   # writes seo.toml + data/
lv24-seo auth set --provider gsc --stdin       # token in the OS keychain
lv24-seo report weekly --json --out reports/
lv24-seo mcp serve                             # stdio MCP server
lv24-seo install --client claude|opencode|vscode|cursor

npx @lv24/seo を使うには uv（またはインストール済みの lv24-seo バイナリ）が必要です。npmパッケージは起動用であり、別の実装ではありません。

動作を見る

$ lv24-seo doctor

[OK  ] python: 3.13.12
[OK  ] platform: Windows 11
[OK  ] config: C:\work\seo.toml
[OK  ] cwd_writable: C:\work
[FAIL] tokens: not configured yet (gsc / yandex / metrika / bing / crux)

$ lv24-seo report weekly --days 7 --json --out reports/

# headline   clicks +18.2%, impressions +6.4%, position -1.1
# traffic    gsc 1 240 clicks · yandex 310 · metrika 92 sessions
# indexing   3 new "crawled - not indexed" URLs, 0 regressions
# actions    5 opportunities, expected +41 clicks/week
# honesty    data_age_days=2, yandex: top_3000_queries, no_query_page_join

同じデータをMCPツール（seo_weekly_report、gsc_search_analytics、 yandex_query_stats、seo_indexing_triage、…）と、監査 → 計画 → 修正 → 検証を定義した3つのスキルから利用できます。

できること

領域	例
レポート	週次の検索パフォーマンスと変化量、インデックス登録のトリアージ、上位表示が目前の機会、コンテンツの劣化、技術的な問題の再発
MCP ツール	gsc_search_analytics、yandex_query_stats、yandex_indexing_state、crawl_site、seo_weekly_report、seo_indexing_triage、seo_opportunities、seo_recrawl_request（制限付き）
CLI	init、doctor、auth、gsc、yandex、crawl、audit、report、schedule、mcp serve
スキル	seo-weekly、seo-indexing-triage、seo-technical-audit — 意思決定ツリー＋ツールの手順＋出力の仕様
自動化	cron／systemd タイマー／Windows タスク スケジューラの生成機能、GitHub Actions のレシピ、nginx ログの取り込み

対応データソース

データソース	無料枠	用途	書き込み操作
Google Search Console	はい（OAuth またはサービスアカウント）	クエリ、ページ、国、デバイス、URL 検査、サイトマップ	サイトマップの送信（制限付き）
Yandex Webmaster	はい（OAuth）	クエリ、インデックス登録履歴、診断、サイトマップ、再クロール	再クロールキューへの追加（クォータ制限あり）
Yandex Metrika	はい	オーガニックセッション、ランディングページ、目標	—
Bing Webmaster + IndexNow	はい	クエリ、クロールの問題、URL の即時通知	IndexNow への送信
Chrome UX Report	はい（API キー）	オリジン単位のフィールド CWV	—
PageSpeed Insights	はい	URL ごとのラボ監査	—
自サイト	—	クロール、robots、サイトマップ、JSON-LD、hreflang、リンク	—
nginx アクセスログ	—	ボットのクロールバジェット、ボットへの 5xx	—

ドキュメント

• 実装計画 — フェーズ、作業パッケージ、完了の定義
• アーキテクチャ — レイヤー、データモデル、プロバイダーの仕様
• データソースと制限 — 各 API でできることとできないこと
• MCP ツール一覧 — ツール名、入力、出力、アノテーション
• CLI リファレンス — コマンド、JSON エンベロープ、終了コード
• 設定 — seo.toml、環境変数、シークレットの保管
• スケジュール設定と配信 — cron／systemd／タスク スケジューラ、SMTP、Telegram
• エージェントスキル — スキル形式とミラー
• セキュリティ — トークンの取り扱い、読み取り専用のデフォルト、書き込み制限
• 2026 年の調査 — API の制限、既存の MCP サーバー、ツールの動向

AI エージェント向け

最初に AGENTS.md を読んでください。これはリポジトリ構成、実行方法、読み取り専用の範囲、変更の提案方法を定めた正式な仕様です。機械可読な補助資料：

• schemas/tools.json — 生成されたツールスキーマ（MCP がなくても利用可能）
• llms.txt — LLM クローラー向けのドキュメント一覧
• skills/*/SKILL.md — 移植可能なスキル（Claude Code、OpenCode、Codex）
• MCP Registry: io.github.LevapVeeskela/lv24-seo

ライセンス

Apache-2.0。LICENSE と TRADEMARKS.md を参照してください。 Google／Yandex／Bing から取得したデータはプロパティの所有者に帰属します。このプロジェクトがデータを転売することはありません。