OpenSkillIndex← back to search
claude-code

Clawhub-skills MakeShop Agent

MakeShop EC管理エージェント — GMOグループのECプラットフォームをAIで完全制御

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/makeshop-agent" ~/.claude/skills/traygerbig-clawhub-skills-makeshop-agent && rm -rf "$T"
manifest: ec-master-pack/makeshop-agent/SKILL.md
source content

MakeShop Agent

╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║          ┌─────────────────────────────────┐                 ║
║          │     M A K E S H O P             │                 ║
║          │     A G E N T   v1.0            │                 ║
║          └─────────────────────────────────┘                 ║
║                                                              ║
║       ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐               ║
║       │ 商品 │  │ 在庫 │  │ 注文 │  │ 顧客 │               ║
║       │ MGR  │  │ MGR  │  │ MGR  │  │ MGR  │               ║
║       └──┬───┘  └──┬───┘  └──┬───┘  └──┬───┘               ║
║          │         │         │         │                     ║
║          └────┬────┴────┬────┴────┬────┘                     ║
║               ▼         ▼         ▼                          ║
║          ┌──────────────────────────────┐                    ║
║          │    MakeShop REST API v2      │                    ║
║          │    GMO MakeShop Gateway      │                    ║
║          └──────────────────────────────┘                    ║
║                                                              ║
║   ┌─────┐  ┌──────┐  ┌────────┐  ┌───────┐                 ║
║   │ SEO │  │ Mail │  │ Coupon │  │Report │                  ║
║   └─────┘  └──────┘  └────────┘  └───────┘                  ║
║                                                              ║
║   GMO MAKESHOP --- AI-POWERED EC MANAGEMENT                  ║
║   ─── 流通額11年連続No.1 ECをAIで完全自動化 ───              ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

Version MakeShop Japan GMO License

claude-code
makeshop
ecommerce
japan
store

MakeShop EC管理エージェント。GMOグループが運営する流通額11年連続No.1のECプラットフォームをClaude Codeから完全操作。商品管理、在庫管理、注文処理、顧客管理、メルマガ配信、クーポン管理、SEO設定、デザインカスタマイズまで全領域をAIが統合管理する。

Author: hanabi-jpn Version: 1.0.0 License: MIT Tags: makeshop, ecommerce, japan, gmo, store, api, crm, seo

Overview

MakeShop Agent は、GMO MakeShop が提供する EC プラットフォーム向けの統合管理エージェントです。MakeShop は日本国内の SaaS 型 EC プラットフォームとして流通額11年連続 No.1 を誇り、22,000店舗以上が利用しています。本スキルは MakeShop の Members API および Shop Management API を通じて、商品登録から在庫管理、注文処理、顧客分析、メルマガ配信、クーポン発行、SEO 最適化、レポート出力まで、EC 運営に必要な全業務を Claude Code 上で完結させます。

日本の商習慣に完全対応しており、消費税計算（標準税率10%・軽減税率8%）、インボイス制度、電子帳簿保存法、日本語フォーマットの帳票出力、国内配送業者連携（ヤマト運輸・佐川急便・日本郵便）をネイティブサポートします。

┌────────────────────────────────────────────────────────────────────┐
│                  MAKESHOP AGENT ARCHITECTURE                       │
│                                                                    │
│  ┌────────────┐     ┌────────────────┐     ┌──────────────────┐   │
│  │ Claude Code │────▶│  MakeShop      │────▶│  MakeShop API    │   │
│  │ (User)      │◀────│  Agent         │◀────│  Gateway (GMO)   │   │
│  └────────────┘     └───────┬────────┘     └────────┬─────────┘   │
│                              │                       │             │
│                     ┌────────┼────────┐              │             │
│                     ▼        ▼        ▼              ▼             │
│              ┌─────────┐┌────────┐┌────────┐  ┌────────────┐      │
│              │Products ││Orders  ││Members │  │  MakeShop  │      │
│              │Engine   ││Engine  ││Engine  │  │  DataStore │      │
│              └────┬────┘└───┬────┘└───┬────┘  └────────────┘      │
│                   │         │         │                             │
│          ┌────────┼─────────┼─────────┤                            │
│          ▼        ▼         ▼         ▼                            │
│   ┌──────────┐┌──────┐┌────────┐┌─────────┐                       │
│   │Inventory ││ Mail ││ Coupon ││  SEO    │                       │
│   │Tracker   ││Sender││Manager ││Optimizer│                       │
│   └────┬─────┘└──┬───┘└───┬────┘└────┬────┘                       │
│        │         │        │          │                             │
│        └─────────┴────────┴──────────┘                             │
│                       ▼                                            │
│        ┌───────────────────────────────┐                           │
│        │   Analytics & Report Engine   │                           │
│        │   売上分析・在庫予測・顧客RFM │                           │
│        └──────────────┬────────────────┘                           │
│                       ▼                                            │
│        ┌───────────────────────────────┐                           │
│        │   Local Cache & Data Store    │                           │
│        │   .makeshop-agent/            │                           │
│        └───────────────────────────────┘                           │
└────────────────────────────────────────────────────────────────────┘

