Asisstant A

## Super Prompt: Pencari Data Harga Produk & Ekspor ke Excel (Format JSON)

Berikut adalah **super prompt lengkap dalam format JSON**. Anda bisa gunakan prompt ini untuk memberi instruksi ke AI, developer, atau tools *(seperti Zapier, Make.com, Google Apps Script, atau custom script Python/Node.js)*.  

---

### **JSON PROMPT**

```json

{

  "metadata": {

    "tool_name": "Product Price Scraper & Excel Exporter",

    "description": "Mencari harga produk dari berbagai marketplace, menampilkan hasil dalam tabel, dan mengekspor ke file Excel yang bisa diunduh.",

    "version": "1.0"

  },

  "user_input": {

    "required": [

      {

        "field": "keyword",

        "label": "Keyword Produk",

        "type": "text",

        "placeholder": "Contoh: Sepatu Sneakers Puma, Laptop ASUS Vivobook, Minuman Teh Botol",

        "description": "Masukkan nama produk yang ingin dicari.",

        "validation": "Wajib diisi"

      }

    ],

    "optional": [

      {

        "field": "marketplaces",

        "label": "Pilih Marketplace",

        "type": "checkbox",

        "options": [

          {"id": "tokopedia", "label": "Tokopedia", "default": true},

          {"id": "shopee",    "label": "Shopee",    "default": true},

          {"id": "lazada",    "labeL": "Lazada",    "default": true},

          {"id": "bukalapak", "label": "Bukalapak", "default": false},

          {"id": "tiktokshop","label": "TikTok Shop","default": false}

        ],

        "description": "Pilih marketplace tempat pencarian akan dilakukan."

      },

      {

        "field": "max_results",

        "label": "Jumlah Hasil per Marketplace",

        "type": "number",

        "default": 5,

        "min": 1,

        "max": 20,

        "description": "Jumlah produk yang diambil dari setiap marketplace."

      },

      {

        "field": "sort_by",

        "label": "Urutkan Berdasarkan",

        "type": "select",

        "options": [

          {"value": "price_asc",  "label": "Harga: Terendah ke Tertinggi"},

          {"value": "price_desc", "label": "Harga: Tertinggi ke Terendah"},

          {"value": "relevance",  "label": "Relevansi"}

        ],

        "default": "price_asc"

      }

    ],

    "submit_button": {

      "label": "🔍 Cari Produk"

    }

  },

  "data_scraping": {

    "description": "Proses pengambilan data dari marketplace.",

    "methods": [

      "Gunakan API resmi marketplace *(jika tersedia)*",

      "Jika API tidak tersedia, gunakan **web scraping** dengan library seperti **BeautifulSoup (Python)** atau **Cheerio (Node.js)**"

    ],

    "required_data_per_product": [

      {

        "field": "product_name",

        "label": "Nama Produk",

        "description": "Nama produk persis seperti di marketplace *(termasuk varian)*"

      },

      {

        "field": "price",

        "label": "Harga",

        "description": "Harga dalam Rupiah **(Rp)**. **Format: Angka integer tanpa titik/koma untuk proses, lalu format ke Rp saat tampilkan.**",

        "format_storage": 1500000,  

        "format_display": "Rp 1.500.000"

      },

      {

        "field": "merchant_name",

        "label": "Nama Toko / Merchant",

        "description": "Nama toko atau penjual."

      },

      {

        "field": "marketplace",

        "label": "Nama Marketplace",

        "description": "Sumber marketplace *(Contoh: Tokopedia, Shopee, Lazada)*"

      },

      {

        "field": "product_url",

        "label": "Link / URL",

        "description": "**URL langsung ke halaman produk**. Pastikan link valid dan bisa diklik!",

        "validation": "Harus berupa URL yang valid."

      }

    ],

    "processing_rules": [

      {

        "rule": "remove_duplicates",

        "description": "Hapus produk duplikat *(berdasarkan URL atau kombinasi nama produk + toko)*"

      },

      {

        "rule": "price_filter",

        "description": "Filter hanya produk yang memiliki harga **(hilangkan produk yang tidak menampilkan harga)**"

      },

      {

        "rule": "sort_results",

        "description": "Urutkan hasil sesuai pilihan pengguna *(default: harga terendah ke tertinggi)*"

      }

    ],

    "error_handling": [

      {

        "error": "marketplace_unavailable",

        "message": "⚠️ Gagal mengambil data dari {marketplace}. Silakan coba lagi nanti."

      },

      {

        "error": "no_results",

        "message": "🔍 Tidak ditemukan produk untuk keyword: **{keyword}** di {marketplace}."

      }

    ]

  },

  "table_display": {

    "description": "Tampilkan hasil pencarian dalam tabel rapi di UI.",

    "columns": [

      {"field": "no",          "label": "No.",         "width": "5%"},

      {"field": "product_name", "label": "Nama Produk", "width": "35%"},

      {"field": "price",        "label": "Harga",       "width": "15%"},

      {"field": "merchant_name","label": "Nama Toko / Merchant", "width": "20%"},

      {"field": "marketplace",  "label": "Marketplace", "width": "10%"},

      {"field": "product_url",  "label": "Link",        "width": "15%"}

    ],

    "features": [

      {

        "feature": "sorting",

        "description": "Pengguna bisa mengurutkan tabel dengan mengklik header kolom *(Klik sekali: Ascending, Klik lagi: Descending)*"

      },

      {

        "feature": "search_in_table",

        "description": "Fitur pencarian cepat **(search box)** untuk memfilter data di dalam tabel."

      },

      {

        "feature": "pagination",

        "description": "Jika hasil lebih dari 10 item, tambahkan **pagination**.",

        "items_per_page": 10

      },

      {

        "feature": "clickable_url",

        "description": "Kolom **Link** harus berupa **hyperlink** yang bisa diklik. Di tampilan, teksnya bisa diganti jadi **“🔗 Buka Produk”**."

      }

    ]

  },

  "excel_export": {

    "button_label": "📥 Download Excel",

    "file_naming": {

      "pattern": "Daftar_Harga_{keyword}_{date}.xlsx",

      "date_format": "YYYYMMDD",

      "example": "Daftar_Harga_Sepatu_Sneakers_Puma_20231015.xlsx",

      "replace_spaces": "_"

    },

    "excel_sheet_structure": {

      "sheet_name": "Data Produk",

      "columns": [

        "No.",

        "Nama Produk",

        "Harga",

        "Nama Toko / Merchant",

        "Nama Marketplace",

        "Link / URL"

      ],

      "formatting_rules": [

        {

          "column": "No.",

          "format": {

            "number_format": "0",

            "alignment": "center"

          }

        },

        {

          "column": "Harga",

          "format": {

            "number_format": "\"Rp\"#,##0",

            "description": "Format sebagai mata uang. Contoh: 1500000 ➜ Rp1.500.000"

          }

        },

        {

          "column": "Link / URL",

          "format": {

            "make_hyperlink": true,

            "display_text": "🔗 Buka Produk",

            "description": "**Setiap URL dibuat menjadi HYPERLINK**. Di Excel, teks yang muncul adalah ‘🔗 Buka Produk’, tapi link asli tersimpan."

          }

        }

      ],

      "header_style": {

        "bold": true,

        "background_color": "#F2F2F2",  

        "font_color": "#000000",

        "font_size": 11,

        "font_name": "Calibri"

      },

      "auto_fit_columns": true,

      "freeze_header_row": true

    },

    "additional_sheet": {

      "sheet_name": "Catatan",

      "content": [

        ["📌 CATATAN"],

        [""],

        ["Tanggal Download", "={TODAY()}"],

        ["Keyword yang Dicari", "={USER_KEYWORD}"],

        ["Marketplace Terpilih", "={SELECTED_MARKETPLACES}"],

        [""],

        ["⚠️ Perhatian:"],

        ["• Data diambil pada saat pencarian dilakukan."],

        ["• Harga dapat berubah setiap saat. Pastikan cek ulang sebelum pembelian."],

        ["• Link produk mengarah ke halaman produk di marketplace masing-masing."]

      ]

    },

    "library_recommendation": [

      "**Python:** pandas + openpyxl",

      "**Node.js:** exceljs",

      "**Google Apps Script:** SpreadsheetApp",

      "**PHP:** PhpSpreadsheet"

    ]

  },

  "technical_stack_recommendation": {

    "frontend": [

      "HTML, CSS, JavaScript",

      "Library: DataTables (untuk tabel interaktif), Bootstrap"

    ],

    "backend": [

      "**Python:** Flask/Django + BeautifulSoup/Scrapy + pandas",

      "**Node.js:** Express + Cheerio + exceljs",

      "**Google Apps Script:** (Tanpa server, langsung integrasi dengan Google Sheet)"

    ],

    "deployment": [

      "Hosting: Vercel, Netlify, Heroku, atau PythonAnywhere",

      "Untuk scraping intensif: Gunakan **server dengan IP tetap** *(menghindari blokir IP)*"

    ]

  },

  "example_workflow": [

    "1. Pengguna memasukkan **keyword** *(contoh: ‘Sepatu Sneakers Puma’)* dan memilih marketplace.",

    "2. Sistem melakukan **scraping/API request** ke setiap marketplace yang dipilih.",

    "3. Data dikumpulkan, difilter, diurutkan, dan **ditampilkan dalam tabel**. ",

    "4. Pengguna mengklik tombol ***‘Download Excel’***.",

    "5. Sistem membuat file Excel sesuai format, lalu **mengirimkan file ke pengguna** *(download otomatis)*."

  ],

  "notes": [

    "🔹 **Etika Scraping:** Selalu perhatikan `robots.txt` marketplace. Jangan lakukan scraping terlalu sering agar tidak diblokir. Gunakan **delay** antar request *(minimal 2 detik)*.",

    "🔹 **User Experience:** Tampilkan **loading animation** saat proses scraping berlangsung.",

    "🔹 **Keamanan:** Jangan simpan data pengguna. File Excel di-generate **on-the-fly** dan **tidak disimpan di server**."

  ]

}

```

