OpenSkillIndex← back to search
claude-code

Clawhub-skills Yahoo Shopping Agent

Yahoo!ショッピング出品・ストア管理AIエージェント — Yahoo! API連携で商品・注文・広告を自動化

install
source · Clone the upstream repo
git clone https://github.com/traygerbig/clawhub-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/traygerbig/clawhub-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/ec-master-pack/yahoo-shopping-agent" ~/.claude/skills/traygerbig-clawhub-skills-yahoo-shopping-agent && rm -rf "$T"
manifest: ec-master-pack/yahoo-shopping-agent/SKILL.md
source content

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で攻略する ───                ║
    ║                                                      ║
    ╚══════════════════════════════════════════════════════╝

Version License Yahoo PayPay

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

  1. Yahoo! ID連携認証を常に検証する。 コマンド実行前にOAuth2.0アクセストークンの有効期限を確認し、期限切れの場合はRefresh Tokenで自動更新する。Yahoo! ID連携v2のフローに従う。
  2. 商品出品はYahoo!ショッピングの商品データ仕様に厳密に準拠する。 必須項目（商品名、価格、在庫数、商品画像、カテゴリコード）を事前にバリデーションする。
  3. ストアマッチ広告はROAS目標に基づいて最適化する。 デフォルトROAS目標は300%。入札額の自動調整、無効キーワードの除外、パフォーマンスレポートの自動生成を行う。
  4. PayPay経済圏イベントを最大活用する。 5のつく日、超PayPay祭、PayPayジャンボなど、Yahoo!ショッピング固有のイベントカレンダーを管理し、事前準備を自動化する。
  5. PRオプション料率は利益率とランキングのバランスを取って設定する。 PRオプション料率（1-30%）を商品カテゴリと競合状況に応じて最適化提案する。
  6. クーポン施策は費用対効果を事前シミュレーションする。 クーポン発行前に想定利用率・売上増加率・利益影響を算出し、判断材料を提供する。
  7. レビュー管理では迅速な返信と評価改善を支援する。 低評価レビューは24時間以内の対応を推奨し、AI返信案を生成する。
  8. 注文処理は出荷期限を厳守する。 Yahoo!ショッピングの出荷遅延ペナルティ基準（注文確認後3営業日以内出荷）を管理し、期限超過リスクをアラートする。
  9. ストアクリエイターPro連携でページカスタマイズを支援する。 トップページ、カテゴリページ、フリースペースのHTML編集を自動生成する。
  10. APIレート制限を厳守する。 Yahoo!ショッピングAPIの呼び出し制限をトラッキングし、制限超過を回避する。
  11. Yahoo!プレミアム会員向けの特別施策を提案する。 プレミアム会員はポイント還元率が高く、ターゲティングの主要セグメントとなる。
  12. 商品画像は仕様に準拠する。 メイン画像は白背景推奨、JPEG/PNG、最大500KB、推奨800x800px以上。テキストオーバーレイは画像面積の20%以下。
  13. PayPayモール出店基準を監視する。 優良店舗評価（ストア評価4.0以上、出荷遅延率5%以下等）を維持し、PayPayモール掲載資格を保護する。
  14. CSV一括処理で大量商品操作を効率化する。 100件以上の商品操作はCSVアップロードAPIを使用し、処理効率を最大化する。
  15. 季節イベント・セール対応を計画的に実施する。 お中元、お歳暮、母の日、クリスマスなど、Yahoo!ショッピングの主要セール期間を年間カレンダーで管理する。

Yahoo! Shopping API Endpoint Reference

Yahoo!ショッピングAPIはREST (JSON/XML)形式。OAuth 2.0認証(Yahoo! ID連携v2)を使用。

商品管理API:

MethodEndpointDescription
POST
/ShoppingWebService/V1/editItem
商品登録・更新
GET
/ShoppingWebService/V1/getItem
商品情報取得
POST
/ShoppingWebService/V1/deleteItem
商品削除
POST
/ShoppingWebService/V1/uploadItemFile
CSV一括登録
GET
/ShoppingWebService/V1/getItemList
商品一覧取得

在庫管理API:

MethodEndpointDescription
POST
/ShoppingWebService/V1/updateStock
在庫数更新
GET
/ShoppingWebService/V1/getStock
在庫数取得
POST
/ShoppingWebService/V1/updateStockFile
CSV一括在庫更新

注文管理API:

MethodEndpointDescription
GET
/ShoppingWebService/V1/orderList
注文一覧取得
GET
/ShoppingWebService/V1/orderInfo
注文詳細取得
POST
/ShoppingWebService/V1/orderStatusChange
注文ステータス変更
POST
/ShoppingWebService/V1/orderPayStatusChange
入金ステータス変更
POST
/ShoppingWebService/V1/orderShipNumberSet
配送伝票番号登録

ストアマッチ広告API:

MethodEndpointDescription
POST
/StoreMatch/V1/createCampaign
キャンペーン作成
GET
/StoreMatch/V1/getCampaignList
キャンペーン一覧
PUT
/StoreMatch/V1/updateCampaign
キャンペーン更新
GET
/StoreMatch/V1/getReport
パフォーマンスレポート
POST
/StoreMatch/V1/addKeyword
キーワード追加

レビューAPI:

MethodEndpointDescription
GET
/ShoppingWebService/V1/getReviewList
レビュー一覧取得
POST
/ShoppingWebService/V1/replyReview
レビュー返信投稿
GET
/ShoppingWebService/V1/getReviewSummary
レビュー集計情報

クーポンAPI:

MethodEndpointDescription
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

VariableDescriptionRequiredDefault
YAHOO_CLIENT_ID
Yahoo! ID連携 アプリケーションID (Client ID)Yes-
YAHOO_CLIENT_SECRET
Yahoo! ID連携 シークレットキーYes-
YAHOO_SELLER_ID
Yahoo!ショッピング ストアアカウントIDYes-
YAHOO_STORE_ACCOUNT
ストアクリエイターPro ストアアカウント名Yes-
YAHOO_REFRESH_TOKEN
OAuth 2.0 Refresh Token (長期有効)Yes-
YAHOO_STOREMATCH_ACCOUNT_ID
ストアマッチ広告 アカウントIDNo-
YAHOO_CALLBACK_URL
OAuth認証コールバックURLNo-
YAHOO_WEBHOOK_URL
注文通知Webhook受信URLNo-

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 CodeMeaningAgent 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

FeatureYahoo Shopping Agentネクストエンジンクロスモール
対象プラットフォームYahoo!ショッピング専門複数モール対応複数モール対応
API直接連携対応(完全)対応(複数)対応(複数)
ストアマッチ広告運用ROAS自動最適化非対応非対応
PayPayモール対応完全対応+指標監視基本対応基本対応
PRオプション最適化料率自動提案非対応非対応
クーポン管理効果分析+自動生成基本対応基本対応
イベント対応5のつく日自動化カレンダー通知カレンダー通知
レビュー返信AI自動生成非対応非対応
ストアページ編集HTML自動生成非対応テンプレート
注文処理自動確認+出荷管理対応対応
在庫管理販売速度予測付き対応対応
日本語対応ネイティブネイティブネイティブ
コスト無料(API費用のみ)月額¥3,000〜月額¥9,800〜
AI搭載Claude Code統合非対応非対応
CLI操作完全対応Web UIWeb UI
売上分析PayPay経済圏分析基本レポート基本レポート

Yahoo!ショッピング Specific Features

  • Yahoo!ショッピングAPI完全対応
  • ストアマッチ広告自動運用
  • PRオプション料率最適化
  • PayPayモール掲載指標管理
  • 5のつく日・超PayPay祭対応
  • PayPayジャンボ連動
  • ストアクリエイターPro連携
  • Yahoo!プレミアム会員ターゲティング
  • ソフトバンクユーザー特別施策対応
  • LYPプレミアム特典連動
  • クーポン施策の自動生成・効果測定
  • 配送グループ設定（ヤマト運輸/佐川急便/日本郵便）
  • コンビニ決済・後払い決済の入金管理
  • ストア評価・優良店舗バッジ維持管理
  • Yahoo!ショッピング SEO最適化（商品名75文字、キャッチコピー）
  • CSV一括商品操作（最大10,000件）