System Prompt Instructions

You are an agent equipped with MakeShop Agent for GMO MakeShop EC store management. Follow these rules precisely when the user invokes MakeShop commands.

Behavioral Guidelines

  1. Always authenticate before any API call. Verify that 

    MAKESHOP_SHOP_ID
    , 
    MAKESHOP_API_KEY
    , and 
    MAKESHOP_API_SECRET
    are configured. If any is missing, prompt the user with the exact variable name and where to obtain the value in the MakeShop管理画面.

  2. Respond in Japanese by default. All output messages, error descriptions, and report headers must be in Japanese unless the user explicitly requests English. Technical field names (API keys, JSON keys) remain in English.

  3. Validate all input before API calls. Product prices must be non-negative integers (JPY). SKU codes must match the pattern 

    [A-Za-z0-9_-]{1,50}
    . Email addresses must pass RFC 5322 basic validation. Date formats must be 
    YYYY-MM-DD
    .

  4. Handle tax calculation correctly. Apply standard tax rate (10%) by default. For food and beverage products, apply reduced tax rate (8%). Always display tax-inclusive and tax-exclusive prices separately in output.

  5. Respect rate limits. MakeShop API allows 300 requests per 5 minutes per shop. Track request count locally and pause with a countdown when approaching the limit (270 requests). Never exceed the limit.

  6. Cache product and category data. Store product listings and category trees locally with a 30-minute TTL. Orders and stock levels are always fetched live to ensure accuracy. Use 

    makeshop sync
    to force a cache refresh.

  7. Log all write operations. Every create, update, or delete operation must be logged to 

    .makeshop-agent/logs/operations.jsonl
    with timestamp, operation type, target resource ID, and result status.

  8. Confirm destructive operations. Before deleting products, canceling orders, or bulk-updating prices, display a summary of affected items and request explicit user confirmation.

  9. Format currency as Japanese Yen. Always display monetary values with the 

    ¥
    prefix and comma-separated thousands (e.g., 
    ¥12,800
    ). Never display decimal places for JPY amounts.

  10. Support batch operations safely. When processing bulk updates (CSV import, batch price changes), process in chunks of 50 items with progress reporting. On any error, pause and report the failed item before continuing.

  11. Generate actionable insights. When displaying analytics or reports, always include at least one concrete recommendation based on the data (e.g., "在庫回転率が低い商品3点をセール対象に推奨").

  12. Maintain backward compatibility. Support both MakeShop Premium and MakeShop Enterprise plans. Detect the plan level via API and adjust available features accordingly (e.g., Enterprise has multi-warehouse support).

  13. Handle image operations carefully. Product images must be JPEG or PNG, maximum 5MB. Validate dimensions (recommended 800x800 minimum). Compress images over 3MB before upload if possible.

  14. Implement idempotent operations. For order status updates and stock adjustments, include an idempotency key derived from the operation parameters to prevent duplicate processing on retries.

  15. Protect customer data. Never output full email addresses or phone numbers in logs. Mask as 

    t***@***.co.jp
    or 
    090-****-1234
    . Comply with Japan's Act on Protection of Personal Information (APPI).

  16. Monitor shop health proactively. When running 

    makeshop report
    , automatically check for anomalies: sudden sales drops (>30% vs previous period), unusually high cancellation rates (>5%), and inventory discrepancies.

  17. Support seasonal campaigns. Recognize Japanese commercial events (初売り, バレンタイン, ホワイトデー, 母の日, お中元, お歳暮, ブラックフライデー, 年末セール) and suggest campaign timing and coupon strategies accordingly.

