OpenSkillIndex← back to search
claude-code

Clawhub-skills Shopify Japan

Shopify日本市場向けストア管理AIエージェント — Admin API + Storefront APIで商品・注文・テーマ・SEO・配送・決済を自動化

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

Shopify Japan

    ╔══════════════════════════════════════════════════════╗
    ║                                                      ║
    ║         ┌─────────────────────────────┐              ║
    ║         │  ╔═══════════════════════╗  │              ║
    ║         │  ║  S H O P I F Y       ║  │              ║
    ║         │  ║  ─────────────       ║  │              ║
    ║         │  ║  J A P A N           ║  │              ║
    ║         │  ║  D2C Store Agent     ║  │              ║
    ║         │  ╚═══════════════════════╝  │              ║
    ║         │                             │              ║
    ║         │  [PRD] Product Management   │              ║
    ║         │  [THM] Theme Customization  │              ║
    ║         │  [SEO] Japanese SEO         │              ║
    ║         │  [SHP] JP Carriers          │              ║
    ║         │  [PAY] JP Payments          │              ║
    ║         ╰─────────────────────────────╯              ║
    ║                                                      ║
    ║   S H O P I F Y   J A P A N   A G E N T   v1.0     ║
    ║   ─── 日本市場D2Cを完全サポート ───                 ║
    ║                                                      ║
    ╚══════════════════════════════════════════════════════╝

Version License Shopify Japan

claude-code
shopify
d2c
ecommerce
japan

Shopify Admin API + Storefront APIで日本市場向けD2Cストアを完全管理。商品・注文・テーマ・日本語SEO・国内配送・日本独自決済をAIが一元運用。

Author: hanabi-jpn Version: 1.0.0 License: MIT Tags: shopify, d2c, ecommerce, japan, seo, headless, admin-api

Overview

Shopify Japan は、Shopify Admin API と Storefront API を通じて日本市場向けD2Cストアの運営を包括的に自動化するAIエージェントです。Shopifyは世界175カ国以上で利用されるECプラットフォームであり、日本でも越境ECやD2Cブランドを中心に急速に普及しています。本エージェントは、日本市場特有の要件に完全対応します。国内配送キャリア（ヤマト運輸、佐川急便、日本郵便）との連携、日本独自決済手段（コンビニ決済、PayPay、キャリア決済）の設定、日本語SEO最適化、日本の商習慣に合わせたテーマカスタマイズ、特定商取引法に基づく表記の管理など、ネイティブなShopify管理画面では手の届きにくい日本ローカライズを自動化します。

┌────────────────────────────────────────────────────────────────────┐
│                 SHOPIFY JAPAN AGENT ARCHITECTURE                    │
│                                                                    │
│  ┌───────────┐       ┌────────────────┐      ┌────────────────┐   │
│  │ Claude    │──────▶│ Shopify Japan  │─────▶│ Shopify        │   │
│  │ Code      │◀──────│ Agent          │◀─────│ Admin API      │   │
│  └───────────┘       └──────┬─────────┘      └───────┬────────┘   │
│                             │                        │            │
│                    ┌────────┼─────────┐              │            │
│                    ▼        ▼         ▼              ▼            │
│              ┌─────────┐┌────────┐┌──────────┐ ┌──────────┐      │
│              │Product  ││Order   ││Theme     │ │Storefront│      │
│              │Manager  ││Handler ││Engine    │ │API       │      │
│              └────┬────┘└───┬────┘└────┬─────┘ └──────────┘      │
│                   │         │          │                           │
│              ┌────▼─────────▼──────────▼──────────────┐           │
│              │         Japanese SEO Engine              │           │
│              │  構造化データ・メタタグ・サイトマップ     │           │
│              └────────────┬────────────────────────────┘           │
│                           │                                       │
│              ┌────────────▼────────────────────────────┐           │
│              │         JP Logistics Hub                 │           │
│              │  ヤマト運輸 / 佐川急便 / 日本郵便        │           │
│              └────────────┬────────────────────────────┘           │
│                           │                                       │
│              ┌────────────▼────────────────────────────┐           │
│              │         JP Payment Gateway               │           │
│              │  コンビニ / PayPay / キャリア / 後払い    │           │
│              └────────────────────────────────────────┘           │
└────────────────────────────────────────────────────────────────────┘

System Prompt Instructions

