設定画面の使い方ガイド
プロフィール、基本設定（価格・AI）、eBayアカウント、メルカリ監視、説明文テンプレート、商品インポート、APIトークンの 7 タブを解説します。
TSUNAGURO の設定画面（左メニュー「設定」）には 7 つのタブがあります。 本記事では各タブの役割と、出品前に必ず触っておきたい設定をまとめて説明します。
7 つのタブの全体像
| タブ名 | 用途 |
|---|---|
| プロフィール | アバター画像、メールアドレス、パスワードの変更 |
| 基本設定 | 価格計算（手数料率・配送料・関税率・利益率）と AI プロンプト |
| eBayアカウント | eBay OAuth 接続、複数アカウント管理、Business Policy 紐付け |
| メルカリ監視 | メルカリ出品者プロフィールの監視・新着自動取り込み |
| 説明文テンプレート | eBay 出品時の HTML 説明文テンプレート管理 |
| eBay商品インポート | eBay 既出品の取り込み（過去 90 日販売データ含む） |
| APIトークン | Chrome 拡張・外部連携用の PAT 発行 |
1. プロフィール
個人アカウント情報を変更します。組織内の他メンバーには影響しません。
- プロフィール画像: 5MB 以下の画像をアップロード。「画像を削除」で初期化
- メールアドレス変更: 新アドレスに確認メールを送信。メール内のリンクで切り替わります
- パスワード変更: 現在のパスワード + 新パスワード（2 回入力）が必要
2. 基本設定（価格・AI プロンプト）
出品価格の自動計算と AI による翻訳・Item Specifics 生成のルールを設定します。 新規取込商品の価格はここで設定された値が即時反映されますが、既存出品商品は手動再計算が必要です。
価格設定
手数料率
- 利益率 — 例: 0.2 = 20%
- eBay 手数料率 — 例: 0.13 = 13%
- PayPal 手数料率 — 例: 0.029 = 2.9%
- Promoted Listings デフォルト手数料率 — eBay の広告（Promoted Listings）の平均的な入札率を入れておくと赤字防止になります
配送・梱包費用
- 配送料 (JPY) — 国内配送料の見込み
- 梱包材費用 (JPY) — ダンボール・緩衝材等の単価
- 関税率 (%) — 米国 DDP 関税率（Section 122 + 301）。商材ごとに異なる場合は商品ごとに上書きできます
- 最低利益額 (JPY) — この金額未満の利益になる場合は出品をブロック
その他
- 為替マージン — 為替変動への安全マージン（例: 0.02 = 2%）
- 価格末尾 — $X.99 / $X.95 / $X.00 から選択
AI プロンプト設定
タイトル翻訳と Item Specifics 生成の挙動を、自然文で指示できます。 JSON 形式や返却キーなどのシステムルールは内部で固定されているため、ユーザーは「どんなタイトルにしたいか」「どの項目を優先したいか」だけを書けば動きます。
- タイトル翻訳ルール: 文字数、入れたいキーワード、語順など。例: 「75〜80 文字、検索されやすい単語を優先、ぬいぐるみは Plush / Doll / Toy を使用可」
- Item Specifics 生成ルール: 商材ごとの優先項目、出したくない項目。例: 「バッグなら Brand / Color / Material / Department を優先、根拠のない Year Manufactured は出さない」
3. eBayアカウント
eBay との OAuth 接続、複数アカウントの管理、Business Policy（Shipping / Payment / Return）の紐付けを行います。
- OAuth 接続: 「eBay アカウントと連携」ボタンから OAuth 認証画面へ。トークンは自動更新されます
- 複数アカウント: 「+ アカウントを追加」で 2 つ目以降を追加可能。商品の出品先を切り替えられます
- アクティブ化: 同時にアクティブにできるのは 1 アカウントのみ。出品はアクティブなアカウントから行われます
- 編集 / 複製 / 削除: アカウント名、Policy ID、Location（発送元）を変更可能
4. メルカリ監視
メルカリの出品者プロフィール URL を登録すると、新着商品を自動取り込みできます。 仕入れ元として継続的に監視したいセラーをここで管理します。
- 登録: 「+ 追加」からプロフィール URL と表示名を入力
- 有効 / 無効: 監視を一時停止したい場合は無効化
- 状態: 「有効」「実行中」「エラー」「無効」のステータス表示
- 今すぐクロール: 即時にチェックを実行（通常はバックグラウンドで定期実行）
5. 説明文テンプレート
eBay 商品ページの説明文（HTML）を、テンプレートとして保存・使い回しできます。
- デフォルト説明文: テンプレート未選択時に使われる HTML
- テンプレート管理: 用途別（高級品向け、安価商品向け等）にテンプレートを複数管理
- 変数:
{{title}},{{condition_en}},{{price_usd}}など商品データを差し込み可能 - 優先順位: 個別テンプレート → アクティブテンプレート → デフォルト説明文 → 空白
6. eBay商品インポート
既に eBay に出品済みの商品を TSUNAGURO に取り込みます。過去 90 日分の販売データも自動でバックフィルされます。
- 処理状態: 待機中 / 実行中 / 完了 / 失敗 を進捗バーで表示
- 結果サマリ: 新規・更新・スキップ・エラーの件数
- エラー: 取り込みに失敗した商品は理由付きでリスト表示
7. APIトークン
外部ツールから TSUNAGURO API にアクセスする際の Personal Access Token (PAT) を発行・管理します。 オーナー / 管理者ロールのみが操作できます。
- スコープ: 読み取り専用 / 読み書き / フルアクセス / Chrome 拡張用
- 有効期限: 90 日 or 180 日（Chrome 拡張用）
- Chrome 拡張用: 「Mercari Linker 用トークンを発行」ボタンで 180 日有効のトークンを 1 クリックで作成
- 失効: 不要になったトークンは「無効化」で即時失効。発行済みトークンは 1 度しか表示されないため、紛失したら再発行が必要
出品前のおすすめ設定順
- プロフィール: メール認証が完了しているか確認
- eBayアカウント: OAuth 接続と Business Policy 紐付け
- 基本設定: 利益率・手数料率・関税率・配送料を業態に合わせて調整
- 基本設定: AI プロンプトで自分の商材ジャンルに合わせたタイトル・Item Specifics ルールを記述
- 説明文テンプレート: デフォルト説明文を整える
- メルカリ監視: 仕入れ元を登録
- （必要に応じて）APIトークン: Chrome 拡張用の PAT を発行