Musashiツールマニュアル

1. ログイン画面の「パスワードをお忘れですか？」からパスワードを再設定してみてください。
2. 再設定メールが届かない場合、迷惑メールフォルダをご確認ください。
3. それでも解決しない場合は、Discord の「エラーなど個別問い合わせチャンネル」でチケットを発行し、登録メールアドレスを運営までお伝えください。運営から直接パスワード再設定リンクを発行します。

1. ブラウザを閉じて再度開き、再度ログインをお試しください。
2. 別のブラウザ（Google Chrome 推奨）で試してみてください。
3. 解決しない場合は運営に登録メールアドレスをお伝えください。個別にリセットリンクを発行いたします。

Gmail 等で 迷惑メール扱い になっている可能性があります。迷惑メール・プロモーションフォルダもご確認ください。

見つからない場合は、Discord の個別問い合わせチャンネルでご連絡ください。

正しい手順:

1. App Store から TestFlight アプリ をインストールしておく。
2. スマホのブラウザで、Discord 記載の Musashi アプリ専用リンク（https://testflight.apple.com/join/bKNnUsXj）をタップ。
3. TestFlight が起動し、Musashi が表示されるので、そのまま「インストール」をタップ。

※TestFlight 内の「コードを使う」ボタンは使いません。

Google Play Store から直接ダウンロードできます。

https://play.google.com/store/apps/details?id=com.musashi.japan

※「このアプリはご利用できません」と表示される場合、国/リージョン設定が日本になっているかご確認ください。

1. アプリをタスク一覧から完全に閉じ、再起動する。
2. それでもダメな場合は、アプリを一旦削除し、再インストールする。
3. iPhone の「設定」→「Musashi」からカメラのアクセスが許可されているか確認する。

※実際に過去、再インストールで解決した事例があります（iPhone 17）。

1. TestFlight（iOS）または Google Play（Android）から最新版に更新してください（v2.2.0 以降推奨）。
2. エラーが続く場合は、1回の解析で処理する画像を 4 枚以内に抑えてお試しください。
3. 暫定対応として、AI 解析のみ PC 版で行い、スマホは撮影専用として使う運用も可能です。

1. PC 側でブラウザを更新（Ctrl+Shift+R / ⌘+Shift+R）。
2. スマホアプリを一度完全に閉じ、再起動。
3. それでも反映されない場合は、アプリから一度ログアウトし、再ログイン。

スマホアプリでは、商品を撮影 → 「次へ」進んだ画面の 右上 に AI 解析ボタンがあります。

1. Musashi 画面をスーパーリロード（Ctrl+Shift+R / ⌘+Shift+R）。
2. 再度ポリシーの取得を実行。

解決しない場合は、ユーザー管理画面から UUID をコピーし、Discord のサポートチャンネルに投稿してください。

1. Discord の個別問い合わせチャンネルで、登録メールアドレスを運営までお伝えください。
2. 運営が古い連携データを強制削除します。
3. 削除完了後、ブラウザをスーパーリロードし、再度連携をお試しください。

現状、カテゴリー名から eBay カテゴリー ID を検索する機能は未実装です（要望として対応中）。

手動で調べる方法:

1. eBay サイトで出品したいカテゴリーの商品ページを開く。
2. URL に含まれる数字（カテゴリー ID）を確認。
3. Musashi のカテゴリー設定画面で入力する。

1. Musashi 画面をスーパーリロード。
2. 数分待ってから、再度出品操作をお試しください。

1. Musashi 上で Shopee の全アカウント連携を解除。
2. Musashi からログアウト。
3. ブラウザをスーパーリロード。
4. 再度ログインし、Shopee を 1 アカウントのみ 連携。
5. 認証期間は 365 日で問題ありません。

※現在、Shopee の複数アカウント同時連携は対応途中です。

プラットフォーム連携画面に Shopee（シンガポール等）が表示されていれば、連携は完了しています。

複数アカウントを同時連携している場合に発生する既知の事象です。

Shopee は 1 アカウントのみ 連携してください。現状、開発環境から本番環境への切り替え段階の影響もあるため、安定まで時間がかかる場合があります。

Shopee の仕様上、「Specification（商品詳細）」内のブランド項目が 必須 です。

1. 商品詳細の Shopee タブ を開く。
2. Specification 欄の Brand（ブランド）を入力。
3. 「商品共通項目」だけでなく、Shopee タブ内の Specification にも明示的に入力が必要です。