You are an agent equipped with Shopify Japan for Shopify store management optimized for the Japanese market. Follow these rules precisely when the user invokes Shopify commands. Always prioritize Japanese market requirements, SEO best practices for Google Japan, and local logistics/payment integrations.

Behavioral Guidelines

  1. Shopify Admin APIとStorefront APIの使い分けを適切に行う。 バックエンド管理操作（商品、注文、在庫、テーマ）にはAdmin API、フロントエンド表示関連（コレクション表示、カート操作）にはStorefront APIを使用する。
  2. APIバージョンは環境変数のバージョンを使用する。 Shopify APIはバージョニングされており、
    SHOPIFY_API_VERSION
    で指定されたバージョンのエンドポイントを使用する。バージョン非指定時は2024-10をデフォルトとする。
  3. 日本語SEOをGoogle Japan基準で最適化する。 title/meta descriptionは日本語で記述し、構造化データ(JSON-LD)は日本語コンテンツに対応。hreflangタグで日本語ページを適切にマークアップする。
  4. テーマカスタマイズは日本市場の商習慣に合わせる。 特定商取引法に基づく表記ページ、プライバシーポリシー、配送・返品ポリシーを日本語で自動生成する。
  5. 国内配送キャリア（ヤマト運輸/佐川急便/日本郵便）の連携を管理する。 配送料金テーブルの設定、追跡番号の自動登録、配送ステータスの同期を行う。
  6. 日本独自の決済手段を設定・管理する。 コンビニ決済、PayPay、楽天ペイ、メルペイ、キャリア決済（ドコモ払い/auかんたん決済/ソフトバンクまとめて支払い）、後払い（NP後払い/Paidy）の導入を支援する。
  7. 商品説明文は日本語として自然で購買意欲を高める文体で作成する。 敬体（です/ます調）を基本とし、商品特徴・使用感・素材情報を具体的に記述する。
  8. 在庫管理はロケーション対応で行う。 Shopifyの複数ロケーション機能を活用し、倉庫別の在庫管理と在庫移動を自動化する。
  9. Shopify Flowを活用した自動化ワークフローを提案する。 注文処理、在庫アラート、顧客タグ付け等の自動化をShopify Flow APIで設定する。
  10. Liquid テンプレート言語での修正を安全に行う。 テーマファイルの編集前にバックアップを取得し、変更内容をプレビューしてから適用する。
  11. 日本の税制（軽減税率）に対応する。 食品・飲料（酒類除く）は8%、その他は10%の消費税設定を正確に管理する。
  12. Shopify Payments JPの手数料を正確に計算する。 ベーシック3.4%、スタンダード3.3%、プレミアム3.25%、Plus2.9%のプラン別手数料を反映する。
  13. ディスカウントコードとオートディスカウントを使い分ける。 期間限定セール、送料無料キャンペーン、まとめ買い割引を目的に応じて適切に設定する。
  14. メタフィールドを活用して日本市場向けの追加情報を管理する。 原材料表示、アレルギー情報、製造者情報、JANコード等をメタフィールドで構造化する。
  15. Shopify GraphQL Admin APIを優先的に使用する。 REST APIよりもGraphQL APIの方がレート制限に余裕があり、必要なデータだけを効率的に取得できる。
  16. 日本の祝日・イベントに合わせたキャンペーン提案を行う。 正月、バレンタイン、ホワイトデー、母の日、父の日、お中元、お歳暮、ブラックフライデーなどの年間スケジュールを管理する。
  17. PWA対応とCore Web Vitalsの最適化を提案する。 日本のモバイルEC比率は70%を超えるため、モバイルパフォーマンスを最重要指標として管理する。

Shopify API Endpoint Reference

Shopify Admin APIはREST (JSON) + GraphQLの2形式。Authentication: Private app access token or OAuth access token.

Products API (商品管理):

MethodEndpointDescription
GET
/admin/api/{version}/products.json
商品一覧取得
GET
/admin/api/{version}/products/{id}.json
商品詳細取得
POST
/admin/api/{version}/products.json
商品登録
PUT
/admin/api/{version}/products/{id}.json
商品更新
DELETE
/admin/api/{version}/products/{id}.json
商品削除
GET
/admin/api/{version}/products/{id}/variants.json
バリアント一覧

Orders API (注文管理):

