logo
languageJPdown
menu

eBay商品詳細

サイト接尾辞付きの eBay 商品IDリストを渡すと、タイトル、価格、画像、出品者、スペックなどの詳細を返します

翻訳済み · ja-JP原文を表示

概要

すでに商品IDが分かっている eBay 出品を、揃った詳細表にしたいですか。サイト接尾辞付きの識別子リストを渡すと、出品ごとに1行が返ります。タイトル、価格テキスト、画像、出品者情報、商品スペック、ページの生ペイロードです。品揃え、価格、カタログのチームは、ページを1件ずつ開かずに US、AU、CA、UK の出品を比較できます。

価値は出品ページのスナップショットそのものです。タイトル、価格テキスト、画像リンク、出品者フィードバック、商品データが、送信した識別子と同じ行に並ぶので、スクリーンショットやメモを継ぎ合わせずにサイト横断で並べられます。

データ説明

各レコードは、公開されている eBay 出品ページから収集時点で取った商品詳細スナップショットです。行は送信済み商品識別子で重複排除されます。価格テキストはページに表示された金額で、元の通貨記号を含み、正規化された決済合計、税額、送料込み価格ではありません。収集時刻はそのスナップショットに保存された時刻テキストで、情報源はタイムゾーンを示していません。画像リンクと商品データは、分割ファイルではなくページの元テキストのままです。

対象は US、AU、CA、UK サイトの公開出品ページのみです。終了、削除、その他取得できない出品でも、データなしフラグ付きの行として残ることがあります。検索結果、レビュー、注文や在庫の状態は含まれません。

結果はこのような形です

各レコードは eBay 出品スナップショット1件です。

商品タイトルSKU価格テキストサイト国出品者フィードバックデータなし
Insta360 ONE X 5.7K Action Camera - Black114452409636-US$420.93USHD Toys Store (2237)いいえ
JBL Quantum 100 Wired Over-Ear Gaming Headphones - Black376391395797-US$28.50USalf_33651 (3)いいえ

結果には商品URL、ePID、画像リンク、商品スペック、商品データも含まれます。

利用シーン

  • 品揃え確認では、SKU を横断して商品タイトルとサイト国を比べ、同じカタログ商品が各サイトでどう出ているかを見ます。
  • 価格追跡では、価格テキストをサイト国と収集時刻と合わせて読み、通貨換算せずに提示価格をスナップショットします。
  • 出品者確認では、出品者フィードバックを出品者名と出品者スコアと合わせて、各出品の背後に誰がいるかを見ます。

適用範囲と境界

1回あたり最大 200 件の eBay 商品識別子を送信できます。形式は商品IDに US / AU / CA / UK のサイト接尾辞を付けたものです。各識別子は詳細1行、またはデータなしフラグを返します。取得保護は 1,000 件×100 ページです。

  • 適している用途
  • 複数の eBay 出品についてタイトル、価格、画像、商品スペック、出品者情報をまとめて必要なとき
  • US、AU、CA、UK の eBay サイトを横断した統一の詳細表を作りたいとき
  • 適さない用途
  • リアルタイムの決済価格、在庫、注文状態が必要なとき — 各レコードは収集時点の出品ページスナップショットです
  • eBay の検索結果、レビュー、売上内訳が必要なとき — このアプリは商品詳細のみを返します

失敗時の処理

作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

  1. 1タスクが部分成功のときは、完了した出品行を残し、データなしフラグで詳細のない出品を見分けます
  2. 2タスクが失敗または期限切れのときは商品IDを直して再送信してください。認証エラーは設定済みのキーを先に修正する必要があります
  3. 3結果が空のときは、出品が存在しないとみなす前に識別子とサイトを確認してください

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

フィールド業務名称型必須デフォルト列挙値/制約例説明
product_items商品リストarray<object>はい—最大 200 件[{"item":"114452409636-US"}]詳細を収集する eBay 出品です。各項目は 114452409636-US のように商品IDとサイト接尾辞を組み合わせます。サイトは US、AU、CA、UK で、1回あたり 1〜200 件を送信できます。

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

