Perintah: catalog:discover ​

Perintah catalog:discover adalah mesin pencari calon produk otomatis (Product Discovery Engine) yang memindai pasar untuk menemukan kandidat produk potensial dalam suatu kategori ulasan. Dirancang dengan paradigma Review-First, perintah ini mengisolasi seluruh calon ke dalam antrean kurasi aman (ReviewQueue) tanpa risiko merusak atau mengotori katalog publik website Anda.

⚡ Fungsi Cepat ​

  • Eksplorasi Skala Kategori Seketika: Menemukan 10–20 kandidat produk potensial dalam hitungan detik tanpa perlu browsing manual satu per satu di marketplace.

  • Filter Cerdas Validasi Produk (Smart Input Filtering): Otomatis menyaring dan menolak entri uang muka (DP), cicilan kredit fiktif, serta aksesoris periferal bernilai rendah agar katalog Anda berfokus pada unit produk utama yang bernilai transaksi memadai.

  • Isolasi Total di Antrean Kurasi (ReviewQueue): Calon produk disimpan secara aman di berkas antrean operator (ReviewQueue). Tidak ada satu pun calon yang langsung tayang di website publik sebelum Anda setujui.

  • Pembacaan Multi-Sumber Bukti (--max-sources): Menggali referensi dari toko resmi dan artikel rujukan terpercaya untuk memverifikasi keaslian spesifikasi teknis dan kewajaran harga bawaan.

🚀 TinyFish Quality Booster: Riset Otomatis Tanpa Halusinasi

Perintah catalog:discover terintegrasi langsung dengan mesin riset semantik resmi TinyFish Search & Fetch (tinyfish.ai):

  • Zero-Hallucination Spesifikasi: Menyalin parameter teknis produk (dimensi, berat, kapasitas baterai, daya, material) secara verbatim dari rujukan toko resmi pabrikan.
  • Deteksi Jebakan DP & Aksesoris: Memindai harga pasar dan otomatis memfilter penawaran pancingan DP/cicilan fiktif serta aksesoris pelengkap ke dalam daftar penolakan (DP_OR_ACCESSORY).
  • Foto Produk Resmi HD: Menyiapkan referensi gambar produk resmi beresolusi tinggi bebas watermark toko marketplace pihak ketiga.
  • 100% Opsional ($0 Modal): Fitur TinyFish 100% opsional. Tanpa kunci API, CuanAff tetap berjalan normal menggunakan pencarian cadangan bawaan atau kurasi manual tanpa biaya tambahan apa pun ($0 modal).
  • Aktivasi 1-Klik: Dapatkan API key di portal resmi tinyfish.ai jika ingin mengaktifkan riset live, lalu simpan lewat php cuanaff tinyfish set <key> atau tambahkan TINYFISH_API_KEY di berkas .env. Periksa status kapan saja dengan php cuanaff tinyfish status.

🛠️ Jalur A: Perintah CLI ​

Jalankan perintah pencarian calon produk di terminal komputer Anda:

bash
php cuanaff catalog:discover [--category="<slug-kategori>"] [--limit=<angka>] [--max-sources=<angka>] [opsi]

Mode Interaktif Cerdas: ​

Jika Anda menjalankan perintah tanpa menyertakan parameter kategori atau situs:

bash
php cuanaff catalog:discover

Sistem CuanAff akan memandu Anda secara interaktif dengan menanyakan situs target dan daftar kategori yang tersedia. Anda cukup memilih nomor kategori yang ingin dieksplorasi.

Contoh Praktis Penggunaan: ​

bash
# 1. Mencari calon produk untuk kategori koper kabin (kuota bawaan 10 produk)
php cuanaff catalog:discover --category="koper-kabin"

# 2. Menentukan kuota maksimal calon produk yang disimpan (misal: 15 kandidat)
php cuanaff catalog:discover --category="cctv-outdoor" --limit=15

# 3. Meningkatkan kedalaman analisis bukti pasar hingga 5 artikel rujukan
php cuanaff catalog:discover --category="koper-kabin" --max-sources=5

# 4. Menentukan situs target spesifik jika Anda mengelola multi-niche
php cuanaff catalog:discover --site="tas" --category="koper-kabin" --limit=10

# 5. Simulasi pencarian aman tanpa menyimpan antrean ke disk (--dry-run)
php cuanaff catalog:discover --category="koper-kabin" --dry-run

# 6. Menghasilkan output terstruktur dalam format JSON untuk otomasi
php cuanaff catalog:discover --category="koper-kabin" --json

Pratinjau Output Terminal: ​

txt
Situs: tas · Kategori: koper-kabin

Calon produk (3):
  [1] Lojel Cubo Small 21 Inch — Rp 4.250.000
  [2] Baller All Aluminium 20 Inch — Rp 3.890.000
  [3] American Tourister Curio Spinner 55 — Rp 2.190.000

Setujui dengan: php cuanaff catalog:approve --pick=<nomor>  (contoh: --pick=1)

Ditolak otomatis (2):
  × Sarung Koper Plastik Bening Elastis 20 Inch — terlihat seperti DP/cicilan/aksesori, bukan unit utuh
  × DP Pre-Order Koper Aluminium Silver — terlihat seperti DP/cicilan/aksesori, bukan unit utuh

🤖 Jalur B: Prompt AI Siap Salin ​

Anda dapat memanfaatkan asisten coding pintar (Antigravity, CommandCode, Cursor) atau web chat AI (ChatGPT, Claude) untuk mengeksekusi pencarian calon produk, menganalisis kelayakan pasar, dan merekomendasikan pilihan kurasi terbaik.

