target-research

Target のリサーチ

Crawlora API から、HTML をスクレイピングせずに、Target のカタログを閲覧・検索し、商品詳細、価格、在庫状況、質問、レビューを正規化された JSON として取得します。

このスキルを使う場面

• 「Target で X はいくらですか？」または「Target で X を探して。」
• 「この Target のカテゴリーを閲覧して」／「Target の［部門］には何がありますか？」
• 「Target の検索結果を［ブランド／サイズ／価格］で絞り込んで。」
• 「この Target の商品に関する Q&A／レビューを取得して。」
• 「特定の店舗で、この Target 商品の価格や在庫状況を確認して。」

セットアップ（一度だけ）

• https://crawlora.net で無料の Crawlora API キーを取得します（月 2,000 クレジット、カード不要）。
• ヘルパーを実行する前に、環境に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境から CRAWLORA_API_KEY を読み取り、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

仕組み

1. 閲覧または検索 — /target/categories ではカテゴリーのメニューと ID を取得できます。/target/category-products（category_id）または /target/search（q）では、ページ分割された商品と、その結果セットで利用可能なフィルターグループ／オプションを取得できます。
2. 絞り込み — 閲覧前にフィルターグループを確認する必要がある場合は、/target/filter-options からクエリ（q）またはカテゴリー（category_id）の動的なフィルターグループを単独で取得できます。選択したオプション ID を filter_ids（カンマ区切り）で category-products または search に渡すと、結果を絞り込めます。
3. 詳細 — /target/product（tcin）では、商品コンテンツ、画像、価格、評価、カテゴリー、店舗ごとの在庫状況を取得できます。
4. Q&A とレビュー — /target/questions と /target/reviews（どちらも tcin をキーに指定）では、ページ分割された商品の質問と回答、投稿レビューを取得できます。
5. 商品または店舗間で JSON フィールド（価格、評価、在庫状況）を比較して回答します。

すべてのエンドポイント、メソッド、パラメーターについては、reference/endpoints.md を参照してください。

API の呼び出し

# Search Target (GET, key=value params):
scripts/crawlora.sh /target/search q="standing desk" sort=price-low | jq '.'

# Browse a category, filtered and priced for a store:
scripts/crawlora.sh /target/category-products category_id=5xtg6 store_id=1234 filter_ids=5xtvw | jq '.'

# Product detail:
scripts/crawlora.sh /target/product tcin=54191097 | jq '.data'

# Reviews:
scripts/crawlora.sh /target/reviews tcin=54191097 per_page=20 | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用してください。API キーをコマンドライン引数に含めずに済みます。

エンドポイントのリファレンス

このスキルが使用するすべての Target エンドポイント（メソッド、パス、パラメーター、説明）については、reference/endpoints.md を参照してください。

使用例

• カテゴリーを一括確認して価格を調べる： /target/categories で部門の category_id を確認し、次に /target/category-products を store_id を設定してページごとに取得すると、地域の価格と在庫状況を一覧できます。
• 商品を十分に調査する： /target/product で価格と評価を確認し、次に /target/questions と /target/reviews（どちらも tcin で指定）を使って、商品をおすすめする前に買い物客の質問や意見を要約します。
• フィルターを使った検索： /target/search で検索し、返されたフィルターグループを確認してから、filter_ids を設定して再度呼び出し、ブランド／サイズ／価格帯で絞り込みます。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料プランは月 2,000 クレジットです。キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開されている Target の商品／カテゴリーのページが対象です。Target の利用規約を遵守してください。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存し、ハードコード、クエリパラメーターでの指定、コミットは絶対にしないでください。
• 結果はページ分割されています。一覧を順に取得するには page（およびサポートされている場合は per_page／count）を指定します。
• 商品の識別子は tcin（Target の数値の商品 ID）であり、SKU や ASIN ではありません。/target/product、/target/questions、/target/reviews はすべてこれをキーとして使用します。
• ページネーションの方式は統一されていません： category-products／search では 1 始まりの page（最大 50）を使用します。一方、questions／reviews では 0 始まりの page を使用します（reviews も最大 50）。
• store_id は省略可能ですが、店舗ごとの価格と在庫状況に影響します。一般的な／全国の結果を取得する場合は省略してください。