Environment Variables

VariableRequiredDescriptionExample
MAKESHOP_SHOP_ID
YesMakeShopのショップID（管理画面のURLから取得）
hanabi-store
MAKESHOP_API_KEY
YesMakeShop API認証キー（管理画面 > 外部システム連携 > API設定）
ms_live_a1b2c3d4e5f6
MAKESHOP_API_SECRET
YesMakeShop APIシークレット（API設定画面で発行）
sec_7g8h9i0j1k2l3m4n
MAKESHOP_PLAN
Noプランレベル（auto-detect if not set）
premium
or 
enterprise
MAKESHOP_WEBHOOK_URL
No注文・在庫アラート通知用Webhook URL
https://hooks.slack.com/services/T00/B00/abcdef
MAKESHOP_CACHE_TTL
NoローカルキャッシュTTL（秒、デフォルト1800）
3600
MAKESHOP_LOG_LEVEL
Noログレベル（debug/info/warn/error）
info
MAKESHOP_TAX_RATE
Noデフォルト消費税率（デフォルト10）
10
MAKESHOP_REDUCED_TAX
No軽減税率（デフォルト8）
8

Commands

makeshop product

商品の一覧取得、検索、作成、更新、削除、公開制御を行います。

$ makeshop product list --category "食品" --limit 20

╔═══════════════════════════════════════════════════════════════╗
║                 商品一覧 — カテゴリ: 食品                      ║
╠═══════════════════════════════════════════════════════════════╣
║ ID      │ 商品名                 │ 価格(税込) │ 在庫 │ 状態  ║
║─────────┼───────────────────────┼───────────┼─────┼──────  ║
║ P-00142 │ 有機宇治抹茶 100g      │   ¥3,240  │  45 │ 公開   ║
║ P-00143 │ 国産はちみつ 500g      │   ¥5,600  │  23 │ 公開   ║
║ P-00144 │ 黒豆茶ティーバッグ 30包 │   ¥1,980  │  89 │ 公開   ║
║ P-00145 │ 手作り醤油 1L           │   ¥2,160  │  12 │ 公開   ║
║ P-00146 │ 梅干し詰め合わせ       │   ¥4,320  │   7 │ 公開   ║
║ P-00147 │ 有機玄米 5kg           │   ¥3,780  │  34 │ 非公開 ║
╠═══════════════════════════════════════════════════════════════╣
║ 合計: 6商品 / 20件中  │  公開: 5  │  非公開: 1               ║
╚═══════════════════════════════════════════════════════════════╝

$ makeshop product create --name "京都宇治 煎茶セット" --price 4800 --tax-class reduced --category "食品" --sku "TEA-SENCHA-SET01"

✓ 商品を作成しました
  商品ID:    P-00201
  商品名:    京都宇治 煎茶セット
  税抜価格:  ¥4,800
  税込価格:  ¥5,184（軽減税率8%適用）
  SKU:       TEA-SENCHA-SET01
  カテゴリ:  食品
  状態:      非公開（確認後に `makeshop product publish P-00201` で公開）


makeshop inventory

在庫の確認、更新、アラート設定、入出庫管理を行います。

$ makeshop inventory status --alert-threshold 10

╔═══════════════════════════════════════════════════════════════╗
║                   在庫ステータス一覧                           ║
╠═══════════════════════════════════════════════════════════════╣
║ SKU              │ 商品名               │ 在庫 │ 状態        ║
║──────────────────┼─────────────────────┼─────┼───────────  ║
║ TEA-MATCHA-100   │ 有機宇治抹茶 100g    │  45 │ 正常        ║
║ HONEY-500        │ 国産はちみつ 500g    │  23 │ 正常        ║
║ SOY-SAUCE-1L     │ 手作り醤油 1L        │  12 │ 注意        ║
║ UMEBOSHI-SET     │ 梅干し詰め合わせ     │   7 │ [!] 要発注  ║
║ RICE-GENMAI-5    │ 有機玄米 5kg         │   3 │ [!!] 緊急   ║
╠═══════════════════════════════════════════════════════════════╣
║ [!] 要発注: 2商品  │  [!!] 緊急: 1商品                       ║
║ 推奨: RICE-GENMAI-5 は過去30日の販売ペース(15個/月)から       ║
║       6日以内に在庫切れの見込みです。即時発注を推奨します。     ║
╚═══════════════════════════════════════════════════════════════╝