MethodEndpointDescription
GET
/admin/api/{version}/orders.json
注文一覧取得
GET
/admin/api/{version}/orders/{id}.json
注文詳細取得
POST
/admin/api/{version}/orders/{id}/fulfillments.json
出荷処理
POST
/admin/api/{version}/orders/{id}/cancel.json
注文キャンセル
POST
/admin/api/{version}/orders/{id}/refunds.json
返金処理

Inventory API (在庫管理):

MethodEndpointDescription
GET
/admin/api/{version}/inventory_levels.json
在庫レベル取得
POST
/admin/api/{version}/inventory_levels/set.json
在庫数設定
POST
/admin/api/{version}/inventory_levels/adjust.json
在庫数調整
GET
/admin/api/{version}/locations.json
ロケーション一覧

Theme API (テーマ管理):

MethodEndpointDescription
GET
/admin/api/{version}/themes.json
テーマ一覧取得
GET
/admin/api/{version}/themes/{id}/assets.json
テーマファイル一覧
PUT
/admin/api/{version}/themes/{id}/assets.json
テーマファイル更新
DELETE
/admin/api/{version}/themes/{id}/assets.json
テーマファイル削除

Discount API (割引管理):

MethodEndpointDescription
POST
/admin/api/{version}/price_rules.json
価格ルール作成
POST
/admin/api/{version}/price_rules/{id}/discount_codes.json
ディスカウントコード作成
GET
/admin/api/{version}/price_rules.json
価格ルール一覧

Environment Variables

VariableDescriptionRequiredDefault
SHOPIFY_STORE_URL
ストアURL (例: my-store.myshopify.com)Yes-
SHOPIFY_ACCESS_TOKEN
Admin APIアクセストークン (shpat_で始まる)Yes-
SHOPIFY_API_VERSION
使用するAPIバージョン (例: 2024-10)No2024-10
SHOPIFY_STOREFRONT_TOKEN
Storefront APIアクセストークンNo-
SHOPIFY_WEBHOOK_SECRET
Webhook検証用シークレットNo-
SHOPIFY_THEME_ID
操作対象テーマIDNo(公開テーマ)
SHOPIFY_LOCATION_ID
デフォルトロケーションIDNo(プライマリ)
SHOPIFY_YAMATO_API_KEY
ヤマトB2クラウド連携APIキーNo-
SHOPIFY_SAGAWA_API_KEY
佐川急便e飛伝連携APIキーNo-

Admin API Base: 

https://{store}.myshopify.com/admin/api/{version}
Storefront API: 
https://{store}.myshopify.com/api/{version}/graphql.json
Authentication: 
X-Shopify-Access-Token: {access_token}

Commands

shopify product [--search <query>] [--collection <id>] [--status <active|draft|archived>]

商品一覧を表示します。

$ shopify product --status active

╔══════════════════════════════════════════════════════════════════════╗
║                     Shopify 商品一覧                                  ║
╠══════════════════════════════════════════════════════════════════════╣
║ ID         | 商品名                      | 価格    | 在庫 | 状態    ║
║────────────┼─────────────────────────────┼─────────┼──────┼─────────║
║ 8123456789 | オーガニックコットンTシャツ  | ¥4,980  |  89  | Active  ║
║ 8123456790 | 天然藍染めストール          | ¥8,900  |  23  | Active  ║
║ 8123456791 | 九谷焼マグカップ            | ¥3,480  |  45  | Active  ║
║ 8123456792 | 手漉き和紙ノート            | ¥2,280  | 156  | Active  ║
║ 8123456793 | 桐箱入り高級箸セット        | ¥6,800  |  34  | Active  ║
╠══════════════════════════════════════════════════════════════════════╣
║ 合計: 5件 | Active: 5件 | 総在庫: 347点                             ║
║ [注意] 8123456790: 在庫23点 — 人気商品のため補充推奨                ║
╚══════════════════════════════════════════════════════════════════════╝


shopify order [--status <open|closed|cancelled>] [--id <order-id>]

注文一覧と詳細を管理します。

$ shopify order --status open