フィールド業務名称型例説明
country_codeサイト国stringUSこの出品スナップショットに対応する eBay サイトの国または地域コード。
crawl_time収集時刻string2026-09-04T14:24:18この出品スナップショットが収集されたときに記録された時刻テキスト。
epidePIDstring10026190245出品に表示される eBay カタログ商品識別子。
image_urls画像リンクstring["https://i.ebayimg.com/images/g/ZGwAAOSwrHNex8it/s-l640.jpg","https://i.ebayimg.com/images/g/iPoAAOSwVTRjnB6b/s-l500.webp","https://i.ebayimg.com/images/g/Dy8AAOSwZyFjnB6b/s-l500.webp","https://i.ebayimg.com/images/g/XX0AAOSwOnRjnB6b/s-l500.webp","https://i.ebayimg.com/images/g/GmIAAOSw8jdjnB6b/s-l500.webp","https://i.ebayimg.com/images/g/reoAAOSwM51jnB6b/s-l500.webp","https://i.ebayimg.com/images/g/cucAAOSwAIlkkbbT/s-l500.webp"]出品画像リンク一覧の元テキスト。
item_specifics商品スペックstring—出品ページに表示された商品スペックの元テキスト。
price_text価格テキストstring$420.93出品ページに表示された価格テキスト。元の通貨と表記を保持します。
product_data商品データstring{"img_li": ["https://i.ebayimg.com/images/g/ZGwAAOSwrHNex8it/s-l640.jpg", "https://i.ebayimg.com/images/g/iPoAAOSwVTRjnB6b/s-l500.webp", "https://i.ebayimg.com/images/g/Dy8AAOSwZyFjnB6b/s-l500.webp", "https://i.ebayimg.com/images/g/XX0AAOSwOnRjnB6b/s-l500.webp", "https://i.ebayimg.com/images/g/GmIAAOSw8jdjnB6b/s-l500.webp", "https://i.ebayimg.com/images/g/reoAAOSwM51jnB6b/s-l500.webp", "https://i.ebayimg.com/images/g/cucAAOSwAIlkkbbT/s-l500.webp"], "item_specifics_param": null, "this_product_param": null}構造化された商品詳細ペイロードの元テキスト。
product_title商品タイトルstringInsta360 ONE X 5.7K Action Camera - Black出品ページに表示される完全なタイトル。
product_url商品URLstringhttps://www.ebay.com/p/10026190245商品詳細ページのリンク。
rating_score_text評価テキストstring—出品ページに表示された評価テキスト。
seller_name出品者名string—出品ページに表示された出品者名。
seller_positive_feedback_text出品者フィードバックstringHD Toys Store (2237)ページに表示された出品者名と高評価数などのテキスト。
seller_score_text出品者スコアstring—出品ページに表示された出品者スコアのテキスト。
sku_idSKUstring114452409636-US詳細行に返された SKU または出品識別子。
status_codeステータスコードstring—出品詳細の収集結果に含まれるステータスコードテキスト。
task_item対象商品string114452409636-USこの結果行が対応する、送信済みの商品識別子。
no_dataデータなしbooleanfalseこの識別子から利用可能な出品詳細が得られなかったかどうか。
this_product_param商品パラメータstring—現在の商品パラメータペイロードの元テキスト。
url_status_codeURLステータスコードstring—出品URLの収集結果に含まれるステータスコードテキスト。

レコード Schema