makeshop order

注文の一覧取得、詳細確認、ステータス更新、配送処理を行います。

$ makeshop order list --status paid --from 2026-02-25

╔═══════════════════════════════════════════════════════════════╗
║              入金済み注文一覧（2026-02-25以降）                ║
╠═══════════════════════════════════════════════════════════════╣
║ 注文ID    │ 日時            │ 顧客名     │ 合計     │ 決済   ║
║───────────┼────────────────┼───────────┼─────────┼──────  ║
║ ORD-38201 │ 02-28 14:23    │ 山田 太郎  │ ¥12,960 │ カード ║
║ ORD-38199 │ 02-28 11:05    │ 佐藤 花子  │  ¥5,184 │ カード ║
║ ORD-38195 │ 02-27 22:31    │ 田中 一郎  │  ¥8,640 │ コンビニ║
║ ORD-38190 │ 02-27 09:12    │ 鈴木 美咲  │ ¥21,600 │ 銀行振込║
║ ORD-38187 │ 02-26 16:45    │ 高橋 健太  │  ¥3,240 │ カード ║
║ ORD-38183 │ 02-25 20:08    │ 伊藤 直美  │  ¥7,560 │ 代引き ║
╠═══════════════════════════════════════════════════════════════╣
║ 合計: 6件  │  総額: ¥59,184  │  発送待ち: 6件                ║
╚═══════════════════════════════════════════════════════════════╝

$ makeshop order ship ORD-38201 --carrier yamato --tracking-number 1234-5678-9012

✓ 発送処理完了
  注文ID:      ORD-38201
  顧客:        山田 太郎
  配送業者:    ヤマト運輸
  追跡番号:    1234-5678-9012
  ステータス:  入金済み → 発送済み
  通知:        発送完了メールを送信しました


makeshop customer

顧客の一覧取得、詳細表示、セグメント分析を行います。

$ makeshop customer analyze --segment vip

╔═══════════════════════════════════════════════════════════════╗
║                 VIP顧客分析レポート                            ║
╠═══════════════════════════════════════════════════════════════╣
║ 会員ID    │ 顧客名     │ 累計購入額  │ 注文回数 │ 最終購入   ║
║───────────┼───────────┼───────────┼─────────┼──────────  ║
║ M-001023  │ 鈴木 美咲  │ ¥287,400   │   23回  │ 2026-02-28 ║
║ M-000891  │ 山田 太郎  │ ¥245,800   │   19回  │ 2026-02-28 ║
║ M-001102  │ 佐藤 花子  │ ¥198,600   │   16回  │ 2026-02-27 ║
║ M-000456  │ 高橋 健太  │ ¥176,200   │   14回  │ 2026-02-22 ║
║ M-000789  │ 伊藤 直美  │ ¥152,400   │   12回  │ 2026-02-20 ║
╠═══════════════════════════════════════════════════════════════╣
║ VIP顧客数: 5名  │  売上構成比: 38.2%                          ║
║ 推奨施策: VIP限定先行販売 + 送料無料クーポンで               ║
║           リピート率をさらに向上可能                           ║
╚═══════════════════════════════════════════════════════════════╝


makeshop mail

メルマガの作成、配信、配信結果確認を行います。

$ makeshop mail send --template spring-sale --segment active --schedule "2026-03-05 10:00"

✓ メルマガ配信をスケジュールしました
  テンプレート:  spring-sale（春の新商品セール）
  配信対象:      アクティブ会員 1,247名
  配信日時:      2026-03-05 10:00 JST
  件名:          【期間限定】春の新商品セール開催！最大30%OFF
  プレビュー:    .makeshop-agent/mail/preview-spring-sale.html

  配信結果は `makeshop mail report spring-sale` で確認できます


makeshop coupon

クーポンの作成、管理、利用状況確認を行います。

$ makeshop coupon create --name "春セール10%OFF" --type percent --value 10 --min-purchase 3000 --expires 2026-03-31 --limit 500

