Perintah: product:add ​

Perintah product:add adalah gerbang utama untuk menambahkan produk rekomendasi baru ke dalam etalase katalog website Anda secara manual dan terarah. Perintah ini dirancang untuk menangkap produk lepas, produk viral di media sosial, atau rilisan terbaru distributor (hidden gems) yang belum terjaring radar kurasi masal (catalog:discover).

Hanya dengan satu baris perintah, sistem CuanAff otomatis menyusun berkas katalog kanonik, mengekstrak merek, mengaitkan tautan afiliasi resmi, memverifikasi kewajaran harga pasar, dan menyiapkan wadah ulasan terstruktur yang siap mendatangkan komisi dari pembeli.

⚡ Fungsi Cepat ​

  • Standar Emas Sweet Spot 3-Parameter: Cukup berikan nama produk, kategori, dan tautan afiliasi. Sistem otomatis menuntaskan seluruh detail teknis lainnya.
  • Batas Minimum 1-Parameter yang Fleksibel: Bisa dieksekusi hanya dengan nama produk (--name), sistem otomatis mengekstrak brand, slug, dan rentang harga wajar.
  • Perlindungan Harga Wajar (Plausibility Gate): Mencegah harga tipuan atau jebakan (bait-pricing) dari marketplace (misal: aksesoris atau cicilan/DP yang dipasang sebagai harga unit utuh). Produk dengan rasio harga anomali otomatis ditahan sebagai draf agar nama baik website ulasan Anda tetap terjaga.
  • Siklus Auto-Publish Cerdas vs Flag --draft: Saat spesifikasi kunci, harga wajar, dan tautan afiliasi lengkap, produk otomatis siap diterbitkan (published). Anda juga bisa menggunakan opsi --draft jika ingin menyunting ulasan secara santai sebelum dipajang ke publik.
  • Pengaitan Link Afiliasi Universal Multi-Network: Mendukung tautan pelacak agregator resmi (AccessTrade, Involve Asia, Indoleads) maupun lokapasar langsung, dengan alias ringkas --url dan alias legacy backward-compatible --shopee.

🎯 Pola Eksekusi: Sweet Spot 3-Parameter vs Batas Minimum 1-Parameter ​

CuanAff memberikan kebebasan penuh dalam penambahan produk manual, mulai dari format rekomendasi tercepat hingga format minimalis:

1. Standar Emas: Sweet Spot 3-Parameter (Sangat Direkomendasikan) ​

Untuk alur kerja kurasi harian paling efisien, gunakan Sweet Spot 3-Parameter (--name, --category, --aff-link):

bash
php cuanaff product:add \
  --name="Ofero Stareer 5 Lit" \
  --category="sepeda-listrik" \
  --aff-link="https://atid.me/002bc7001bpn?url=https%3A%2F%2Fshopee.co.id%2Fproduct%2F123%2F456"

Mengapa kombinasi 3 parameter ini menjadi sweet spot ideal?

  1. --name: Menentukan identitas model dan varian produk secara tegas.
  2. --category: Menempatkan produk ke dalam kategori kanonik yang tepat di dalam arsitektur website niche Anda.
  3. --aff-link: Langsung mengaktifkan jalur komisi afiliasi tanpa perlu mengedit berkas di kemudian hari.

2. Batas Minimum: Eksekusi 1-Parameter ​

Jika kurator sedang terburu-buru dan hanya memiliki nama model produk, perintah tetap dapat berjalan sempurna dengan batas minimum 1 parameter:

bash
php cuanaff product:add --name="Ofero Stareer 5 Lit"

3. Apa yang Otomatis Ditangani Sistem CuanAff? ​

Baik Anda menggunakan pola 3-parameter maupun 1-parameter, engine CuanAff secara cerdas menangani tugas-tugas teknis berikut di balik layar:

