Mercari Product Detail Text Writing Rules

このドキュメントは、Takazudo ModularのMercari Shops商品説明文を作成する際のスタイルガイドです。統一感のある、読みやすく、商品の魅力が伝わる説明文を書くための指針を提供します。

概要と目的

本スタイルガイドの目的：

商品説明文の品質と一貫性の確保
3000文字制限内での効果的な情報伝達
詳細な商品紹介記事をMercari向けに要約する際の基準提供
モジュラーシンセサイザーの専門性と親しみやすさのバランス

文字数制限

基本制限

上限：3000文字（Mercariの仕様）
推奨文字数：2000〜2800文字（できる限り詳細な説明を記載）

:::warning 重要既存の短いテキスト（700〜1000文字程度）は、執筆時間の都合で簡略化されたものです。新規作成時は可能な限り詳細な説明を心がけ、2000〜2800文字を目標としてください。3000文字の制限内で、できるだけ多くの有益な情報を含めることが望ましいです。 :::

文字数の目安

標準目標：2000〜2800文字
最低限の場合でも1500文字以上を推奨
複雑な機能を持つモジュール：2800文字（上限に近い詳細な説明）

文書構造

基本構造パターン

パターン1: 標準的なモジュール

[製品名]は、[簡潔な機能説明]です。

こちらはTakazudo Modularが[メーカー名]より正規のディーラーとして販売を許可された商品です。
※注：Takazudo Modularブランドのオリジナル商品の場合は、このディーラー表記は含めません

## [製品名]とは

[詳細な機能説明]

## 主な特徴／使いどころ

[箇条書きまたは番号付きリストで特徴を列挙]

## 参考動画

[YouTube動画のタイトルとURL]

## 技術仕様

- 幅: XXhp
- 深さ: XXmm
- 消費電力: +12V XXmA／-12V XXmA

## 付属品

[付属品のリスト]

## マニュアル

Takazudo Modularではマニュアルに日本語を添えて公開しています。以下を商品理解の一助として頂ければと。

[マニュアルのURL]

## [メーカー名]について

[メーカーの簡単な紹介]

## オマケ: 電氣美術研究會セット付き

[オマケの説明]

---

この商品説明は、以下当店Webサイトの簡略版です。
併せてご確認頂けると幸いです。

[商品詳細ページのタイトルとURL]

---

#モジュラーシンセ #モジュラーシンセサイザー
#modularsynthesizer

パターン2: シンプルな商品（zudo-blockなど）

[製品名]、[バリエーション名]です。
詳細は以下をご参照ください。

Takazudo Modular: [製品名]
[URL]

パターン3: バリエーション商品（zudo-railなど）

[製品名]は、[簡潔な機能説明]です。

この商品には多数のバリエーションがあります。
本商品は以下の購入用ページです。

★★★★★★★★★★★★★★★★★★★
[具体的なバリエーション名と仕様]
★★★★★★★★★★★★★★★★★★★

以下[製品名]の商品説明をよくお読み頂いた上でご購入くださいますようお願い申し上げます。

[商品詳細ページURL]

## 主な特徴

[特徴のリスト]

## 用途

[用途の説明]

[価格帯や選択肢の説明]

セクションの使い方

必須セクション

製品概要（冒頭1〜2文）
正規販売の明記（ディーラー商品の場合のみ。Takazudo Modularブランドのオリジナル商品には不要）
Webサイトリンク（末尾）
ハッシュタグ（最下部）

:::info ディーラー表記について「こちらはTakazudo Modularが[メーカー名]より正規のディーラーとして販売を許可された商品です。」という文言は、他社製品を販売する場合のみ使用してください。

使用する場合：ADDAC System、AI Synthesis、Meng Qiなど他メーカーの製品
使用しない場合：zudo-rail、zudo-block、zudo-busなどTakazudo Modularブランドのオリジナル商品 :::

条件付き必須セクション

技術仕様：モジュールの場合は必須
付属品：付属品がある場合は必須
参考動画：YouTube動画がある場合は推奨
マニュアル：翻訳マニュアルがある場合は必須（下記参照）
メーカー紹介：外部メーカー製品の場合は必須

オプションセクション

使いどころ：機能が複雑な場合に追加
注意事項：特別な注意が必要な場合
DIYガイド：DIYキットの場合
その他：個人的な感想など（控えめに）

ヘッディングルール

使用可能な見出しレベル

##（h2）のみを使用
h3（###）以下は使用しない
番号付きの小見出しは本文内で処理

見出しの標準パターン

## [製品名]とは
## 主な特徴
## 使いどころ
## 参考動画
## 技術仕様
## 付属品
## マニュアル
## [メーカー名]について
## 製品の保証について
## オマケ: 電氣美術研究會セット付き
## その他
## DIYガイド
## 注意事項

文体と表現

基本的な文体

敬語使用：「です・ます」調を基本とする
専門用語：適度に使用し、必要に応じて簡単な説明を加える
読みやすさ：1文は60文字以内を目安に
段落：3〜4文で改行し、読みやすさを確保

説明の順序

概要から詳細へ：まず全体像、次に具体的な機能
重要な情報を先に：価格、仕様、注意事項は早めに
技術詳細は後半に：初心者にも配慮した構成

表現の例

:::danger 重要な注意事項以下の例は、スタイルを理解するための参考例です。実際の商品説明文を作成する際は：

既存のオリジナルテキストを必ず参照してください（sub-packages/zmdpreview/docs/products/ ディレクトリ）
虚偽の情報や創作した内容を追加しないでください
オリジナルテキストの内容を忠実に要約・整理してください
製品の事実に基づいた情報のみを記載してください

例として示されている文章をそのままコピーして使用しないでください。 :::