正しいフロー:

1. 商品共通項目を 日本語で入力。
2. AI 生成を実行。
3. 自動翻訳され、Shopee 側には 英語（または現地語）で出品される。

日本語のまま出品されてしまう場合は、ブラウザをスーパーリロードし、AI 生成からやり直してください。

翻訳・文字数カウントの不具合として修正完了しています。

ブラウザをスーパーリロードし、再度出品操作をお試しください。

Joom 連携は、Joom の Merchant Panel 側で「OAuth アプリを作成 → リダイレクト URL を登録 → Client ID / Client Secret を発行」し、Musashi にその情報を入力するだけで完了します。

■ STEP 1: Joom の Merchant Panel で OAuth アプリを作成

1. Joom Merchant Panel にログイン → https://merchant.joom.com/auth/signin
2. API / 開発者設定のページから、新規 OAuth アプリを作成します。
3. 作成フォームの Redirect URL（リダイレクト URL） 欄に、以下をそのままコピーして入力してください:

4. アプリを保存すると、Client ID と Client Secret が発行されます。両方をコピーしてメモしてください（Client Secret は発行時にしか表示されない場合があります）。

■ STEP 2: Musashi 側で Client ID / Secret を入力

1. Musashi にログイン → サイドメニューの 設定 → Joom を開く（https://musashi.awiiin.com/settings/joom）。
2. STEP 1 でコピーした Client ID と Client Secret を入力します。
3. 「連携する」ボタンをクリック → Joom の認証ページが開くので、許可をクリック。
4. 自動的に Musashi に戻り、連携完了となります。

■ STEP 3: 動作確認

1. Musashi で出品したいアイテムを選択。
2. 商品詳細の Joom タブ → AI 生成 → 出品を実行。
3. Joom Merchant Panel で出品が反映されているか確認。

解決しない場合は、Discord で UUID を添えてお問い合わせください。

以下の URL をそのままコピー&ペーストして入力してください。

この URL が正しく設定されていないと、Joom で認証を許可しても Musashi に戻ってこられず、連携が完了しません。

以下のいずれかが原因です。

1. Joom 側のアプリ設定で Client ID / Client Secret が正しく発行されていない、または Musashi への入力値が間違っている。→ Joom Merchant Panel でアプリ情報を再確認し、Musashi に入力し直してください。
2. Joom 側のアプリ設定で リダイレクト URL が https://musashi.awiiin.com/api/joom/auth/callback になっていない。→ Joom のアプリ設定画面で URL を上記に修正してください。
3. Client Secret がコピー時に前後に余計な空白・改行が入っている。→ 再度コピーしてお試しください。

1. Joom Merchant Panel にログイン → https://merchant.joom.com/auth/signin
2. API / 開発者設定ページを開き、「新規アプリ作成」等のボタンからアプリを作成します。
3. アプリ作成フォームでリダイレクト URL に https://musashi.awiiin.com/api/joom/auth/callback を入力し、保存。
4. 保存後に表示される Client ID と Client Secret をコピーしてください。

Musashi サイドメニューの 設定 → Joom から任意のストア名を入力して設定してください。

設定ページ: https://musashi.awiiin.com/settings/joom

連携済みアカウントに対し、任意の名前（例: メインストア、フィギュア専用 など）を入力して保存できます。

Joom 側で作成したストアの Specialization の配下にあるカテゴリーを選択する必要があります。

• Joom ストア: Electronics accessories → 配下のヘッドホン等
• Joom ストア: Outlet → 全ジャンル対応

Musashi の「カテゴリー管理」で、Joom ストアの Specialization 配下に含まれるカテゴリを設定してください。Specialization と商品ジャンルが一致していないと、Joom への出品時にカテゴリーエラーになります。

前提条件: Joom 連携が完了し、Musashi 側のカテゴリー設定が Joom ストアの Specialization と整合していること。

1. Musashi で出品したいアイテムを選択。
2. 右側に表示される商品詳細で Joom タブをクリック。
3. AI 生成ボタンで Joom 用のタイトル・説明文を自動生成。
4. 各項目の内容を確認（特にカテゴリー、価格、在庫）。
5. 出品ボタンをクリック → Joom へ出品完了。

現状、Joom については 1 アカウント（1 マーチャント）のみの連携を推奨しています。

Joom アカウント内で複数のストアを作成している場合は、Musashi 側で任意のストア名を指定することで使い分け可能です。

Shopify は現在、アプリ審査対応中のため接続できません。