╔══════════════════════════════════════════════════════════════════════╗
║                     未処理注文一覧                                     ║
╠══════════════════════════════════════════════════════════════════════╣
║ 注文番号 | 注文日     | 顧客名     | 金額    | 決済        | 配送    ║
║──────────┼────────────┼────────────┼─────────┼─────────────┼────────║
║ #1047    | 2026-03-01 | 田中 太郎  | ¥8,460  | Shopify Pay | 未出荷 ║
║ #1046    | 2026-03-01 | 鈴木 花子  | ¥4,980  | コンビニ    | 入金待 ║
║ #1045    | 2026-02-28 | 佐藤 一郎  | ¥15,700 | PayPay      | 未出荷 ║
║ #1044    | 2026-02-28 | 山田 美咲  | ¥3,480  | クレジット  | 未出荷 ║
╠══════════════════════════════════════════════════════════════════════╣
║ 合計: 4件 | 出荷待ち: 3件 | 入金待ち: 1件                           ║
║ [要対応] #1045: 2日経過 — 本日中の出荷を推奨                        ║
║ [注意] #1046: コンビニ決済の入金確認待ち (期限: 2026-03-08)         ║
╚══════════════════════════════════════════════════════════════════════╝


shopify inventory [--location <id>] [--low-stock]

在庫管理をロケーション別に表示します。

$ shopify inventory --low-stock

╔══════════════════════════════════════════════════════════════════════╗
║                  在庫アラート (20個以下)                               ║
╠══════════════════════════════════════════════════════════════════════╣
║ 商品名                  | 東京倉庫 | 大阪倉庫 | 合計 | 日販 | 残日 ║
║─────────────────────────┼──────────┼──────────┼──────┼──────┼──────║
║ 天然藍染めストール      |    15    |     8    |   23 |  1.8 | 12.8 ║
║ 九谷焼マグカップ(青)    |     3    |     2    |    5 |  0.4 | 12.5 ║
║ 桐箱入り箸セット(夫婦)  |    10    |     4    |   14 |  0.7 | 20.0 ║
╠══════════════════════════════════════════════════════════════════════╣
║ [警告] 九谷焼マグカップ(青): 在庫5個 — 受注生産品のため早期発注推奨 ║
║ [情報] 東京→大阪の在庫移動を提案: ストール 5個                     ║
╚══════════════════════════════════════════════════════════════════════╝


shopify theme [--action <list|edit|backup|preview>] [--file <path>]

テーマカスタマイズを管理します。

$ shopify theme --action list

╔══════════════════════════════════════════════════════════════════════╗
║                     テーマ管理                                        ║
╠══════════════════════════════════════════════════════════════════════╣
║ ID          | テーマ名            | ロール   | 更新日              ║
║─────────────┼─────────────────────┼──────────┼─────────────────────║
║ 14567890001 | Dawn JP Custom      | main     | 2026-02-28 15:30    ║
║ 14567890002 | Dawn JP (backup)    | unpub    | 2026-02-20 10:00    ║
║ 14567890003 | Spring Campaign     | unpub    | 2026-02-25 18:45    ║
╠══════════════════════════════════════════════════════════════════════╣
║ 公開中: Dawn JP Custom                                               ║
║ [操作] shopify theme --action edit --file sections/main-product.liquid║
║ [操作] shopify theme --action backup (公開テーマをバックアップ)       ║
║ [操作] shopify theme --action preview --id 14567890003               ║
║                                                                      ║
║ 日本市場カスタマイズ状況:                                            ║
║   特商法表記ページ:    設定済み                                      ║
║   プライバシーポリシー: 設定済み                                      ║
║   送料説明ページ:      設定済み                                      ║
║   日本語フォント:      Noto Sans JP (設定済み)                       ║
║   消費税表示:          税込表示 (設定済み)                            ║
╚══════════════════════════════════════════════════════════════════════╝


shopify seo [--page <product|collection|blog|home>] [--audit]

日本語SEO分析と最適化を行います。

$ shopify seo --audit

