ebay-research

eBay の調査

Crawlora API から正規化された JSON としてデータを取得し、HTML スクレイピングを行わずに、 eBay を検索して商品詳細を取得し、出品者を審査します。

このスキルを使う場面

• 「eBay で X はいくらですか？」または「eBay で X の出品を探して。」
• 「この eBay の商品の詳細を取得して」（価格、状態、仕様）。
• 「この eBay の出品者は信頼できますか？」／「出品者のフィードバックと評価を取得して。」
• 「この eBay 出品者のショップ／ストアには何がありますか？」
• eBay に限定した競合価格や出品情報の調査。

セットアップ（初回のみ）

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

仕組み

1. 検索 — POST /ebay/search に keyword を含むフラットな JSON ボディを送信し、キーワードから候補となる出品を検索します。
2. 商品詳細 — 特定の出品の価格、状態、仕様を取得するには GET /ebay/item/{item_id} を使います。
3. 出品者プロフィール — 出品者の概要プロフィールを取得するには GET /ebay/seller/{seller} を、統計情報、トップ評価出品者のステータス、ストアのカテゴリーを取得するには GET /ebay/seller/{seller}/about を使います。
4. 出品者のフィードバック — フィードバックの概要、詳細な評価、最近のレビューカードを取得するには GET /ebay/seller/{seller}/feedback を使います（page／per_page でページネーションします）。
5. 出品者のショップ — 出品者が現在販売している商品をすべて一覧表示するには GET /ebay/seller/{seller}/shop を使います（page でページネーションします）。

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

API の呼び出し

# Search eBay (POST, JSON body):
scripts/crawlora.sh -X POST /ebay/search '{"keyword":"mechanical keyboard"}' | jq '.'

# Item detail:
scripts/crawlora.sh /ebay/item/1234567890 | jq '.data'

# Seller feedback (paginated):
scripts/crawlora.sh /ebay/seller/some-seller/feedback page=1 per_page=20 | jq '.'

すべてのリクエストには scripts/crawlora.sh を使います。これにより、API キーがコマンドライン引数に含まれないようにできます。

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

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

例

• 価格の確認： POST /ebay/search に {"keyword":"..."} を指定し、そのキーワードに一致する候補の出品と価格を取得します。
• 出品者のデューデリジェンス： /ebay/seller/{seller}/about と /ebay/seller/{seller}/feedback を使って、購入前に出品者のトップ評価ステータス、評価の内訳、最近のフィードバックを要約します。
• ショップの監査： /ebay/seller/{seller}/shop（page でページネーション）を使って、出品者が現在販売している商品をすべて一覧表示します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料プランは月 2,000 クレジットです。 キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開されている出品者ページおよび商品ページを対象とします。eBay の利用規約を遵守してください。
• セキュリティ： キーの保存先は CRAWLORA_API_KEY のみにしてください。ハードコード、クエリパラメーターへの指定、コミットはしないでください。
• /ebay/search は keyword、page、limit などのフラットなフィールドを指定する POST です。MCP 引数名の option は REST 用 JSON ラッパーではありません。
• フィードバックとショップの出品情報はページネーションされます。最初のページ以降を取得するには page を指定します（フィードバックの場合は per_page も指定します）。