linkfox-product-title-analyze

商品タイトル分析

このスキルでは、以前に検索した商品のタイトルをトークン化して分析する方法を説明します。Amazon の出品者が、商品リストのタイトルからキーワードのパターン、使用シーンを表す語、対象ユーザーを表す語、その他の属性項目を抽出できるようにします。

基本概念

商品タイトル分析では、現在の会話ですでに取得した商品タイトルをインテリジェントにトークン化します。LLM を活用した分析により、自由形式のタイトルから構造化された属性（使用シーンを表す語、対象ユーザーを表す語、素材、色など）を抽出し、パターンを見つけるためにグループ化して集計します。

データの自動集約：このツールは、ページ分割された検索結果も含め、現在の会話ターンでのすべての前のステップから商品を自動的に収集します。前の会話ターンのデータを参照する場合を除き、商品データを手動で渡す必要はありません。

1 回のリクエストにつき 1 つの項目：各呼び出しで分析する属性項目は必ず 1 つだけにしてください（例：使用シーンを表す語、または対象ユーザーを表す語）。1 回の呼び出しで複数の項目をリクエストしないでください。

データフィールド

リクエストフィールド

フィールド	API 名	必須	説明	例
分析リクエスト	tokenizationAndCountingRequest	はい	タイトルから抽出する属性項目を説明する自然言語の指示	"商品タイトルに含まれる使用シーンを表す語を数える"
出力モード	outputMode	いいえ	複数の値を返す方法。MULTIPLE_RECORDS（デフォルト）：値ごとに 1 レコード。COMMA_SEPARATED：すべての値を 1 レコードにまとめる	MULTIPLE_RECORDS
参照データ	refResultData	いいえ	外部から提供される商品データ（前の会話ターンのデータを参照する場合にのみ必要）	(JSON string)

レスポンスフィールド -- 商品属性

フィールド	API 名	説明	例
ASIN	asin	商品の ASIN 識別子	B0XXXXXXXX
商品タイトル	title	元の商品タイトル	Portable Camping Lantern...
属性名	attributeName	抽出された属性カテゴリ	使用シーンを表す語
属性値	attributeValue	抽出された属性値	屋外 / キャンプ
価格	price	商品価格	29.99
月間販売数	monthlySalesUnits	月間販売数量	1200
月間売上	monthlySalesRevenue	月間売上高	35988
評価	rating	商品の評価	4.5
評価件数	ratings	評価の件数	3820
販売開始日	availableDate	商品リストへの掲載日	2024-03-15
ブランド	brand	ブランド名	BrandX
画像 URL	imageUrl	商品のメイン画像	https://...

レスポンスフィールド -- 属性グループ

フィールド	API 名	説明
属性名	attributeName	このグループの属性カテゴリ（例："使用シーンを表す語"）
属性値	attributeValue	グループ内の特定の値（例："屋外"）
件数	count	この属性値を共有する商品数
ASIN リスト	asins	この属性値を共有する ASIN のリスト

レスポンスメタデータ

フィールド	API 名	説明
レンダリングタイプ	type	UI のレンダリングスタイル
列	columns	テーブル表示用の列定義
ソースタイプ	sourceType	データソースの種類
トークンコスト	costToken	消費された LLM トークンの合計数（入力 + 出力）

パラメーターガイド

tokenizationAndCountingRequest の例

tokenizationAndCountingRequest パラメーターは、分析する項目をツールに指示する自然言語の指示です。対象を 1 つの項目に絞ってください。

使用シーンを表す語（商品を使用する場所／時期）

Count scene words appearing in product titles

対象ユーザー／ターゲットユーザーを表す語（誰向けの商品か）

Count audience words appearing in product titles

素材を表す語

Count material-related words appearing in product titles

機能／特徴を表す語

Count function or feature words appearing in product titles

不適切 -- 1 つのリクエストで複数の項目を指定（行わないでください）

Count scene words AND audience words in product titles

代わりに、これを 2 回の呼び出しに分けてください。

outputMode

Value	Behavior	When to Use
MULTIPLE_RECORDS	各属性值がそれぞれ個別のレコードになります（デフォルト）	ほとんどの分析向け。カウント、並べ替え、グループ化が簡単です
COMMA_SEPARATED	複数の値がカンマ区切りで1つのレコードにまとまります	ASIN ごとの全属性を一目で確認したい場合

表示ルール