✓ クーポンを作成しました
  クーポンコード:  SPRING2026
  割引内容:        10% OFF
  最低購入金額:    ¥3,000
  有効期限:        2026-03-31 23:59 JST
  発行上限:        500枚
  対象:            全商品
  ステータス:      有効


makeshop seo

商品やページのSEO設定の確認、最適化を行います。

$ makeshop seo analyze --page top

╔═══════════════════════════════════════════════════════════════╗
║                 SEOスコア — トップページ                       ║
╠═══════════════════════════════════════════════════════════════╣
║ 総合スコア: 72/100                                            ║
║                                                               ║
║ [OK] title タグ: 適切な長さ (32文字)                          ║
║ [OK] meta description: 設定済み (120文字)                     ║
║ [!!] h1 タグ: 未設定 → 店舗名を含むh1を追加推奨              ║
║ [OK] alt属性: 全画像に設定済み                                ║
║ [!]  ページ速度: 3.2秒 → 画像圧縮で2秒以下を推奨            ║
║ [OK] モバイル対応: レスポンシブ確認済み                       ║
║ [!]  構造化データ: Organization のみ → Product追加推奨        ║
║ [OK] canonical: 正しく設定済み                                ║
║ [OK] robots.txt: 適切に設定済み                               ║
║ [!!] サイトマップ: 最終更新が30日以上前 → 再生成推奨         ║
╠═══════════════════════════════════════════════════════════════╣
║ 改善推奨: 2件の重要課題と2件の注意事項があります              ║
║ `makeshop seo fix --page top` で自動修正を実行できます        ║
╚═══════════════════════════════════════════════════════════════╝


makeshop report

売上レポート、在庫分析、顧客分析の統合レポートを生成します。

$ makeshop report --period month --month 2026-02

╔═══════════════════════════════════════════════════════════════╗
║              月次レポート — 2026年2月                          ║
╠═══════════════════════════════════════════════════════════════╣
║ 売上合計:        ¥2,847,600  (+8.3% vs 前月)                 ║
║ 注文件数:        312件       (+24件 vs 前月)                  ║
║ 客単価:          ¥9,127      (+1.2% vs 前月)                 ║
║ 新規会員:        47名        (+12名 vs 前月)                  ║
║ リピート率:      34.2%       (+2.1pt vs 前月)                 ║
║ コンバージョン率: 2.8%       (+0.3pt vs 前月)                 ║
╠═══════════════════════════════════════════════════════════════╣
║ カテゴリ別売上:                                               ║
║ 1. 食品・飲料      ¥1,423,800 (50.0%)                        ║
║ 2. 健康・美容       ¥569,520  (20.0%)                        ║
║ 3. 生活雑貨         ¥427,140  (15.0%)                        ║
║ 4. ギフト           ¥284,760  (10.0%)                        ║
║ 5. その他           ¥142,380  ( 5.0%)                        ║
╠═══════════════════════════════════════════════════════════════╣
║ AIインサイト:                                                 ║
║ - 食品カテゴリのリピート率が42%と高水準。定期購入導入を推奨   ║
║ - 新規流入の68%がスマートフォン。モバイルUX改善で             ║
║   コンバージョン率0.5pt向上の余地あり                         ║
║ - 3月はホワイトデー需要が見込まれます。                       ║
║   ギフトカテゴリのクーポン施策を推奨                          ║
╚═══════════════════════════════════════════════════════════════╝

Workflow Diagram

┌─────────────────────────────────────────────────────────────────┐
│                   MAKESHOP AGENT WORKFLOW                        │
│                                                                 │
│  ┌──────────┐    ┌──────────┐    ┌───────────┐                  │
│  │ユーザー   │───▶│コマンド   │───▶│入力       │                  │
│  │コマンド入力│    │パーサー   │    │バリデーション│                │
│  └──────────┘    └──────────┘    └─────┬─────┘                  │
│                                        │                        │
│                                  ┌─────▼─────┐                  │
│                                  │ 認証チェック │                 │
│                                  │ API Key有効?│                 │
│                                  └─────┬─────┘                  │
│                                        │                        │
│                          ┌─────────────┼─────────────┐          │
│                          ▼             ▼             ▼          │
│                    ┌──────────┐  ┌──────────┐  ┌──────────┐    │
│                    │キャッシュ │  │ API呼出  │  │バッチ処理│    │
│                    │ヒット判定 │  │(単件)    │  │(CSV/一括)│    │
│                    └────┬─────┘  └────┬─────┘  └────┬─────┘    │
│                         │             │             │           │
│                         └─────────────┼─────────────┘           │
│                                       ▼                         │
│                              ┌──────────────┐                   │
│                              │レスポンス整形 │                   │
│                              │日本語フォーマット│                │
│                              └───────┬──────┘                   │
│                                      │                          │
│                               ┌──────▼──────┐                   │
│                               │ログ記録     │                   │
│                               │操作履歴保存 │                   │
│                               └──────┬──────┘                   │
│                                      │                          │
│                               ┌──────▼──────┐                   │
│                               │結果表示     │                   │
│                               │ユーザー出力 │                   │
│                               └─────────────┘                   │
└─────────────────────────────────────────────────────────────────┘

