How to Add Mercari Item

手順の概要

商品ページが product-master-data.mjs とMDXに存在することを確認する
画像が処理済みで mercari.png が生成されていることを確認する
/l-add-mercari-item コマンドを実行し、対話形式でMercari出品データを作成する
mercari-viewer でドラフトを確認する
必要に応じて編集し、Mercari Shopsにアップロードする

詳細な手順やテンプレートは /l-add-mercari-item スキルに記載されています。Claude Codeで /l-add-mercari-item を実行すると、対話形式でMercari出品データの作成を進めることができます。

商品説明文のスタイルルールについては Mercari Product Detail Text Writing Rules を参照してください。

`/l-add-mercari-item` が行うこと

product master data から商品を特定
MDXファイルから商品情報を抽出
Mercari向けフォーマットに変換（最大5000文字）
mercari.png 画像の存在チェック
sub-packages/mercari-viewer/draft.json にドラフトJSONを生成

前提条件

商品が登録済み: src/data/product-master-data.mjs にエントリがあること
MDXファイルが存在: src/mdx/products/{slug}-intro.mdx
画像が処理済み: /static/images/p/{slug}/mercari.png が存在すること

# 画像が未処理の場合
pnpm convimgs:upload

カテゴリ

デフォルトカテゴリ（モジュラーシンセサイザー）

特に指定がない限り、以下を使用する:

Category ID: BBVpNT3pj4eHYBFujNsxJk
フルパス: ホビー・楽器・アート > 楽器・機材 > 鍵盤楽器 > シンセサイザー > モジュラーシンセサイザー

その他のカテゴリ

カテゴリパス	Category ID
鍵盤楽器 > シンセサイザー > モジュラーシンセサイザー	`BBVpNT3pj4eHYBFujNsxJk` DEFAULT
DTM・DAW > ハードウェア音源	`BbjaCJKXUJFPBGaEL4pvwh`
DTM・DAW > その他	`q3ZvPK6zuKSHXVYCbKVzfH`
DTM・DAW > コントローラー・フェーダー	`4mYFwqimF5qDPdRV73A6QQ`

カテゴリIDの検索:

cat mercari-data/category/category-master.csv | grep "DTM"

画像パス

画像は フルURL で指定する（相対パス不可）。

"images": ["https://takazudomodular.com/images/p/{slug}/mercari.png"]

複数ビューがある場合:

"images": [
  "https://takazudomodular.com/images/p/product-view1/mercari.png",
  "https://takazudomodular.com/images/p/product-view2/mercari.png"
]

画像の存在確認:

ls static/images/p/{slug}*/mercari.png

Draft JSON の構造

{
  "id": "{slug}-draft-001",
  "product_id": "{slug}",
  "商品名": "Brand: Product Name",
  "商品説明": "Description with \\n for line breaks",
  "name": "Brand: Product Name",
  "description": "Same as 商品説明",
  "price": "1480",
  "category": "BBVpNT3pj4eHYBFujNsxJk",
  "categoryId": "BBVpNT3pj4eHYBFujNsxJk",
  "itemCondition": "1",
  "productCondition": "1",
  "productStatus": "2",
  "shippingMethod": "3",
  "shippingOrigin": "jp11",
  "shippingDuration": "2",
  "shippingPayer": "1",
  "images": ["https://takazudomodular.com/images/p/{slug}/mercari.png"],
  "skus": [{"variant": "", "stock": "1", "managementCode": "", "janCode": ""}],
  "stock": "1",
  "更新日時": "YYYY-MM-DD"
}

デフォルト値

フィールド	値	説明
shippingMethod	”3”	らくらくメルカリ便
shippingOrigin	”jp11”	埼玉県
shippingDuration	”2”	2-3日で発送
shippingPayer	”1”	送料込み（出品者負担）
itemCondition	”1”	新品、未使用
productStatus	”2”	下書き（非公開）

ドラフトの確認

# mercari-viewer を起動
pnpm mercari:dev

# http://zmercari.localhost:23234 にアクセス
# "Drafts" ページでドラフトを確認

よくある問題

問題	原因	対処
カテゴリが空白	無効なカテゴリID	category-master.csv から正しいIDを使用
画像が表示されない	相対パスを使用	`https://` のフルURLを使用
説明文が長すぎる	5000文字超過	内容を短縮
ドラフトが保存されない	必須フィールド不足	product_id, name, price, category を確認

スキルの場所

スキル定義ファイル: .claude/skills/l-add-mercari-item/SKILL.md

How to Add Mercari Item

How to Add Mercari Item

手順の概要

/l-add-mercari-item が行うこと

前提条件

カテゴリ

デフォルトカテゴリ（モジュラーシンセサイザー）

その他のカテゴリ

画像パス

Draft JSON の構造

デフォルト値

ドラフトの確認

よくある問題

関連ドキュメント

スキルの場所

`/l-add-mercari-item` が行うこと