traygerbig Yahoo Shopping Agent
╔══════════════════════════════════════════════════════╗
║ ║
║ ┌─────────────────────────────┐ ║
║ │ ╔═══════════════════════╗ │ ║
║ │ ║ Y! SHOPPING ║ │ ║
║ │ ║ ─────────────── ║ │ ║
║ │ ║ STORE AGENT ║ │ ║
║ │ ║ PayPay Mall Ready ║ │ ║
║ │ ╚═══════════════════════╝ │ ║
║ │ │ ║
║ │ [STR] Store Management │ ║
║ │ [ORD] Order Processing │ ║
║ │ [ADV] StoreMatch Ads │ ║
║ │ [PAY] PayPay Integration │ ║
║ │ [CPN] Coupon & Campaign │ ║
║ ╰─────────────────────────────╯ ║
║ ║
║ Y A H O O ! S H O P P I N G A G E N T v1.0 ║
║ ─── PayPay経済圏をAIで攻略する ─── ║
║ ║
╚══════════════════════════════════════════════════════╝
claude-code yahoo shopping ecommerce japan
Yahoo!ショッピング出品・在庫・注文・ストアマッチ広告・クーポン管理をAPI連携で完全自動化。PayPay経済圏を最大活用するAIエージェント。
Author: hanabi-jpn Version: 1.0.0 License: MIT Tags: yahoo, shopping, paypay, ecommerce, japan, marketplace, storematch
Overview
Yahoo Shopping Agent は、Yahoo!ショッピングAPIを通じてストア運営を包括的に自動化するAIエージェントです。商品出品、在庫管理、注文処理、ストアマッチ広告運用、PayPayモール対応、クーポン管理、レビュー管理、売上分析を単一のインターフェースから実行します。Yahoo!ショッピングは月間訪問者数約5,800万人、PayPay経済圏との連携により高い集客力を誇る日本有数のECモールです。出店料・月額固定費無料のため、低リスクでの出店が可能です。
┌────────────────────────────────────────────────────────────────────┐
│ YAHOO SHOPPING AGENT ARCHITECTURE │
│ │
│ ┌───────────┐ ┌────────────────┐ ┌────────────────┐ │
│ │ Claude │──────▶│ Yahoo Shopping │─────▶│ Yahoo! │ │
│ │ Code │◀──────│ Agent │◀─────│ Shopping API │ │
│ └───────────┘ └──────┬─────────┘ └───────┬────────┘ │
│ │ │ │
│ ┌────────┼─────────┐ │ │
│ ▼ ▼ ▼ ▼ │
│ ┌─────────┐┌────────┐┌──────────┐ ┌──────────┐ │
│ │Product ││Order ││StoreMatch│ │ PayPay │ │
│ │Manager ││Handler ││Ads │ │ Wallet │ │
│ └────┬────┘└───┬────┘└────┬─────┘ └──────────┘ │
│ │ │ │ │
│ ┌────▼─────────▼──────────▼──────────────┐ │
│ │ Campaign Engine │ │
│ │ 5のつく日・PayPayジャンボ・超PayPay祭 │ │
│ └────────────┬────────────────────────────┘ │
│ │ │
│ ┌────────────▼────────────────────────────┐ │
│ │ Coupon & Promotion Engine │ │
│ │ クーポン配布・ポイント倍率・SALE管理 │ │
│ └────────────┬────────────────────────────┘ │
│ │ │
│ ┌────────────▼────────────────────────────┐ │
│ │ Analytics Dashboard │ │
│ │ 売上・アクセス・転換率・広告効果分析 │ │
│ └────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────┘
System Prompt Instructions
You are an agent equipped with Yahoo Shopping Agent for Yahoo!ショッピング store management. Follow these rules precisely when the user invokes Yahoo commands. Always optimize for Yahoo!ショッピング's search algorithm and the PayPay economic ecosystem.
Behavioral Guidelines
- Yahoo! ID連携認証を常に検証する。 コマンド実行前にOAuth2.0アクセストークンの有効期限を確認し、期限切れの場合はRefresh Tokenで自動更新する。Yahoo! ID連携v2のフローに従う。
- 商品出品はYahoo!ショッピングの商品データ仕様に厳密に準拠する。 必須項目（商品名、価格、在庫数、商品画像、カテゴリコード）を事前にバリデーションする。
- ストアマッチ広告はROAS目標に基づいて最適化する。 デフォルトROAS目標は300%。入札額の自動調整、無効キーワードの除外、パフォーマンスレポートの自動生成を行う。
- PayPay経済圏イベントを最大活用する。 5のつく日、超PayPay祭、PayPayジャンボなど、Yahoo!ショッピング固有のイベントカレンダーを管理し、事前準備を自動化する。
- PRオプション料率は利益率とランキングのバランスを取って設定する。 PRオプション料率（1-30%）を商品カテゴリと競合状況に応じて最適化提案する。
- クーポン施策は費用対効果を事前シミュレーションする。 クーポン発行前に想定利用率・売上増加率・利益影響を算出し、判断材料を提供する。
- レビュー管理では迅速な返信と評価改善を支援する。 低評価レビューは24時間以内の対応を推奨し、AI返信案を生成する。
- 注文処理は出荷期限を厳守する。 Yahoo!ショッピングの出荷遅延ペナルティ基準（注文確認後3営業日以内出荷）を管理し、期限超過リスクをアラートする。
- ストアクリエイターPro連携でページカスタマイズを支援する。 トップページ、カテゴリページ、フリースペースのHTML編集を自動生成する。
- APIレート制限を厳守する。 Yahoo!ショッピングAPIの呼び出し制限をトラッキングし、制限超過を回避する。
- Yahoo!プレミアム会員向けの特別施策を提案する。 プレミアム会員はポイント還元率が高く、ターゲティングの主要セグメントとなる。
- 商品画像は仕様に準拠する。 メイン画像は白背景推奨、JPEG/PNG、最大500KB、推奨800x800px以上。テキストオーバーレイは画像面積の20%以下。
- PayPayモール出店基準を監視する。 優良店舗評価（ストア評価4.0以上、出荷遅延率5%以下等）を維持し、PayPayモール掲載資格を保護する。
- CSV一括処理で大量商品操作を効率化する。 100件以上の商品操作はCSVアップロードAPIを使用し、処理効率を最大化する。
- 季節イベント・セール対応を計画的に実施する。 お中元、お歳暮、母の日、クリスマスなど、Yahoo!ショッピングの主要セール期間を年間カレンダーで管理する。
Yahoo! Shopping API Endpoint Reference
Yahoo!ショッピングAPIはREST (JSON/XML)形式。OAuth 2.0認証(Yahoo! ID連携v2)を使用。
商品管理API:
| Method | Endpoint | Description |
|---|---|---|
| POST | /ShoppingWebService/V1/editItem |
商品登録・更新 |
| GET | /ShoppingWebService/V1/getItem |
商品情報取得 |
| POST | /ShoppingWebService/V1/deleteItem |
商品削除 |
| POST | /ShoppingWebService/V1/uploadItemFile |
CSV一括登録 |
| GET | /ShoppingWebService/V1/getItemList |
商品一覧取得 |
在庫管理API:
| Method | Endpoint | Description |
|---|---|---|
| POST | /ShoppingWebService/V1/updateStock |
在庫数更新 |
| GET | /ShoppingWebService/V1/getStock |
在庫数取得 |
| POST | /ShoppingWebService/V1/updateStockFile |
CSV一括在庫更新 |
注文管理API:
| Method | Endpoint | Description |
|---|---|---|
| GET | /ShoppingWebService/V1/orderList |
注文一覧取得 |
| GET | /ShoppingWebService/V1/orderInfo |
注文詳細取得 |
| POST | /ShoppingWebService/V1/orderStatusChange |
注文ステータス変更 |
| POST | /ShoppingWebService/V1/orderPayStatusChange |
入金ステータス変更 |
| POST | /ShoppingWebService/V1/orderShipNumberSet |
配送伝票番号登録 |
ストアマッチ広告API:
| Method | Endpoint | Description |
|---|---|---|
| POST | /StoreMatch/V1/createCampaign |
キャンペーン作成 |
| GET | /StoreMatch/V1/getCampaignList |
キャンペーン一覧 |
| PUT | /StoreMatch/V1/updateCampaign |
キャンペーン更新 |
| GET | /StoreMatch/V1/getReport |
パフォーマンスレポート |
| POST | /StoreMatch/V1/addKeyword |
キーワード追加 |
レビューAPI:
| Method | Endpoint | Description |
|---|---|---|
| GET | /ShoppingWebService/V1/getReviewList |
レビュー一覧取得 |
| POST | /ShoppingWebService/V1/replyReview |
レビュー返信投稿 |
| GET | /ShoppingWebService/V1/getReviewSummary |
レビュー集計情報 |
クーポンAPI:
| Method | Endpoint | Description |
|---|---|---|
| POST | /ShoppingWebService/V1/createCoupon |
クーポン作成 |
| GET | /ShoppingWebService/V1/getCouponList |
クーポン一覧 |
| PUT | /ShoppingWebService/V1/updateCoupon |
クーポン更新 |
| DELETE | /ShoppingWebService/V1/deleteCoupon |
クーポン削除 |
| GET | /ShoppingWebService/V1/getCouponReport |
クーポン利用レポート |
Core Capabilities
1. 商品管理:
- 商品登録・編集・削除（個別/CSV一括）
- カテゴリ・スペック設定
- 商品画像管理（最大20枚、500KB以内）
- 商品説明文の自動生成・最適化
- SEO対策（商品名75文字最適化、キャッチコピー設定）
- PRオプション料率の個別設定
- バリエーション商品の管理（色・サイズ等）
- 定期購入商品の設定
2. 在庫管理:
- リアルタイム在庫確認
- 在庫数一括更新（CSV対応）
- 在庫切れアラート（販売速度ベース）
- 入荷予定管理
- 品切れ商品の自動非公開設定
3. 注文管理:
- 新規注文の一覧・詳細確認
- 注文ステータス更新（確認→出荷→完了）
- 配送伝票番号の登録（ヤマト/佐川/日本郵便）
- 入金ステータス管理（コンビニ/後払い）
- キャンセル・返品処理
- お届け日指定管理
4. 広告運用:
- ストアマッチ広告のキャンペーン管理
- キーワード別入札額の最適化
- PRオプション料率の自動調整
- アイテムマッチ広告の運用
- 日次/週次/月次の広告効果レポート
- ROAS目標に基づく予算配分最適化
5. レビュー管理:
- レビュー一覧と評価分布の可視化
- AI返信文の自動生成（丁寧な日本語対応）
- 低評価レビューの優先対応アラート
- レビュー促進施策の提案
- 競合ストアのレビュー傾向分析
Product Optimization Workflow
商品ページの品質スコアリングと最適化を実行するワークフロー:
┌───────────────────────────────────────────────────┐
│ 商品ページ最適化ワークフロー │
│ │
│ Step 1: 現状分析 │
│ └─ 商品名の文字数・キーワード配置チェック │
│ └─ 商品画像の枚数・品質チェック │
│ └─ 商品説明のHTML構造チェック │
│ └─ PRオプション料率と競合比較 │
│ │
│ Step 2: Yahoo! SEO最適化 │
│ └─ 商品名を最適化（75文字以内推奨） │
│ 例: NG「おいしいコーヒー」 │
│ 例: OK「コーヒー豆 スペシャルティ 200g │
│ 自家焙煎 ブラジル産 送料無料」 │
│ └─ キャッチコピーの設定 │
│ └─ プロダクトカテゴリの最適設定 │
│ │
│ Step 3: 品質スコアリング │
│ └─ 100点満点でスコアを算出 │
│ - 商品名: 25pt (キーワード配置、文字数) │
│ - 画像: 25pt (枚数、品質、白背景) │
│ - 説明文: 25pt (情報量、HTML、読みやすさ) │
│ - PRオプション/レビュー: 25pt │
│ │
│ Step 4: 改善提案レポート出力 │
└───────────────────────────────────────────────────┘
Environment Variables
| Variable | Description | Required | Default |
|---|---|---|---|
YAHOO_CLIENT_ID |
Yahoo! ID連携 アプリケーションID (Client ID) | Yes | - |
YAHOO_CLIENT_SECRET |
Yahoo! ID連携 シークレットキー | Yes | - |
YAHOO_SELLER_ID |
Yahoo!ショッピング ストアアカウントID | Yes | - |
YAHOO_STORE_ACCOUNT |
ストアクリエイターPro ストアアカウント名 | Yes | - |
YAHOO_REFRESH_TOKEN |
OAuth 2.0 Refresh Token (長期有効) | Yes | - |
YAHOO_STOREMATCH_ACCOUNT_ID |
ストアマッチ広告 アカウントID | No | - |
YAHOO_CALLBACK_URL |
OAuth認証コールバックURL | No | - |
YAHOO_WEBHOOK_URL |
注文通知Webhook受信URL | No | - |
API Base: https://circus.shopping.yahooapis.jp
StoreMatch API: https://ss.yahooapis.jp
Authentication: OAuth 2.0 (Yahoo! ID連携v2)
Commands
yahoo list [--search <query>] [--category <code>] [--status <active|draft>]
商品一覧を表示します。
$ yahoo list --search "コーヒー"
╔══════════════════════════════════════════════════════════════════════╗
║ Yahoo!ショッピング 商品リスティング ║
╠══════════════════════════════════════════════════════════════════════╣
║ 商品コード | 商品名 | 価格 | 在庫 | 状態║
║────────────────┼───────────────────────────────┼─────────┼──────┼────║
║ COFFEE-BL-001 | スペシャルティブレンド 200g | ¥1,480 | 342 | 公開║
║ COFFEE-DR-002 | ドリップバッグ 30袋セット | ¥2,980 | 87 | 公開║
║ COFFEE-GF-003 | ギフトセット 3種アソート | ¥3,980 | 124 | 公開║
║ COFFEE-IC-004 | 水出しコーヒーボトル 1L | ¥1,280 | 0 | 品切║
╠══════════════════════════════════════════════════════════════════════╣
║ 合計: 4件 | 公開中: 3件 | 品切れ: 1件 ║
║ [警告] COFFEE-IC-004: 在庫0 — 非公開またはを在庫補充を推奨 ║
╚══════════════════════════════════════════════════════════════════════╝
yahoo inventory [--low-stock] [--export]
在庫一覧と在庫切れアラートを表示します。
$ yahoo inventory --low-stock
╔══════════════════════════════════════════════════════════════════════╗
║ 在庫アラート (残り30個以下) ║
╠══════════════════════════════════════════════════════════════════════╣
║ 商品コード | 商品名 | 在庫 | 日販 | 残日数 ║
║────────────────┼───────────────────────────┼──────┼──────┼──────────║
║ COFFEE-IC-004 | 水出しコーヒーボトル 1L | 0 | 3.2 | 0日(品切)║
║ TEA-GT-012 | 静岡深蒸し煎茶 100g | 12 | 1.8 | 6.7日 ║
║ COFFEE-DR-002 | ドリップバッグ 30袋セット | 28 | 2.1 | 13.3日 ║
╠══════════════════════════════════════════════════════════════════════╣
║ [緊急] COFFEE-IC-004: 即時補充が必要 ║
║ [警告] TEA-GT-012: 7日以内に在庫切れ予測 — 発注推奨 ║
║ [注意] COFFEE-DR-002: 2週間以内に在庫切れ予測 ║
╚══════════════════════════════════════════════════════════════════════╝
yahoo order [--status <new|processing|shipped>] [--id <order-id>]
注文一覧と詳細を管理します。
$ yahoo order --status new
╔══════════════════════════════════════════════════════════════════════╗
║ 新規注文一覧 ║
╠══════════════════════════════════════════════════════════════════════╣
║ 注文ID | 注文日 | 商品 | 金額 | 決済 ║
║─────────────────┼────────────┼───────────────────┼────────┼─────────║
║ ys-20260301-001 | 2026-03-01 | ブレンド200g x2 | ¥2,960 | PayPay ║
║ ys-20260301-002 | 2026-03-01 | ギフトセット | ¥3,980 | クレカ ║
║ ys-20260301-003 | 2026-03-01 | ドリップ30袋 x1 | ¥2,980 | コンビニ║
║ ys-20260228-015 | 2026-02-28 | 煎茶100g + 紅茶 | ¥3,260 | PayPay ║
╠══════════════════════════════════════════════════════════════════════╣
║ 合計: 4件 | PayPay: 2件 | クレジット: 1件 | コンビニ: 1件 ║
║ [要対応] ys-20260228-015: 注文から24時間超過 — 早急に出荷処理 ║
║ [注意] ys-20260301-003: コンビニ決済 — 入金確認後に出荷 ║
╚══════════════════════════════════════════════════════════════════════╝
yahoo ad [--campaign <id>] [--period <day|week|month>]
ストアマッチ広告のパフォーマンスを表示します。
$ yahoo ad --period month
╔══════════════════════════════════════════════════════════════════════╗
║ ストアマッチ広告 月次レポート — 2026年2月 ║
╠══════════════════════════════════════════════════════════════════════╣
║ キャンペーン | 予算 | 消化 | クリック | 売上 | ROAS ║
║──────────────────┼────────┼─────────┼─────────┼──────────┼─────────║
║ コーヒー_汎用 | ¥60,000| ¥54,200 | 2,847 | ¥328,400 | 606% ║
║ ギフト_季節 | ¥40,000| ¥38,600 | 1,423 | ¥187,200 | 485% ║
║ 茶葉_ブランド | ¥30,000| ¥27,800 | 1,102 | ¥67,400 | 242% ║
╠══════════════════════════════════════════════════════════════════════╣
║ 合計消化: ¥120,600 | 合計売上: ¥583,000 | 平均ROAS: 483% ║
║ [最適化] 茶葉_ブランド: ROAS目標300%を下回り → KW見直し推奨 ║
║ [提案] コーヒー_汎用: 高効率 → 予算30%増額で売上拡大の余地あり ║
╚══════════════════════════════════════════════════════════════════════╝
yahoo review [--rating <1-5>] [--unreplied]
レビュー管理と分析を行います。
$ yahoo review --unreplied
╔══════════════════════════════════════════════════════════════════════╗
║ 未返信レビュー一覧 ║
╠══════════════════════════════════════════════════════════════════════╣
║ 日付 | 評価 | 商品名 | 内容 (抜粋) ║
║────────────┼──────┼───────────────────────┼─────────────────────────║
║ 2026-02-28 | ★★★★★ | ブレンド200g | 香りが素晴らしい。毎朝… ║
║ 2026-02-27 | ★★☆☆☆ | ドリップバッグ30袋 | 個包装が破れていた。味… ║
║ 2026-02-25 | ★★★★☆ | ギフトセット | 包装がきれいで喜ばれ… ║
╠══════════════════════════════════════════════════════════════════════╣
║ 未返信: 3件 | うち低評価(3以下): 1件 ║
║ [優先対応] ★2レビュー: 個包装破損 — 品質管理の確認と返信が必要 ║
║ ║
║ AI返信案 (★2レビュー): ║
║ 「この度は商品に不備があり、大変申し訳ございません。個包装の ║
║ 破損について、梱包体制を見直し改善いたします。代替品の発送等 ║
║ ご希望がございましたら、ストアまでお気軽にご連絡ください。 ║
║ 貴重なご意見ありがとうございました。」 ║
╚══════════════════════════════════════════════════════════════════════╝
yahoo report [--type <sales|access|conversion>] [--period <day|week|month>]
売上・アクセス・転換率レポートを生成します。
$ yahoo report --type sales --period month
╔══════════════════════════════════════════════════════════════════════╗
║ Yahoo!ショッピング 月次売上レポート — 2026年2月 ║
╠══════════════════════════════════════════════════════════════════════╣
║ 売上合計: ¥2,487,600 (前月比 +22.4%) ║
║ 注文件数: 487件 (前月比 +19.8%) ║
║ 客単価: ¥5,108 (前月比 +2.2%) ║
║ アクセス数: 67,420PV (前月比 +14.6%) ║
║ 転換率: 0.72% (前月比 +0.06pt) ║
║ ║
║ 決済方法別: ║
║ PayPay: ¥1,194,048 (48.0%) ║
║ クレジットカード: ¥745,284 (29.9%) ║
║ コンビニ決済: ¥348,264 (14.0%) ║
║ その他: ¥200,004 (8.1%) ║
║ ║
║ イベント効果: ║
║ 5のつく日(2/5,15,25): 売上¥623,400 (全体の25.1%) ║
║ 超PayPay祭(2/10-20): 売上¥847,200 (全体の34.0%) ║
╚══════════════════════════════════════════════════════════════════════╝
yahoo campaign [--type <sale|event|seasonal>] [--action <create|list|optimize>]
キャンペーン・セール管理を行います。
$ yahoo campaign --action list
╔══════════════════════════════════════════════════════════════════════╗
║ キャンペーン管理 ║
╠══════════════════════════════════════════════════════════════════════╣
║ キャンペーン名 | 期間 | ステータス | 効果 ║
║──────────────────────┼───────────────────┼───────────┼──────────────║
║ 春の新生活応援SALE | 3/1 - 3/31 | 実施中 | — ║
║ 超PayPay祭連動 | 3/10 - 3/20(予定) | 準備中 | — ║
║ ホワイトデー特集 | 3/1 - 3/14 | 実施中 | 売上+32% ║
║ バレンタインSALE | 2/1 - 2/14 | 終了 | 売上+48% ║
╠══════════════════════════════════════════════════════════════════════╣
║ [準備] 超PayPay祭連動: クーポン設定・PRオプション調整を3/8までに ║
║ [推奨] 春の新生活応援: ストアマッチ広告予算を通常の1.5倍に ║
╚══════════════════════════════════════════════════════════════════════╝
yahoo coupon [--action <create|list|analyze>] [--type <fixed|percent|shipping>]
クーポンの作成・管理・効果分析を行います。
$ yahoo coupon --action list
╔══════════════════════════════════════════════════════════════════════╗
║ クーポン一覧 ║
╠══════════════════════════════════════════════════════════════════════╣
║ クーポンID | 内容 | 期間 | 使用/上限 ║
║─────────────┼────────────────────────┼──────────────┼───────────────║
║ CPN-SP-001 | 全品10%OFF | 3/1-3/31 | 47/500 ║
║ CPN-NW-002 | 新規購入者¥300OFF | 常時 | 234/無制限 ║
║ CPN-FR-003 | ¥5,000以上で送料無料 | 3/1-3/14 | 89/200 ║
╠══════════════════════════════════════════════════════════════════════╣
║ [分析] CPN-SP-001: 利用率9.4%、売上貢献¥187,200、利益影響-¥18,720 ║
║ [分析] CPN-NW-002: 新規獲得効果大、リピート率28.3% ║
║ [提案] 5のつく日限定クーポン追加でPayPayユーザー獲得を強化 ║
╚══════════════════════════════════════════════════════════════════════╝
Workflow Diagram
┌─────────────────────────────────────────────────────────────────────┐
│ Yahoo!ショッピング 運用ワークフロー │
│ │
│ 毎朝 ┌──────────────────────────────────────────────┐ │
│ 07:00 │ 1. 注文確認・処理 │ │
│ │ └─ 新規注文の一括確認 │ │
│ │ └─ コンビニ決済の入金確認 │ │
│ │ └─ 出荷期限の迫る注文の優先処理 │ │
│ └──────────────────┬───────────────────────────┘ │
│ ▼ │
│ 09:00 ┌──────────────────────────────────────────────┐ │
│ │ 2. 在庫チェック │ │
│ │ └─ 低在庫商品のアラート確認 │ │
│ │ └─ 品切れ商品の非公開設定 │ │
│ │ └─ 入荷予定商品の在庫数更新 │ │
│ └──────────────────┬───────────────────────────┘ │
│ ▼ │
│ 11:00 ┌──────────────────────────────────────────────┐ │
│ │ 3. 広告・クーポン最適化 │ │
│ │ └─ ストアマッチ広告のパフォーマンス確認 │ │
│ │ └─ 入札額の調整 │ │
│ │ └─ クーポン利用状況の確認 │ │
│ │ └─ PRオプション料率の調整 │ │
│ └──────────────────┬───────────────────────────┘ │
│ ▼ │
│ 15:00 ┌──────────────────────────────────────────────┐ │
│ │ 4. レビュー・問い合わせ対応 │ │
│ │ └─ 新着レビューの確認 │ │
│ │ └─ 低評価レビューへの返信 │ │
│ │ └─ 購入者問い合わせへの回答 │ │
│ └──────────────────┬───────────────────────────┘ │
│ ▼ │
│ 18:00 ┌──────────────────────────────────────────────┐ │
│ │ 5. 日次レポート │ │
│ │ └─ 売上・アクセス数サマリー │ │
│ │ └─ 広告効果サマリー │ │
│ │ └─ イベント効果の確認 │ │
│ │ └─ 翌日のアクション整理 │ │
│ └──────────────────────────────────────────────┘ │
│ │
│ イベント日 ┌────────────────────────────────────────┐ │
│ (5のつく日)│ 特別対応 │ │
│ │ └─ ポイント倍率の確認 │ │
│ │ └─ 限定クーポンの有効化 │ │
│ │ └─ ストアマッチ入札額の一時増額 │ │
│ │ └─ リアルタイム売上モニタリング │ │
│ └────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
Error Handling
| Error Code | Meaning | Agent Action |
|---|---|---|
auth_expired |
OAuth 2.0 アクセストークン期限切れ | Refresh Tokenで自動再取得。失敗時は再認証URLを表示 |
invalid_parameter |
APIリクエストパラメータ不正 | エラー詳細のフィールドを特定し、正しい形式を案内 |
item_not_found |
指定商品コードが存在しない | 商品コードの再確認を促す。類似商品の候補を表示 |
stock_negative |
在庫数がマイナスに設定された | 在庫数を0以上に修正し、正しい値を確認 |
order_already_shipped |
既に出荷済みの注文を操作 | 現在のステータスを表示し、適切な操作を案内 |
rate_limit_exceeded |
API呼び出し制限超過 | 指数バックオフで自動リトライ（最大60秒） |
storematch_budget_exceeded |
ストアマッチ広告予算上限到達 | 予算増額または入札額調整を提案 |
coupon_conflict |
重複するクーポン条件 | 既存クーポンとの条件重複を表示し、調整を案内 |
image_too_large |
画像ファイルサイズ超過 (500KB上限) | 画像圧縮を実行し、リサイズ後に再アップロード |
csv_format_error |
CSV一括処理のフォーマット不正 | エラー行番号とフィールドを特定し、修正案を提示 |
FAQ
Q: Yahoo!ショッピングの出店費用は？ A: 出店料・月額固定費は無料です。売上発生時に成約手数料(ストアポイント原資1%+成約手数料なし)が発生します。主要コストはPRオプション料率(任意)とストアマッチ広告費(任意)です。
Q: PayPayモール掲載の条件は？
A: ストア評価4.0以上、出荷遅延率5%以下、キャンセル率2%以下、直近3ヶ月の売上実績が必要です。yahoo health コマンドで現在の指標を確認できます。
Q: PRオプション料率の推奨値は？
A: カテゴリ平均は5-10%です。新規出店時は8-12%で露出を確保し、レビューが蓄積されたら5-7%に段階的に下げるのが効果的です。yahoo ad optimize で最適値を算出します。
Q: 5のつく日の対策は？
A: 5のつく日はPayPayポイント還元が増加し、アクセスが通常の2-3倍になります。yahoo campaign --type event で自動的にクーポン発行、ストアマッチ入札額増額、特集ページ更新を準備します。
Q: ストアマッチ広告の推奨予算は？ A: 月商の3-5%が目安です。ROAS 300%を目標に、キーワードごとの入札額を調整します。開始時はオートターゲティングで幅広く配信し、データ蓄積後にマニュアル運用に移行することを推奨します。
Q: 楽天やAmazonとの在庫連動は？
A: Rakuten SellerやAmazon Japan Sellerスキルと併用することで在庫同期が可能です。yahoo sync --enable で他プラットフォームとの在庫引当を自動化します。
Q: ストアクリエイターProでのページ編集は？
A: yahoo storefront edit でトップページ、カテゴリページ、フリースペースのHTML編集をAIが支援します。Yahoo!ショッピングの独自タグ仕様にも対応しています。
Q: 注文のコンビニ決済待ちへの対処は？ A: コンビニ決済は注文から14日間の支払い猶予があります。エージェントは入金確認を自動監視し、入金済みになった時点で出荷処理キューに追加します。未入金のまま期限切れの場合は自動キャンセルを案内します。
Q: 商品ページのSEO対策は？
A: Yahoo!ショッピングの検索アルゴリズムでは、商品名(75文字推奨)、キャッチコピー、PRオプション料率、売上実績、レビュー評価が主要因子です。yahoo seo analyze で現在のスコアと改善提案を取得できます。
Q: CSV一括処理の最大件数は？
A: 1回のCSVアップロードで最大10,000件の商品を処理できます。処理時間は件数に応じて5-30分です。yahoo list --bulk-upload <file> でCSVフォーマットの自動検証と一括登録を行います。
Q: LYPプレミアム特典とは何ですか？ A: LYPプレミアム（旧Yahoo!プレミアム + LINE連携）会員はYahoo!ショッピングでの購入時にポイント還元率が大幅に上がります。ストア側としては、LYPプレミアム会員向けの限定クーポンを発行することで、高い購買力を持つ会員の来店率を高められます。
Q: Yahoo!ショッピングのアフィリエイト設定は？
A: バリューコマース経由のアフィリエイトに対応しています。アフィリエイト報酬料率（1-50%）をストア管理画面から設定でき、yahoo affiliate rate コマンドで商品カテゴリ別の料率最適化を提案します。高料率設定はアフィリエイター経由の集客増加に効果的です。
Q: ストア評価を改善するにはどうすればいい？
A: ストア評価は出荷速度、問い合わせ対応速度、レビュー評点の3要素で構成されます。yahoo health で各指標を可視化し、改善優先順位を提案します。特に出荷遅延率の低減が最も効果的で、注文確認後24時間以内の出荷を目標にすることを推奨します。
Q: 複数ストアを管理できますか？
A: はい、環境変数で複数のストアアカウントを設定し、--store フラグでストアを切り替えて操作できます。yahoo stores list で登録済みストア一覧と各ストアの売上サマリーを確認できます。
Review Response AI Workflow
エージェントはレビュー内容を分析し、文脈に応じた適切な返信を自動生成します:
Input: 低評価レビュー (★2)
「商品自体は良かったが、到着まで10日もかかった。
問い合わせても返信が遅かった。」
AI Analysis:
→ Sentiment: Negative (配送+対応) / Positive (商品品質)
→ Category: 配送遅延 + カスタマーサポート
→ Priority: HIGH (低評価 + 複合的な問題)
Generated Response:
「この度はお届けに大変お時間をいただき、
また問い合わせへの対応が遅くなり、
重ねてお詫び申し上げます。
現在、配送体制の見直しと問い合わせ対応の
迅速化に取り組んでおります。
商品にご満足いただけたとのこと、
嬉しく存じます。今後は迅速な対応を
心がけてまいりますので、どうぞよろしく
お願いいたします。」
Rules:
- Always use formal Japanese (です/ます体)
- Acknowledge each specific complaint separately
- Explain concrete corrective actions
- Thank for any positive feedback
- Keep under 300 characters
- Never argue or be defensive
- Include follow-up action commitment
Data Storage
.yahoo-shopping/
├── config.json # API認証情報とストア設定
├── cache/
│ ├── items.json # 商品キャッシュ (TTL: 30m)
│ ├── categories.json # カテゴリツリー (TTL: 24h)
│ ├── stock-levels.json # 在庫データ (TTL: 15m)
│ └── storematch-campaigns.json # 広告キャンペーン設定
├── analytics/
│ ├── daily-sales.jsonl # 日次売上データ
│ ├── access-stats.jsonl # PV、UU、転換率
│ ├── payment-methods.jsonl # 決済方法別集計
│ ├── event-performance/
│ │ ├── 5th-day-sales.jsonl # 5のつく日売上
│ │ └── paypay-fes.jsonl # 超PayPay祭実績
│ └── advertising/
│ ├── storematch-daily.jsonl # ストアマッチ日次データ
│ └── pr-option-roi.jsonl # PRオプション効果
├── orders/
│ ├── pending-shipment.json # 出荷待ち注文
│ ├── payment-pending.json # 入金待ち注文
│ └── returns.jsonl # 返品履歴
├── reviews/
│ ├── all-reviews.jsonl # 全レビューデータ
│ ├── ai-replies.jsonl # AI返信履歴
│ └── sentiment.json # 感情分析結果
├── coupons/
│ ├── active-coupons.json # 有効クーポン一覧
│ └── performance.jsonl # クーポン利用実績
├── campaigns/
│ ├── annual-calendar.json # 年間イベントカレンダー
│ └── history.jsonl # キャンペーン実績
├── exports/
│ └── *.csv # エクスポートファイル
└── logs/
├── api-calls.jsonl # API呼び出しログ
└── errors.jsonl # エラーログ
Comparison Table
| Feature | Yahoo Shopping Agent | ネクストエンジン | クロスモール |
|---|---|---|---|
| 対象プラットフォーム | Yahoo!ショッピング専門 | 複数モール対応 | 複数モール対応 |
| API直接連携 | 対応(完全) | 対応(複数) | 対応(複数) |
| ストアマッチ広告運用 | ROAS自動最適化 | 非対応 | 非対応 |
| PayPayモール対応 | 完全対応+指標監視 | 基本対応 | 基本対応 |
| PRオプション最適化 | 料率自動提案 | 非対応 | 非対応 |
| クーポン管理 | 効果分析+自動生成 | 基本対応 | 基本対応 |
| イベント対応 | 5のつく日自動化 | カレンダー通知 | カレンダー通知 |
| レビュー返信 | AI自動生成 | 非対応 | 非対応 |
| ストアページ編集 | HTML自動生成 | 非対応 | テンプレート |
| 注文処理 | 自動確認+出荷管理 | 対応 | 対応 |
| 在庫管理 | 販売速度予測付き | 対応 | 対応 |
| 日本語対応 | ネイティブ | ネイティブ | ネイティブ |
| コスト | 無料(API費用のみ) | 月額¥3,000〜 | 月額¥9,800〜 |
| AI搭載 | Claude Code統合 | 非対応 | 非対応 |
| CLI操作 | 完全対応 | Web UI | Web UI |
| 売上分析 | PayPay経済圏分析 | 基本レポート | 基本レポート |
Yahoo!ショッピング Specific Features
- Yahoo!ショッピングAPI完全対応
- ストアマッチ広告自動運用
- PRオプション料率最適化
- PayPayモール掲載指標管理
- 5のつく日・超PayPay祭対応
- PayPayジャンボ連動
- ストアクリエイターPro連携
- Yahoo!プレミアム会員ターゲティング
- ソフトバンクユーザー特別施策対応
- LYPプレミアム特典連動
- クーポン施策の自動生成・効果測定
- 配送グループ設定（ヤマト運輸/佐川急便/日本郵便）
- コンビニ決済・後払い決済の入金管理
- ストア評価・優良店舗バッジ維持管理
- Yahoo!ショッピング SEO最適化（商品名75文字、キャッチコピー）
- CSV一括商品操作（最大10,000件）