╔══════════════════════════════════════════════════════════════════════╗
║                  日本語SEO監査レポート                                 ║
╠══════════════════════════════════════════════════════════════════════╣
║ サイト全体スコア: 74/100                                             ║
║                                                                      ║
║ ページ別分析:                                                        ║
║   ホームページ:        82/100                                        ║
║     title: 「手仕事の温もり｜匠のD2Cブランド」(29文字) — OK         ║
║     description: 設定済み (112文字) — OK                             ║
║     h1: 1個 — OK                                                     ║
║                                                                      ║
║   商品ページ (平均):   71/100                                        ║
║     [改善] 5商品中2商品でmeta descriptionが未設定                    ║
║     [改善] 構造化データ(Product)が3商品で不完全                      ║
║     [改善] 画像alt属性が12枚中4枚で未設定                            ║
║                                                                      ║
║   コレクション:        68/100                                        ║
║     [改善] コレクション説明文が3件中2件で100文字未満                 ║
║                                                                      ║
║ 技術SEO:                                                             ║
║   robots.txt:          OK                                            ║
║   sitemap.xml:         OK (自動生成)                                 ║
║   hreflang:            未設定 — 多言語展開時に必要                   ║
║   Core Web Vitals:     LCP 2.1s / FID 45ms / CLS 0.08               ║
║   モバイルフレンドリー: OK                                            ║
║                                                                      ║
║ [優先対応] meta description未設定の2商品を修正                       ║
║ [推奨] 全商品に構造化データ(JSON-LD)を完全実装                       ║
╚══════════════════════════════════════════════════════════════════════╝


shopify shipping [--carrier <yamato|sagawa|japanpost>] [--rates]

国内配送設定と料金を管理します。

$ shopify shipping --rates

╔══════════════════════════════════════════════════════════════════════╗
║                  配送料金設定                                          ║
╠══════════════════════════════════════════════════════════════════════╣
║ 配送ゾーン     | ヤマト運輸    | 佐川急便     | 日本郵便            ║
║────────────────┼──────────────┼──────────────┼─────────────────────║
║ 関東           | ¥930 (60s)   | ¥880 (60s)   | ¥870 (ゆうパック)   ║
║ 関西           | ¥1,040 (60s) | ¥990 (60s)   | ¥970 (ゆうパック)   ║
║ 北海道         | ¥1,370 (60s) | ¥1,320 (60s) | ¥1,300 (ゆうパック) ║
║ 沖縄           | ¥1,370 (60s) | ¥1,540 (60s) | ¥1,350 (ゆうパック) ║
╠══════════════════════════════════════════════════════════════════════╣
║ 送料無料ライン: ¥8,000以上のご注文                                   ║
║ ネコポス対応:   ¥385 (A4サイズ・厚さ3cm・1kg以内)                   ║
║ クリックポスト: ¥185 (A4サイズ・厚さ3cm・1kg以内)                   ║
║                                                                      ║
║ [設定] 時間帯指定: 午前中/14-16/16-18/18-20/19-21                   ║
║ [設定] 日付指定:   注文から3-7日で指定可能                           ║
║ [提案] 沖縄・離島は佐川急便が割高 → ゆうパックへ自動切替推奨        ║
╚══════════════════════════════════════════════════════════════════════╝


shopify analytics [--period <day|week|month>] [--metric <sales|traffic|conversion>]

売上・トラフィック・コンバージョン分析を表示します。

$ shopify analytics --period month

╔══════════════════════════════════════════════════════════════════════╗
║              Shopify 月次レポート — 2026年2月                         ║
╠══════════════════════════════════════════════════════════════════════╣
║ 売上合計:     ¥3,624,800 (前月比 +16.7%)                            ║
║ 注文件数:     487件      (前月比 +14.2%)                            ║
║ 客単価:       ¥7,443     (前月比 +2.2%)                             ║
║ セッション数: 28,400     (前月比 +11.8%)                            ║
║ 転換率:       1.71%      (前月比 +0.08pt)                           ║
║ カート離脱率: 67.2%      (前月比 -2.1pt — 改善)                     ║
║                                                                      ║
║ 流入元:                                                              ║
║   Google検索:  38.2% (10,851セッション)                              ║
║   SNS(Instagram): 24.7% (7,016セッション)                            ║
║   ダイレクト:  18.3% (5,197セッション)                              ║
║   リファラル:  12.4% (3,522セッション)                              ║
║   その他:      6.4%  (1,814セッション)                              ║
║                                                                      ║
║ 決済方法:                                                            ║
║   Shopify Payments:  58.3% (¥2,113,258)                              ║
║   PayPay:            18.7% (¥677,838)                               ║
║   コンビニ決済:      12.4% (¥449,475)                               ║
║   キャリア決済:       6.2% (¥224,738)                               ║
║   その他:             4.4% (¥159,491)                               ║
║                                                                      ║
║ [インサイト] Instagram流入が前月比+32% → SNS施策が奏功              ║
║ [提案] カート離脱率67.2% → カゴ落ちメール最適化で5%改善見込み       ║
╚══════════════════════════════════════════════════════════════════════╝


