CHALLENGE / SOLUTION
内部リンク施策、こんなお悩みはありませんか？
Before — 従来の課題
- 被リンクが少ない記事を手動で洗い出すのが大変
- どの記事から内部リンクを張るべきか判断が難しい
- 記事数が多いと確認作業だけで数日かかる
- 担当者によって基準がバラバラで見落としが発生
- リンク先の見出し位置まで特定するのが手間
After — このツールの解決策
- SEOデータのスプレッドシートを渡すだけで自動処理が始まる
- Claude SonnetがAI採点（100点満点・60点以上を採用）
- 約200記事を約50分で処理（APIモード・5並列）
- 読者層・地理・自然さ・トピック深度の4項目で均一判定
- リンク設置する見出しまで自動特定してスプレッドシートに出力
FEATURES
4つの主要機能
🎯
対象記事の自動抽出
被リンク数が少なく未処理の記事だけを自動抽出。処理済み記事はスキップ
📚
記事インデックスの構築
全記事のHTMLをキャッシュ。2回目以降は再取得不要で高速処理。キーワードインデックスで候補を効率検索
🤖
AIスコアリング
Claude Sonnetが4項目・100点満点で採点。60点以上を採用し、見出し位置まで特定して出力
⏸️
中断・再開機能
処理中にいつでも中断可能。再実行すると未処理の記事だけ処理され、続きから自動再開
PROCESS
5ステップの自動化フロー
CoworkにSpreadsheetのリンクを渡すだけで、以下の処理が自動実行されます。
1
対象記事の抽出
スプレッドシートから被リンク不足かつ未処理の記事を対象として取得。処理済みの記事は自動でスキップします。
Google Sheets API
2
記事インデックスの構築
全記事のHTMLをフェッチしてキャッシュシートに保存。タイトル・見出し・本文・キーワードを抽出してインデックス化。2回目以降はキャッシュから即座に参照。
Python requests + Claude Haiku
3
キーワードマッチングで候補絞り込み
対象記事のキーワードをインデックスと照合し、関連スコアが高い上位20件を候補として選出します。AIによるキーワード概念拡張も実行。
Python（スコアリング）+ Claude Haiku（キーワード拡張）
4
AI一括スコアリング
候補上位20件をClaude Sonnetに渡し、4項目・100点満点で採点。読者層・地理的一致・読者にとっての自然さ・トピック深度を総合評価。60点以上を採用。
Claude Sonnet（1記事あたり1回の呼び出し）
5
スプレッドシートへ出力
採用記事のURLとリンク設置先の見出しをスプレッドシートに書き込み。採用なしの場合は「該当なし」と記入。
Google Sheets API
SCORING
AI採点基準（4項目・100点満点）
Claude Sonnetが以下の4項目で候補記事を採点します。60点以上を内部リンク候補として採用します。
| 採点項目 | 内容 | 配点 |
|---|---|---|
| 読者層の一致 | 利用者側・提供者側・管理者側を自律推定し、両記事の読者が一致するか評価 | 25点 |
| 地理的一致 | 地名を含む記事同士は地域マッチを必須判定。地域外リンクを排除 | 15点 |
| 読者にとっての自然さ | リンクが読者の記事内での流れを妨げないか。文脈上の自然さを評価 | 35点 |
| トピックの深さと関連性 | 表面的なキーワード一致でなく、内容レベルの接点があるか評価 | 25点 |
| 合計（採用閾値：60点以上） | 100点 | |
EXECUTION MODE
2つの実行モード
🖥️ CLIモード（追加コストなし）
- Claude Desktop Proを使用
- 追加の従量課金なし
- 1記事ずつ逐次処理
- 1セッション（約5時間）で約25件処理
- 大量記事：数日かかる（自動で待機・再開）
- PCを起動したまま放置でOK
⚡ APIモード（高速・有料）
- Anthropic APIを直接呼び出し
- 5並列で高速処理
- 約200件を約50分で完了
- コスト：約1,500〜2,000円（約200件）
- ANTHROPIC_API_KEY が必要
- 急ぎの場合に推奨
※ どちらのモードも、中断後の再実行で自動的に続きから再開されます。
EFFECTS
導入効果（約200記事への適用実績）
50分
約200記事を処理
APIモード・5並列実行の実測値
60点
採用閾値
100点満点・4項目の総合スコア
約¥2k
APIモードのコスト
大量記事の一括処理（Claude Sonnet）
0
手動チェック記事数
スプレッドシートに結果が自動書き込み
TECH STACK
使用技術・ツール
🤖 Claude Sonnet（採点）
🤖 Claude Haiku（キーワード拡張・キャッシュ）
🖥️ Claude Code CLI
🐍 Python
⚡ FastAPI（ローカルサーバー）
📊 Google Sheets API
🌐 Cowork
🔗 Chrome連携
CoworkがVM上で動作するため、ローカルのPythonプロセスをChromeブラウザ経由でHTTP連携する独自アーキテクチャを採用。FastAPIサーバーがCoworkとローカルプロセスを仲介します。