Otomatisasi SistemMekanisme di Balik LayarManfaat bagi Pemilik Web
Ekstraksi Brand & Model CerdasSistem memisahkan nama merek (misal: "Ofero") dan nama varian model ("Stareer 5 Lit") secara otomatis.Anda tidak perlu repot mengetik opsi --brand secara terpisah.
Slug URL Kanonik BersihMembentuk slug ramah SEO berformat kebab-case (contoh: ofero-stareer-5-lit).Menghasilkan tautan permalink yang rapi, profesional, dan bebas dari karakter ilegal.
Plausibility Gate (Anti-Bait-Pricing)Memvalidasi rasio spesifikasi vs harga pasar acuan untuk menyaring jebakan harga murah/DP.Melindungi reputasi website Anda dari informasi harga palsu yang merugikan pembeli.
Hero Image DiscoveryMempersiapkan jalur resolusi foto hero beresolusi tinggi tanpa tanda air (watermark) melalui helper media.Tampilan etalase produk langsung menarik dan siap dikompresi ke WebP ringan.

🛠️ Jalur A: Perintah CLI ​

Jalankan perintah penambahan produk di terminal komputer Anda:

bash
php cuanaff product:add --name="<Nama Produk>" [--category="<slug-kategori>"] [--aff-link="<URL Afiliasi>"] [opsi]

Contoh Praktis Multi-Network: ​

bash
# 1. Sweet Spot 3-Parameter: Sepeda listrik via deeplink AccessTrade (Shopee CPS)
php cuanaff product:add --name="Ofero Stareer 5 Lit" --category="sepeda-listrik" \
  --aff-link="https://atid.me/002bc7001bpn?url=https%3A%2F%2Fshopee.co.id%2Fproduct%2F123%2F456"

# 2. Sweet Spot 3-Parameter: Koper kabin via deeplink Involve Asia (Blibli CPS) via alias --url
php cuanaff product:add --name="American Tourister Curio Spinner 55" --category="koper-kabin" \
  --url="https://invl.me/clo2x25?url=https%3A%2F%2Fwww.blibli.com%2Fp%2Famerican-tourister-curio-spinner-55%2Fps--AMT-10293"

# 3. Sweet Spot 3-Parameter: CCTV via deeplink Indoleads dan ditahan sebagai draf (--draft)
php cuanaff product:add --name="Bardi Smart Outdoor PTZ Camera" --category="cctv-outdoor" \
  --aff-link="https://gettracker.net/dpl/6ac7a819b1a58?url=https%3A%2F%2Fshopee.co.id%2Fproduct%2F11223%2F44556" \
  --draft

# 4. Batas Minimum 1-Parameter: Eksekusi instan hanya dengan nama model
php cuanaff product:add --name="Ofero Stareer 5 Lit"

# 5. Dukungan alias legacy bagi pengguna lama (--shopee tetap berfungsi)
php cuanaff product:add --name="Lojel Cubo Small 21 Inch" --category="koper-kabin" \
  --shopee="https://shopee.co.id/product/12345/67890"

# 6. Simulasi aman tanpa menulis ke disk (--dry-run)
php cuanaff product:add --name="Thule Subterra Carry-on 36L" --category="koper-kabin" --dry-run

Pratinjau Output Terminal: ​

txt
[OK] Produk baru berhasil ditambahkan: Ofero Stareer 5 Lit
[INFO] Slug produk: ofero-stareer-5-lit
[INFO] Berkas katalog: data/pilihlistrik/products/ofero-stareer-5-lit.md
[INFO] Kategori: sepeda-listrik | Brand: Ofero
[INFO] Status: published (Lolos verifikasi Plausibility Gate)
[AFFILIATE] Tautan afiliasi resmi multi-network berhasil dikaitkan

🤖 Jalur B: Prompt AI Siap Salin ​

Jika Anda menggunakan asisten coding pintar (Antigravity, CommandCode, Cursor) atau web chat AI (ChatGPT, Claude), gunakan template prompt di bawah ini untuk mengambil data spesifikasi asli toko marketplace dan menambahkannya ke katalog CuanAff.

Aturan Emas Kurasi CuanAff: Anti-Ngarang Data

Gunakan AI untuk mengekstrak dan merapikan data spesifikasi asli toko, bukan untuk mengarang angka dimensi, daya motor, atau kapasitas baterai. Spesifikasi yang akurat adalah kunci utama pembeli mempercayai rekomendasi Anda!

Template Prompt AI Ekstraksi Toko Resmi: ​