良い例

ADDAC112は、多様なパラメーターをCVコントロール可能なLooper（ルーパー）＆Granular Processor（グラニュラープロセッサー）です。

避けるべき例

ADDAC112はLooper/Granular Processorです。（説明不足）

技術情報の記載方法

仕様の記載フォーマット

## 技術仕様

- 幅: 32HP
- 深さ: 45mm
- 消費電力: 240mA +12V／70mA -12V

機能説明の構造

基本機能の説明
特徴的な機能の詳述
使用例や応用方法
他製品との比較（必要に応じて）

リンクと参照

YouTube動画の記載

## 参考動画

以下は、[メーカー名]公式の[製品名]のデモ動画です。

[動画タイトル]
https://youtu.be/[動画ID]

Webサイトリンクの記載

---

この商品説明は、以下当店Webサイトの簡略版です。
併せてご確認頂けると幸いです。

[記事タイトル]
https://takazudomodular.com/notes/[記事URL]

---

ハッシュタグ規則

標準ハッシュタグセット

#モジュラーシンセ #モジュラーシンセサイザー
#modularsynthesizer
モジュラーシンセ
modularsynthesizer
modular synthesizer
モジュラーシンセサイザー

ハッシュタグの配置

文書の最下部に配置
区切り線（---）の後に記載
日本語と英語を併記

特殊な記載事項

バリエーション商品の強調

★★★★★★★★★★★★★★★★★★★
[バリエーション名と仕様]
★★★★★★★★★★★★★★★★★★★

注意事項の記載

★★本商品は、[注意内容]。ご注意ください。★★

DIYキットの場合

★こちらは[色]パネル版DIYキットです★

本DIYキットは部品数が少なく、短時間で組み立てを完了できるため、モジュラーシンセDIYを始める最初のモジュールとして最適です。

マニュアルリンクの記載

:::caution 条件付きセクションこのセクションは、該当製品の翻訳マニュアルが公開されている場合のみ記載してください。マニュアルの有無は src/data/product-manual-mapping.mjs で確認できます。 :::

標準テンプレート

## マニュアル

Takazudo Modularではマニュアルに日本語を添えて公開しています。以下を商品理解の一助として頂ければと。

[マニュアルのURL（1行に1つずつ）]

具体例：OXI E16の場合

## マニュアル

Takazudo Modularではマニュアルに日本語を添えて公開しています。以下を商品理解の一助として頂ければと。

https://takazudomodular.com/manuals/oxi-e16-manual/
https://takazudomodular.com/manuals/oxi-e16-quick-start/

マニュアルURLの確認方法

マニュアルのURLは src/data/product-manual-mapping.mjs の productSlug フィールドを参照して特定できます。URLの形式は以下の通りです：

https://takazudomodular.com/manuals/[manual-id]/

電氣美術研究會セットの記載

:::caution 条件付きセクションこのセクションは、商品のMDXファイルに <Denbi /> コンポーネントが含まれている場合のみ記載してください。すべての商品に含めるわけではありません。 :::

標準テンプレート

## オマケ: 電氣美術研究會セット付き

モジュラーシンセをもっと多くの方に触って欲しいという願いの元、電氣美術研究會さまにご協力頂き、モジュラー小物セットを本商品にバンドルさせて販売させていただいております。パッチケーブルや電源ケーブル、ドレスナットのサンプルセット、モノラルスプリッターなど、内容は時期に応じて変化します。商品に同梱しますので是非お試し下さい！

:::caution 商品画像とのセット運用このオマケテキストを記載する商品は、商品画像リストの最後に https://takazudomodular.com/images/p/denbi-cables/mercari.png を必ず追加してください。テキストと画像はワンセットで運用します（テキストだけ／画像だけ、はNG）。denbi-cables/ がモジュラー小物セットの現物写真です（denbi/ はWebサイトの <Denbi /> コンポーネントが使うロゴ画像なので、Mercariには使いません）。 :::

文章の簡略化テクニック

長い説明を短くする方法

箇条書きの活用：長い説明を箇条書きに変換
専門用語の省略：基本的な用語は説明を省略
参照リンクの活用：詳細はWebサイトに誘導
例の削減：使用例は1〜2個に絞る

省略可能な要素

メーカーの詳細な歴史
技術的な実装の詳細
全ての使用例
個人的な感想（最小限に）

品質チェックリスト

商品説明文を作成後、以下の項目を確認：

よくあるパターンと例

パターン1: 複雑な機能を持つモジュール

ADDAC112のような複雑なモジュールの場合：

基本機能と応用機能を分けて説明
参考動画を複数掲載
「ソフトな」アプローチなど、メーカーの哲学を引用
文字数制限により省略した旨を明記

パターン2: シンプルなユーティリティモジュール

DSVやVU Level Meterのような単機能モジュール：

具体的な使用例を2〜3個提示
なぜこのモジュールが便利なのかを説明
個人的な使用感を適度に含める

パターン3: DIYキット

AI Synthesisのキットなど：

DIY初心者向けであることを強調
ビルドガイドへのリンクを必須で含める
組み立て難易度を明記
必要な工具について言及（はんだごてなど）

パターン4: オリジナル商品

zudo-railやzudo-blockなど：

バリエーションを明確に区別
価格帯を明記
他製品との互換性を説明
用途と拡張性を強調

まとめ

このスタイルガイドは、Mercari商品説明文の品質と一貫性を保つための基準です。3000文字という制限の中で、商品の魅力を最大限に伝え、かつ技術的な正確性を保つバランスが重要です。

商品の特性に応じて適切なパターンを選択し、必要な情報を過不足なく含めることで、購入者にとって有益な商品説明文を作成することができます。