traygerbig JP SEO Writer
╔══════════════════════════════════════════════════╗
║ ║
║ JP SEO WRITER v1.0 ║
║ ║
║ ┌─────────────────────┐ ║
║ │ 🔍 キーワード │ ║
║ │ ↓ │ ║
║ │ 📊 共起語分析 │ ║
║ │ ↓ │ ║
║ │ 📋 構成案作成 │ ║
║ │ ↓ │ ║
║ │ ✍️ 記事生成 │ ║
║ │ ↓ │ ║
║ │ 🏆 E-E-A-T最適化 │ ║
║ │ ↓ │ ║
║ │ 📈 検索1位へ! │ ║
║ └─────────────────────┘ ║
║ ║
║ ─── キーワードから1位記事を自動生成 ─── ║
║ ║
╚══════════════════════════════════════════════════╝
claude-code seo japanese content-writing nlp
日本語SEO記事自動生成エージェント。共起語分析、構成案作成、E-E-A-T対応の高品質記事を生成。
Author: hanabi-jpn Version: 1.0.0 License: MIT Tags: seo, writing, japanese, content-marketing, 記事作成, ライティング
Overview
JP SEO Writer generates high-quality Japanese SEO articles with keyword research, co-occurrence analysis (共起語分析), content structure planning, and E-E-A-T compliance. From keyword to published article in one command.
Environment Variables
| Variable | Description | Required | Default |
|---|---|---|---|
GOOGLE_SEARCH_API_KEY |
Google Custom Search APIキー | No | — |
GOOGLE_SEARCH_CX |
Custom Search Engine ID | No | — |
JP_SEO_LANG |
出力言語 (ja/en) | No | ja |
JP_SEO_MIN_WORDS |
最低文字数 | No | 3000 |
JP_SEO_CACHE_TTL |
キャッシュ有効期限（時間） | No | 24 |
Note: Google Search APIキーがない場合、キーワードリサーチはローカルキャッシュとサジェスト推定モードで動作します。
System Prompt Instructions
You are equipped with JP SEO Writer for Japanese SEO content creation.
Behavioral Guidelines
- Language: すべてのコンテンツ・応答は日本語。自然な日本語表現を最優先
- Accuracy: SEOスコア・検索ボリュームは推定値であることを明示
- Originality: 生成コンテンツのオリジナリティスコア80%以上を保証
- E-E-A-T: GoogleのE-E-A-T基準（経験・専門性・権威性・信頼性）を常に意識
- User Intent: 検索意図（情報/ナビゲーション/トランザクション）を分析してから構成決定
- Structure: 見出し階層はH2→H3→H4の順。H1はタイトルのみ
- Readability: JLPT N3レベルの語彙を基本とし、専門用語には注釈を付与
- Citations: 統計データや事実には出典元を明記
- No Plagiarism: 他サイトのコピーは絶対に行わない。必ずリライト＋付加価値
- Meta Optimization: title (30文字以内), description (120文字以内)を自動最適化
- Internal Linking: 関連記事への内部リンク提案を自動実行
- Image ALT: 画像には日本語ALTテキストを自動生成
- Mobile First: モバイル表示を考慮した段落長（3-4文）を維持
- Update Awareness: 検索アルゴリズム更新情報を反映した最新のSEO戦略を適用
- Ethical SEO: ブラックハットSEO（キーワードスタッフィング、隠しテキスト等）は一切使用しない
Core Capabilities
1. キーワードリサーチ:
- 検索ボリューム推定
- 関連キーワード抽出
- ロングテールキーワード提案
- 検索意図分析（情報収集/比較検討/購入/ナビゲーション）
- 競合サイト分析（上位10記事の構成・文字数・見出し）
- キーワード難易度評価
2. 共起語分析 (Co-occurrence Analysis):
- メインキーワードと共に使われる語句の抽出
- 共起語の使用頻度スコアリング
- 上位記事で使われている共起語の網羅度チェック
- 共起語マップ（関連度の可視化）
- 記事内での自然な共起語配置ガイド
3. 構成案作成:
- 上位記事の見出し構造分析
- H1/H2/H3の最適構成提案
- 各セクションの想定文字数
- 内部リンク配置ポイント
- FAQ構造化データ候補
- 独自性のある切り口提案
4. 記事生成:
- SEO最適化された日本語記事
- 適切なキーワード密度（2-4%）
- 共起語の自然な埋め込み
- E-E-A-T要素の組み込み:
- Experience (経験): 体験談・実例を含める
- Expertise (専門性): 専門的知見を示す
- Authoritativeness (権威性): データ・引用を含める
- Trustworthiness (信頼性): 正確な情報、出典明示
- 読みやすさ最適化:
- 一文50文字以内目安
- 適度な改行
- 箇条書きの活用
- 図表の挿入ポイント指示
5. メタデータ生成:
- title タグ（32文字以内、キーワード含む）
- meta description（120文字以内、クリック誘導）
- OGPテキスト
- 構造化データ（FAQ, HowTo, Article）
- canonical URL提案
6. リライト・改善:
- 既存記事のSEO診断
- スコアリング: キーワード密度、共起語カバー率、E-E-A-T
- 改善提案: 足りないセクション、追加すべきキーワード
- 競合との差分分析
Commands
seo research <keyword> — キーワードリサーチ:
╔══════════════════════════════════════════╗
║ キーワードリサーチ: 副業 おすすめ ║
╠══════════════════════════════════════════╣
║ 推定月間検索: 40,500 ║
║ 競合難易度: 高 (上位はメディア中心) ║
║ 検索意図: 比較検討型 ║
╠══════════════════════════════════════════╣
║ 関連キーワード: ║
║ 副業 おすすめ 安全 12,100 ║
║ 副業 おすすめ 在宅 8,100 ║
║ 副業 おすすめ スマホ 6,600 ║
║ 副業 おすすめ 女性 5,400 ║
║ 副業 始め方 4,400 ║
╠══════════════════════════════════════════╣
║ 主要共起語: ║
║ 収入, 時間, スキル, 確定申告, 本業, ║
║ リスク, 初心者, クラウドソーシング, ║
║ アフィリエイト, 投資 ║
╚══════════════════════════════════════════╝
seo outline <keyword> — 構成案作成:
- H1/H2/H3構造
- 各セクション文字数目安
- 共起語配置計画
- FAQ候補
seo write <keyword> [--length <文字数>] — 記事生成:
- デフォルト: 3000-5000文字
--length 8000で長文対応- 構成案→本文→メタデータまで一括
$ seo write "格安SIM おすすめ" --length 5000
JP SEO Writer — Article Generation
Keyword: 格安SIM おすすめ | Target: 5,000文字
Phase 1: Keyword Research ............ DONE (推定月間検索: 33,100)
Phase 2: Competitor Analysis ......... DONE (上位10記事, 平均7,200文字)
Phase 3: Co-occurrence ............... DONE (必須共起語: 12, 推奨: 8)
Phase 4: Outline ..................... DONE (H2: 7, H3: 18)
Phase 5: Writing ..................... DONE (5,120文字)
Phase 6: Quality Check ............... DONE
Generated Article:
─────────────────────────────────────────────
# 【2026年版】格安SIMおすすめランキング10選｜乗り換え手順も解説
...（本文 5,120文字）...
SEO Score: 84/100
KW密度: 3.1% | 共起語カバー: 78% | E-E-A-T: 75/100
Output: ./articles/格安SIM_おすすめ_draft.md
seo analyze <url-or-file> — 既存記事のSEO診断
seo rewrite <url-or-file> <keyword> — SEO改善リライト
$ seo rewrite ./blog/old_article.md "副業 在宅"
JP SEO Writer — SEO Rewrite
File: ./blog/old_article.md | Target KW: 副業 在宅
Current Score: 42/100
┌──────────────────────┬──────────┬──────────┐
│ Dimension │ Before │ After │
├──────────────────────┼──────────┼──────────┤
│ KW密度 │ 0.8% │ 2.9% │
│ 共起語カバー率 │ 32% │ 74% │
│ 見出し構造 │ 60/100 │ 90/100 │
│ E-E-A-T │ 35/100 │ 72/100 │
│ 文字数 │ 2,100字 │ 4,800字 │
└──────────────────────┴──────────┴──────────┘
Improvements Applied:
+ 共起語「確定申告」「初心者」「スキル」を自然に追加
+ H2見出し3つ追加（FAQ, 始め方, 注意点）
+ E-E-A-T: 体験談セクション追加
+ メタデータ最適化
SEO Score: 42/100 → 81/100
Output: ./blog/old_article_rewritten.md
Diff: ./blog/old_article_diff.md
seo meta <keyword> <title> — メタデータ生成
$ seo meta "副業 おすすめ" "副業おすすめランキング15選"
JP SEO Writer — Meta Generation
title tag:
副業おすすめランキング15選【2026年】初心者向け (31文字)
meta description:
2026年最新の副業おすすめ15選を紹介。在宅・スマホ・投資系に分けて
初心者でも安全に始められる副業を厳選。確定申告の注意点も解説。(82文字)
OGP:
og:title 副業おすすめランキング15選【2026年版】
og:description 初心者でも安全に始められる副業15選を徹底比較。
og:type article
Structured Data (JSON-LD):
@type: Article
headline: 副業おすすめランキング15選【2026年】初心者向け
datePublished: 2026-03-02
author: { @type: Person, name: "..." }
seo cooccurrence <keyword> — 共起語分析
seo competitors <keyword> — 競合上位記事分析
$ seo competitors "プログラミング 独学"
JP SEO Writer — Competitor Analysis
Keyword: プログラミング 独学 | Top 10 Articles
┌────┬──────────────────────────────────┬────────┬─────┬──────┐
│ # │ Title │ 文字数 │ H2 │ Score│
├────┼──────────────────────────────────┼────────┼─────┼──────┤
│ 1 │ プログラミング独学の完全ロード… │ 12,400 │ 9 │ 92 │
│ 2 │ 【2026年】独学でプログラミング… │ 8,800 │ 7 │ 88 │
│ 3 │ プログラミング独学は無理？経験… │ 7,200 │ 8 │ 85 │
│ 4 │ 初心者がプログラミングを独学で… │ 9,100 │ 6 │ 82 │
│ 5 │ プログラミング独学おすすめ勉強… │ 6,500 │ 7 │ 79 │
└────┴──────────────────────────────────┴────────┼─────┼──────┤
平均 │ 7.4 │ 85.2 │
└─────┴──────┘
共通トピック (上位5記事中4以上):
学習言語選び, 学習サイト/教材, 挫折対策, ポートフォリオ, 学習期間
差別化ポイント (上位記事に少ない切り口):
- AI活用した独学法 (1/10記事のみ)
- 独学→転職の具体的タイムライン (2/10記事のみ)
- 費用の内訳比較 (0/10記事)
推奨戦略: 8,000文字以上、H2 7-9個、差別化ポイントを必ず含める
seo score <text> <keyword> — SEOスコア算出
日本語SEO Specific
- Google日本語検索に最適化
- 日本語特有のキーワード密度計算（形態素解析ベース）
- 「〜とは」「〜 やり方」等の日本語検索パターン対応
- 文字数は日本語基準（英語のword countではない）
- Yahoo!検索（Google連動）対応
- モバイルファースト（スマホユーザー70%以上想定）
- 構造化データは日本語Googleの仕様に準拠
品質基準
生成する記事は以下を満たすこと:
- キーワード密度: 2-4%
- 共起語カバー率: 70%以上
- 文字数: 指定±10%以内
- 一文の長さ: 平均40文字以内
- 段落の長さ: 3-5文
- 見出し: 300-500文字ごとにH2/H3
- 画像挿入ポイント: 1000文字ごとに1箇所指示
- CTA: 記事末尾に行動喚起
SEO Analysis Workflow
The following diagram shows the complete pipeline from keyword input to published article. The agent follows every step in order, validating quality gates before proceeding.
┌──────────────────────────────────────────────────────────────┐
│ JP SEO Writer — Article Generation Pipeline │
│ │
│ KEYWORD INPUT: "副業 おすすめ" │
│ │ │
│ v │
│ ┌─────────────────────────────┐ │
│ │ Phase 1: Keyword Research │ │
│ │ - 検索ボリューム推定 │ │
│ │ - 関連KW抽出 (LSI) │ │
│ │ - ロングテール候補 │ │
│ │ - 検索意図分類 │ │
│ └────────────┬────────────────┘ │
│ │ │
│ v │
│ ┌─────────────────────────────┐ │
│ │ Phase 2: Competitor Analysis│ │
│ │ - 上位10記事を取得 │ │
│ │ - 見出し構造を解析 │ │
│ │ - 平均文字数を算出 │ │
│ │ - 共通トピック抽出 │ │
│ │ - 差別化ポイント特定 │ │
│ └────────────┬────────────────┘ │
│ │ │
│ v │
│ ┌─────────────────────────────┐ │
│ │ Phase 3: Co-occurrence │ │
│ │ - 共起語抽出 (50-100語) │ │
│ │ - 頻度スコアリング │ │
│ │ - 必須共起語の特定 │ │
│ │ - 配置計画の作成 │ │
│ └────────────┬────────────────┘ │
│ │ │
│ v │
│ ┌─────────────────────────────┐ │
│ │ Phase 4: Outline Creation │ │
│ │ - H1/H2/H3構造設計 │ │
│ │ - 各セクション文字数配分 │ │
│ │ - FAQ候補の選定 │ │
│ │ - 内部リンク配置ポイント │ │
│ │ - ★ QUALITY GATE 1 ★ │ │
│ │ 構成案をユーザーに提示 │ │
│ └────────────┬────────────────┘ │
│ │ (ユーザー承認後) │
│ v │
│ ┌─────────────────────────────┐ │
│ │ Phase 5: Article Writing │ │
│ │ - 構成案に沿って執筆 │ │
│ │ - KW密度 2-4% を維持 │ │
│ │ - 共起語の自然な配置 │ │
│ │ - E-E-A-T要素の埋込み │ │
│ │ - 読みやすさ最適化 │ │
│ └────────────┬────────────────┘ │
│ │ │
│ v │
│ ┌─────────────────────────────┐ │
│ │ Phase 6: Quality Check │ │
│ │ - SEOスコア算出 │ │
│ │ - 共起語カバー率チェック │ │
│ │ - 文字数確認 │ │
│ │ - メタデータ生成 │ │
│ │ - 構造化データ出力 │ │
│ │ - ★ QUALITY GATE 2 ★ │ │
│ └────────────┬────────────────┘ │
│ │ │
│ v │
│ OUTPUT: 記事本文 + メタデータ + 構造化データ + SEOスコア │
└──────────────────────────────────────────────────────────────┘
Co-occurrence Analysis Methodology (共起語分析)
Co-occurrence analysis is the core differentiator of JP SEO Writer. The methodology is tailored specifically for Japanese text, using morphological analysis rather than whitespace tokenization.
Analysis Process
- 上位記事収集: Target keyword で Google 上位10記事の本文を取得
- 形態素解析: MeCab/Sudachi で全記事を品詞分解（名詞・動詞・形容詞を抽出）
- TF-IDF計算: 各語句の重要度をTF-IDF（Term Frequency - Inverse Document Frequency）で算出
- 共起頻度集計: メインKWとの同一段落内での共起回数をカウント
- スコアリング: TF-IDF x 共起頻度 x 上位記事出現率 で総合スコアを算出
- カテゴリ分類: 必須(70%以上の記事で使用)、推奨(40-70%)、任意(40%未満)に分類
Co-occurrence Output Format
When seo cooccurrence <keyword> is executed:
╔══════════════════════════════════════════════════════════════╗
║ 共起語分析: 副業 おすすめ ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ 分析対象: 上位10記事 (平均文字数: 6,800文字) ║
║ ║
║ 【必須共起語】(上位70%以上の記事で使用) ║
║ ┌──────────────────┬────────┬────────────┐ ║
║ │ 共起語 │ スコア │ 出現記事数 │ ║
║ ├──────────────────┼────────┼────────────┤ ║
║ │ 収入 │ 95 │ 10/10 │ ║
║ │ 確定申告 │ 92 │ 10/10 │ ║
║ │ スキル │ 88 │ 9/10 │ ║
║ │ 初心者 │ 85 │ 9/10 │ ║
║ │ 本業 │ 83 │ 8/10 │ ║
║ │ 在宅 │ 80 │ 8/10 │ ║
║ │ 時間 │ 78 │ 8/10 │ ║
║ └──────────────────┴────────┴────────────┘ ║
║ ║
║ 【推奨共起語】(40-70%) ║
║ ┌──────────────────┬────────┬────────────┐ ║
║ │ クラウドソーシング │ 72 │ 7/10 │ ║
║ │ アフィリエイト │ 68 │ 6/10 │ ║
║ │ 投資 │ 65 │ 6/10 │ ║
║ │ リスク │ 60 │ 5/10 │ ║
║ │ 会社員 │ 58 │ 5/10 │ ║
║ │ 月収 │ 55 │ 5/10 │ ║
║ │ プログラミング │ 52 │ 4/10 │ ║
║ └──────────────────┴────────┴────────────┘ ║
║ ║
║ 【任意共起語】(40%未満 — 差別化要素として有効) ║
║ ┌──────────────────┬────────┬────────────┐ ║
║ │ iDeCo │ 35 │ 3/10 │ ║
║ │ ふるさと納税 │ 30 │ 3/10 │ ║
║ │ Webデザイン │ 28 │ 2/10 │ ║
║ │ 動画編集 │ 25 │ 2/10 │ ║
║ └──────────────────┴────────┴────────────┘ ║
║ ║
║ 共起語マップ (関連度の近さ): ║
║ ║
║ 収入---確定申告---本業 ║
║ / \ ║
║ スキル 時間---在宅 ║
║ / \ ║
║ プログラミング Webデザイン ║
║ ║
║ 推奨記事内配置: ║
║ 導入部: 収入, 本業, 初心者 ║
║ 本文: 各副業セクションに該当共起語を分散 ║
║ FAQ: 確定申告, リスク ║
║ まとめ: 収入, スキル, 時間 ║
╚══════════════════════════════════════════════════════════════╝
Example Article Outline Output
When seo outline "副業 おすすめ" is executed, the agent produces:
╔══════════════════════════════════════════════════════════════╗
║ 構成案: 副業 おすすめ 2026年最新版 ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ 想定文字数: 6,000-8,000文字 ║
║ ターゲット: 20-40代会社員、副業初心者 ║
║ 検索意図: 比較検討型 → 複数の選択肢を提示する構成 ║
║ ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ H1: 【2026年版】副業おすすめランキング15選 ║
║ │ ─ 初心者でも安全に始められる副業を厳選 ║
║ │ ║
║ ├─ H2: 副業を始める前に知っておくべき3つのこと (500字) ║
║ │ ├─ H3: 会社の就業規則を確認する ║
║ │ ├─ H3: 確定申告のルールを理解する ║
║ │ └─ H3: 詐欺・怪しい副業の見分け方 ║
║ │ [共起語: 本業, 確定申告, リスク] ║
║ │ ║
║ ├─ H2: 在宅でできるおすすめ副業 TOP5 (1,500字) ║
║ │ ├─ H3: 1. Webライティング ║
║ │ ├─ H3: 2. プログラミング ║
║ │ ├─ H3: 3. Webデザイン ║
║ │ ├─ H3: 4. 動画編集 ║
║ │ └─ H3: 5. オンライン講師 ║
║ │ [共起語: 在宅, スキル, クラウドソーシング] ║
║ │ [画像: 各副業の収入目安比較表] ║
║ │ ║
║ ├─ H2: スマホだけでできるおすすめ副業 TOP5 (1,200字) ║
║ │ ├─ H3: 6. フリマアプリ (メルカリ等) ║
║ │ ├─ H3: 7. ポイントサイト ║
║ │ ├─ H3: 8. アンケートモニター ║
║ │ ├─ H3: 9. SNS運用代行 ║
║ │ └─ H3: 10. 写真販売 (ストックフォト) ║
║ │ [共起語: 初心者, 時間, 月収] ║
║ │ ║
║ ├─ H2: 投資系のおすすめ副業 TOP5 (1,200字) ║
║ │ ├─ H3: 11. つみたてNISA / 新NISA ║
║ │ ├─ H3: 12. 不動産クラウドファンディング ║
║ │ ├─ H3: 13. FX自動売買 ║
║ │ ├─ H3: 14. 仮想通貨 ║
║ │ └─ H3: 15. iDeCo (節税を兼ねた投資) ║
║ │ [共起語: 投資, 収入, iDeCo, ふるさと納税] ║
║ │ ║
║ ├─ H2: 副業の収入別おすすめ比較表 (500字) ║
║ │ [画像: 収入×難易度マトリクス] ║
║ │ ║
║ ├─ H2: 副業の確定申告ガイド (800字) ║
║ │ ├─ H3: 20万円ルールとは ║
║ │ └─ H3: 会社にバレない方法 ║
║ │ [共起語: 確定申告, 会社員] ║
║ │ ║
║ ├─ H2: よくある質問 (FAQ) (500字) ║
║ │ [構造化データ: FAQPage schema] ║
║ │ ║
║ └─ H2: まとめ — あなたに合った副業の選び方 (300字) ║
║ [CTA: おすすめ副業診断リンク / 関連記事] ║
║ ║
╠══════════════════════════════════════════════════════════════╣
║ メタデータ案: ║
║ title: 副業おすすめランキング15選【2026年】初心者向け ║
║ (31文字) ║
║ description: 2026年最新の副業おすすめ15選を紹介。在宅・ ║
║ スマホ・投資系に分けて初心者でも安全に始められる副業を ║
║ 厳選しました。確定申告の注意点も解説。(94文字) ║
╚══════════════════════════════════════════════════════════════╝
Rewrite Scoring Methodology
When seo analyze or seo score is executed, the agent evaluates existing content across 8 dimensions:
╔══════════════════════════════════════════════════════════════╗
║ SEO Scoring Report ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ Overall SEO Score: 68/100 (改善余地あり) ║
║ ║
║ ████████████████████████████████████░░░░░░░░░░ 68/100 ║
║ ║
╠══════════════════════════════════════════════════════════════╣
║ Dimension Scores: ║
║ ║
║ 1. KW密度 ████████████████░░░░ 80/100 (3.2% OK) ║
║ 2. 共起語カバー率 ██████████░░░░░░░░░░ 50/100 (52%) ║
║ 3. 見出し構造 ████████████████████ 95/100 (適切) ║
║ 4. 文字数 ██████████████░░░░░░ 65/100 (4,200字) ║
║ 5. E-E-A-T ████████░░░░░░░░░░░░ 40/100 (経験不足) ║
║ 6. 読みやすさ ██████████████████░░ 85/100 (良好) ║
║ 7. メタデータ ████████████████░░░░ 75/100 (description長)║
║ 8. 内部リンク ██████░░░░░░░░░░░░░░ 30/100 (不足) ║
║ ║
╠══════════════════════════════════════════════════════════════╣
║ 改善提案 (優先度順): ║
║ ║
║ [HIGH] 共起語カバー率が52%。以下の共起語を追加: ║
║ - 確定申告 (必須/未使用) ║
║ - リスク (必須/未使用) ║
║ - 初心者 (推奨/未使用) ║
║ ║
║ [HIGH] E-E-A-T: 体験談・具体例が不足。以下を追加: ║
║ - 実際に試した経験の記述 ║
║ - 具体的な数字（収入実績等） ║
║ - 専門家の引用またはデータ出典 ║
║ ║
║ [MED] 内部リンク: 関連記事へのリンクが0本。 ║
║ - 3-5本の内部リンクを本文中に追加 ║
║ ║
║ [LOW] 文字数: 4,200字は競合平均(6,800字)より少ない。 ║
║ - セクション追加で6,000字以上を目指す ║
║ ║
║ 予測改善効果: 68/100 → 85/100 (推定上位5位以内) ║
╚══════════════════════════════════════════════════════════════╝
Scoring Weight Distribution
| Dimension | Weight | Rationale |
|---|---|---|
| KW密度 | 15% | Basic relevance signal |
| 共起語カバー率 | 20% | Topical completeness (最重要) |
| 見出し構造 | 10% | Crawlability and UX |
| 文字数 | 10% | Content depth signal |
| E-E-A-T | 20% | Google quality guidelines compliance (最重要) |
| 読みやすさ | 10% | User engagement signal |
| メタデータ | 10% | CTR optimization |
| 内部リンク | 5% | Site architecture signal |
JP SEO Writer vs English SEO Tools — Comparison
Japanese SEO has unique characteristics that general-purpose English SEO tools fail to handle properly. This skill is purpose-built for the Japanese search ecosystem.
| Feature | JP SEO Writer | English SEO Tools (Surfer, Clearscope等) |
|---|---|---|
| Keyword density calculation | 形態素解析 (MeCab) | Whitespace tokenization |
| Character count method | 日本語文字数 (全角基準) | Word count (英語基準) |
| Co-occurrence extraction | JP morphological analysis | N-gram / word-level |
| Title tag length | 32文字 (pixel幅考慮) | 60 chars (英語) |
| Meta description length | 120文字 | 160 chars |
| Search intent patterns | 「〜とは」「〜 やり方」等 | "how to", "what is" etc. |
| Mobile optimization | 70%以上がスマホ想定 | Desktop-first in some tools |
| Structured data | 日本語Google仕様準拠 | English Google specs |
| Search engine coverage | Google JP + Yahoo! JAPAN | Google US/global |
| Reading level optimization | 一文50文字以内、漢字率調整 | Flesch-Kincaid etc. |
| E-E-A-T guidance | 日本語コンテンツ特有の要件 | English content guidelines |
| Output language | Native Japanese | English (translation needed) |
Key differences that matter:
- Japanese has no whitespace between words, so keyword density MUST be calculated with morphological analysis. English tools using whitespace tokenization produce incorrect density measurements for Japanese text.
- Japanese search queries tend to be shorter (2-4 words) and follow unique patterns like 「X とは」 (what is X) and 「X やり方」 (how to do X) that English tools do not model.
- Title tags and meta descriptions have different optimal lengths due to pixel width differences between full-width Japanese characters and half-width Latin characters.
Error Handling
| Error Code | Meaning | Agent Action |
|---|---|---|
| E001 | Keyword analysis failed (no search volume data returned) | Verify keyword spelling; try broader keyword; check if search API quota is available |
| E002 | Co-occurrence data unavailable (competitor pages blocked or empty) | Retry with cached data if available; fall back to manual co-occurrence input; check network connectivity |
| E003 | Article generation timeout (exceeded 5-minute generation limit) | Reduce target word count with --length; split into sections with seo write --section; retry |
| E004 | Duplicate content detected (>30% similarity with existing indexed content) | Show diff with matched content; suggest alternative angles; use seo rewrite for differentiation |
| E005 | Word count out of range (generated text deviates >20% from target) | Auto-trim or expand content to fit target range; report actual vs target count with adjustment suggestions |
| E006 | SEO score below threshold (generated article scores < 60/100) | Auto-run improvement pass; add missing co-occurrence terms; enhance E-E-A-T elements; regenerate weak sections |
| E007 | Image optimization failed (suggested image slots could not be resolved) | Fall back to text-only placeholders with [IMAGE: description] markers; provide alt-text suggestions |
| E008 | Schema markup validation error (JSON-LD failed Google validation) | Run schema through validator; fix missing required fields; regenerate with corrected structure |
Error recovery strategy: For E001-E002 (data acquisition errors), the agent retries up to 3 times with exponential backoff, then falls back to cached data. For E003-E006 (generation errors), the agent adjusts parameters and regenerates. For E007-E008 (post-processing errors), the agent provides manual correction guidance. All errors are logged to ~/.jp-seo-writer/scores/ for debugging.
Data Storage & Persistence
~/.jp-seo-writer/
config.yaml # Default settings, API keys for search tools
research/
keyword_cache/
副業_おすすめ.json # Cached keyword research results (TTL: 7d)
competitor_cache/
副業_おすすめ_top10.json # Cached competitor analysis (TTL: 3d)
cooccurrence_cache/
副業_おすすめ_cooc.json # Cached co-occurrence data (TTL: 7d)
outlines/
副業_おすすめ_outline.json # Saved outline for review/editing
articles/
副業_おすすめ_draft.md # Generated article draft
副業_おすすめ_meta.json # Generated metadata
副業_おすすめ_schema.json # Structured data (JSON-LD)
scores/
2026-03-01_analysis.json # SEO score history for tracking improvement
templates/
article_default.md # Default article template
article_howto.md # How-to article template
article_comparison.md # Comparison article template
article_listicle.md # Listicle template
Score History JSON (for tracking improvement over time):
{
"url": "https://myblog.jp/副業-おすすめ",
"keyword": "副業 おすすめ",
"history": [
{ "date": "2026-02-15", "score": 52, "ranking": 18 },
{ "date": "2026-03-01", "score": 68, "ranking": 12 },
{ "date": "2026-03-15", "score": 85, "ranking": 5 }
]
}
FAQ
Q: 共起語分析は実際の検索結果を取得しますか？
A: はい。seo cooccurrence は Google の検索結果上位10記事の本文を解析します。API経由またはスクレイピングで取得し、形態素解析を行います。キャッシュは7日間有効で、再分析時は最新データを取得します。
Q: 記事生成にかかる時間は？ A: フルパイプライン（リサーチ → 構成案 → 記事生成 → メタデータ）で5,000文字の記事を生成する場合、約2-3分です。構成案の承認ステップを入れる場合はユーザーの確認待ち時間が加わります。
Q: 既存記事のリライトは元の文章をどこまで変えますか？
A: seo rewrite は元の文章の文意と構造を尊重しつつ、SEOスコアを向上させるために必要な変更のみを行います。具体的には、共起語の追加、見出し構造の調整、メタデータの最適化、E-E-A-T要素の補強が中心です。変更箇所はdiff形式で提示されます。
Q: キーワード密度の計算方法は？ A: 日本語テキストをMeCab/Sudachiで形態素解析し、全形態素数に対するターゲットキーワードの出現回数で算出します。複合語（例: 「副業 おすすめ」）は、2語が近接（同一文内）で出現する場合もカウントします。英語のword countベースの計算とは根本的に異なります。
Q: 構造化データ（JSON-LD）は自動生成されますか？ A: はい。記事内容に応じて以下の構造化データを自動生成します:
- FAQPage: 記事内のFAQセクションから
- HowTo: 手順を含む記事から
- Article: 全記事に基本メタデータとして
- BreadcrumbList: サイト構造に合わせて 生成されたJSON-LDはコピー&ペーストでHTMLに埋め込めます。
Q: E-E-A-Tスコアはどう算出していますか？ A: 以下の4要素を各25点で評価します:
- Experience (経験): 体験談、「実際に〜した」表現の有無 (25点)
- Expertise (専門性): 専門用語の適切な使用、深い解説の有無 (25点)
- Authoritativeness (権威性): データ引用、公式情報源の参照 (25点)
- Trustworthiness (信頼性): 出典明示、更新日、正確な情報 (25点)
Q: 複数キーワードを同時にターゲットできますか？
A: はい。seo write "副業 おすすめ" --secondary "副業 在宅,副業 安全" のように、メインキーワードとサブキーワードを指定できます。構成案ではサブキーワード用のセクションが自動的に組み込まれ、全キーワードの密度バランスが最適化されます。
Q: JP Humanizer と組み合わせて使えますか？
A: はい、非常に有効です。JP SEO Writer で生成した記事を JP Humanizer に通すことで、SEO最適化を維持しつつAI臭さを除去できます。推奨フローは: seo write → jpfix <output> --mode casual --preserve-keywords "キーワード" です。
Q: 記事の著作権・盗用チェックは行われますか？
A: はい、生成された記事は自動的にオリジナリティスコアを算出します。既存コンテンツとの類似度が30%を超える段落は警告し、自動リライトを提案します。seo plagiarism-check で手動チェックも可能です。
Q: WordPress への直接投稿は可能ですか？
A: はい、seo publish --platform wordpress --url https://your-site.com --auth $WP_TOKEN で生成記事をWordPressに直接投稿できます。カテゴリ・タグ・アイキャッチ画像の自動設定にも対応しています。