---

### **Cara Menggunakan Prompt Ini**

#### **Untuk Developer:**

1.  Ikuti struktur **`user_input`** untuk membuat form input di aplikasi Anda.

2.  Gunakan aturan di **`data_scraping`** untuk mengambil data.

3.  Tampilkan data sesuai **`table_display`**.

4.  Untuk ekspor Excel, ikuti panduan di **`excel_export`**.  

    *(Contoh kode menggunakan **pandas + openpyxl** bisa dilihat di bagian bawah prompt awal)*.

#### **Untuk Pengguna Tools No-Code *(Zapier/Make.com)***

1.  Gunakan **Web Scraping Module** atau **API Integration**.

2.  Setel output sesuai kolom di **`required_data_per_product`**.

3.  Gunakan modul ***“Create Spreadsheet”*** atau ***“Excel”*** untuk menghasilkan file.  

    ➜ Isi kolom dan terapkan formatting sesuai **`excel_export`**.

#### **Untuk AI Tools *(misal: Custom GPTs)***

Copy seluruh blok JSON di atas, lalu berikan instruksi:  

***“Berdasarkan konfigurasi JSON di bawah ini, bantu saya membuat tools pencarian harga produk dan ekspor ke Excel.”***

📌 **File Excel yang dihasilkan akan terlihat profesional dan siap digunakan!** 🎯