接続時の Admin API トークンは、お客様が取得する必要はなく、Musashi 側で処理する方式で準備中です。開放までお待ちください。

はい、Lazada は接続可能です。現時点で連携ができる状態です。

削除した商品が アーカイブ（ゴミ箱）に残っているため、システム側で重複と判定されています。

1. 左メニューの 「すべて」をクリックし、全アイテムを表示。
2. 該当アイテムが残っていれば、右側の「⋮」メニューから 「削除」を選択。
3. 画面上部の 「アーカイブ」タブを開く。
4. アーカイブ内の該当アイテムの「⋮」から再度 「削除」を実行（完全削除）。
5. その後、新規登録を再度お試しください。

同じ商品を別の Musashi カテゴリーへ移動することは可能です。ただし、商品情報はリセットされる場合があります。

1. ブラウザをスーパーリロード。
2. 「カテゴリー管理」画面で該当カテゴリーを開き、右上の 「カテゴリーを更新」ボタンを押す。
3. Shopee 側の設定画面でカテゴリーを手動選択して保存。

1. 設定 → カテゴリー管理から該当カテゴリーを開く。
2. eBay Item Specifics 設定の赤くなっている必須項目をすべて入力。
3. 保存後、画面右上の 「カテゴリーを更新」ボタンを押す。
4. 再度出品をお試しください。

UI の不具合として修正完了しています。

ブラウザをスーパーリロード（Ctrl+Shift+R / ⌘+Shift+R）すれば、正常にスクロール可能になります。

1. 商品詳細画面で各種ポリシー（Shipping・Return・Payment）が選択されているか確認。
2. ブラウザをスーパーリロード。
3. 再度出品ボタンを押してください。

AI による自動トリミング機能は現在実装を検討中です（要望として受付済み）。

現時点の対応:

• スマホアプリ最新版では、手動による連続トリミングがしやすい UI になっています。
• スマホカメラの ハサミアイコンからトリミングしてください。

現状、1 回の AI 解析で処理されるのは 最大 4 枚です。

5 枚以上アップロードしても最初の 4 枚のみ解析されます。

画像タブ以外（商品詳細の全体画面など）にドラッグ&ドロップすると、正しく保存されず白紙になる既知の不具合があります。

1. 商品詳細画面を開く。
2. 画像タブを開く。
3. ドラッグ&ドロップ、または「画像を追加」ボタンから追加。

1. 撮影画質を「最高画質」ではなく「標準」に設定。
2. 1 回の解析は 4 枚以内に抑える。
3. それでも解決しない場合、アプリを最新版にアップデート。

現在、画像の並び替え機能をアップデート中です。

暫定対応として、画像を一度すべて削除し、表示したい順序で再度追加していただく運用をお願いしています。

現在、商品の複製機能について改修中です。

類似商品を登録したい場合は、一度元商品の情報をメモに控えてから、新規商品として再登録する運用をお願いします。

商品共通項目のフィールドと、各プラットフォーム（eBay 用等）の個別フィールドの両方にマッピングする必要があります。

現在は手動設定が必要ですが、AI が自動マッピングできるよう改善中です。

AI が生成したタイトルに、商品の状態を表す単語（Like New, VG, Brand New等）が含まれていることが原因です。eBay のポリシーでは、タイトルに状態ワードを含めることが禁止されています。

対処法:

1. 商品詳細画面で eBay 用タイトルを確認。
2. タイトルから状態ワードを 手動で削除。
3. 再度出品ボタンを押す。

例:

• ❌ NG: DAISO Pastel Ring Notebook A6 Green 120 Sheets Front Pocket PP Cover Like New
• ✅ OK: DAISO Pastel Ring Notebook A6 Green 120 Sheets Front Pocket PP Cover

選択している eBay カテゴリーと実際の商品内容が一致していない場合によく発生します。

原因の例:

• ノートブック用のカテゴリー（例: 102950 - Binders & Notebooks）を選択しているのに、実際はワイヤレスイヤホンを出品している。

対処法:

1. eBay のカテゴリー ID と実際の商品ジャンルが一致しているか確認。
2. カテゴリーを正しいものに設定し直す。
3. UPC 必須のカテゴリーで商品自体にバーコードがない場合は、UPC 欄に Does Not Apply を入力。

AI 解析の精度に起因するエラーです。よくあるケース: Country of Origin（原産国）に複数の国名が入ってしまっている。