1. データは表で表示する：抽出した属性とその頻度を、見やすく並べ替え可能な表で表示します
2. 頻出キーワードを強調する：頻度が最も高い属性値を示し、傾向がすぐにわかるようにします
3. 概要を先にグループ化する：attributeGroups が返された場合は、商品ごとの詳細より先にグループ化した概要を表示します
4. 分析する切り口は一度に1つにする：複数の切り口を分析したい場合は、個別に呼び出しを行い、順番に結果を表示します
5. トークンコストに注意する：レスポンスには costToken が含まれます。ユーザーから使用状況について質問された場合を除き、表示しないでください
6. エラー処理：ツールがエラーを返した場合は、理由を説明し、修正方法を提案します（例：「現在の会話に商品がありません。まず商品を検索してください」）

適用シナリオ

ユーザーの発言	シナリオ
「これらの商品タイトルにはどんなシーンを表す語句がありますか？」	シーン語句の抽出
「タイトルのキーワードを分析して」「タイトルの単語頻度」	一般的なタイトルのトークン化
「これらの商品はどのような層をターゲットにしていますか？」	ターゲット層を表す語句の抽出
「これらの出品に共通する素材」	素材を表す語句の抽出
「競合を参考にタイトルを最適化したい」	競合タイトルのキーワード分析
「トップセラーはタイトルにどんな語句を使っていますか？」	頻出キーワードの発見
「タイトル属性でこれらの商品をグループ化して」	属性に基づく商品グループ化

適用外のシナリオ

• まだ商品を検索していない：このツールを使うには、商品がすでに会話のコンテキストに存在している必要があります。まず商品を検索するようユーザーに促してください。
• 広告／PPC キーワードの提案：このツールは既存のタイトルを分析するものであり、広告キーワードは分析しません。
• 出品内容全体のコピーライティング：このツールは語句を抽出してカウントするものであり、新しいタイトルは生成しません。
• バックエンドの検索語句分析：このツールは表示されているタイトルを分析するもので、非表示の検索語句は対象外です。
• ABA の検索語句データ：代わりに ABA Data Explorer スキルを使用してください。

呼び出し方法

• API エンドポイント：POST /product/titleAnalyze（パラメーター／レスポンス／エラーコードの詳細は references/api.md を参照）
• Python スクリプト：python scripts/title_analyze.py '<JSON 参数>' [--inline]
• コスト制約：このツールは計算リソースを消費します。同じ会話内で同じパラメーターの組み合わせに対しては、デフォルトで1回のみ呼び出します。スクリプトには24時間のローカルキャッシュがあります。失敗または結果が空の場合、キーワードやページ、郵便番号を自動的に変更して連続で試行してはいけません。検索を続ける必要がある場合は、追加の消費が発生することを事前にユーザーに説明してください。

出力方針（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-product-title-analyze-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリにあたります。<session> は環境変数 SESSION_ID から取得され、ユーザーのタスクごとに自動的に集約されます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーを返してください）
• レスポンス本文が 8 KB 以下の場合：ファイルに書き込んだ後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える場合：ファイルに書き込んだ後、stdout には概要のみを出力します（トップレベルのフィールド、total／costToken などの一般的なカウント、最大のリストフィールドの長さと先頭3件のサンプル）
• --inline を付けると、stdout に全量を強制出力します（同様にファイルにも書き込みます）

データの読み取りに関する推奨事項：まず概要を確認し、十分かどうかを判断してください。具体的なフィールドが必要な場合は、保存された json ファイルから jq または ConvertFrom-Json を使って必要な項目だけを抽出し、JSON 全体がコンテキストに入らないようにしてください。

認証と計算リソースの問題の解決

次の異常が発生した場合は、references/onboarding.md の案内に従って解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• レスポンスのステータスコードが401または402
• 計算リソースまたは残高不足を示すレスポンス：メッセージに「計算リソース残高不足／料金不足／残高不足／quota exceeded／insufficient balance／プランの期限切れ／チャージが必要／チャージしてください」など、同様の意味の内容が含まれています。

計算リソースの消費ルール

動的なルールに基づいて課金されます。計算リソースの消費量 = 処理対象となる全商品のタイトルについて、（入力に使用した計算リソース + 出力結果に使用した計算リソース）を合計した量です。

重要：このスキルのサービスでは倍率に基づく動的な計算が行われ、一度に大量の計算リソースを消費する可能性があります。必ずユーザーに注意を促し、続行するかどうかはユーザーに判断してもらってください。