Template Prompt AI (Tinggal Salin & Tempel Deskripsi Toko)

text
Halo AI, tolong bantu saya menambahkan produk rekomendasi berikut ke situs CuanAff aktif saat ini:

1. Data Produk:
   - Nama Produk: [MASUKKAN NAMA PRODUK LENGKAP]
   - Kategori: [MASUKKAN KATEGORI KEBAB-CASE, misal: sepeda-listrik atau koper-kabin]
   - URL Afiliasi: [MASUKKAN TAUTAN DEEPLINK ACCESSTRADE / INVOLVE ASIA / INDOLEADS]
   - Deskripsi & Spek Resmi Toko:
     """
     [TEMPELKAN TEKS BROSUR / DESKRIPSI RESMI TOKO DI SINI]
     """

2. Instruksi Eksekusi:
   - Ekstrak spesifikasi teknis asli tanpa mengubah atau mengarang angka.
   - Jalankan perintah Sweet Spot 3-Parameter di terminal:
     php cuanaff product:add --name="[Nama]" --category="[Kategori]" --aff-link="[Link]"
   - Konfirmasikan berkas katalog produk terbentuk di data/<slug-situs>/products/ dengan status publikasi yang valid.

Eksekusi Otomatis Coding Agent (Antigravity / CommandCode / Cursor)

Asisten coding seperti Antigravity dan CommandCode dapat membaca teks spesifikasi yang Anda berikan, langsung mengeksekusi perintah CLI product:add melalui terminal lokal, serta memeriksa berkas Markdown produk yang dihasilkan untuk memastikan seluruh parameter terisi sempurna.

⚙️ Parameter & Opsi Kunci ​

Berikut adalah opsi dan parameter yang paling sering digunakan pada perintah product:add:

Parameter / OpsiWajib?Keterangan & FungsiContoh Nilai
--name="<Nama>"WajibNama model lengkap produk beserta varian ukuran atau serinya.--name="Ofero Stareer 5 Lit"
--category="<slug>"OpsionalKategori produk kanonik dalam format kebab-case.--category="sepeda-listrik"
--aff-link="<URL>"OpsionalTautan afiliasi universal (AccessTrade, Involve Asia, Indoleads, dsb.).--aff-link="https://atid.me/..."
--url="<URL>"OpsionalAlias singkat untuk opsi --aff-link.--url="https://invl.me/..."
--shopee="<URL>"OpsionalAlias legacy untuk kompatibilitas tautan Shopee lama.--shopee="https://shopee.co.id/..."
--draftOpsionalMemaksa status produk tetap sebagai draft untuk ditinjau manual.--draft
--site="<slug>"OpsionalMenentukan situs target secara spesifik (bawaan: situs aktif).--site="pilihlistrik"
--slug="<slug>"OpsionalMenentukan slug URL kustom jika tidak ingin otomatis dari nama.--slug="ofero-stareer-5-lit"
--dry-runOpsionalSimulasi pembuatan katalog tanpa menyimpan berkas ke disk.--dry-run
--jsonOpsionalMenghasilkan respons output dalam format JSON terstruktur.--json

📱 Hasil Nyata di Website ​

Setelah perintah product:add berhasil dijalankan:

  1. Berkas Katalog Kanonik Terbentuk (data/<situs>/products/<slug>.md):
    • Berisi metadata terstruktur (frontmatter) seperti nama, merek, harga acuan, tautan afiliasi, dan kategori.
    • Berkas siap dilengkapi narasi ulasan jujur atau evaluasi kelebihan/kekurangan via product:review dan product:enrich.
  2. Muncul Otomatis di Etalase & Tabel Komparasi:
    • Saat website dirakit (site:build), produk otomatis terdaftar di halaman katalog kategori, kartu rekomendasi, serta siap diikutsertakan ke dalam artikel magnet traffic komparasi versus (page:create).
  3. Tombol Rekomendasi Afiliasi Aktif:
    • Pengunjung website dapat langsung mengklik tombol "Cek Promo di Toko Resmi" yang telah tersemat atribut keamanan rel="sponsored nofollow noopener" menuju tautan afiliasi Anda untuk menghasilkan komisi.