Kedaulatan Kurator: Mengapa Isolasi Antrean Sangat Penting?

Di CuanAff, AI dan mesin pencari hanya bertindak sebagai asisten riset, bukan penentu isi website. Seluruh calon produk ditahan di antrean kurasi agar Anda dapat meneliti kualitasnya terlebih dahulu. Pembeli ulasan Anda hanya disajikan produk-produk unggulan yang telah lolos penilaian manusia.

Template Prompt AI Riset Pasar & Kurasi Calon Produk: ​

Template Prompt AI (Tinggal Salin & Sesuaikan Kategori)

text
Halo AI, tolong bantu saya mengeksplorasi calon produk baru untuk kategori ulasan di website CuanAff.

Target Riset:
- Situs Aktif: tas (atau situs aktif saat ini)
- Kategori Target: koper-kabin
- Batas Kandidat: 10 produk

Tolong lakukan langkah-langkah berikut:
1. Jalankan perintah discovery di terminal lokal:
   php cuanaff catalog:discover --category="koper-kabin" --limit=10

2. Baca daftar calon produk yang berhasil masuk ke antrean ReviewQueue beserta daftar produk yang ditolak otomatis.
3. Berikan analisis singkat untuk 3 calon produk teratas:
   - Apakah brand tersebut memiliki reputasi resmi dan dicari pembeli?
   - Apakah rentang harganya wajar untuk produk kelas menengah ke atas?
   - Mana calon produk nomor urut ([1], [2], atau [3]) yang paling layak disetujui pertama kali untuk artikel komparasi?

4. Jika Anda merekomendasikan calon nomor urut 1, siapkan perintah persetujuan:
   php cuanaff catalog:approve --pick=1

Eksekusi Otomatis Coding Agent (Antigravity / CommandCode / Cursor)

Asisten coding AI dapat menjalankan catalog:discover secara langsung di terminal lokal, membaca respons antrean kurasi, memfilter opsi terbaik, dan meminta konfirmasi Anda sebelum mengeksekusi catalog:approve.

⚙️ Parameter & Opsi Kunci ​

Berikut adalah seluruh opsi dan parameter yang dapat digunakan pada perintah catalog:discover:

Parameter / OpsiWajib?BawaanKeterangan & FungsiContoh Nilai
--category="<slug>"OpsionalInteraktifKategori target yang ingin dicari produknya. Jika dikosongkan, CLI akan menampilkan daftar pilihan.--category="koper-kabin"
--limit=<angka>Opsional10Batas maksimal jumlah calon produk potensial yang disimpan ke antrean kurasi.--limit=15
--max-sources=<angka>Opsional3Batas maksimal artikel dan sumber rujukan yang dibaca untuk memvalidasi bukti produk.--max-sources=5
--site="<slug>"OpsionalAktifMenentukan nama situs target secara spesifik jika Anda mengelola lebih dari satu situs.--site="tas"
--dry-runOpsionalfalseMenampilkan pratinjau hasil penemuan produk tanpa menyimpan apa pun ke antrean kurasi disk.--dry-run
--jsonOpsionalfalseMenghasilkan respons keluaran mesin dalam format JSON terstruktur untuk kebutuhan otomasi/script.--json
--data="<path>"Opsionaldata/Menentukan direktori data kanonik jika bekerja di luar path standar.--data="data"

🛡️ Mekanisme Penyaringan Cerdas (Smart Rejection Engine) ​

Salah satu keunggulan utama catalog:discover adalah sistem penyaringannya yang ketat. Mesin pencari CuanAff secara proaktif melindungi website Anda dari produk-produk sampah yang sering bertebaran di marketplace:

  1. DP_OR_ACCESSORY (Penolakan DP, Cicilan & Aksesoris):
    • Marketplace sering memajang judul seperti "DP Koper Aluminium 500rb" atau menjual aksesoris murah seperti "Sarung Plastik Koper" di dalam kategori koper.
    • catalog:discover mendeteksi anomali harga dan kata kunci aksesoris sampingan, lalu menolaknya secara otomatis dengan label: terlihat seperti DP/cicilan/aksesori, bukan unit utuh.
  2. ALREADY_IN_CATALOG (Pencegahan Duplikasi Produk):
    • Produk yang sudah pernah disetujui dan ada di katalog website Anda tidak akan dimunculkan kembali ke dalam antrean, mencegah penumpukan data ganda.
  3. NO_IDENTITY (Penyaringan Toko Tanpa Identitas):
    • Listing produk yang tidak memiliki identitas toko resmi atau data merchant yang valid akan langsung ditolak demi menjaga integritas tautan rujukan.

📱 Hasil Nyata & Langkah Selanjutnya ​

Setelah perintah catalog:discover selesai dijalankan:

  1. Antrean Kurasi Terbentuk di Operator State:
    • Calon produk disimpan secara rapi di berkas antrean kurasi (ReviewQueue) pada direktori state internal yang terisolasi.
  2. Katalog Publik Tetap Bersih & Aman:
    • Berkas katalog resmi di data/<site>/products/ sama sekali tidak tersentuh. Pengunjung website publik tidak akan melihat produk mentah yang belum diverifikasi.
  3. Langkah Berikutnya (Persetujuan Kurator):
    • Tinjau nomor urut calon produk yang tampil di terminal, lalu setujui calon terbaik ke katalog resmi menggunakan perintah catalog:approve:
      bash
      php cuanaff catalog:approve --pick=1