Lompat ke konten utama
StableTerakhir diperbarui: 19 Okt 2026, 22.00

Generator Artikel SEO (AI)

Generator Artikel SEO adalah modul kecerdasan buatan terintegrasi pada platform DagangBot yang dirancang untuk memproduksi artikel informatif berkualitas tinggi dan teroptimasi mesin pencari secara otomatis. Modul ini menggabungkan model bahasa besar (Large Language Model), perutean waterfall berjenjang, dan mesin audit SEO deterministik 18 parameter untuk menghasilkan konten yang siap bersaing di halaman pencarian Google tanpa proses kurasi teknis manual yang berulang.

Stable

1. Ikhtisar & Nilai Bisnis

Membangun keberadaan digital dan mendatangkan calon pembeli organik membutuhkan produksi artikel edukatif yang konsisten. Namun, penulisan artikel ramah mesin pencari sering kali terhambat oleh keterbatasan waktu staf, pemahaman teknis riset kata kunci, serta tingginya biaya jasa agensi konten eksternal.

  • Efisiensi Produksi Konten Skala Besar: Memungkinkan pembuatan batch hingga puluhan artikel dalam satu kali eksekusi antrean latar belakang (background worker).
  • Segmentasi Corong Konversi (Funnel-Aware): Artikel dirancang sesuai tahapan pencarian informasi dan pertimbangan calon pembeli (Top, Middle, atau Bottom of Funnel).
  • Audit SEO Deterministik 18 Parameter: Hasil generasi dievaluasi otomatis terhadap aturan SEO teknis seperti keyword density, struktur heading, panjang metadata, dan keterbacaan.
  • Integrasi Sistem Eksternal: Gunakan All-in-One API untuk mengirim kata kunci, memantau batch, dan mengambil hasil artikel ke sistem pemanggil.
  • Model Biaya Transparan: Pemrosesan mengikuti estimasi biaya dan kuota yang berlaku untuk merchant.
Keamanan Multi-Tenant & RLS

Seluruh data proyek, kata kunci, antrean batch, dan naskah artikel dilindungi oleh PostgreSQL Row-Level Security (RLS) berbasis merchant_id. Data antar-penyewa terisolasi secara mutlak di lapisan pangkalan data pangkalan server.

2. Alur Kerja & Konsep Inti

Siklus pembuatan artikel meliputi penyiapan konteks proyek, antrean generasi, evaluasi SEO, dan pengambilan hasil melalui API. Sistem eksternal mengelola review dan publikasi ke CMS tujuannya.

2.1 Entitas Proyek Artikel

Proyek (Project) bertindak sebagai wadah tematik untuk mengelompokkan kata kunci dan konten. Melalui API, sistem pemanggil dapat menggunakan proyek, konteks bisnis, dan gaya bahasa acuan saat meminta pembuatan artikel.

2.2 Klasifikasi Corong Pemasaran (Marketing Funnel)

Setiap kata kunci diklasifikasikan ke dalam salah satu dari tiga tingkatan corong pemasaran:

  1. TOFU (Top of Funnel - Kesadaran): Artikel berfokus pada edukasi audiens yang baru mengenal topik atau permasalahan umum. Panjang konten minimal 800 kata.
  2. MOFU (Middle of Funnel - Pertimbangan): Artikel membandingkan solusi, mengulas kelebihan produk, dan membantu audiens mengevaluasi alternatif. Panjang konten minimal 1200 kata.
  3. BOFU (Bottom of Funnel - Keputusan): Artikel berorientasi pada pembaca yang siap mengambil keputusan, sesuai konteks yang diberikan sistem pemanggil.

2.3 Preset Gaya Bahasa (Tone of Voice)

Platform menyediakan lima gaya bahasa baku yang dapat dipilih per proyek maupun per antrean batch:

  • Profesional: Lugas, formal, kredibel, dan berwibawa.
  • Kasual: Santai, bersahabat, dan menggunakan sapaan akrab.
  • Persuasif: Menekankan manfaat emosional, urgensi, dan fokus penjualan.
  • Edukatif: Terstruktur runtut seperti modul panduan atau tutorial praktis.
  • Friendly: Hangat, interaktif, dan penuh empati.

2.4 Sistem Antrean Asinkron (Asynq Queue)

Pembuatan naskah artikel tidak mengeblok antarmuka pengguna. Permintaan dikirim ke antrean antrean berprioritas khusus (article_gen) yang diproses berurutan oleh worker latar belakang. Setiap artikel diproses dengan jeda waktu aman (rate-limit delay) untuk mencegah pemutusan koneksi atau pembatasan kuota penyedia LLM.

3. Penggunaan melalui All-in-One API

Article Generator tidak tersedia sebagai halaman dashboard merchant. Gunakan All-in-One API agar sistem eksternal dapat mengirim kata kunci, memantau batch, dan mengambil hasil artikel.

  1. Buat API key All-in-One dengan scope article_gen pada /app/integrations.
  2. Kirim permintaan ke POST /api/v1/all-in-one/article-gen/generate. Sertakan kata kunci atau proyek, konteks bisnis, dan webhook_url opsional.
  3. Pantau status dengan GET /api/v1/all-in-one/article-gen/batches/{id} atau tunggu event webhook batch.completed.
  4. Ambil daftar hasil melalui GET /api/v1/all-in-one/article-gen/batches/{id}/articles, lalu baca konten melalui GET /api/v1/all-in-one/article-gen/articles/{id}.
  5. Sistem pemanggil bertanggung jawab atas review, penyimpanan, dan publikasi artikel ke CMS tujuan. API tidak menerbitkan artikel merchant ke blog DagangBot.