shopify discount [--action <create|list|analyze>] [--type <code|automatic>]

ディスカウント管理を行います。

$ shopify discount --action list

╔══════════════════════════════════════════════════════════════════════╗
║                     ディスカウント一覧                                 ║
╠══════════════════════════════════════════════════════════════════════╣
║ コード/名称        | タイプ    | 割引内容    | 期間        | 使用数  ║
║────────────────────┼──────────┼─────────────┼─────────────┼─────────║
║ SPRING2026         | コード    | 全品15%OFF  | 3/1-3/31    | 47      ║
║ 新規購入¥500OFF    | 自動      | ¥500OFF     | 常時        | 234     ║
║ まとめ買い10%OFF   | 自動      | 3点以上10%  | 常時        | 89      ║
║ FREEDEL            | コード    | 送料無料    | 3/1-3/14    | 127     ║
╠══════════════════════════════════════════════════════════════════════╣
║ [分析] SPRING2026: 売上貢献¥487,200、平均注文額+18%                 ║
║ [分析] まとめ買い: 客単価¥9,800(通常比+32%)、効果大                ║
║ [提案] ホワイトデー向け期間限定コードの追加を推奨                    ║
╚══════════════════════════════════════════════════════════════════════╝

Workflow Diagram

┌─────────────────────────────────────────────────────────────────────┐
│             Shopify Japan 日次運用ワークフロー                         │
│                                                                     │
│  07:00 ┌──────────────────────────────────────────────┐             │
│        │ 1. 注文処理                                   │             │
│        │    └─ 新規注文の確認                          │             │
│        │    └─ コンビニ決済の入金確認                  │             │
│        │    └─ 出荷処理（追跡番号登録）                │             │
│        │    └─ お届け日指定注文の優先処理              │             │
│        └──────────────────┬───────────────────────────┘             │
│                           ▼                                         │
│  09:00 ┌──────────────────────────────────────────────┐             │
│        │ 2. 在庫管理                                   │             │
│        │    └─ ロケーション別在庫確認                  │             │
│        │    └─ 低在庫アラートの確認                    │             │
│        │    └─ 在庫移動の実行                          │             │
│        └──────────────────┬───────────────────────────┘             │
│                           ▼                                         │
│  11:00 ┌──────────────────────────────────────────────┐             │
│        │ 3. SEO・コンテンツ最適化                      │             │
│        │    └─ 新商品のmeta情報設定                    │             │
│        │    └─ 構造化データの確認                      │             │
│        │    └─ ブログ記事の公開                        │             │
│        │    └─ Core Web Vitalsの確認                   │             │
│        └──────────────────┬───────────────────────────┘             │
│                           ▼                                         │
│  14:00 ┌──────────────────────────────────────────────┐             │
│        │ 4. マーケティング                             │             │
│        │    └─ ディスカウント効果の確認                │             │
│        │    └─ カゴ落ちメールの効果分析                │             │
│        │    └─ SNS連携投稿の確認                      │             │
│        └──────────────────┬───────────────────────────┘             │
│                           ▼                                         │
│  18:00 ┌──────────────────────────────────────────────┐             │
│        │ 5. 日次レポート                               │             │
│        │    └─ 売上・トラフィック・転換率サマリー      │             │
│        │    └─ 決済方法別分析                          │             │
│        │    └─ テーマパフォーマンス                    │             │
│        │    └─ 翌日のアクション整理                    │             │
│        └──────────────────────────────────────────────┘             │
└─────────────────────────────────────────────────────────────────────┘

Error Handling

Error CodeMeaningAgent Action
401 Unauthorized
アクセストークンが無効トークンの再発行手順を案内。Shopifyアプリ設定画面でのスコープ確認
402 Payment Required
Shopifyプラン制限必要な機能のプラン要件を表示し、アップグレードを案内
404 Not Found
リソースが存在しないID/ハンドルの確認を促し、類似リソースの候補を表示
422 Unprocessable
バリデーションエラーエラー詳細のフィールドを特定し、修正方法を具体的に案内
429 Too Many Requests
APIレート制限超過リトライヘッダーに従い自動待機。GraphQL APIへの切り替えを提案
500 Internal Error
Shopify内部エラー3回までリトライ。status.shopify.comの確認を案内
THEME_LOCKED
テーマが編集ロック中ロック解除を待つか、テーマの複製を提案
INVENTORY_NOT_TRACKED
在庫追跡が無効商品設定で在庫追跡を有効化する手順を案内
FULFILLMENT_EXISTS
既に出荷処理済み現在のフルフィルメント状況を表示し、追跡番号更新の手順を案内

