SEO untuk Web SPA di Cloudflare Pages: Judul, Meta, dan Isi Langsung Terbaca Google

Pernah membuat web yang tampil bagus di browser, tapi tidak pernah muncul di Google, dan saat link-nya dibagikan di WhatsApp tidak keluar judul maupun gambarnya? Biasanya penyebabnya adalah jenis web yang disebut SPA. Artikel ini menjelaskan kenapa itu terjadi dan cara memperbaikinya di Cloudflare Pages, tanpa harus membuat ulang web Anda. Cara ini dipakai langsung di situs OutsiderDev.
Apa itu SPA?
SPA (Single Page Application) adalah web yang awalnya mengirim halaman kosong, lalu isinya "diisi belakangan" oleh JavaScript di browser pengunjung. Bagi manusia hasilnya terlihat sama. Tapi bagi mesin, ini seperti menerima amplop kosong yang baru diisi setelah dibuka.
Kenapa SPA sulit muncul di Google?
- Google membaca isinya belakangan. Google memproses halaman dalam tiga tahap: mengunjungi, menjalankan JavaScript, lalu mencatat. Halaman SPA harus antre dulu di tahap kedua, jadi lebih lambat masuk Google.
- Tidak semua "pembaca" menjalankan JavaScript. Pratinjau link di WhatsApp, Telegram, dan media sosial umumnya hanya membaca halaman awal. Karena halaman awalnya kosong, judul dan gambar tidak muncul. Google sendiri menyarankan agar isi halaman sudah disiapkan dari server.
- Alamat memakai tanda pagar. Alamat seperti
/#artikeltidak dianggap halaman terpisah oleh Google. Sebaiknya setiap artikel punya alamat sendiri, misalnya/artikel/judul-artikel. - Semua halaman berjudul sama. Kalau judul dan deskripsinya sama semua, hasil pencarian terlihat seragam dan tidak menarik diklik.
Solusinya: isi amplop sebelum dikirim
Cloudflare Pages punya fitur Pages Functions, yaitu program kecil yang berjalan di server sebelum halaman dikirim ke pengunjung. Program ini membaca alamat yang diminta (misalnya /artikel/judul-artikel), mengambil data artikel dari database, lalu menuliskan judul, deskripsi, gambar, dan isi artikel langsung ke halaman. Jadi Google dan WhatsApp menerima "amplop yang sudah terisi". Setelah itu, web SPA Anda tetap berjalan seperti biasa.
Istilah yang perlu Anda tahu
- Slug: bagian alamat yang mewakili judul, misalnya
cara-beli-domain. - Meta tag: "label" tersembunyi di halaman yang dibaca Google dan WhatsApp, berisi judul, deskripsi, dan gambar pratinjau. Yang diawali
og:dipakai untuk pratinjau link. - Sitemap: daftar semua halaman situs Anda, supaya Google tahu halaman apa saja yang ada.
Langkah 1: Beri setiap artikel alamat sendiri
Tambahkan kolom slug di tabel artikel. Slug dibuat dari judul (huruf kecil, spasi diganti tanda minus). Sebaiknya slug tidak diubah walau judul diedit, supaya link lama tidak rusak.
alter table news add column slug text unique; alter table news add column updated_at timestamptz default now();
Langkah 2: Susun folder
public/ -> index.html, assets/, img/, _routes.json functions/ [[path]].js -> menangkap semua alamat _lib/handler.js -> kode pengisi judul dan isi wrangler.toml
File bernama [[path]].js (dengan dua kurung siku) artinya "tangkap semua alamat apa pun". Folder yang namanya diawali garis bawah, seperti _lib, tidak dianggap alamat, jadi aman untuk menyimpan kode bantu.
Langkah 3: Biarkan gambar dan file lain lewat langsung
File gambar, CSS, dan JavaScript tidak perlu diproses program. Selain lebih cepat, ini juga hemat, karena akses file biasa di Cloudflare gratis tanpa batas, sedangkan setiap kali program dijalankan dihitung ke jatah gratis harian (100.000 kali per hari). Tulis aturannya di public/_routes.json:
{
"version": 1,
"include": ["/*"],
"exclude": ["/assets/*", "/img/*"]
}
Artinya: semua alamat diproses program, kecuali yang ada di folder assets dan img.
Langkah 4: Program pengisi halaman
Berikut versi sederhananya. Program ini mengambil index.html, mencari artikel sesuai slug, lalu mengisi judul, deskripsi, gambar, dan isi artikel:
// functions/[[path]].js
const SB = 'https://ID-PROJECT.supabase.co';
export async function onRequest({ request, env }) {
const url = new URL(request.url);
const shell = await (await env.ASSETS.fetch(new URL('/', url).href)).text();
const m = url.pathname.match(/^\/artikel\/([a-z0-9-]+)$/);
if (!m) return html(shell, 200);
const res = await fetch(`${SB}/rest/v1/news?select=*&status=eq.Active&slug=eq.${m[1]}`,
{ headers: { apikey: env.SUPABASE_KEY } });
const [a] = await res.json();
if (!a) return html(shell.replace('<head>', '<head><meta name="robots" content="noindex">'), 404);
const desc = esc(a.content.replace(/<[^>]+>/g, '').slice(0, 155));
const head = `<title>${esc(a.title)}</title>
<meta name="description" content="${desc}">
<link rel="canonical" href="${url.origin}${url.pathname}">
<meta property="og:title" content="${esc(a.title)}">
<meta property="og:description" content="${desc}">
<meta property="og:image" content="${url.origin}${a.thumbnail}">
<meta property="og:type" content="article">`;
const body = `<article id="ssr-root"><h1>${esc(a.title)}</h1>${a.content}</article>`;
return html(shell.replace(/<title>.*?<\/title>/, head).replace('<!--SSR-->', body), 200);
}
const esc = s => String(s).replace(/[&<>"]/g, c => `&#${c.charCodeAt(0)};`);
const html = (b, status) => new Response(b, { status,
headers: { 'Content-Type': 'text/html; charset=utf-8',
'Cache-Control': 'public, max-age=0, s-maxage=300' } });
Cara membacanya: kalau alamatnya /artikel/sesuatu, program mencari artikel dengan slug itu di database. Kalau tidak ketemu, kirim kode 404 (tidak ditemukan) dan minta Google tidak mencatatnya. Kalau ketemu, judul dan isi artikel ditulis ke halaman. Contoh ini memakai Supabase, tapi idenya sama untuk database lain.
Taruh tanda <!--SSR--> di index.html pada tempat isi artikel biasanya tampil. Simpan kunci database di menu Settings > Variables project Pages Anda.
Langkah 5: Hal yang sering terlupa
- Bersihkan isi artikel. Buang kode berbahaya seperti
<script>daniframesebelum isi artikel ditulis ke halaman. - Pakai kode status yang benar. Artikel yang tidak ada harus menjawab 404. Kalau database sedang bermasalah, jawab 503 supaya Google mencoba lagi nanti, bukan menghapus halaman Anda dari hasil pencarian.
- Satu artikel, satu alamat. Alihkan alamat ganda (misalnya domain lama atau garis miring di akhir) ke alamat utama.
- Buat sitemap otomatis. Layani
/sitemap.xmldari program yang sama, supaya artikel baru langsung masuk daftar. - Simpan sementara (cache). Pengaturan
s-maxage=300menyimpan halaman selama 5 menit, jadi database tidak diakses setiap kali ada kunjungan.
Langkah 6: Unggah dan cek hasilnya
Unggah lewat GitHub atau perintah npx wrangler pages deploy public, jangan seret-lepas (drag-and-drop) di dashboard, karena folder functions harus ikut terunggah. Setelah itu cek di terminal:
curl -s https://domainanda.com/artikel/slug-artikel | head -40
Kalau judul artikel sudah terlihat di hasilnya, berarti Google dan WhatsApp juga bisa melihatnya. Langkah berikutnya adalah mendaftarkan situs ke Google (lihat artikel cara daftar Google Search Console).
Sumber: JavaScript SEO basics, Google Search Central, Functions routing, Cloudflare Pages, dan Functions pricing, Cloudflare Pages.