AIがSEO記事を丸ごと作る！調査→執筆→最適化→公開まで全自動のコンテンツ工場 — seomachine

アーキテクチャ・仕組み

SEO MachineはClaude Codeのカスタムコマンド・エージェント・スキル機能を基盤とし、Pythonの分析モジュール群とデータソース連携を組み合わせたワークスペースとして構成されている。

• カスタムコマンド: .claude/commands/ に定義された20以上のMarkdownベースのコマンド（/research、/write、/rewrite、/optimize、/publish-draft など）
• 専門エージェント: .claude/agents/ に10種類（Content Analyzer、SEO Optimizer、Meta Creator、Internal Linker、Keyword Mapper、Editor、Performance、Headline Generator、CRO Analyst、Landing Page Optimizer）
• マーケティングスキル: .claude/skills/ に26種類（コピーライティング、CRO、A/Bテスト、メール施策、価格戦略など）

Python分析モジュール

SEO分析に特化した5つの主要モジュール:

• search_intent_analyzer.py — 検索意図を4分類（情報型/ナビゲーション型/取引型/商用型）で判定
• keyword_analyzer.py — キーワード密度計算、TF-IDF/K-meansによるトピッククラスタリング、LSIキーワード抽出
• content_length_comparator.py — SERP上位10〜20サイトの文字数比較と最適記事長の算出
• readability_scorer.py — Flesch Reading Ease、Flesch-Kincaid Grade Levelなど複数の読みやすさ指標
• seo_quality_rater.py — 0〜100のSEOスコアをカテゴリ別（コンテンツ/キーワード/メタ/構造/リンク/可読性）に算出

CRO分析モジュール6種:

• above_fold_analyzer.py、cta_analyzer.py、trust_signal_analyzer.py、landing_page_scorer.py、landing_performance.py、cro_checker.py

データソース連携

WordPress連携

• WordPress REST APIを利用した記事公開
• Yoast SEOフィールドを公開するカスタムMUプラグイン（wordpress/seo-machine-yoast-rest.php）を同梱
• .env にWordPress認証情報を設定して利用

コンテンツ品質基準

• 最低2,000語（推奨2,500〜3,000語以上）
• プライマリキーワード密度1〜2%
• 8〜10年生レベルの読みやすさ（英語基準）
• メタタイトル50〜60文字、メタディスクリプション150〜160文字
• 内部リンク3〜5本、外部権威リンク2〜3本
• 300〜400語ごとに見出しを配置

コンテキストファイル構成

context/ ディレクトリで以下を管理:

• ブランドボイス、スタイルガイド、SEOガイドライン
• ターゲットキーワード（トピッククラスター別）
• 内部リンクマップ、競合分析、CROベストプラクティス
• ライティング例（3〜5本の模範記事）

対応環境

• 前提: Claude Code（Anthropic）のインストール、Anthropic APIアカウント
• Python依存: nltk、textstat、scikit-learn、beautifulsoup4、Googleアナリティクス/Search Console API
• CMS連携: WordPress（REST API + Yoast SEO）

制約・注意点

• コンテキストファイルの品質が生成コンテンツの品質に直結する
• SEO分析スクリプトは config/competitors.json の事前設定が必要
• ライセンスは未指定（READMEに「Add your license information」と記載）
• 元々はCastos（ポッドキャストホスティングSaaS）向けに開発され、オープンソース化された

インストール手順

1. リポジトリをクローン:

git clone https://github.com/TheCraigHewitt/seomachine.git
cd seomachine

1. Python依存パッケージをインストール:

pip install -r data_sources/requirements.txt

1. Claude Codeで開く:

claude-code .

1. context/ ディレクトリ内のテンプレートファイルを自社情報で埋める（examples/castos/ に実例あり）:

   • brand-voice.md — ブランドの文体定義
   • writing-examples.md — 参考ブログ記事3〜5本
   • features.md — 製品・サービスの特徴
   • internal-links-map.md — 内部リンク先のマッピング
   • target-keywords.md — ターゲットキーワード

2. 記事作成開始:

/research [トピック]
/write [トピック]
/optimize [ファイルパス]