投稿者 投稿日: カテゴリー EC×AI活用
このスキルは、EC用CSVの文字化けをアップロード前に自動検出するツールです。
楽天RMSに商品CSVをアップロードしたら、商品名の「①」や「髙」が「?」に化けていた。よくある事故です。原因の多くは、Excelで開いて保存した瞬間の文字コード変換にあります。本記事は、EC支援19年・5,000社超の実績を持ち、AI導入支援は2023年から提供する株式会社オルセル（うるチカラ運営）が、この事故をアップロード前に止めるスキルを解説します。CSV文字コードの検証は、ALSEL Agent Skillsで配布するスキルの1つをClaude Code上で動かすと、8モール分の要件チェックが数十秒で終わります。
このスキルでできること
このスキルは、ECモール向けCSVが各モールの要求する文字コードと形式に適合しているかを、アップロード前に検証します。楽天RMSはShift_JIS（CP932）とCRLF改行、AmazonはUTF-8のタブ区切り、Yahoo!ショッピングはUTF-8とCRLF、Shopifyはbom付きUTF-8とLF改行、というように、モールごとに要件が異なります。ネクストエンジン、クロスモール、BASE、makeshopを加えた8つのフォーマットに対応し、まず「どのモール向けか」を確定してから検証します。
検出できる不備は主に4種類です。1つ目は文字コードと改行コードの不一致です。2つ目は、Shift_JISでエンコードすると「?」や「・」に化けるShift_JIS範囲外文字の混入で、丸数字の①〜⑳、㈱、㍑、絵文字、はしごだかの「髙」、たちさきの「﨑」、全角チルダと波ダッシュの混在などが該当します。3つ目はExcel保存時の破壊で、JANコードの指数表記化（4901234567894が4.901234567894E+12になる現象）、先頭0の消失、型番のハイフンが日付に変わる自動変換を拾います。4つ目は、カンマや改行を含む値のダブルクォート囲みが崩れているケースです。該当する行・列・文字を具体的に出力するため、どこを直せばよいかがすぐ分かります。
実際の使い方
使い方は、チェックしたいCSVファイルを渡し、対象モールを伝えるだけです。「この楽天用CSVがShift_JISで文字化けしないか確認して」「Amazon用のタブ区切りUTF-8になっているかチェックして」といった依頼で起動します。
内部の処理は5ステップで進みます。第1にファイル冒頭のバイト列を検査してBOMの有無と改行コードを判定し、第2にヘッダー行の文字パターンから実際のエンコードを推定します。第3にユーザー指定のモール要件と実ファイルを照合し、文字コード・改行・区切り文字・BOM要件の一致を確認します。第4に範囲外文字の禁止リストで全行をスキャンし、Shift_JISで化ける文字を検出します。第5にExcel破壊のパターン（指数表記、日付シリアル値、桁数異常）を検査します。
出力は、該当箇所を列挙した検証レポートです。たとえば「3行目の商品名にShift_JIS範囲外文字『髙』を検出」「JAN列12行目が指数表記化」というように、修正対象を行番号つきで示します。食品ギフトやアパレルのように商品点数が数千行に及ぶ店舗でも、目視では見落とす1文字を機械的に拾えるのが利点です。編集そのものはExcelを避け、テキストエディタやGoogleスプレッドシート経由で行うのが安全という原則もあわせて確認できます。モール間で列の並びが違う場合の変換は、別スキルのモール間CSV列マッピングと組み合わせると、移行作業がさらに速くなります。
導入による業務インパクト
このスキルの効果は、アップロード後の再修正という手戻りをなくす点にあります。文字化けCSVを一度アップロードしてしまうと、商品ページの修正、再アップロード、反映待ちで、1回あたり数十分から数時間を失うことがあります。数千行のCSVを目視で確認する作業も、集中力に依存し、見落としが起きます。
アップロード前に数十秒で検証を挟むだけで、この手戻りを事前に防げます。特に月に何度も一括更新を回す店舗ほど、削減できる工数は積み上がります。ただし限界もあります。文字コードや形式の不備は検出できますが、商品名のSEO的な良し悪しや価格の妥当性までは判断しません。あくまで「機械的に判定できる形式不備」の検出に用途を絞るのが、失敗しない使い方です。
まとめ
このスキルは、楽天・Amazon・Yahoo!ショッピングなど複数モールを1つのCSV運用で回している店舗、そしてExcelでCSVを編集している店舗に向いています。一歩目としては、直近でアップロードに失敗した1本のCSVを渡し、どの文字がどのモールで化けるかを確認してみてください。文字コードの事故は、原因さえ分かれば再発を防げます。
参考文献
※うるチカラでは、生成AIの導入支援から運用最適化まで、貴社のEC事業に合わせたカスタマイズ提案を行っています。無料相談（30分）も実施中ですので、お気軽にお問い合わせください。
https://uruchikara.jp/contact/
【監修】齋藤竹紘（株式会社オルセル代表 / 19年・5,000社のEC支援実績）
株式会社オルセル代表取締役 / うるチカラ編集長。19年・5,000社以上のEC支援実績を持ち、楽天市場・Amazon・Yahoo!ショッピング・Shopify・Shopee越境ECの実装ノウハウを保有。AI×ECに関する書籍を3冊執筆。「現場で使えるAI実装」を一次情報として発信しています。
この記事を読んだ人は、こんな記事も読んでいます