Rujuk All-in-One API untuk format request, autentikasi, webhook, dan respons.

4. Evaluasi SEO & Parameter Validasi

Mesin audit SEO internal DagangBot memeriksa 18 parameter teknis setiap kali artikel digenerate atau diedit:

ID Pemeriksaan Nama Parameter Batasan Validasi Bobot Skor
focus_keyword_present Keberadaan Kata Kunci Kata kunci target wajib terdefinisi 40% (Kata Kunci)
keyword_in_title Kata Kunci di Judul H1 Muncul di judul utama artikel 40% (Kata Kunci)
keyword_in_meta_title Kata Kunci di Meta Title Muncul di judul SERP Google 40% (Kata Kunci)
keyword_in_meta_description Kata Kunci di Meta Desc Muncul di ringkasan SERP Google 40% (Kata Kunci)
keyword_in_excerpt Kata Kunci di Excerpt Muncul di ringkasan konten 40% (Kata Kunci)
keyword_in_first_paragraph Kata Kunci di Paragraf 1 Muncul dalam 100 kata pertama 40% (Kata Kunci)
keyword_in_h2 Kata Kunci di Subjudul Minimal 1 heading H2 memuat kata kunci 40% (Kata Kunci)
keyword_density Kerapatan Kata Kunci Ideal antara 1.0% hingga 3.0% dari total kata 40% (Kata Kunci)
meta_title_length Panjang Meta Title 50 hingga 60 karakter 25% (Metadata)
meta_description_length Panjang Meta Deskripsi 140 hingga 160 karakter 25% (Metadata)
excerpt_length Panjang Excerpt 120 hingga 250 karakter 25% (Metadata)
slug_contains_keyword Kata Kunci di Slug URL Slug memuat kata kunci terformat URL-safe 25% (Metadata)
content_word_count Jumlah Kata Konten Sesuai batas minimum corong (800 / 1200 / 1500) 20% (Keterbacaan)
paragraph_length Kerapatan Paragraf Maksimal 4 kalimat per paragraf 20% (Keterbacaan)
has_subheadings Kepadatan Subjudul Minimal 1 subjudul per 300 kata 20% (Keterbacaan)
heading_hierarchy Hierarki Judul H2 mendahului H3, tidak melompat level 15% (Struktur)
internal_link_suggestion Tautan Internal Memuat penanda tautan rekomendasi 15% (Struktur)
canonical_url_valid Validitas URL Kanonikal Format URL kanonikal valid berprotokol HTTPS 15% (Struktur)

Mekanisme Percobaan Ulang Otomatis (SEO Auto-Retry)

Jika artikel yang digenerate menghasilkan skor SEO di bawah ambang batas yang ditentukan (default: 60/100), sistem secara otomatis merumuskan umpan balik perbaikan dan memanggil ulang AI (maksimal 1 kali percobaan ulang). Biaya token dari percobaan ulang ditambahkan secara transparan ke metrik pengerjaan.

5. Integrasi Biaya, Token & Dompet

Pengerjaan artikel memanfaatkan arsitektur penagihan yang telah teruji pada ekosistem keuangan DagangBot:

  1. Pemeriksaan Kuota Gratis Bulanan: Sistem memeriksa tabel pemakaian kuota periode berjalan (article_gen_quota_usage). Jika jatah kuota paket langganan Anda masih tersedia, artikel diproduksi secara gratis tanpa memotong saldo dompet.
  2. Prapemeriksaan Saldo Dompet (Wallet Preflight): Jika kuota gratis telah habis, sistem mengecek kecukupan saldo efektif dompet toko terhadap estimasi biaya minimum sebelum perintah pemrosesan dijalankan.
  3. Reservasi Dana Sementara: Saldo sebesar estimasi awal ditahan sementara (reserved) selama artikel dikerjakan oleh worker.
  4. Penyelesaian Transaksi (Settlement): Setelah artikel selesai digenerate, biaya dihitung berdasarkan jumlah token masukan (articlegen_token_in), token keluaran (articlegen_token_out), serta aturan dasar tarif minimal artikel (min_charge_per_article Rp 200). Saldo cadangan diselesaikan, dan selisih estimasi langsung dikembalikan seketika.

6. Pemecahan Masalah (Troubleshooting)

Gunakan tabel referensi berikut apabila integrasi API gagal:

Gejala Teramati Penyebab Tindakan Penanganan
Pembuatan batch ditolak dengan kode INSUFFICIENT_BALANCE Kuota artikel gratis habis dan saldo efektif tidak mencukupi. Isi saldo atau ubah paket merchant sesuai kebutuhan.
Muncul kesalahan CONCURRENT_LIMIT_REACHED Merchant telah mencapai batas batch aktif. Tunggu batch aktif selesai sebelum mengirim permintaan baru.
Gagal mengambil metadata website dengan pesan penolakan alamat URL proyek mengarah ke IP privat, localhost, atau jaringan internal. Gunakan URL publik yang dapat diakses melalui HTTP atau HTTPS.
Webhook batch tidak diterima URL webhook tidak dapat dijangkau atau merespons HTTP 4xx / 5xx. Periksa endpoint webhook dan respons server Anda.

7. Referensi Terkait

Untuk pemahaman teknis dan panduan operasional pendukung lainnya, pelajari dokumentasi berikut:

content/docs/features/article-generator.mdx
Terakhir diperbarui: 19 Okt 2026, 22.00

Dokumentasi teknis DagangBot