投稿者 投稿日: カテゴリー EC×AI活用
MakeShop商品CSVの登録エラーは、文字コード・エスケープ・goods_idの3点を機械的に潰せば10分で切り分けられます。
MakeShop（メイクショップ）で商品データCSVをアップロードしたのに「登録できませんでした」とだけ返され、どの行が悪いのか分からないまま数時間溶かした経験はないでしょうか。500商品を一括更新するつもりが、結局1件ずつ管理画面で直すことになった、という話は珍しくありません。ALSEL が公開している MakeShop 商品CSV 検証スキルを使うと、この切り分けが10分程度で終わります。本記事は、EC支援19年・5,000社超の支援実績を持ち、AI導入支援を2023年から提供する株式会社オルセル（うるチカラ運営）が解説します。
MakeShop商品CSV検証スキルとは、エラー原因を機械的に特定する仕組みのことです
MakeShop商品CSV検証スキルとは、商品データCSV・オプションデータCSV・在庫数CSVを読み込ませると、アップロード失敗の原因を特定して修復コマンドまで提示するスキルのことです。ALSEL Agent Skills から配布されており、Claude Code 上で動作します。
このスキルが前提としている考え方は明快です。アップロード失敗の大半は、文字コードとBOM（ファイル先頭に付く不可視の識別バイト）と改行コードの不一致、ダブルクォートのエスケープ漏れ、goods_id の不一致という3種類に集約されます。そこでスキルはまず物理構造を判定し、そのあとで意味的な検証に進みます。
具体的に扱う範囲は、商品データCSVの必須列と列順序、オプションデータCSVの2階層モデル（オプション項目とオプション値）とアップロード順序、在庫数CSVの上書きと差分の運用、そして MakeShop 独自のフリースペース1から10へのHTML差し込みです。フリースペースは商品ページのテンプレート側に擬似タグで差し込まれる仕組みのため、CSV側のHTMLが壊れると商品ページのレイアウトごと崩れます。この破損パターンも検証対象に入っています。
実際の使い方：CSVを渡して「MakeShop CSVが上がらない」と伝えるだけ
使い方は、対象のCSVファイルを渡して「MakeShop CSVが上がらない」「フリースペースが反映されない」「列がずれる」などと伝えるだけです。スキルは次の順序で処理を進めます。
第1段階は、どのCSVかの特定です。ヘッダ行を見て商品データCSVかオプションデータCSVか在庫数CSVかを判定します。第2段階は物理構造の判定で、文字コードの判定、先頭3バイトによるBOM有無の確認、行数の確認、そして各行の列数が揃っているかの確認を行います。列数が揃っていない行が出た時点で、エスケープ漏れが強く疑われます。
第3段階は変換です。UTF-8のBOMあり・なし、Shift_JIS（CP932）、改行コードのCRLFとLFの相互変換について、実行できる形のコマンドが提示されます。変換後は再判定し、10件程度の少数行でテストアップロードして確かめる流れです。第4段階はCSVエスケープの検証で、値の内部にあるダブルクォートが二重化されているか、カンマや改行を含む値が正しく囲まれているかを見ます。HTMLタグをフリースペース列に入れる運用では、ここが最頻出の事故ポイントです。
第5段階は goods_id の検証です。空欄がないか、半角英数字と記号のみか、重複がないか、大文字小文字の揺れがないかを確認します。第6段階では商品名の欠落、商品分類が管理画面の既存カテゴリと一致しているか、販売価格に「円」やカンマが混入していないか、JANコードの先頭0が落ちていないかといった意味的な検証に進みます。オプションデータCSVがある場合は第7段階で、goods_id が商品データCSVと完全一致しているか、商品データCSVを先にアップロードする順序が守られているかを点検します。
なお、列名や上限値といった仕様はプランや時期で変わるため、スキル自体も MakeShop の管理画面と公式ヘルプで最新値を確認するよう促す作りになっています。ここは自動化に丸投げせず、必ず一次情報を見てください。
導入による業務インパクト：切り分け時間が数時間から10分程度へ
このスキルの効果が最も大きいのは、原因不明のまま試行錯誤していた時間です。1回のアップロードにつき、エラー行の目視確認、Excelで開き直して保存、再アップロードという往復を3回繰り返せば、それだけで1時間から2時間が消えます。物理構造の判定を先にやるだけで、この往復自体が不要になります。月2回のCSV更新をしている店舗なら、月あたり2時間から4時間の削減が見込める計算です（実際の削減幅は商品点数と運用体制によって変わるため、自社での計測を推奨します）。
もう1つの効果は、事故の予防です。CSVをExcelで開いて保存すると、Shift_JIS化、JANコード先頭0の消失、改行コードの変換、BOMの付与といった事故が同時に起きます。スキルはこの運用そのものを止めるよう案内するので、テキストエディタで文字コードと改行コードを常時表示する運用に切り替える契機になります。文字化けの一般的な対処については、うるチカラのECのCSV文字化けを直すスキルの解説記事もあわせてご覧ください。モール間で商品データを移す場面ではモール間CSVマッピングのスキル解説が近い役割を担います。
限界も正直に書いておきます。このスキルはCSVの構造と整合性を検証するものであり、商品名やキャッチコピーの中身の良し悪しは判定しません。また MakeShop 側の仕様変更を自動追従するわけではないので、列名が認識されないエラーが出たときは管理画面のCSVガイドを確認する必要があります。
まとめ
MakeShop で商品CSVのアップロード失敗を繰り返している店舗、フリースペースにHTMLを流し込んで商品ページを組んでいる店舗、オプションデータCSVで「該当商品なし」エラーが出ている店舗には、このスキルが向いています。一歩目は、直近で失敗したCSVを1本用意して、そのままスキルに渡してみることです。原因が3分類のどれに当たるかが分かれば、次回以降の更新は同じ手順で通せるようになります。
参考文献
※うるチカラでは、生成AIの導入支援から運用最適化まで、貴社のEC事業に合わせたカスタマイズ提案を行っています。無料相談（30分）も実施中ですので、お気軽にお問い合わせください。
https://uruchikara.jp/contact/
【監修】齋藤竹紘（株式会社オルセル代表 / 19年・5,000社のEC支援実績）
株式会社オルセル代表取締役 / うるチカラ編集長。19年・5,000社以上のEC支援実績を持ち、楽天市場・Amazon・Yahoo!ショッピング・Shopify・Shopee越境ECの実装ノウハウを保有。AI×ECに関する書籍を3冊執筆。「現場で使えるAI実装」を一次情報として発信しています。
この記事を読んだ人は、こんな記事も読んでいます
