中古楽器店が、他店の販売価格と業者オークションの落札結果を n8n で毎日集め、Claude で自店の在庫と同じ条件の出品かを判定して、値付けの見直し候補を出す
他店の中古の販売価格と、業者オークションの落札結果を毎朝集め、出品ごとに自店の在庫と同じ条件で比べられるかを判定して、値付けの見直し候補の一覧を出します。バイヤーは候補だけを見て値付けを決めます。
- 生成AI
- ChatGPT/Claude/Gemini
- 連携・自動化
- Make/n8n/Power Automate/Zapier
- 対象業界
- EC/小売
- 対象部門
- 購買
- 対象業務
- 比較検討/集計・分析
- 主な課題
- データ分析に時間がかかる/判断に時間がかかる/属人化している
- AIで行う処理
- 判定
- 主な効果
- 判断支援/属人化解消/工数削減
- 導入難易度
- ★★★☆☆
- 実装レベル
- 本格構成
- 費用感
- API連携(中)
- 人間の確認
- 条件付き
01導入前 / 導入後の業務フロー
- バイヤーが在庫の表から、今日見直す在庫を選ぶ
- 通販のモールと他店のサイトで、型番で中古の出品を検索する
- 出品の題名と説明を読み、年代・状態・改造・付属品が自店の在庫と近いものを選ぶ
- 業者オークションの落札結果の CSV を開き、同じ機種の行を探す
- 選んだ出品の価格を書き出し、頭の中で相場を決める
- 自店の店頭価格と比べ、上げるか下げるか据え置くかを決める
- 店頭と通販の管理画面で価格を直す
- 自動業者オークションの落札結果のメールが届くと、n8n が添付の CSV を取り込み、落札の記録の表に足す
- 自動毎朝6時に n8n が動き、在庫の表から今日見直す在庫を選ぶ
- 自動在庫ごとに、通販のモールの商品検索 API で同じ型番の中古の出品を取る
- 自動落札の記録の表から、同じ型番の直近の落札を引く
- 自動出品と落札を Claude API へ渡し、1件ずつ自店の在庫と比べられるかを判定させる
- 自動Code ノードが、比べられる出品だけで販売価格と落札価格の中央値を別々に計算する
- 自動店頭価格と中央値の差、入荷からの日数から、見直し候補かどうかを決める
- 自動見直し候補の一覧を表に書き、バイヤーにメールで知らせる
- 人バイヤーが候補を開き、判定の根拠と比べた出品を確かめて、価格を決めて直す
各工程の詳しい説明を読む
- バイヤーが在庫の表から、今日見直す在庫を選ぶ
- 通販のモールと他店のサイトで、型番で中古の出品を検索する
- 出品の題名と説明を読み、年代・状態・改造・付属品が自店の在庫と近いものを選ぶ
- 業者オークションの落札結果の CSV を開き、同じ機種の行を探す
- 選んだ出品の価格を書き出し、頭の中で相場を決める
- 自店の店頭価格と比べ、上げるか下げるか据え置くかを決める
- 店頭と通販の管理画面で価格を直す
(a)検索と見比べに時間がかかる。 型番で検索すると新品・部品・ケースだけの出品が混ざり、1点の在庫に数十件の出品を読みます。
(b)条件の違う出品を混ぜてしまう。 「ピックアップ交換済み」「ネック反りあり」「ジャンク」は、説明の後ろのほうに書かれていることが多く、急いでいると価格だけを拾って相場に入れます。 相場が安く出て、値下げしなくてよい在庫を下げることになります。
(c)販売価格と落札価格を混ぜてしまう。 他店の店頭の価格は売りたい値段、業者オークションの落札は業者が買った値段です。同じ表に並べて平均すると、どちらでもない数字になります。
(d)値付けがバイヤーの経験に頼る。 比べる相手に選んだ出品が残らず、バイヤーごとに違う相場を出します。
- 【自動】 業者オークションの落札結果のメールが届くと、n8n が添付の CSV を取り込み、落札の記録の表に足す
- 【自動】 毎朝6時に n8n が動き、在庫の表から今日見直す在庫を選ぶ
- 【自動】 在庫ごとに、通販のモールの商品検索 API で同じ型番の中古の出品を取る
- 【自動】 落札の記録の表から、同じ型番の直近の落札を引く
- 【自動】 出品と落札を Claude API へ渡し、1件ずつ自店の在庫と比べられるかを判定させる
- 【自動】 Code ノードが、比べられる出品だけで販売価格と落札価格の中央値を別々に計算する
- 【自動】 店頭価格と中央値の差、入荷からの日数から、見直し候補かどうかを決める
- 【自動】 見直し候補の一覧を表に書き、バイヤーにメールで知らせる
- 【人】 バイヤーが候補を開き、判定の根拠と比べた出品を確かめて、価格を決めて直す
9番目が、この設計の分かれ目です。人が見るのは候補だけです。 中央値と店頭価格の差が小さい在庫は据え置きの一覧に入り、差が大きいものと、比べられる出品が少ないものに時間を使います。
6番目で販売価格と落札価格を分けているのは、第3章の(c)への答えです。 店頭価格が2つの中央値のどこにあるかでバイヤーが判断します。
02今回想定するシステム構成
【A】業者オークションの落札結果のメール(CSV 添付)
▼【トリガー】Email Trigger (IMAP)
Extract from File(CSV)→ Google Sheets:落札の記録の表に足す
【B】【トリガー】Schedule Trigger(毎朝6時、Asia/Tokyo)
▼
Google Sheets:在庫の表から今日見直す在庫を読む
▼ 在庫ごとに
HTTP Request ── 通販のモールの商品検索 API(中古、型番、価格の幅)
Google Sheets ── 落札の記録の表から同じ型番の直近の落札
▼
HTTP Request ── Claude API(構造化出力)
│ 出品ごとに:同じ機種か/条件は比べられるか/理由の文
▼
Code ── 比べられる出品だけで中央値(販売・落札を別々に)
── 店頭価格との差と入荷からの日数で候補を決める
▼
Google Sheets:見直し候補の表 ── Gmail:バイヤーへの知らせ
▼
【バイヤーが値付けを決めて管理画面で直す】| 役割 | 想定する製品 | 代替候補 |
|---|---|---|
| ワークフロー | n8n(Schedule Trigger、Email Trigger (IMAP)、HTTP Request、Extract from File、Code、Google Sheets、Gmail) | Make、Zapier、Power Automate |
| 生成AI | Claude API(Messages API、構造化出力) | OpenAI API、Gemini API |
| 相場の情報源 | Yahoo!ショッピングの商品検索 API(v3) | 自動の取得を認める他のモールの公式 API |
| 保管 | Google スプレッドシート(在庫の表・落札の記録の表・見直し候補の表・判定の記録の表) | Airtable |
新しく足すのは、2本のワークフローと、落札の記録の表と見直し候補の表です。 在庫の表は今のものを使い、この構成からは読むだけにします。 店頭と通販の価格の管理画面にも書き込みません。
通販のモールの出品は、Yahoo!ショッピングの商品検索 API(v3)で取ります。 公式のページでは、condition に used を指定すると中古に絞れ、query・price_from・price_to・sort(+price など)を指定できます。start と results の合計は1,000が上限で、1秒に1回の目安を超えて同じ URL に短い間に多く送ると一定時間使えなくなることがあり、429 は利用の一時的な制限です。応答には価格(price)、状態(condition)、ストアの名前(seller/name)、商品の URL(url)が入ります。
使う前に、商用の利用の可否を問い合わせます。 Yahoo! デベロッパーネットワークの案内では、Web API は利用者自身の便宜のための非商用の目的にだけ使えるとされ、商用のアプリケーションで使いたい法人の開発者は、その API の問い合わせの窓口に連絡するようにと書かれています。店の値付けに使うのは商用の目的なので、問い合わせて使ってよいと確かめてから組みます。 また、API を使うサイトやアプリケーションには、API のドキュメントへのリンクを付けたクレジットの表示が求められています。社内の見直し候補の表の下部にも表示します。
03どうやって実装するのか
処理の起点を決める
トリガーは2つに分けます。 1つ目は業者オークションの落札結果のメールが届いたとき、2つ目は毎朝6時です。落札の記録はメールが届くたびに貯め、見直しは毎朝まとめて行います。
落札結果のメールは Email Trigger (IMAP) で受けます。 公式のページでは、Email Trigger (IMAP) は IMAP のサーバーからメールを受け、読むメールボックスの名前、受けたメールを既読にするか(None/Mark as Read)、添付を取り込むか(Download Attachments)、形式(RAW/Resolved/Simple)を選べます。Resolved は添付をバイナリのデータとして返すとされているので、Download Attachments を有効にして Resolved で受けます。会員のメールだけが届く専用のメールボックスを作り、そこだけを読みます。
毎朝の見直しは Schedule Trigger で動かします。 公式のページでは、日ごとの間隔と時刻を指定でき、ワークフローにタイムゾーンを設定していなければ n8n のインスタンスのタイムゾーンを使い、自前で運用する場合の既定は America/New York とされています。ワークフローの設定で Asia/Tokyo を指定します。 また、ワークフローを保存して公開しないと予定どおりに動かないとされています。
1日に見直す在庫は、在庫の表から決まりで選びます。 600点を月に1回ずつ見るなら、1日に20〜30点です。入荷からの日数が長いもの、前回の見直しから日が経ったものを先に選びます。
入力データを集める
| データ | 中身 | 取得元 |
|---|---|---|
| 在庫 | 在庫の番号、メーカー、型番、製造の国と年代、色、状態のランク、改造の内容、付属品、店頭価格、入荷日、前回の見直しの日 | 在庫の表 |
| モールの出品 | 商品の名前、価格、状態、ストアの名前、商品の URL、説明の抜粋 | 商品検索 API の応答 |
| 落札の記録 | 開催日、品名、型番、状態の評価、落札価格 | 落札の記録の表(CSV から取り込んだもの) |
| 判定の決まり | 状態のランクの対応、比べられないとする語(ジャンク・部品取り・ケースのみ など) | 判定の決まりの表 |
| 候補の線引き | 店頭価格と中央値の差の幅、比べられる出品の最少の件数、入荷からの日数の区切り | 候補の線引きの表 |
質を決めるのは、在庫の表の改造と付属品の欄です。 自店の在庫の条件が書かれていなければ、出品と比べられるかを判定する基準がありません。 「ピックアップ交換(純正なし)」「ハードケース付き」のように、出品の説明と照らせる言葉で書きます。
落札の記録の状態の評価は、オークションの書き方のまま持ちます。 自店のランクとの対応は判定の決まりの表で持ちます。
データの取得方法を決める
| 取るもの | どこから | 何に使うか |
|---|---|---|
| 今日の在庫 | Google Sheets の Get Row(s) | 見直す在庫の条件と店頭価格 |
| モールの出品 | HTTP Request(商品検索 API、condition=used、query=メーカーと型番) | 販売価格の材料 |
| 落札の記録 | Google Sheets の Get Row(s)(型番で絞る) | 落札価格の材料 |
| 落札結果の CSV | Email Trigger (IMAP) の添付 → Extract from File | 落札の記録の表に足す |
| 判定の決まり・候補の線引き | Google Sheets の Get Row(s) | Claude への指示と Code の式 |
商品検索 API は、在庫1点につき1回、価格の幅を付けて呼びます。 price_from・price_to を店頭価格の半分から2倍のように決め、新品の価格帯や部品だけの安い出品を最初から外します。 公式のページでは両方の端を含みます。
呼ぶ間隔は、HTTP Request の Batching で空けます。 公式のページでは、HTTP Request には1回にまとめる件数と、まとまりの間隔(ミリ秒)の設定があります。1件ずつ、1,000ミリ秒より長い間隔にして、1秒に1回の目安を超えないようにします。
落札結果の CSV は Extract from File で行に直します。 公式のページでは、Extract from File は CSV・XLSX などから取り出せますが、CSV の区切りや文字コードの設定の記載がありません。 業者オークションの CSV が Shift_JIS のときに文字が化けないかを、最初の1通で必ず確かめます。 化けるなら、オークションの側に UTF-8 での書き出しを頼むか、XLSX で受けられないかを聞きます。
AIへ渡す前に整形する
- 出品から新品と自店の出品を外す …
conditionがusedでないものと、ストアの名前が自店のものを外します - 明らかに別の物を外す … 判定の決まりの表の語(ケースのみ・部品・ジャンク)が商品の名前にあるものを外します
- 出品に番号を付ける … 1件ずつ番号を付け、判定の結果を番号で戻します
- 販売と落札を見出しで分けて渡す … モールの出品と落札の記録を、別の見出しで渡します
- 件数をそろえる … 1点の在庫につき、モールの出品は価格の安い順に最大30件、落札は直近の30件までにします
- 価格を Claude に渡さない … 判定に価格は要りません。価格は番号で Code ノードが持ちます
6番目が、この設計でいちばん効く前処理です。 価格を渡すと、Claude は「この価格は相場より安すぎるので条件が悪いはず」と、価格から状態を推して判定します。 判定の根拠は、商品の名前と説明に書かれていることだけにします。
1番目の自店の出品を外すのも忘れないでください。 自店も同じモールに出していれば、自店の価格が相場の材料に入り、見直しの意味がなくなります。
AIに処理させる
させるのは、出品と落札の1件ずつについて、自店の在庫と同じ機種か、条件が比べられるかを判定し、根拠にした文を写すことだけです。
| 判定するもの | 判定の仕方 | 判断できないときの扱い |
|---|---|---|
| 同じ機種か | メーカー・型番・製造の国と年代・色が在庫と合うか | 年代の記載が無ければ unknown |
| 状態 | 説明の傷・反り・動作の記載から、在庫より better/similar/worse | 記載が無ければ unknown |
| 改造 | 交換・加工の記載があるか。在庫の改造と同じか | 記載が無ければ none_stated |
| 付属品 | ケース・保証書・元箱の有無が在庫と合うか | 記載が無ければ unknown |
| 比べられるか | 上の4つから comparable/not_comparable/uncertain | 1つでも unknown が重なれば uncertain |
unknown と not_comparable を分けるのが、この判定の要です。 「年代が書かれていない」は比べられないという意味ではなく、分からないという意味です。 分からない出品を全部外すと比べる相手が足りなくなり、全部入れると条件の違う出品が混ざります。Code ノードは comparable だけで中央値を出し、uncertain の件数は別に数えてバイヤーに見せます。
「状態が在庫より良い・悪い」は、説明の言葉だけで決めさせます。 「美品」「目立つ傷なし」「打痕あり」「フレット残り7割」のように書かれた言葉を、判定の決まりの表の例と照らします。写真は渡しません。 写真を見せると見た目の判断になり、根拠の文として残せません。
| させないこと | 理由 |
|---|---|
| 相場の価格を決める | 中央値は Code ノードが比べられる出品だけで計算する |
| 値上げ・値下げを勧める | 値付けはバイヤーが決める |
| 価格から状態を推す | 価格を渡さない。判定は説明の言葉だけ |
| 真贋やコピーモデルかを判断する | 出品の説明だけでは分からない。疑わしい語は印だけ |
| 書かれていない条件を補う | 年代や付属品が無ければ unknown |
4行目は明記しておきます。 説明に「〇〇タイプ」「〇〇モデル」と書かれた出品は、本家の型番ではない類似の品であることがあります。 Claude には真贋を判断させず、判定の決まりの表の語に当たれば not_comparable にして、その語を写させます。
指示内容を固定する
あなたは中古楽器店のバイヤーの補助として、相場の材料になる出品を振り分ける立場です。
【自店の在庫】と、番号の付いた【モールの出品】【落札の記録】だけを見て、
1件ずつ決められた形の JSON で判定してください。推測で埋めないでください。
【判定すること】
1. same_model:メーカー・型番・製造の国と年代・色が在庫と合うか
2. condition:説明の言葉から、在庫より better/similar/worse/unknown
3. modification:改造の記載。在庫と同じか、違うか、記載なしか
4. accessories:ケース・保証書・元箱が在庫と合うか
5. verdict:comparable/not_comparable/uncertain
【厳守事項】
- 判定は、商品の名前と説明に書かれた言葉だけで行ってください。
- 年代・状態・付属品が書かれていないときは unknown にしてください。
型番が同じでも、書かれていない条件を在庫と同じと見なさないでください。
- unknown が2つ以上ある出品は uncertain にしてください。
- 【判定の決まり】の語(ジャンク、部品取り、ケースのみ、〇〇タイプ など)に
当たる出品は not_comparable にし、当たった語を evidence に写してください。
- 本物か、コピーモデルかを判断しないでください。
- 相場の価格、値上げ・値下げの勧めを書かないでください。
- evidence には、判定の根拠にした言葉を説明からそのまま写してください。
【自店の在庫】{stock_item}
【判定の決まり】{rules}
【モールの出品】{listings}
【落札の記録】{auction_results}
「書かれていない条件を在庫と同じと見なさない」を書かないと、型番が合えば comparable にします。 説明が短い出品ほど条件の記載が無く、記載の無い出品を同じ条件と見なすと、第3章の(b)がそのまま起きます。
「unknown が2つ以上なら uncertain」と数で決めさせるのは、判定の厳しさが呼ぶたびに揺れないようにするためです。
出力形式を固定する
次の形の JSON で受け取ります。 Claude の構造化出力で、output_config.format に JSON スキーマを渡します。Claude API は HTTP Request のノードで、Authorization: Bearer(x-api-key は旧来の方法として引き続き使える)、anthropic-version、content-type: application/json のヘッダーを付けて呼びます。
{
"stock_id": "",
"judgements": [
{
"ref": "L01",
"source": "listing | auction",
"same_model": "yes | no | unknown",
"condition": "better | similar | worse | unknown",
"modification": "same | different | none_stated",
"accessories": "match | differ | unknown",
"verdict": "comparable | not_comparable | uncertain",
"evidence": ""
}
]
}
1つ目の理由は、判定と価格を番号で結べることです。 Code ノードは ref で、前処理で外しておいた価格と結び、verdict が comparable の出品だけで、source ごとに中央値を出します。 販売と落札は混ぜません。
2つ目は、候補の線引きを表で決められることです。 候補の線引きの表に、比べられる出品が3件以上、店頭価格が販売価格の中央値から上下に何%以上離れている、入荷から何日以上、のような条件を持たせ、Code ノードがそれを読みます。線引きを変えるときは表だけを直します。
3つ目は、スキーマの制約の扱いです。 公式のページでは、構造化出力は数値の最小・最大と文字列の長さの制約に対応せず、minItems は0か1だけ、オブジェクトには additionalProperties: false が要るとされています。enum の値は大文字小文字だけ違って返ることがあるとされているので、Code ノードでは小文字にそろえてから比べます。返った ref の集まりが渡した番号の集まりと合わなければ、その在庫は見直し候補を出さずに「要確認」にします。
システムへ連携する
| つなぎ先 | 方式 | 内容 |
|---|---|---|
| 会員のメールボックス | Email Trigger (IMAP) | 落札結果のメールと CSV の添付を受ける |
| 落札の記録の表 | Google Sheets の Append Row | CSV の行を足す |
| 在庫の表・判定の決まり・候補の線引き | Google Sheets の Get Row(s) | 読むだけ |
| 商品検索 API | HTTP Request(Batching で間隔を空ける) | 中古の出品の価格と説明 |
| Claude API | HTTP Request | 出品ごとの判定 |
| 見直し候補の表・判定の記録の表 | Google Sheets の Append or Update Row | 在庫の番号ごとに候補と中央値を書く |
| Gmail | メールの送信 | バイヤーへ候補の件数と表のリンクを知らせる |
見直し候補の表は、在庫の番号ごとに1行にします。 公式のページでは、Google Sheets のノードの Append or Update Row は行が無ければ足し、あれば更新します。 同じ在庫を翌月に見直したときは、同じ行が新しい中央値で上書きされ、前の値は判定の記録の表に日付つきで残します。
価格の管理画面には書き込みません。 候補の表に「据え置き・値下げ・値上げ」の欄を置き、バイヤーが決めた値を書きます。管理画面の価格を直すのはバイヤーです。 自動で直すと、判定の誤りがそのまま店頭の価格になります。
人が確認する
バイヤーは、見直し候補の表を次の順で見ます。
- 「要確認」の在庫を先に見る … 判定の番号がそろわなかった在庫です
- 比べた出品を開く …
comparableの出品の URL を開き、説明の条件が在庫と合っているかを確かめます uncertainの件数を見る … 多い在庫は、比べる相手が足りていません。中央値を割り引いて見ます- 販売と落札の2つの中央値の間で、店頭価格を決める … 入荷からの日数と、自店での売れ行きも合わせて決めます
- 決めた値を書き、管理画面で直す … 据え置きの判断も表に残します
2番目を省かないでください。 comparable の判定でも、説明の後ろのほうに書かれた「リペア歴あり」を読み落としていることがあります。比べた出品が3件なら、3件とも開いても数分です。
目標は、600件をならして1件4分です。 差が小さい在庫は据え置きの一覧で流し見て、差が大きい在庫と、比べる相手が少ない在庫に時間を使います。
例外に対処する
| 起きること | 対応 |
|---|---|
| 商品検索 API が 429 を返した | 利用の一時的な制限。その日の残りを止め、翌朝に回す |
| モールの出品が0件 | 落札の記録だけで中央値を出し、「販売の材料なし」の印 |
| 比べられる出品が線引きの件数に届かない | 候補にせず「材料不足」。バイヤーが手で探すか決める |
| 落札結果の CSV の文字が化けた | 取り込みを止め、元のメールに印。書き出しの形式をオークションに確かめる |
| 落札結果のメールに添付が無い | 取り込まず、担当に知らせる |
| 判定の番号がそろわない | 見直し候補を出さず「要確認」。同じ在庫でもう一度だけ呼ぶ |
stop_reason が refusal か max_tokens | 判定を使わず「要確認」。出品の件数を減らして呼び直す |
| 在庫の表の改造・付属品の欄が空 | 判定の基準が無い。Claude を呼ばず「在庫の記載不足」 |
4行目は、化けたまま型番で引くと落札の記録が0件に見える行です。 取り込んだ行数を毎回メールの件名と並べて残し、失敗と見分けます。
stop_reason の扱いも決めておきます。 公式のページでは、構造化出力でも拒否(refusal)や上限の到達(max_tokens)のときはスキーマに合わない出力になりうるとされています。出品が多くて上限に届いたときは、件数を減らして呼び直します。
記録を残す
- 見直した日、在庫の番号、そのときの店頭価格と在庫の条件
- 商品検索 API の応答と、落札の記録から引いた行(価格を含む)
- Claude に渡した本文と、返った判定の JSON の全文
- Code ノードが出した中央値(販売・落札)と、使った出品の番号
- バイヤーが決めた価格と、候補と違う判断をしたときの理由の一言
- 値付けを直した後に売れた日と売れた価格
最後の行が、候補の線引きを育てる材料です。 値下げした在庫が何日で売れたか、据え置いた在庫がどうなったかを月に1回並べ、線引きの%と日数の区切りを、店の売れ方に合わせて直します。
4つ目の「使った出品の番号」は、第3章の(d)への答えです。
04実装レベルの3段階
最小構成は、判定の指示と在庫の表の書き方を決めるための段階です。 半自動化で、1件15分が8分程度になります。 材料の収集と振り分けは自動になりますが、中央値の計算と候補の見極めをバイヤーが行う手間が残ります。本格構成で4分になり、この段階が本記事の想定です。 差が大きいのは、比べられる出品だけで販売と落札を分けて計算する作業が、1件ずつの手作業だからです。 段階を飛ばさないでください。 半自動化の一覧で、uncertain の多い機種が先に分かります。
05工数削減シミュレーション
導入後 600件 × 4分 ÷ 60 = 40 時間/月
自社条件で導入効果を整理したい方へ
このユースケースを自社に当てはめた場合の前提値と削減見込みを、業務ヒアリングをもとに整理します。
06向いている企業・向いていない企業
- ギター・ベース・エフェクター・管楽器などの中古を数百点以上の在庫で持ち、店頭と通販で売っている楽器店。他店の販売価格と業者オークションの落札の相場を見て値付けを見直す作業が、バイヤーの経験と手作業の検索に頼っている場合。在庫を型番・年代・状態・改造・付属品の欄でスプレッドシートに持てる場合。中古のオーディオ機器・カメラの店の値付けの見直しにも使える。
- 在庫が数十点で、バイヤーが毎週すべてを見て回れる場合。一点ものの古い楽器(ヴィンテージの弦楽器・和楽器など)が中心で、同じ条件の出品がほとんど無い場合。相場の情報を、自動での取得を認めていないサイトからしか得られない場合。なお、値付けの決定、楽器の状態と真贋の判断、買取価格の決定は、この構成では代替できません。
07最小構成で試す方法
- 在庫から、入荷から日が経ったものを中心に20点を選ぶ(うち数点は、改造品や付属品の欠けがあるものを入れる)
- 各在庫について、バイヤーが手で集めた他店の出品と落札を10件ずつ、価格を消して書き出す
- 手元のAIサービスの画面に、在庫の条件と出品の説明を貼る
- 「出品ごとに、在庫と同じ機種か、状態・改造・付属品が比べられるかを判定し、根拠の言葉を写してください。書かれていない条件は unknown にしてください」と指示する
- 判定を、バイヤーが手で選んだ「比べる相手」と見比べる
20点は必ずやってください。 ワークフローを組む前に、出品の説明の言葉だけで、バイヤーと同じ振り分けができるかを確かめます。
| 出てきた内容 | 判断 |
|---|---|
| バイヤーの選んだ相手とほぼ同じ振り分けになった | API とワークフローの組み立てに進む |
| 書かれていない条件を同じと見なしている | 指示の書き方で直る。構成は有効 |
| 在庫の条件が書かれておらず判定できない | 在庫の表の整備が先。 AIの問題ではない |
3行目は失敗ではなく、在庫の条件がバイヤーの記憶にしかなかったということです。
08実装時につまずきやすいポイント
| 問題 | 対策 |
|---|---|
| 改造品・ジャンク品の安値が相場に混ざる | 比べられるかを判定し、comparable だけで中央値 |
| 書かれていない条件を同じと見なす | 指示で禁じ、unknown が重なれば uncertain |
| 販売価格と落札価格を混ぜる | source ごとに中央値を分けて出す |
| 価格から状態を推して判定する | 価格を Claude に渡さない |
| 自店の出品が相場の材料に入る | ストアの名前で自店の出品を外す |
| 商品検索 API が止まる | 1秒に1回の目安を Batching の間隔で守る |
| 商用の利用の確かめをせずに組む | 非商用が前提。問い合わせの窓口で確かめてから使う |
| 落札の CSV の文字が化ける | 最初の1通で確かめ、書き出しの形式をオークションに頼む |
| 毎朝のはずが時差のある時刻に動く | 自前運用の既定は America/New York。Asia/Tokyo を指定 |
| 価格を自動で直す形にしてしまう | 候補の表までにする。 直すのはバイヤー |
| 規約で自動の取得を認めないサイトから集める | 公式の API と会員の受け取るデータに限る |
上の3行が、この構成の失敗のほとんどです。 どれも、比べてはいけないものを比べることから起きます。
09セキュリティ・AIガバナンス上の注意点
この構成で扱うデータ: 自店の在庫と店頭価格、他店の公開された出品の情報、そして会員として受け取る業者オークションの落札結果です。個人の情報は扱いません。
- 情報源の利用の条件を先に確かめる … Yahoo! デベロッパーネットワークの Web API は非商用の目的が前提で、商用は問い合わせが要ります。 業者オークションの落札結果も、会員の規約で社内の値付けに使ってよいか、外部のサービスに渡してよいかを確かめます
- 自動の取得を認めないサイトから集めない … 他店のサイトやフリマ・個人のオークションのページを、規約を確かめずに自動で読み取る構成にしません
- この構成は値付けを代替しません … 店頭価格を決めるのはバイヤーです。 この構成が出すのは、比べられる出品の振り分けと中央値の計算の結果です
- 楽器の状態と真贋を判断させない … 出品の説明の言葉だけでは状態も真贋も確定できません。疑わしい語は印を付けるだけにします
- 落札結果を外部へ出さない … 会員だけが受け取る落札の記録は、判定に要る品名・型番・状態の評価だけを Claude に渡し、価格は渡しません
誤りが起きた場合のリスクは、相場を低く見て値下げしすぎることと、高く見て売れ残らせることの2つです。 どちらも条件の違う出品を混ぜると起きるので、比べられるかの判定は設計で守ります。
10まず何から始めるか
1週目:情報源を確かめる
Yahoo!ショッピングの商品検索 API の商用の利用を問い合わせの窓口で確かめ、業者オークションの会員の規約で落札結果を社内の値付けに使えるかを確かめます。どちらかが使えなければ、使える情報源だけで始めます。
2週目:在庫の表を整える
在庫の表の改造と付属品の欄を、出品の説明と照らせる言葉で埋めます。入荷から日が経った在庫から先に埋めます。 判定の決まりの表(比べられないとする語、状態の言葉の対応)を作ります。
3週目:20点で試す
手で集めた出品の説明で、手元のAIサービスに判定させます。書かれていない条件を同じと見なしていないかを最優先で見ます。
4週目:落札の CSV の取り込みをつなぐ
Email Trigger (IMAP) と Extract from File で、落札結果を落札の記録の表に足すところまで作ります。最初の1通で文字コードと列を確かめます。
2か月目: 毎朝の見直しのワークフローで、商品検索 API と Claude の判定と Code ノードの中央値までをつなぎ、見直し候補の表を出します。3か月目以降: 値付けを直した在庫の売れた日と価格を月に1回並べ、候補の線引きを直します。1件15分が何分になったかを実測し、全在庫の見直しが毎月そろった時点で、この構成は完成です。
11関連ユースケース
12この仕組みを理解するための記事
13技術仕様の確認日・参考情報
| 確認した内容 | 情報源 | 確認日 |
|---|---|---|
商品検索 API(v3)の URL、appid が必須なこと。condition に new/used を指定できること。price_from・price_to が両端を含むこと。sort に +price などがあること。start と results の合計が1,000までであること。短い間に同じ URL へ大量に送ると一定時間使えなくなること(1クエリー/秒)。429 が利用の一時的な制限であること。応答に価格・状態・ストアの名前・商品の URL が入ること | Yahoo!デベロッパーネットワーク: 商品検索(v3) | 2026-11-19 |
| Web API は利用者自身の便宜のための非商用の目的にだけ使えること。商用のアプリケーションで使いたい法人の開発者は、その API の問い合わせの窓口に連絡すること | Yahoo!デベロッパーネットワーク: WebAPIの商用利用について | 2026-11-19 |
| API を利用するすべてのサイトやアプリケーションにクレジットの表示が要ること。アプリケーションの下部に置き、API のドキュメントのページにリンクすること | Yahoo!デベロッパーネットワーク: クレジット表示 | 2026-11-19 |
| Schedule Trigger で日ごとの間隔と時刻を指定できること。ワークフローのタイムゾーンが無ければインスタンスのタイムゾーンを使い、自前運用の既定が America/New York であること。保存して公開しないと動かないこと | n8n: Schedule Trigger | 2026-11-19 |
| HTTP Request にクエリの値・ヘッダー・JSON の本文、Batching(1回の件数とミリ秒の間隔)、Timeout、応答の形式、Never Error の設定があること | n8n: HTTP Request | 2026-11-19 |
| Email Trigger (IMAP) でメールボックスの名前、既読にするか(None/Mark as Read)、Download Attachments、形式(RAW/Resolved/Simple)を選べ、Resolved が添付をバイナリで返すこと | n8n: Email Trigger (IMAP) | 2026-11-19 |
| Extract from File が CSV・XLSX などから取り出せること。CSV の区切り・文字コードの設定の記載が無いこと | n8n: Extract from File | 2026-11-19 |
| Google Sheets のノードの Append or Update Row が、行が無ければ足し、あれば更新すること。Get Row(s) が行を読むこと | n8n: Google Sheets | 2026-11-19 |
構造化出力を output_config.format で指定すること。数値の最小・最大、文字列の長さの制約に対応せず、minItems は0と1のみ、additionalProperties は false が必要なこと。enum の大文字小文字が保証されないこと。refusal・max_tokens のときはスキーマに合わない出力になりうること | Claude API: Structured outputs | 2026-11-19 |
認証は Authorization: Bearer で、x-api-key は旧来の方法として引き続き使えること。anthropic-version と content-type が必要なこと | Claude API: API overview | 2026-11-19 |
情報源の利用の条件と、値付けの基準は、自社の責任者と、API の提供元・業者オークションの運営に確かめてください。 本記事は上の公開情報で確認できた範囲だけを扱っています。
実装ステータス:構成例。 公開仕様に基づいて設計した構成であり、当社で実際に構築・検証したものではありません。工数の数値はモデル条件による試算です。
自社の業務に使えるAI活用候補を整理します
このユースケース(UC-4162)についてのご相談はこちらから。
