ファクトチェック済みの商品比較ガイド作成

Fact-checked product comparison guide builder

既存の商品記事を「解決したい悩み」でグループ化し、公式ページで数値を確認した比較表つきガイドを作成。広告表記・リンク・画像の欠落は自動で公開をブロックします。

Claude CodeHermes AgentCodex CLICursorMIT(改変・再配布・商用利用可)

できること

商品紹介記事や商品台帳から、読者が選びやすい比較・選び方ガイドを作ります。

  • 公開中の記事を取得し、「同じ悩みを解決する商品」ごとに 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.py confirms 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.

インストール方法

  1. ダウンロードしたZIPを展開します(中に comparison-guide-builder/ フォルダと SKILL.md があります)。
  2. フォルダごと、使うエージェントのスキル置き場にコピーします。
    • Claude Code:~/.claude/skills/(プロジェクト単位なら .claude/skills/)
    • Hermes Agent:~/.hermes/skills/
  3. エージェントを再起動し、スキル一覧に表示されることを確認します。

詳しい使い方