Error Handling

MakeShop Agent は以下のエラーを検知し、適切に対処します。

1. 認証エラー (401 Unauthorized)

[ERROR] MakeShop API 認証エラー
  原因:  MAKESHOP_API_KEY または MAKESHOP_API_SECRET が無効です
  対処:  MakeShop管理画面 > 外部システム連携 > API設定 で
         APIキーの有効期限と値を確認してください
  確認コマンド: makeshop health

2. レートリミット超過 (429 Too Many Requests)

[WARN] APIレートリミットに到達しました
  現在のリクエスト数: 298/300 (5分間)
  リセットまで: 2分13秒
  対処:  自動的にリセット待ち後にリトライします (最大3回)
  進捗:  ▓▓▓▓▓▓▓▓░░ 80% 完了（残り48アイテム）

3. 商品バリデーションエラー (422 Unprocessable Entity)

[ERROR] 商品作成バリデーションエラー
  フィールド: price
  エラー内容: 価格は1円以上の整数で入力してください
  入力値:    -500
  対処:      正の整数値で再入力してください
  例:        makeshop product create --name "商品名" --price 4800

4. 在庫不足エラー

[ERROR] 在庫調整エラー — 出庫数が在庫数を超過
  商品:    有機玄米 5kg (RICE-GENMAI-5)
  現在庫:  3個
  出庫指示: 10個
  不足:    7個
  対処:    出庫数を3個以下に調整するか、入庫処理を先に行ってください
  確認:    makeshop inventory status RICE-GENMAI-5

5. ネットワーク接続エラー

[ERROR] MakeShop APIに接続できません
  エンドポイント: https://api.makeshop.jp/v2/products
  タイムアウト:   30秒
  対処:
    1. インターネット接続を確認してください
    2. MAKESHOP_SHOP_ID が正しいか確認してください
    3. MakeShopのステータスページ (status.makeshop.jp) を確認してください
  リトライ: 5秒後に自動リトライします (1/3)

6. CSV取込エラー

[ERROR] CSV取込エラー — 行 47 でエラーが発生しました
  ファイル:    products-import.csv
  エラー行:    47
  エラー内容:  SKUコード "TEA 001" に空白が含まれています
  処理済み:    46/120行
  対処:        CSVファイルの47行目を修正後、
               makeshop product import --file products-import.csv --skip 46
               で残りを処理できます

7. 決済ステータス不整合

[ERROR] 注文ステータス変更エラー
  注文ID:      ORD-38195
  現ステータス: 新規受付
  変更先:       発送済み
  エラー:       入金確認前のため発送処理できません
  対処:         先に入金確認を行ってください
               makeshop order update ORD-38195 --status paid

FAQ

Q1: MakeShopのどのプランに対応していますか？ A: MakeShop プレミアムプラン、MakeShop エンタープライズプラン、MakeShop Platinum に対応しています。フリープランではAPI機能が制限されているため、一部コマンドが使用できません。プラン判別は 

makeshop health
コマンドで自動的に行われます。

Q2: APIキーはどこで発行できますか？ A: MakeShop 管理画面にログイン後、「外部システム連携」>「API設定」からAPIキーとシークレットを発行できます。発行時に必要な権限スコープ（商品管理、注文管理、顧客管理など）を全て有効にしてください。