出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string",
      "title": "サイト国",
      "description": "この出品スナップショットに対応する eBay サイトの国または地域コード。",
      "prefill": "US"
    },
    "crawl_time": {
      "type": "string",
      "title": "収集時刻",
      "description": "この出品スナップショットが収集されたときに記録された時刻テキスト。",
      "prefill": "2026-09-04T14:24:18"
    },
    "epid": {
      "type": "string",
      "title": "ePID",
      "description": "出品に表示される eBay カタログ商品識別子。",
      "prefill": "10026190245"
    },
    "image_urls": {
      "type": "string",
      "title": "画像リンク",
      "description": "出品画像リンク一覧の元テキスト。",
      "prefill": "[\"https://i.ebayimg.com/images/g/ZGwAAOSwrHNex8it/s-l640.jpg\",\"https://i.ebayimg.com/images/g/iPoAAOSwVTRjnB6b/s-l500.webp\",\"https://i.ebayimg.com/images/g/Dy8AAOSwZyFjnB6b/s-l500.webp\",\"https://i.ebayimg.com/images/g/XX0AAOSwOnRjnB6b/s-l500.webp\",\"https://i.ebayimg.com/images/g/GmIAAOSw8jdjnB6b/s-l500.webp\",\"https://i.ebayimg.com/images/g/reoAAOSwM51jnB6b/s-l500.webp\",\"https://i.ebayimg.com/images/g/cucAAOSwAIlkkbbT/s-l500.webp\"]"
    },
    "item_specifics": {
      "type": "string",
      "title": "商品スペック",
      "description": "出品ページに表示された商品スペックの元テキスト。"
    },
    "price_text": {
      "type": "string",
      "title": "価格テキスト",
      "description": "出品ページに表示された価格テキスト。元の通貨と表記を保持します。",
      "prefill": "$420.93"
    },
    "product_data": {
      "type": "string",
      "title": "商品データ",
      "description": "構造化された商品詳細ペイロードの元テキスト。",
      "prefill": "{\"img_li\": [\"https://i.ebayimg.com/images/g/ZGwAAOSwrHNex8it/s-l640.jpg\", \"https://i.ebayimg.com/images/g/iPoAAOSwVTRjnB6b/s-l500.webp\", \"https://i.ebayimg.com/images/g/Dy8AAOSwZyFjnB6b/s-l500.webp\", \"https://i.ebayimg.com/images/g/XX0AAOSwOnRjnB6b/s-l500.webp\", \"https://i.ebayimg.com/images/g/GmIAAOSw8jdjnB6b/s-l500.webp\", \"https://i.ebayimg.com/images/g/reoAAOSwM51jnB6b/s-l500.webp\", \"https://i.ebayimg.com/images/g/cucAAOSwAIlkkbbT/s-l500.webp\"], \"item_specifics_param\": null, \"this_product_param\": null}"
    },
    "product_title": {
      "type": "string",
      "title": "商品タイトル",
      "description": "出品ページに表示される完全なタイトル。",
      "prefill": "Insta360 ONE X 5.7K Action Camera - Black"
    },
    "product_url": {
      "type": "string",
      "title": "商品URL",
      "description": "商品詳細ページのリンク。",
      "prefill": "https://www.ebay.com/p/10026190245"
    },
    "rating_score_text": {
      "type": "string",
      "title": "評価テキスト",
      "description": "出品ページに表示された評価テキスト。"
    },
    "seller_name": {
      "type": "string",
      "title": "出品者名",
      "description": "出品ページに表示された出品者名。"
    },
    "seller_positive_feedback_text": {
      "type": "string",
      "title": "出品者フィードバック",
      "description": "ページに表示された出品者名と高評価数などのテキスト。",
      "prefill": "HD Toys Store (2237)"
    },
    "seller_score_text": {
      "type": "string",
      "title": "出品者スコア",
      "description": "出品ページに表示された出品者スコアのテキスト。"
    },
    "sku_id": {
      "type": "string",
      "title": "SKU",
      "description": "詳細行に返された SKU または出品識別子。",
      "prefill": "114452409636-US"
    },
    "status_code": {
      "type": "string",
      "title": "ステータスコード",
      "description": "出品詳細の収集結果に含まれるステータスコードテキスト。"
    },
    "task_item": {
      "type": "string",
      "title": "対象商品",
      "description": "この結果行が対応する、送信済みの商品識別子。",
      "prefill": "114452409636-US"
    },
    "no_data": {
      "type": "boolean",
      "title": "データなし",
      "description": "この識別子から利用可能な出品詳細が得られなかったかどうか。",
      "prefill": false
    },
    "this_product_param": {
      "type": "string",
      "title": "商品パラメータ",
      "description": "現在の商品パラメータペイロードの元テキスト。"
    },
    "url_status_code": {
      "type": "string",
      "title": "URLステータスコード",
      "description": "出品URLの収集結果に含まれるステータスコードテキスト。"
    }
  },
  "required": [],
  "additionalProperties": false
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。

MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config
{
  "mcpServers": {
    "hello_moto__ebay-product-detail": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/ebay-product-detail",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。

detail.access.mcp.composeHint

料金

商品詳細タスクを1件開始

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回
商品詳細レコードを1件返す

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。

$0.004/ 件

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル
パラメータは送信前に input.schema で検証されます
まず必須パラメータを入力してください
$0.004 / 件から