ファクトチェック済みの商品比較ガイド作成
Fact-checked product comparison guide builder
既存の商品記事を「解決したい悩み」でグループ化し、公式ページで数値を確認した比較表つきガイドを作成。広告表記・リンク・画像の欠落は自動で公開をブロックします。
できること
商品紹介記事や商品台帳から、読者が選びやすい比較・選び方ガイドを作ります。
- 公開中の記事を取得し、「同じ悩みを解決する商品」ごとに 2〜7 件でグループ化
- 付属の
scripts/check_groups.pyで、全記事がちょうど 1 つのガイドに属しているかを確認 templates/guide-spec.mdの固定構成(選び方、比較表、状況別の候補、注意点、個別記事、参照した一次情報)で執筆- 比較表の数値はすべて公式ページで確認し、確認できない値は「商品ページで確認」と表記
- 広告表記・各商品の既存アフィリエイトリンク・カバー画像が欠けたペイロードは生成段階で拒否
使い方
python scripts/check_groups.py groups.json --articles articles.txt
「商品記事ごとに比較ガイドを付けて」と依頼すると、スナップショット → グループ化 → 仕様書 → 執筆 → 検証 → 公開 → 公開ページ確認の順に進めます。
必要な環境
- Web 取得ができるエージェント、Python 3
- 公開先の CMS(任意。EmDash など Portable Text 系の表ブロック例付き)
注意点
- 売上・ランキング・レビュー・使用体験・価格を創作しません。
- アフィリエイト URL を新たに作ったり書き換えたりしません。
- AI 検索での引用や順位を約束しません。
English description
Group product articles by the problem they solve and write comparison guides with officially verified tables; missing disclosures, links or images block publishing.
What it does
Builds buying guides from your product articles or ledger.
- Fetches published articles and groups them by the problem they solve (2-7 per guide)
scripts/check_groups.pyconfirms every article belongs to exactly one guide- Writes to the fixed structure in
templates/guide-spec.md(criteria, comparison table, situation-to-candidate table, cautions, individual articles, primary sources) - Verifies every table number on official pages; unverifiable cells say "check the product page"
- Refuses to build a payload that lacks the disclosure, each member's existing affiliate link, or a cover image
How to use
python scripts/check_groups.py groups.json --articles articles.txt
Ask "add a comparison guide for every product article"; the agent runs snapshot → grouping → spec → writing → verification → publishing → live checks.
Requirements
- An agent with web fetch, Python 3
- A CMS to publish to (optional; Portable Text table example included)
Notes
- No invented sales, rankings, reviews, experience or prices.
- Affiliate URLs are never generated or rewritten.
- No promises about AI-search citation or rankings.
インストール方法
- ダウンロードしたZIPを展開します(中に
comparison-guide-builder/フォルダとSKILL.mdがあります)。 - フォルダごと、使うエージェントのスキル置き場にコピーします。
- Claude Code:
~/.claude/skills/(プロジェクト単位なら.claude/skills/) - Hermes Agent:
~/.hermes/skills/
- Claude Code:
- エージェントを再起動し、スキル一覧に表示されることを確認します。