KH Merch Graph

日本語の中古出品タイトル・説明文から、正規SKU候補・状態語・海賊版注意フラグ・定価比の目安を返す。

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "出品タイトル（必須）"
    },
    "description": {
      "type": "string",
      "description": "説明文の抜粋（任意）"
    },
    "price_jpy": {
      "type": "number",
      "description": "出品価格（円、任意）"
    },
    "platform": {
      "type": "string",
      "enum": [
        "mercari",
        "yahoo",
        "surugaya",
        "mandarake",
        "other"
      ],
      "description": "出品プラットフォーム（任意）"
    },
    "url": {
      "type": "string",
      "description": "出品URL（任意・サーバー側では保存しない）"
    },
    "src": {
      "type": "string",
      "description": "計測用の流入元タグ（任意）。Web版チェッカーのURLパラメータ?src=から渡される。src自体と日時のみ利用ログに残す"
    }
  },
  "required": [
    "title"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

resolve_listing を最大5件まとめて1回で実行する。多数の出品を照会するときに使う。結果は入力と同じ順番の配列で、各要素は resolve_listing と同じ形式（失敗した件のみ { error }）。5件を超える場合は5件ずつに分けて複数回呼ぶこと。1件だけなら resolve_listing を使う。

{
  "type": "object",
  "properties": {
    "listings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "出品タイトル（必須）"
          },
          "description": {
            "type": "string",
            "description": "説明文の抜粋（任意）"
          },
          "price_jpy": {
            "type": "number",
            "description": "出品価格（円、任意）"
          },
          "platform": {
            "type": "string",
            "enum": [
              "mercari",
              "yahoo",
              "surugaya",
              "mandarake",
              "other"
            ],
            "description": "出品プラットフォーム（任意）"
          },
          "url": {
            "type": "string",
            "description": "出品URL（任意・サーバー側では保存しない）"
          },
          "src": {
            "type": "string",
            "description": "計測用の流入元タグ（任意）。src自体と日時のみ利用ログに残す"
          }
        },
        "required": [
          "title"
        ],
        "additionalProperties": false
      },
      "description": "出品の配列（1〜5件）。各要素は resolve_listing と同じ引数"
    }
  },
  "required": [
    "listings"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sku_id または自然文クエリから、商品ライン・キャラ・寸法・再販履歴・出典URLなど商品の詳細を返す。

{
  "type": "object",
  "properties": {
    "sku_id": {
      "type": "string",
      "description": "正規SKU_ID（sku_id か query のどちらか必須）"
    },
    "query": {
      "type": "string",
      "description": "自然文クエリ（sku_id が無い場合に使用）"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

カタログから条件（IP・キャラ・予算・用途）に合う候補SKUを探す。実際に出品されているかは保証しない。

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "作品ID（例: kingdom-hearts）"
    },
    "character": {
      "type": "string",
      "description": "キャラ名（日英どちらでも可、任意）"
    },
    "budget_jpy": {
      "type": "number",
      "description": "予算上限（円、任意）"
    },
    "purpose": {
      "type": "string",
      "enum": [
        "display",
        "wear",
        "read",
        "play",
        "any"
      ],
      "description": "用途（任意、既定は any）"
    },
    "limit": {
      "type": "number",
      "description": "最大件数（任意、既定10）"
    },
    "terms": {
      "type": "object",
      "properties": {
        "types": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "character",
              "faction",
              "world",
              "item",
              "keyblade",
              "song",
              "event",
              "other"
            ]
          },
          "description": "固有語の種類で絞る（character/faction/world/item/keyblade/song/event/other）"
        },
        "names": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "固有語の名前で絞る（日英どちらでも可。例: XIII機関, Heartless）"
        }
      },
      "additionalProperties": false,
      "description": "data/ip_terms.csv の固有語（陣営・ワールド・キーブレード等）が名称・別名・備考に含まれる商品だけに絞る（任意）"
    }
  },
  "required": [
    "ip"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

出品価格・重量（またはsku_id）・仕向国から、代行×配送の経路別の総額目安と最安経路を返す。

{
  "type": "object",
  "properties": {
    "price_jpy": {
      "type": "number",
      "description": "出品価格（円、必須）"
    },
    "sku_id": {
      "type": "string",
      "description": "正規SKU_ID（重量の参照に使用、任意）"
    },
    "weight_g": {
      "type": "number",
      "description": "重量（g、sku_idが無い場合はこちらを指定）"
    },
    "dest_country": {
      "type": "string",
      "description": "仕向国（ISO2、例: US）"
    },
    "proxy": {
      "type": "string",
      "description": "代行名を指定して絞り込む（任意）"
    }
  },
  "required": [
    "price_jpy",
    "dest_country"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

カタログの誤り・不足を報告する。受付IDを返す。

{
  "type": "object",
  "properties": {
    "sku_id": {
      "type": "string",
      "description": "対象SKU_ID（任意。新規商品の提案なら空でよい）"
    },
    "field": {
      "type": "string",
      "description": "修正したい列名（例: msrp_jpy, name_en）"
    },
    "proposed_value": {
      "type": "string",
      "description": "提案する値"
    },
    "source_url": {
      "type": "string",
      "description": "根拠となる一次情報URL（任意）"
    },
    "note": {
      "type": "string",
      "description": "補足（任意）"
    }
  },
  "required": [
    "field",
    "proposed_value"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}