Q3: 在庫連携は自動ですか？ A: MakeShop Agent は API 経由でリアルタイムに在庫データを取得・更新します。ただし、他の外部システム（テンポスター、ロジレス等）との直接連携は MakeShop 側の設定が必要です。Agent は MakeShop 上の在庫データを正として動作します。

Q4: メルマガ配信で HTMLテンプレートは使えますか？ A: はい。

.makeshop-agent/templates/
ディレクトリに HTML テンプレートを配置することで、
makeshop mail send --template <name>
で利用できます。テンプレート内では 
{{customer_name}}
, 
{{shop_name}}
, 
{{coupon_code}}
などの変数が使用可能です。

Q5: 消費税の計算はどのように行われますか？ A: 商品ごとに標準税率（10%）または軽減税率（8%）を設定できます。食品・飲料カテゴリの商品は自動的に軽減税率が適用されます。インボイス制度に対応した適格請求書フォーマットでの帳票出力にも対応しています。

Q6: 複数ショップの管理は可能ですか？ A: はい。

.makeshop-agent/config.json
にショップ別のプロファイルを設定することで、
--shop <profile-name>
オプションで切り替えて使用できます。各ショップの認証情報は個別に管理されます。

Q7: CSVの文字コードは何に対応していますか？ A: MakeShop 標準の Shift_JIS（CP932）および UTF-8 に対応しています。インポート時は自動判別し、エクスポート時はデフォルトで UTF-8(BOM付き) を使用します。Excel での文字化けを防ぐためBOMを付与しています。

Q8: 注文の自動処理（自動発送通知など）は可能ですか？ A: Agent 単体では定期実行機能はありませんが、cron や launchd と組み合わせることで定期的な自動処理が可能です。例えば、入金済み注文の自動発送処理を30分ごとに実行するスクリプトを生成できます。

Q9: 商品画像の一括アップロードはできますか？ A: はい。

makeshop product images --import <directory>
で、ファイル名が SKU コードに対応する画像を一括アップロードできます。JPEG/PNG 対応、1ファイル最大5MBです。3MB を超えるファイルは自動圧縮されます。

Q10: MakeShop の決済方法にはどんなものがありますか？ A: クレジットカード（GMOペイメントゲートウェイ）、コンビニ決済、銀行振込、代金引換、Amazon Pay、楽天ペイ、PayPay に対応しています。決済方法ごとのフィルタリングは 

makeshop order list --payment <method>
で可能です。

Q11: データのバックアップ機能はありますか？ A: 

makeshop export --all --format json
で商品・注文・顧客データの全量エクスポートが可能です。定期バックアップの設定は 
.makeshop-agent/config.json
の 
backup
セクションで設定できます。

Q12: APIリクエスト数の制限は？ A: MakeShop API は5分間あたり300リクエストの制限があります。Agent は内部でリクエスト数をカウントし、270リクエストに達した時点で自動的にペースダウンします。大量処理時はバッチ処理モードを使用してください。

Data Storage

.makeshop-agent/
├── config.json                  # ショップ接続設定・マルチショップ対応
├── cache/
│   ├── products.json            # 商品キャッシュ (TTL: 30分)
│   ├── categories.json          # カテゴリツリー (TTL: 30分)
│   ├── customers-segments.json  # 顧客セグメント (TTL: 1時間)
│   └── seo-scores.json          # SEOスコアキャッシュ (TTL: 24時間)
├── analytics/
│   ├── daily-sales.jsonl        # 日次売上集計
│   ├── monthly-report.jsonl     # 月次レポートアーカイブ
│   ├── rfm-analysis.json        # RFM分析最新結果
│   ├── inventory-forecast.json  # 在庫消費予測
│   └── conversion-funnel.json   # CVファネル分析
├── mail/
│   ├── templates/               # メルマガHTMLテンプレート
│   ├── drafts/                  # 配信下書き
│   └── reports/                 # 配信結果レポート
├── coupons/
│   └── active-coupons.json      # 有効クーポン一覧
├── exports/
│   ├── products-*.csv           # 商品エクスポート
│   ├── orders-*.csv             # 注文エクスポート
│   └── customers-*.csv          # 顧客エクスポート
├── logs/
│   ├── operations.jsonl         # 全操作ログ (書込操作)
│   ├── api-calls.jsonl          # APIコールログ (直近7日)
│   └── errors.jsonl             # エラーログ
└── backups/
    └── *.json.gz                # 圧縮バックアップファイル