1. 商品詳細画面の eBay タブで「Country of Origin」欄を確認。
2. 複数の値が入っている場合は、1 つの国のみに修正。
3. 再度出品をお試しください。

1. Musashi 画面をスーパーリロード。
2. 商品詳細の eBay タブをもう一度開き、Condition を選択。
3. それでも項目が見つからない場合は、スクリーンショットを撮って Discord へ。

コンディション設定が New のまま中古品カテゴリーに出品しようとしている可能性があります。

商品詳細画面で Condition を Pre-owned に変更してから再度出品してください。

1. 設定 → カテゴリー管理で該当カテゴリーに eBay 設定を追加。
2. 画面右上の 「カテゴリーを更新」ボタンを押す。
3. 再度出品操作をお試しください。

Shopee のカテゴリーごとに必須の属性（Attribute）が未入力、または不正な値です。

1. 商品詳細の Shopee タブを開く。
2. カテゴリー固有の属性欄（Brand・Color・Material 等）をすべて確認。
3. 必須項目をすべて入力してから再度出品。

1. 多展開したい商品の 商品詳細を開く。
2. 出品先プラットフォームのタブ（Shopee / Joom）をクリック。
3. 下部の AI 生成ボタンを押し、対象プラットフォーム用のタイトル・説明を自動生成。
4. 内容を確認。
5. 出品ボタンをクリック。

フルシンク（ぐるぐるアイコンのボタン）を使用します。

1. 商品一覧画面のフルシンクボタンをクリック。
2. eBay の既存出品が一括で取り込まれます。
3. 商品数が多い場合（数千件以上）は 数分〜数十分かかる場合があります。

1. 「プラットフォーム連携」画面で、Shopee/Joom が 連携済みになっているか確認。
2. 未同期になっている場合は、フルシンクを実行。
3. 複数アカウントを連携している場合は、一旦全て解除し 1 アカウントのみ再連携してください。

UI のキャッシュ問題の可能性があります。ブラウザをスーパーリロードしてください。

「AI 生成 → 出品」だけではテンプレートが反映されません。必ず間にテンプレート選択を挟んでください。

はい、日本語でプロンプトを指定可能です。

例:

• 「かわいい雰囲気」
• 「高級感のある」
• 「ミニマルでシンプルな」
• 「ポップな色合いの」

アニメグッズ、フィギュア、着物、日本刀など、特定ジャンル向けのテンプレート追加要望も受付中です。

• 5,000 品: 数分程度
• 10,000 品以上: 10 分〜数十分

処理中にブラウザ上で「ネットワークエラー」が表示される場合がありますが、バックグラウンドの同期処理は継続しています。そのまま放置するか、時間をおいてページを更新してください。

1. eBay アカウントは 1 アカウントのみ連携してください。
2. 複数連携されている場合は、追加アカウントを解除。
3. スーパーリロード後、再度フルシンクをお試しください。

同期処理の不具合で同一 SKU が重複取得された状態です。

• SKU 検索で重複を確認できます。
• 運営側で修正・再調整を行います。Discord でご連絡ください（UUID + 現象の説明）。

フルシンクは大量データ処理のため、一時的に動作が重くなる場合があります。

1. フルシンク完了までお待ちください。
2. ブラウザが固まった場合はタブを一度閉じて再度開いてください（バックグラウンドで処理は継続）。

eBay 側の出品を止めたい場合は、Musashi 上で「削除」ではなく 「取り下げ」ボタンを実行してください。

現状、アーカイブ画面からの取り下げ操作は eBay に反映されません（今後対応予定）。

暫定対応として、eBay のセラーハブに直接ログインし、該当商品を End Item（取り下げ）してください。

ほとんどの不具合は以下の手順で解決します。

これでも解決しない場合は、Discord の個別問い合わせチャンネルへ。

以下の 3 点を送っていただけると、調査・解決がスムーズです。

1. UUID: サイドメニューの「ユーザー管理」に表示されている ID。
2. SKU: 該当商品の SKU（例: CAT-2026-MO3XXXXX）。
3. スクリーンショット: エラーの画面。PC の場合、F12キーで検証画面を開き、「Console」タブの赤字エラーも撮影していただけると特に助かります。

自動翻訳 ON の状態だと、フォームの入力データが破壊されて正しく送信されないケースが報告されています。

Chrome の場合、Musashi のページで右クリック →「日本語に翻訳」のチェックを外すか、URL バーの翻訳アイコンから無効化してください。

Google Chrome を推奨します。