Impor Masal CSV ​
Selamat datang di panduan Impor Masal CSV! Di dalam perjalanan membangun website ulasan dan rekomendasi belanja, ada saatnya Anda ingin melangkah lebih jauh dari sekadar mengelola beberapa produk pilihan. Ketika Anda ingin mengelola puluhan hingga ratusan produk rekomendasi (20–500 SKU) sekaligus, memasukkan produk satu per satu lewat perintah terminal tentu menyita banyak waktu.
Di sinilah alur Impor Masal CSV & Utilitas bekerja untuk Anda. CuanAff dirancang dengan kemampuan pemrosesan borongan berkecepatan tinggi:
- Impor Masal via Spreadsheet Excel / CSV: Masukkan 50 hingga 500 produk sekaligus dari lembar kerja Microsoft Excel atau Google Sheets dalam waktu kurang dari 5 detik.
- Toleransi Delimiter Regional Cerdas: Sistem otomatis mengenali tanda pemisah kolom standar internasional (koma
,) maupun format regional Windows Indonesia (titik-koma;). - Pembersihan Harga Otomatis: Memahami format harga pasar sehari-hari seperti
150rb,150k,1.5 jt, maupunRp 3.850.000tanpa perlu Anda ubah manual. - Asisten Peluncur Interaktif (
jalankan.bat&jalankan.sh): Antarmuka berbasis menu angka ramah pemula yang dapat dijalankan tanpa perlu mengetik atau menghafal perintah terminal. - Utilitas Sistem & Brankas Kredensial: Diagnostik kesiapan laptop, pemantauan status katalog, serta penyimpanan token Cloudflare yang aman tanpa risiko bocor ke publik.
Semua alur disusun dengan prinsip Progressive Disclosure: Anda cukup membaca panduan kilat 3 langkah di awal untuk langsung mengimpor data hari ini, lalu pelajari spesifikasi kolom, asisten peluncur, template AI, dan kamus opsi teknis lengkap di bagian bawah saat dibutuhkan.
Aman Diulang & Dilengkapi Mode Simulasi
Seluruh proses impor masal CuanAff dilengkapi opsi simulasi aman (--dry-run). Anda dapat memeriksa berapa banyak produk yang valid dan mendeteksi kesalahan penulisan tanpa mengubah atau menimpa berkas katalog yang sudah ada.
1. Panduan Kilat 3 Langkah Skalabilitas Borongan ​
Bagi Anda yang ingin langsung memasukkan puluhan produk dari lembar kerja spreadsheet, berikut adalah 3 langkah emas mengoperasikan impor masal CuanAff:
📥 Unduh Sampel Berkas CSV Siap Pakai
Dapatkan berkas template resmi yang sudah terisi 5 produk nyata (koper & tas travel):
👉 📥 Unduh Sampel contoh-produk.csv (Klik untuk mengunduh template)
Pratinjau Cuplikan Data Riil Template CSV ​
Berikut adalah cuplikan data nyata dari berkas contoh-produk.csv:
| Nama Produk | Brand | Kategori | Harga | Link Afiliasi (Deeplink) | Gambar URL | Rating |
|---|---|---|---|---|---|---|
Lojel Cubo Small Carry-on 21" | Lojel | koper-kabin | Rp 3.850.000 | https://atid.me/002bc7001bpn?url=... | https://images.shopee.co.id/... | 4.9 |
American Tourister Curio Spinner 55 | American Tourister | koper-kabin | Rp 2.190.000 | https://invl.me/clo2x25?url=... | https://images.shopee.co.id/... | 4.8 |
Baller Polycarbonate Front Pocket 20 | Baller | koper-kabin | Rp 3.499.000 | https://gettracker.net/dpl/... | https://images.shopee.co.id/... | 4.9 |
Thule Subterra Carry-on 36L | Thule | koper-kabin | Rp 4.750.000 | https://atid.me/002bc7001bpn?url=... | https://images.shopee.co.id/... | 4.9 |
Tas Travel Duffle Canvas Oxford | Tanpa Merek | weekender-bag | Rp 150rb | https://invl.me/clo2x1x?url=... | https://images.shopee.co.id/... | 4.7 |
Alur 3 Langkah Emas Skalabilitas Borongan
- Langkah 1: Siapkan Spreadsheet → Unduh template contoh-produk.csv atau isi data produk di Excel / Google Sheets, lalu simpan sebagai berkas
.csv. - Langkah 2: Impor Sekali Jalan → Jalankan
php cuanaff product:import-csv tas contoh-produk.csv(pemisah otomatis & sanitasi harga). - Langkah 3: Tayangkan Online ($0) → Tambahkan opsi
--publishuntuk merakit dan mendeploy langsung ke internet!
Langkah 1: Siapkan Lembar Kerja Spreadsheet (CSV) ​
Buka Microsoft Excel, Google Sheets, atau unduh template contoh-produk.csv. Masukkan daftar produk riset Anda dengan header kolom baku:
csv
nama_produk,brand,kategori,harga,aff_link,gambar_url,ratingSetelah selesai, simpan berkas tersebut dengan format CSV (Comma delimited) (*.csv).
Langkah 2: Impor Borongan ke Katalog Situs (1-Baris Langsung Coba) ​
Buka terminal laptop Anda, lalu jalankan perintah impor borongan dengan menyebutkan nama situs dan lokasi berkas CSV:
bash
# Coba langsung menggunakan berkas template bawaan
php cuanaff product:import-csv tas contoh-produk.csvSistem akan membaca seluruh baris, membersihkan format harga, mendaftarkan kategori secara otomatis, dan menyimpannya ke dalam folder katalog situs. Seluruh proses selesai dalam hitungan detik!
Langkah 3: Impor Sekaligus Tayangkan ke Internet ​
Jika seluruh data produk sudah Anda pastikan benar dan Anda ingin langsung memperbarui website di Cloudflare Pages, cukup tambahkan opsi --publish:
bash
php cuanaff product:import-csv tas contoh-produk.csv --publishSatu baris perintah ini akan mengimpor seluruh produk baru, merakit website statis, dan menerbitkan pembaruan ke internet publik secara otomatis tanpa biaya server ($0/bulan).
2. Format & Spesifikasi Header Kolom CSV ​
Sistem pengimpor CuanAff mendukung dua pilihan skema header kolom: Skema Baku 7 Kolom (Bahasa Indonesia) dan Skema Alternatif Ringkas (Format Affiliate). Parser cerdas CuanAff otomatis mengenali alias kolom tersebut tanpa perlu konfigurasi tambahan.
Pilihan Format Header yang Didukung ​
Opsi A: Skema Baku 7 Kolom (Standar Template Bawaan) ​
csv
nama_produk,brand,kategori,harga,aff_link,gambar_url,ratingOpsi B: Skema Alternatif / Ringkas (Format Affiliate) ​
csv
name,brand,category,price,aff_link,pros,consKedua opsi di atas sepenuhnya valid dan dapat dikombinasikan sesuai kenyamanan lembar kerja spreadsheet Anda.
Rincian Spesifikasi Kolom & Aturan Pengisian ​
| Kolom Utama | Alias yang Dikenali | Status | Deskripsi & Contoh Nilai | Aturan Normalisasi & Nilai Standar |
|---|---|---|---|---|
nama_produk | name, nama, model, produk | Wajib | Nama model atau judul lengkap produk. Contoh: "Lojel Cubo Small Carry-on 21\"" | Spasi ganda dibersihkan otomatis. Alamat tautan cantik (slug) dibuat otomatis. Baris diabaikan jika nama kosong. |
brand | merek, merk | Wajib | Nama produsen atau merek produk. Contoh: "Lojel", "Baller", "Tumi" | Jika dikosongkan, sistem otomatis menetapkan "Tanpa Merek" dan produk ditandai berstatus draf aman. |
kategori | category, kategori_produk | Wajib | Kategori produk dalam niche situs. Contoh: "koper-kabin", "ransel-laptop" | Otomatis dinormalisasi menjadi huruf kecil bertanda hubung (kebab-case). Jika kategori belum ada di config.yaml, sistem otomatis mendaftarkannya! |
harga | price, harga_produk | Wajib | Harga acuan produk di pasaran. Contoh: Rp 3.850.000, 150rb, 1.5 jt | Sanitasi harga cerdas membersihkan simbol Rp, titik ribuan, spasi, dan singkatan k/rb/jt menjadi angka murni. |
aff_link | link_shopee, affiliate_url, url, link, link_afiliasi | Opsional | Tautan afiliasi universal (AccessTrade, Involve Asia, Indoleads, Shopee, dsb.). Contoh: https://atid.me/... atau https://invl.me/... | Dipetakan langsung ke tombol beli utama (cta.url). Jika kosong, sistem membuat tautan pencarian aman. |
gambar_url | image, foto, foto_url | Opsional | Tautan foto produk web atau lokasi berkas lokal. Contoh: https://images.shopee.co.id/... | Disimpan ke aset media hero. Jika kosong, sistem menandai produk untuk diunduh otomatis via media sweeper. |
rating | skor, bintang | Opsional | Skor rating ulasan produk (1.0–5.0). Contoh: 4.9 | Angka antara 1.0 hingga 5.0. Jika dikosongkan, nilai standar otomatis adalah 4.8. |
pros | kelebihan, keunggulan, pro | Opsional | Poin keunggulan utama produk. Contoh: Bahan ringan tahan banting|Roda 360 senyap | Pisahkan beberapa poin dengan tanda pipa (|) atau titik-koma (;). Jika kosong, diisi poin keunggulan standar. |
cons | kekurangan, kelemahan, con | Opsional | Poin catatan jujur kekurangan produk. Contoh: Harga premium|Pilihan warna terbatas | Pisahkan beberapa poin dengan tanda pipa (|) atau titik-koma (;). Jika kosong, diisi catatan ketersediaan pasar. |
Keunggulan Fitur Pengimpor CSV CuanAff ​
- Deteksi Delimiter Cerdas (Koma vs Titik-Koma): Pengguna Windows di Indonesia sering mengalami kendala saat menyimpan berkas di Microsoft Excel, di mana pemisah bawaan adalah titik-koma (
;) bukan koma (,). Parser CuanAff mendeteksi pemisah kolom tersebut secara otomatis. Anda tidak perlu mengubah pengaturan regional laptop Anda. - Sanitasi Angka Harga Cerdas: Anda tidak perlu mengetik angka harga secara kaku. Format penulisan berikut semuanya dipahami dengan benar oleh CuanAff:
Rp 3.850.000→38500003.850.000→38500001.5 jtatau1,5 juta→1500000450rbatau450k→450000
- Pencegahan Data Dobel (Duplicate Safeguard): Jika sebuah produk dengan nama yang sama sudah ada di dalam katalog, sistem secara cerdas memperbarui harga dan tautan tanpa menghapus ulasan jujur (review) atau poin pro-kontra yang sudah Anda tulis sebelumnya.
- Simulasi Aman Tanpa Tulis (Dry Run): Jalankan perintah dengan flag
--dry-rununtuk melihat ringkasan baris yang akan diproses tanpa menyentuh berkas di laptop:bashphp cuanaff product:import-csv tas data-baru.csv --dry-run
3. Asisten Peluncur Interaktif Pemula (jalankan.bat & jalankan.sh) ​
Bagi Anda yang merasa asing dengan layar terminal atau tidak ingin menghafal perintah teks, CuanAff menyediakan Asisten Peluncur Interaktif yang siap pakai. Cukup pilih angka menu, dan sistem akan memandu Anda langkah demi langkah.
Cara Menjalankan Peluncur Interaktif ​
- Pengguna Windows: Buka folder proyek CuanAff di File Explorer, lalu dobel-klik berkas
jalankan.bat. - Pengguna macOS & Linux: Buka terminal di folder proyek CuanAff, lalu ketik:bash
./jalankan.sh
Tampilan menu interaktif akan langsung muncul di layar Anda:
text
======================================================================
CUANAFF — PELUNCUR INTERAKTIF RAMAH PEMULA
Bangun & Kelola Situs Afiliasi Anda Tanpa Menghafal Perintah CLI
======================================================================
[1] Cek Kesiapan Laptop (PHP, Node, Ekstensi & Data)
[2] Atur Nama & Brand Situs (Ganti Nama, Slogan & Wordmark)
[3] Import Produk dari CSV & Publish ke Cloudflare Pages
[4] Lihat Preview Website (Rakit & Buka di Browser)
[5] Tayangkan ke Cloudflare Pages (Online Global $0)
[0] Keluar
----------------------------------------------------------------------
Pilih nomor menu [1-5, 0 untuk keluar]:Bedah 5 Menu Peluncur Interaktif ​
| Nomor Menu | Nama Fitur | Fungsi & Yang Terjadi di Balik Layar |
|---|---|---|
| [1] | Cek Kesiapan Laptop | Memeriksa ketersediaan runtime PHP (minimal 8.2), 6 ekstensi PHP wajib (mbstring, curl, dom, libxml, pdo_sqlite, zip), Node.js, Composer, status folder data katalog data/, dan keberadaan berkas template contoh-produk.csv. |
| [2] | Atur Nama & Brand Situs | Mengubah nama website, slogan, dan logo wordmark di berkas data/{site}/config.yaml secara tanya-jawab interaktif tanpa perlu membuka editor teks atau menyunting berkas YAML secara manual. |
| [3] | Import Produk dari CSV & Publish | Meminta nama situs target dan lokasi berkas CSV, mengimpor puluhan produk sekaligus, lalu memberikan konfirmasi instan: "Ingin langsung tayangkan ke website sekarang? [Y/N]". Jika dijawab Y, website langsung terbit online ke Cloudflare Pages! |
| [4] | Lihat Preview Website | Merakit website statis (php cuanaff site:build) dan menyajikan opsi pratinjau: buka langsung berkas HTML di browser Chrome/Safari atau jalankan server lokal sederhana (localhost:8000). |
| [5] | Tayangkan ke Cloudflare Pages | Menerbitkan website ke Cloudflare Pages (php cuanaff site:publish) dengan opsi simulasi aman (--dry-run) atau langsung terbit ke alamat web publik. |
| [0] | Keluar | Menutup jendela peluncur secara bersih. |
Panduan Mandiri 1-Command-1-Halaman (Dual-Track CLI & Prompt AI)
Untuk panduan modular super ringkas per-perintah lengkap dengan prompt siap pakai untuk Coding Agent (Antigravity, CommandCode, Cursor, ChatGPT, Claude), buka halaman berikut:
- Perintah
product:import-csv— Impor borongan puluhan produk dari spreadsheet CSV - Peluncur Interaktif
launcher— Panduan jalankan.sh & jalankan.bat tanpa terminal rumit - Perintah
auth— Kelola kredensial token Cloudflare Pages secara aman
Deteksi Cerdas Runtime Komputer
Jika runtime PHP belum terpasang di komputer Anda saat menjalankan jalankan.bat atau jalankan.sh, jendela peluncur tidak akan langsung error atau tertutup sendiri. Layar akan menampilkan kotak petunjuk instalasi ramah pemula yang membimbing Anda mengunduh PHP via winget (Windows) atau brew (Mac).
4. Utilitas Sistem & Diagnostik Kesiapan ​
Selain impor borongan dan peluncur interaktif, CuanAff menyediakan utilitas sistem untuk memastikan kondisi teknis laptop dan proyek Anda selalu dalam kondisi prima.
1. Diagnostik Kesiapan Laptop (launcher-helper.php check) ​
Gunakan perintah diagnostik ini kapan saja untuk memverifikasi bahwa lingkungan laptop Anda siap menjalankan seluruh fitur:
bash
php scripts/launcher-helper.php checkOutput pemeriksaan yang rapi akan muncul di terminal:
text
======================================================================
HASIL PEMERIKSAAN KESIAPAN LAPTOP (CUANAFF)
======================================================================
[✓] PHP Runtime : v8.3.x (Memenuhi syarat >= 8.2)
[✓] Ekstensi PHP : Lengkap (mbstring, curl, dom, libxml, pdo_sqlite, zip)
[✓] Node.js : v20.x.x (Siap untuk perakitan dokumentasi)
[✓] Composer : v2.x.x (Siap)
[✓] Status Katalog : Direktori data ditemukan dan siap digunakan.
======================================================================2. Cek Status Situs Aktif (site:status) ​
Ketika Anda mengelola lebih dari satu situs ulasan belanja di laptop yang sama, gunakan perintah ini untuk memastikan situs mana yang sedang aktif menjadi fokus kerja:
bash
php cuanaff site:statusPerintah ini menampilkan ringkasan situs aktif, lokasi folder data, jumlah produk yang siap terbit (published) vs draf (draft), dan status kompilasi terakhir.
3. Pindah Fokus Situs Kerja (site:switch) ​
Untuk berpindah fokus mengerjakan situs lain tanpa perlu mengetik parameter --site berulang kali:
bash
php cuanaff site:switch amanSetelah berpindah, perintah lanjutan seperti site:build, product:list, atau site:publish akan otomatis bekerja pada situs aman.
4. Brankas Keamanan Token Cloudflare (auth) ​
CuanAff tidak pernah menyimpan token Cloudflare atau kredensial rahasia di dalam berkas website publik. Kredensial disimpan di brankas variabel lingkungan aman di laptop Anda:
bash
# 1. Periksa status otentikasi token Cloudflare
php cuanaff auth status
# 2. Daftarkan profil akses baru
php cuanaff auth add profil-utama
# 3. Lihat daftar profil otentikasi tersimpan
php cuanaff auth list5. Template Formula Prompt AI untuk Riset CSV Borongan ​
Jika Anda ingin mengisi puluhan produk rekomendasi baru tetapi belum memiliki waktu untuk mengetik lembar kerja spreadsheet secara manual, Anda dapat memanfaatkan kecerdasan asisten AI gratis (seperti ChatGPT, Claude, atau Gemini) untuk meriset produk dan langsung menghasilkan format CSV yang siap disalin!
Template Prompt Riset Produk Masal Siap Salin ​
Salin teks prompt di bawah ini, sesuaikan bagian tanda kurung siku dengan niche website Anda, lalu kirimkan ke asisten AI:
markdown
Saya sedang membangun website rekomendasi ulasan belanja terkurasi untuk niche [CONTOH: Koper dan Tas Traveling Indonesia].
Tolong buatkan daftar 15 produk rekomendasi terpopuler yang bernilai komisi bagus di Shopee/Tokopedia dalam format tabel CSV siap impor.
Patuhi ketentuan berikut dengan ketat:
1. Header CSV WAJIB menggunakan format 7 kolom:
nama_produk,brand,kategori,harga,link_shopee,gambar_url,rating
2. nama_produk: sebutkan tipe/model lengkap (misal: "Lojel Cubo Small 21 Inch").
3. brand: merek resmi produk.
4. kategori: kategori produk dalam format huruf kecil bertanda hubung (kebab-case, misal: koper-kabin, travel-backpack, tas-pinggang).
5. harga: estimasi harga pasaran wajar di Indonesia (contoh penulisan: 1.850.000 atau 450rb).
6. link_shopee: gunakan tautan pencarian resmi toko Shopee untuk produk tersebut.
7. gambar_url: kosongkan saja (tulis kosong atau tanda kutip kosong "").
8. rating: berikan estimasi rating ulasan pembeli antara 4.7 hingga 4.9.
Sajikan output HANYA dalam blok kode CSV murni tanpa basa-basi pengantar agar bisa langsung saya salin ke Excel!Cara Memindahkan Hasil AI ke CuanAff ​
| Langkah | Tindakan Praktis | Hasil / Berkas |
|---|---|---|
| 1. Salin Tabel AI | Salin blok teks CSV dari hasil chat AI (ChatGPT/Claude). | Teks CSV berada di clipboard komputer. |
| 2. Simpan di Laptop | Buka Notepad atau Excel, paste, dan simpan sebagai produk-baru.csv (UTF-8). | Berkas CSV tersimpan di folder proyek CuanAff. |
| 3. Jalankan Impor | Ketik php cuanaff product:import-csv <site> produk-baru.csv di terminal. | Puluhan katalog produk langsung terdaftar rapi! |
- Salin seluruh teks CSV yang dihasilkan oleh asisten AI.
- Buka aplikasi Notepad atau Microsoft Excel, tempel (paste) teks tersebut, lalu simpan dengan nama
produk-baru.csvdi dalam folder proyek CuanAff (pilih opsi Save as type: CSV (Comma delimited) atau format UTF-8). - Buka terminal atau peluncur interaktif CuanAff, lalu jalankan impor borongan!
6. Kamus Lengkap Opsi Baris Perintah (CLI) Skalabilitas & Utilitas ​
Bagi pengguna yang lebih menyukai baris perintah terminal atau ingin mengintegrasikan perintah ini dengan asisten coding AI (seperti Antigravity, Cursor, atau Claude Code), berikut adalah spesifikasi teknis lengkap dari seluruh opsi yang didukung:
Perintah product:import-csv ​
- Modul Mandiri & Prompt AI: 👉 Panduan Lengkap product:import-csv
- Sintaks Dasar:bash
php cuanaff product:import-csv <slug-situs> <path-file.csv> [opsi] - Daftar Opsi Lengkap:
| Opsi / Flag | Tipe | Standar | Fungsi & Keterangan |
|---|---|---|---|
<slug-situs> | Argumen Teks | Wajib | Nama slug situs target yang akan diisi produk (misal: tas, aman). |
<path-file.csv> | Argumen Teks | Wajib | Lokasi berkas CSV relatif terhadap folder proyek (misal: contoh-produk.csv). |
--publish | Bendera Sakelar | false | Langsung merakit website dan menerbitkan perubahan ke Cloudflare Pages secara otomatis setelah impor berhasil. |
--dry-run | Bendera Sakelar | false | Mode simulasi aman: memvalidasi format berkas dan menghitung baris yang akan diproses tanpa menyimpan perubahan ke disk. |
--delimiter= | Opsi Teks | Otomatis | Memaksa penggunaan pemisah kolom tertentu (misal: --delimiter=";" atau --delimiter=","). Standarnya terdeteksi otomatis. |
Perintah scripts/launcher-helper.php ​
- Modul Mandiri & Prompt AI: 👉 Panduan Lengkap Peluncur Interaktif (launcher)
- Sintaks Dasar:bash
php scripts/launcher-helper.php [perintah] - Daftar Perintah:
| Perintah | Deskripsi | Yang Diperiksa |
|---|---|---|
check | Menjalankan audit kesehatan dan kesiapan sistem. | Versi PHP (>= 8.2), ekstensi PHP lengkap, Node.js, status data katalog, dan berkas template. |
| (tanpa argumen) | Menampilkan ringkasan bantuan cara pemakaian skrip helper. | Informasi bantuan dasar. |
Perintah auth ​
- Modul Mandiri & Prompt AI: 👉 Panduan Lengkap auth
- Sintaks Dasar:bash
php cuanaff auth <sub-perintah> [argumen] - Daftar Sub-perintah:
| Sub-perintah | Fungsi & Hasil |
|---|---|
status | Memeriksa apakah token Cloudflare saat ini aktif, Account ID terhubung, dan izin deploy tersedia. |
add <nama-profil> | Mendaftarkan token otentikasi baru secara aman langsung dari prompt terminal. |
list | Melihat daftar seluruh profil otentikasi deploy yang tersimpan di lingkungan laptop. |
7. Hubungan Impor Masal dengan Panduan Lainnya ​
Alur impor masal adalah mesin akselerasi skala bisnis Anda. Untuk mendapatkan hasil monetisasi yang optimal, hubungkan alur ini dengan panduan kerja lainnya:
- Operasi Situs (
/kelola-operasi-situs): Setelah mengimpor ratusan produk baru, pastikan identitas brand, slogan, dan logo wordmark di panduan Operasi Situs sudah terpasang rapi, serta pantau status publikasi di Cloudflare Pages. - Katalog Produk Kurasi E-E-A-T (
/katalog-produk-kurasi): Produk yang diimpor via CSV memiliki data dasar. Pilih 5–10 produk unggulan berpotensi komisi tertinggi (hero products), lalu perkaya ulasannya menggunakan perintahproduct:reviewdanproduct:enrichagar memiliki nilai kepercayaan manusia standar E-E-A-T Google. - Konten Magnet Traffic SEO (
/konten-magnet-seo): Pilih 2 produk paling populer dari hasil impor CSV, lalu buat artikel perbandingan langsung (versus) menggunakan perintahpage:createuntuk menarik calon pembeli dari Google. - Inspeksi, Kualitas & Keamanan (
/inspeksi-kualitas-keamanan): Jalankan auditproduct:validatedansite:auditsetelah melakukan impor borongan untuk memastikan tidak ada foto yang rusak, format harga salah, atau link bermasalah sebelum situs diluncurkan. - Kamus Perintah CuanAff (
/kamus-perintah): Gunakan lembar contekan perintah harian untuk referensi cepat seluruh sintaks baris perintah saat Anda bekerja berdampingan dengan terminal laptop atau asisten AI coding.