FAQ

Q: Shopifyの日本向けプランの料金は？ A: ベーシック月額¥4,850、スタンダード月額¥13,500、プレミアム月額¥58,500、Plus月額$2,300です。決済手数料はプランにより3.25-3.55%です。

shopify analytics
で現在のプランに対する費用対効果を分析できます。

Q: 特定商取引法に基づく表記の設定方法は？ A: 

shopify theme --action edit
で法定ページを自動生成します。事業者名、所在地、電話番号、メールアドレス、販売価格、送料、返品条件等の必須項目をテンプレートから生成し、ポリシーページとして公開します。

Q: コンビニ決済・PayPay等の日本独自決済の導入方法は？ A: Shopify Payments JPを有効化し、追加決済としてKOMOJU等のゲートウェイを設定します。

shopify payment setup
でコンビニ決済(セブン-イレブン、ローソン、ファミリーマート等)、PayPay、楽天ペイ、メルペイの導入ステップを案内します。

Q: ヤマト運輸/佐川急便との連携方法は？ A: Shopifyアプリ「Ship&co」等の配送連携アプリを通じて、送り状の一括発行、追跡番号の自動登録が可能です。

shopify shipping --carrier yamato
でヤマトB2クラウドとの連携設定を案内します。

Q: 日本語SEOで最も重要なポイントは？ A: title(30-35文字)、meta description(100-120文字)の日本語最適化が最重要です。構造化データ(Product, BreadcrumbList, Organization)の実装、画像alt属性の日本語記述、日本語URL(ハンドル)の設定も効果的です。

Q: 消費税の軽減税率対応は？ A: Shopifyの税金設定で商品カテゴリ別に税率を設定します。食品・飲料(酒類除く)は8%、その他は10%です。

shopify product --set-tax
で商品ごとの税率を一括設定できます。

Q: テーマのLiquidファイルを直接編集しても大丈夫？ A: 編集前に必ず 

shopify theme --action backup
でバックアップを取得してください。エージェントは変更内容をプレビュー環境で確認後に本番適用する安全なワークフローを提供します。

Q: EC-CUBEからの移行は可能？ A: 商品データ、顧客データ、注文履歴のCSVエクスポート/インポートで移行可能です。

shopify migrate --from ec-cube
で移行ウィザードを起動し、データマッピングと検証を自動化します。

Q: Headless Commerce（ヘッドレス）構成は対応している？ A: Storefront API経由でNext.js、Gatsby、Nuxt.js等のフロントエンドフレームワークとの連携をサポートします。

shopify storefront
コマンドでGraphQLクエリのテスト・実行が可能です。

Q: 定期購入（サブスクリプション）は設定できる？ A: Shopify Subscription APIを通じて定期購入機能を管理できます。

shopify subscription
で定期購入プランの作成、顧客管理、次回配送日の調整等が可能です。日本の食品定期便やサプリメント定期購入に最適です。

Q: Shopify Flow自動化はどんなことができる？ A: 注文処理の自動化（高額注文のフラグ付け、特定地域の配送方法自動選択）、在庫アラート、顧客タグ付け（VIP判定）、Slackやメールへの通知等が設定可能です。

shopify flow
でワークフローテンプレートを提供します。

Data Storage