Comparison Table

機能MakeShop AgentEC-CUBEShopifyBASESTORESカラーミーショップ
運営形態SaaS (GMO)OSS (自前)SaaS (海外)SaaSSaaSSaaS (GMO)
月額費用¥12,100~無料(+サーバ代)$29~無料~無料~¥4,950~
商品登録数10,000~無制限無制限無制限無制限無制限無制限
日本語対応ネイティブネイティブ翻訳ネイティブネイティブネイティブ
API提供REST API v2Web APIREST/GraphQL限定的限定的REST API
消費税対応10%+軽減8%プラグインアプリ基本対応基本対応基本対応
インボイス制度標準対応プラグイン非対応対応対応対応
決済方法15種類以上プラグイン依存Shopify Pay他BASEかんたん決済STORES決済10種類以上
メルマガ機能標準搭載別途Shopify Email標準搭載標準搭載オプション
クーポン機能標準搭載プラグイン標準搭載標準搭載標準搭載標準搭載
SEOツール標準搭載基本対応標準搭載限定的限定的基本対応
デザイン自由度HTML/CSS編集完全自由LiquidテンプレートテンプレートHTML/CSS
サポート日本語電話対応コミュニティ英語メインメールメール電話/メール
流通額実績11年連続No.1国内シェア高い世界最大200万ショップ毎月1万新規老舗
AI Agent対応MakeShop AgentEC-CUBE Operator複数ありなしなしなし

MakeShop API Endpoint Reference

全エンドポイントは 

https://api.makeshop.jp/v2/{MAKESHOP_SHOP_ID}/
をベースとします。認証は Bearer トークン方式です。

Products:

MethodEndpointDescription
GET
/products
商品一覧取得（ページネーション、最大100件/ページ）
GET
/products/{id}
商品詳細取得（バリエーション含む）
POST
/products
商品新規作成
PUT
/products/{id}
商品更新
DELETE
/products/{id}
商品削除（論理削除）
POST
/products/{id}/images
商品画像アップロード
PUT
/products/{id}/seo
SEOメタデータ更新

Orders:

MethodEndpointDescription
GET
/orders
注文一覧取得（フィルタ・ソート対応）
GET
/orders/{id}
注文詳細取得
PUT
/orders/{id}/status
注文ステータス更新
POST
/orders/{id}/shipping
配送情報登録

Customers:

MethodEndpointDescription
GET
/members
会員一覧取得
GET
/members/{id}
会員詳細取得
PUT
/members/{id}
会員情報更新

Inventory:

MethodEndpointDescription
GET
/stock
在庫一覧取得
PUT
/stock/{product_id}
在庫数更新
POST
/stock/adjust
一括在庫調整

Mail & Coupons:

MethodEndpointDescription
POST
/mail/send
メルマガ配信
GET
/mail/reports
配信結果取得
POST
/coupons
クーポン作成
GET
/coupons
クーポン一覧取得

Order Status Workflow

┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
│  新規受付 │───▶│  入金待ち │───▶│  入金済み │───▶│  発送準備 │
│  (new)   │    │(pending) │    │  (paid)  │    │(preparing│
└──────────┘    └──────────┘    └──────────┘    └────┬─────┘
                      │                               │
                      ▼                               ▼
                ┌──────────┐                    ┌──────────┐
                │ キャンセル │                    │  発送済み │
                │(cancelled│                    │ (shipped)│
                └──────────┘                    └────┬─────┘
                                                     │
                      ┌──────────┐              ┌────┴─────┐
                      │  返品受付 │◀─────────────│   完了   │
                      │ (return) │              │(completed│
                      └──────────┘              └──────────┘

Seasonal Campaign Calendar

時期イベント推奨施策
1月初売り・福袋福袋セット商品、期間限定クーポン
2月バレンタインギフト特集、送料無料キャンペーン
3月ホワイトデー・卒業お返しセット、名入れ対応
5月母の日ギフトラッピング、メッセージカード
7月お中元のし対応、法人向けまとめ買い
11月ブラックフライデー全品割引、タイムセール
12月お歳暮・クリスマス年末ギフト、限定商品

makeshop coupon
と 
makeshop mail
を組み合わせて、各イベントに合わせた自動キャンペーン設定が可能です。