ログイン

一次情報つき商品スペック台帳の作成

Build a source-cited product spec ledger

記事や比較表を書く前に、商品の型番・サイズ・入数・付属品を一次情報で確定し、出典と証跡ファイルつきの JSON 台帳にまとめます。楽天・Amazon の実務メモ付き。

Claude CodeHermes AgentCodex CLICursorMIT（改変・再配布・商用利用可）

できること

商品紹介記事・比較ガイド・カタログ作成の前段として、商品情報を「検証済みの台帳」に固めます。

  • 検索で正確な商品 URL を見つけ、HTML と抽出テキストを証跡として保存（EUC-JP / Shift_JIS も考慮）
  • SKU 固有の本文・表だけから、サイズ・色・入数・付属品・詰め替えかどうかを確定
  • 商品 ID・ショップ ID・ASIN などを複数箇所で照合
  • メーカーと販売店で食い違う情報は両方を出典つきで記録し、断定文から外す
  • 付属の scripts/verify_ledger.py で件数・重複・必須項目・出典・証跡ファイルの存在を自動チェック

楽天市場と Amazon.co.jp で確認済みの抽出ポイントを references/store-notes.md にまとめています。

使い方

python scripts/verify_ledger.py ledger.json --expect 5

「この5商品を台帳にまとめて」と依頼すると、templates/ledger-entry.json の形式で台帳を作り、検証してから報告します。

必要な環境

  • Web 検索と HTTP 取得ができるエージェント、Python 3

注意点

  • 在庫・価格・レビュー・評価・アフィリエイトリンクを推測で作りません。
  • ログインやボット対策の回避はしません。取得できないページは別の情報源を使います。
English description

Freeze exact product identity, size, pack count and included items from primary sources into a cited JSON ledger before writing. Includes store notes.

What it does

Locks product facts into a verified ledger before articles or guides are written.

  • Finds exact product URLs and saves HTML plus extracted text as evidence (EUC-JP / Shift_JIS aware)
  • Establishes size, colour, pack count, included items and refill-vs-starter status from SKU-specific content only
  • Cross-checks item IDs, shop IDs and ASINs in more than one place on the page
  • Records manufacturer-vs-seller conflicts with both sources and keeps them out of definitive prose
  • scripts/verify_ledger.py checks count, duplicates, required fields, sources and evidence files

Tested extraction notes for Rakuten Ichiba and Amazon.co.jp are in references/store-notes.md.

How to use

python scripts/verify_ledger.py ledger.json --expect 5

Ask "put these five products into a ledger"; the agent fills templates/ledger-entry.json entries and verifies them.

Requirements

  • An agent with web search and HTTP fetch, Python 3

Notes

  • Stock, prices, reviews, ratings and affiliate links are never invented.
  • No login or bot-protection bypassing; unavailable pages are replaced with other sources.

インストール方法

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

詳しい使い方