.shopify-japan/
├── config.json                  # API認証情報とストア設定
├── cache/
│   ├── products.json            # 商品キャッシュ (TTL: 30m)
│   ├── collections.json         # コレクションキャッシュ (TTL: 1h)
│   ├── inventory-levels.json    # 在庫レベル (TTL: 15m)
│   ├── locations.json           # ロケーション (TTL: 24h)
│   └── shipping-rates.json      # 配送料金テーブル (TTL: 7d)
├── analytics/
│   ├── daily-sales.jsonl        # 日次売上データ
│   ├── traffic-sources.jsonl    # 流入元データ
│   ├── conversion-funnel.jsonl  # コンバージョンファネル
│   ├── payment-methods.jsonl    # 決済方法別集計
│   └── monthly-reports/
│       └── 2026-02.json         # 月次レポート
├── seo/
│   ├── audit-results.json       # SEO監査結果
│   ├── meta-tags.json           # メタタグ設定
│   ├── structured-data.json     # 構造化データ
│   └── core-web-vitals.jsonl    # CWV推移データ
├── themes/
│   ├── backups/
│   │   └── {theme-id}-{date}/   # テーマバックアップ
│   ├── customizations.jsonl     # カスタマイズ履歴
│   └── liquid-snippets/
│       └── *.liquid             # カスタムスニペット
├── orders/
│   ├── pending-fulfillment.json # 出荷待ち注文
│   ├── shipping-labels/
│   │   └── {order-number}.pdf   # 送り状
│   └── refunds.jsonl            # 返金履歴
├── discounts/
│   ├── active-codes.json        # 有効ディスカウント
│   └── performance.jsonl        # 割引効果分析
├── legal/
│   ├── tokutei-shoutorihiki.html # 特定商取引法表記
│   ├── privacy-policy.html       # プライバシーポリシー
│   └── shipping-policy.html      # 配送・返品ポリシー
├── exports/
│   └── *.csv                    # エクスポートファイル
└── logs/
    ├── api-calls.jsonl          # API呼び出しログ
    ├── theme-changes.jsonl      # テーマ変更履歴
    └── errors.jsonl             # エラーログ

Comparison Table

FeatureShopify JapanEC-CUBEBASESTORESMakeShop
タイプSaaS (グローバル)OSS (自社サーバー)SaaSSaaSSaaS
初期費用無料無料(構築費別)無料無料¥11,000
月額費用¥4,850〜無料(サーバー費)無料無料¥12,100〜
決済手数料3.25-3.55%決済会社依存6.6%+¥405.0%3.19-3.49%
カスタマイズ性Liquid+APIPHP完全自由テンプレートテンプレートテンプレート
Headless対応Storefront APIREST API非対応非対応非対応
日本語SEO本エージェントプラグイン基本基本基本
国内配送連携ヤマト/佐川/郵便プラグイン基本基本ヤマト/佐川
決済手段30+種類プラグイン基本基本多数
越境EC175カ国対応独自対応非対応非対応限定的
アプリエコシステム8,000+アプリ700+プラグイン100+アプリ限定的限定的
サーバー管理不要(SaaS)必要不要不要不要
AI搭載Claude Code統合非対応非対応非対応非対応
CLI操作完全対応コマンドラインWeb UIWeb UIWeb UI
D2Cブランド適性最適高い中程度中程度中程度
拡張性GraphQL APIPHP拡張限定的限定的限定的
セキュリティPCI DSS Level 1自己管理プラットフォームプラットフォームプラットフォーム

Shopify Japan Specific Features

  • Shopify Admin API + Storefront API 完全対応
  • GraphQL Admin API優先使用（効率的なレート制限管理）
  • 日本語SEO完全最適化（title/meta/構造化データ/hreflang）
  • Core Web Vitals監視とパフォーマンス最適化
  • ヤマト運輸(B2クラウド)連携
  • 佐川急便(e飛伝)連携
  • 日本郵便(ゆうパック/クリックポスト)連携
  • Shopify Payments JP（クレジットカード・Apple Pay・Google Pay）
  • コンビニ決済（セブン-イレブン/ローソン/ファミリーマート）
  • PayPay・楽天ペイ・メルペイ決済
  • キャリア決済（ドコモ/au/ソフトバンク）
  • 後払い決済（NP後払い/Paidy/atone）
  • 消費税軽減税率対応（8%/10%自動設定）
  • 特定商取引法に基づく表記の自動生成
  • 日本語テーマカスタマイズ（Noto Sans JP/游ゴシック）
  • Liquid テンプレート安全編集（バックアップ+プレビュー）
  • メタフィールドによる日本市場向け追加情報管理
  • 複数ロケーション在庫管理
  • Shopify Flow自動化ワークフロー
  • 越境EC対応（多言語・多通貨）
  • サブスクリプション（定期購入）管理
  • Shopify POS連携（実店舗在庫同期）