l-add-mercari-item

Create Mercari shop product listing from existing product data and MDX content. Use when: (1) User wants to create a Mercari listing, (2) User says 'add mercari item' or 'mercari listing'. Transforms ...

Add Mercari Item

Create a new Mercari shop listing with AI assistance. Follow the Mercari text style rules at: https://takazudomodular.com/doc/docs/writing/mercari-text-style-rule

Workflow

1. Ask for product slug (must exist in src/data/product-master-data.mjs)
2. Find and read the product’s MDX file
3. Transform content to Mercari format
4. Verify mercari.png images exist
5. Generate draft JSON entry
6. Add to sub-packages/mercari-viewer/draft.json
7. Guide testing in mercari-viewer

Content Transformation

Mercari Text Structure

{Opening paragraph - 1-2 sentences}

こちらはTakazudo Modularが{メーカー名}より正規のディーラーとして販売を許可された商品です。
※Takazudo Modularブランド商品の場合は除外

## {Product Name}とは
{Description}

## 主な特徴
{Features}

## 仕様
- 素材: {Material}
- 幅: {Width}

## 付属品
- ...

## {Brand Name}について
{Brand description - only if <Brand{Name} /> component in MDX}
{Brand website URL}

## マニュアル
{ONLY if the product has a JP translated manual on the website}
Takazudo Modularではマニュアルに日本語を添えて公開しています。以下を商品理解の一助として頂ければと。
https://takazudomodular.com/manuals/{manual-slug}/
{Note: Almost all products have JP manuals. Check the product intro MDX for ProductDetailManualNav component or the manuals page.}

## 製品の保証について
{ONLY if explicitly described on the product intro page. Do NOT add by default.}
{Each vendor has different warranty terms. Check the MDX page for warranty info.}
{Examples: 4ms=1年, ADDAC=2年, OXI=2年. Weston does NOT have this section.}

## オマケ: 電氣美術研究會セット付き
{Only if <Denbi /> component in MDX}

---
{Website link}
---
#モジュラーシンセ #モジュラーシンセサイザー #modularsynthesizer

Section Order

1. Product description/features -> 2. Specs -> 3. Included items -> 4. Reference videos (if available) -> 5. Manual (if JP manual exists) -> 6. Brand (if applicable) -> 7. Warranty (ONLY if on product page) -> 8. Denbi bonus (if applicable) -> 9. Website link -> 10. Hashtags

Text Style Rules

• \n for line breaks in JSON
• - for bullet lists
• Half-width numbers only
• Japanese punctuation (、。)
• Keep English technical terms as-is
• ## headers (NOT ■ symbols)

Image Verification

Check these exist:

• /static/images/p/{slug}/mercari.png (required)
• /static/images/p/{slug}-view{N}/mercari.png (optional additional views)

Images must use full https://takazudomodular.com/images/p/{slug}/mercari.png URLs.

Denbi bonus image (paired with the Denbi text section)

When the product MDX contains <Denbi /> — i.e. the draft body includes the ## オマケ: 電氣美術研究會セット付き section — always append https://takazudomodular.com/images/p/denbi-cables/mercari.png as the FINAL entry in the images array. This is the photo of the actual モジュラー小物セット that ships with the product, and it must appear together with the Denbi text so buyers can see what they get.

Pairing rule: Denbi text ⇔ Denbi image. If one is present, the other must be too. If the product does not bundle the Denbi set (no <Denbi /> in MDX), omit both.

Note: static/images/p/denbi/ is the brand logo used by the website’s <Denbi /> component — do NOT use it for Mercari. Use denbi-cables/ (the physical-set photo).

Draft JSON Entry

{
  "id": "{slug}-draft-001",
  "product_id": "{slug}",
  "商品名": "Brand: Product Name",
  "商品説明": "Description with \\n",
  "name": "Brand: Product Name",
  "description": "Same as 商品説明",
  "price": "7980",
  "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"
}

Default Category

BBVpNT3pj4eHYBFujNsxJk (モジュラーシンセサイザー)

Other Categories

Shipping Defaults

shippingMethod: "3" (らくらくメルカリ便), shippingOrigin: "jp11" (埼玉県), shippingDuration: "2" (2-3日), shippingPayer: "1" (送料込み)

Testing

Start mercari viewer: pnpm mercari:dev -> Visit http://zmercari.localhost:23234 -> Navigate to Drafts page -> Verify listing.