{"id":3206,"date":"2026-11-20T07:58:09","date_gmt":"2026-11-20T00:58:09","guid":{"rendered":"https:\/\/komunitech.com\/blog\/?p=3206"},"modified":"2026-11-20T07:58:09","modified_gmt":"2026-11-20T00:58:09","slug":"audit-auto-fix-internal-linking-python-gemini-api","status":"publish","type":"post","link":"https:\/\/komunitech.com\/blog\/tutorial\/audit-auto-fix-internal-linking-python-gemini-api\/","title":{"rendered":"Audit &#038; Auto-Fix Internal Linking Menggunakan Python + Gemini API: Cara Memetakan Topical Authority dari Ratusan Artikel WordPress dan Menyuntikkan Internal Link Kontekstual Secara Otomatis Tanpa Merusak Struktur HTML"},"content":{"rendered":"<p><strong>TL;DR:<\/strong> Kalau situsmu sudah ratusan artikel, internal link manual satu-satu tidak akan pernah selesai \u2014 dan kamu tidak tahu artikel mana yang yatim alias tidak punya satu pun inbound link. Artikel ini membangun skrip Python yang menarik semua artikel WordPress lewat REST API, memetakan klaster topik dan artikel yatim, lalu memakai Gemini API buat menilai pasangan artikel yang relevan dan menyuntikkan link-nya ke HTML dengan BeautifulSoup. Semua jalan dalam mode dry-run dulu, dengan backup, sebelum ada perubahan yang ditulis balik.<\/p>\n<blockquote>\n<p><strong>\ud83d\udca1 Key Takeaway<\/strong><\/p>\n<ul>\n<li><strong>Internal link itu peta topical authority.<\/strong> Link internal membantu crawler menemukan halaman, menyalurkan otoritas dari halaman kuat, dan memberi sinyal hubungan antar topik.<\/li>\n<li><strong>REST API WordPress mengembalikan maksimal 100 artikel per request.<\/strong> Baca totalnya dari header <code>X-WP-TotalPages<\/code>, lalu looping dengan <code>per_page=100<\/code> dan <code>_fields<\/code>.<\/li>\n<li><strong>Gemini menilai relevansi lewat structured output.<\/strong> Skema Pydantic memaksa jawaban selalu berbentuk JSON yang bisa diparse.<\/li>\n<li><strong>Injeksi yang aman cuma di dalam <code>&lt;p&gt;<\/code> yang belum punya link.<\/strong> Jangan sentuh heading, code block, atau link yang sudah ada; anchor harus frasa yang sudah tertulis di teks.<\/li>\n<li><strong>Dry-run dan backup dulu, selalu.<\/strong> Skor Gemini itu pendapat model, bukan kebenaran \u2014 review laporan sebelum menulis balik.<\/li>\n<\/ul>\n<\/blockquote>\n<h2>Ratusan artikel, nol peta: kenapa internal link-mu mungkin berantakan<\/h2>\n<p>Bayangin blog WordPress dengan 500 artikel. Setiap kali ada artikel baru, penulisnya menambahkan dua-tiga internal link dari ingatan \u2014 artikel yang dia ingat atau kebetulan muncul di pencarian wp-admin. Setelah dua tahun, artikel pilar yang seharusnya jadi pusat topik malah sepi inbound link, sementara sepuluh artikel acak saling menautkan tanpa pola. Ada juga artikel bagus yang tidak pernah ditautkan dari mana pun. Di dunia SEO, artikel seperti itu disebut orphan page.<\/p>\n<p>Masalahnya bukan cuma soal kerapian. Crawler Google menemukan halaman lewat link \u2014 artikel tanpa inbound link internal jauh lebih lambat ditemukan dan diindeks, dan pembaca pun praktis tidak pernah sampai ke sana. Membereskannya manual itu pekerjaan berminggu-minggu. Automasi masuk akal justru di sini: memindai seluruh situs, menghitung siapa menautkan siapa, lalu mengusulkan pasangan artikel yang relevan berdasarkan isi, bukan ingatan.<\/p>\n<h2>Kenapa internal link itu soal authority, bukan cuma navigasi<\/h2>\n<p>Banyak orang mengira internal link cuma soal kenyamanan pembaca \u2014 benar, tapi cuma sepertiga ceritanya. Buat mesin pencari, internal link punya tiga fungsi sekaligus. <strong>Pertama, discovery:<\/strong> crawler menemukan halaman baru dengan mengikuti link dari halaman yang sudah dikenal. <strong>Kedua, distribusi authority:<\/strong> halaman yang sudah kuat &#8220;mengalirkan&#8221; sebagian otoritasnya ke halaman yang ditautkannya, sehingga artikel pilar bisa mengangkat seluruh klaster. <strong>Ketiga, sinyal topikal:<\/strong> anchor text dan konteks paragraf di sekitar link memberi tahu Google bahwa dua halaman itu berhubungan. Inilah inti topical authority: bukan satu artikel yang hebat, tapi satu jaringan artikel yang saling menguatkan.<\/p>\n<table>\n<tbody>\n<tr>\n<th><strong>Peran<\/strong><\/th>\n<th><strong>Cirinya<\/strong><\/th>\n<th><strong>Yang harus dilakukan<\/strong><\/th>\n<\/tr>\n<tr>\n<td>Halaman pilar<\/td>\n<td>Membahas topik luas, jadi rujukan utama satu klaster<\/td>\n<td>Ditaautkan dari semua artikel pendukung di klasternya<\/td>\n<\/tr>\n<tr>\n<td>Artikel pendukung<\/td>\n<td>Membahas sub-topik spesifik, menautkan balik ke pilar<\/td>\n<td>Dapat 1\u20133 link dari artikel lain di klaster yang sama<\/td>\n<\/tr>\n<tr>\n<td>Artikel yatim (orphan)<\/td>\n<td>Tidak punya satu pun inbound link internal<\/td>\n<td>Prioritas pertama audit \u2014 cari pasangan yang relevan dan tautkan<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Topical authority bukan metrik resmi Google \u2014 ini kerangka kerja praktisi SEO, yang makin relevan di era AI search, seperti dibahas di artikel soal <a href=\"https:\/\/komunitech.com\/blog\/karir-skill\/geo-aeo-aio-adalah-perbedaan-dengan-seo\/\">perbedaan SEO, AEO, GEO, dan AIO<\/a>.<\/p>\n<h2>Langkah 1: tarik semua artikel dari WordPress lewat REST API<\/h2>\n<p>Semua bermula dari satu pertanyaan: artikel apa saja yang ada di situs ini, dan apa isinya? WordPress sudah menyediakan jawabannya lewat REST API bawaan: endpoint <code>GET \/wp\/v2\/posts<\/code> mengembalikan daftar artikel sebagai JSON, lengkap dengan judul, slug, URL, dan kategori. Artikel publik bisa dibaca tanpa login; yang butuh autentikasi cuma write-back nanti.<\/p>\n<p>Ada dua detail yang wajib kamu pegang. <strong>Pertama, pagination.<\/strong> REST API mengembalikan maksimal 10 artikel per request secara default, dan parameter <code>per_page<\/code> dibatasi 1 sampai 100 \u2014 minta lebih dari itu dan server menjawab HTTP 400. Setiap respons paginasi membawa dua header penting: <code>X-WP-Total<\/code> dan <code>X-WP-TotalPages<\/code> \u2014 baca dari respons pertama, lalu looping halaman demi halaman sampai selesai. <strong>Kedua, ringankan responsnya.<\/strong> Field <code>content.rendered<\/code> itu besar; parameter <code>_fields<\/code> membatasi field yang dikembalikan \u2014 cukup <code>id,slug,link,title,categories,content<\/code> buat audit ini. Kalau WordPress-mu terpasang di subdirektori seperti <code>\/blog<\/code>, endpoint-nya ikut di sana, misalnya <code>https:\/\/situsmu.com\/blog\/wp-json\/wp\/v2\/posts<\/code>.<\/p>\n<h2>Langkah 2: petakan topical authority-mu \u2014 siapa yatim, siapa pilar<\/h2>\n<p>Setelah semua artikel ketarik, jangan langsung menilai relevansi \u2014 itu tugas Gemini nanti. Hitung dulu siapa menautkan siapa. Setiap <code>content.rendered<\/code> adalah HTML; parse dengan BeautifulSoup dan hitung berapa inbound link yang diterima tiap artikel. Artikel dengan inbound nol itulah daftar yatimmu \u2014 prioritas pertama audit. Fungsi <code>hitung_inbound<\/code> di skrip lengkap melakukan itu: URL dinormalisasi dengan membuang garis miring di akhir, dan self-link sengaja tidak dihitung. Satu keterbatasan: fungsi ini cuma menghitung link absolut \u2014 kalau situsmu memakai link relatif, normalisasi dulu semua href.<\/p>\n<p>Dari hitungan ini, peta situsmu langsung terlihat: sebagian besar artikel pendukung punya 1\u20133 inbound link, dan 10\u201320% tidak punya inbound sama sekali \u2014 angka kasar dari pengalaman audit, bukan kutipan penelitian. Klaster topiknya bisa dipetakan dari kategori WordPress dan kata kunci judul. Fungsi <code>shortlist<\/code> di skrip lengkap melakukan itu: ambil kata kunci judul, beri skor tumpang tindih kata plus bonus kategori sama, lalu ambil 8 kandidat teratas per artikel \u2014 makin sedikit kandidat yang dikirim ke Gemini, makin murah.<\/p>\n<h2>Langkah 3: biar Gemini yang menilai relevan atau tidak<\/h2>\n<p>Pencocokan kata kunci cuma bisa bilang &#8220;judulnya mirip&#8221; \u2014 dia tidak bisa bilang apakah artikel A benar-benar membantu pembaca artikel B \u2014 penilaian seperti itu butuh membaca, dan di sinilah model bahasa masuk: kirim judul plus cuplikan isi artikel sumber dan 8 kandidatnya ke Gemini, lalu minta dia mengembalikan pasangan yang benar-benar relevan sebagai JSON. Kuncinya: structured output lewat skema Pydantic \u2014 tanpa ini, satu respons nyasar saja sudah cukup merusak seluruh jalan skrip.<\/p>\n<p>Model yang dipakai sengaja yang murah: <code>gemini-3.8-flash<\/code> \u2014 menilai relevansi itu tugas klasifikasi ringan, tidak butuh penalaran berlapis model paling mahal. Harga per 20 November 2026, dari halaman pricing resmi Google (Gemini 4 Carbon harganya sama dengan Argon):<\/p>\n<table>\n<tbody>\n<tr>\n<th><strong>Model<\/strong><\/th>\n<th><strong>Input \/ 1 jt token<\/strong><\/th>\n<th><strong>Output \/ 1 jt token<\/strong><\/th>\n<th><strong>Cache baca \/ 1 jt token<\/strong><\/th>\n<\/tr>\n<tr>\n<td>Gemini 3.8 Flash<\/td>\n<td>$0,75 s.d. 31 Des 2026, lalu $1,50 mulai 1 Jan 2027<\/td>\n<td>$3,75 s.d. 31 Des 2026, lalu $7,50 mulai 1 Jan 2027<\/td>\n<td>$0,075 s.d. 31 Des 2026, lalu $0,15 mulai 1 Jan 2027<\/td>\n<\/tr>\n<tr>\n<td>Gemini 4 Argon<\/td>\n<td>$2,00 s.d. 30 Nov 2026, lalu $4,00 mulai 1 Des 2026<\/td>\n<td>$10,00 s.d. 30 Nov 2026, lalu $20,00 mulai 1 Des 2026<\/td>\n<td>$0,10 s.d. 30 Nov 2026, lalu $0,20 mulai 1 Des 2026<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Harga di atas adalah foto per 20 November 2026 \u2014 Argon dan Carbon naik dua kali lipat per 1 Desember 2026, Flash naik per 1 Januari 2027. Cek halaman pricing Google sebelum menghitung anggaran. Batch API memberi diskon 50% buat pekerjaan yang tidak butuh jawaban seketika, seperti dibahas di artikel soal <a href=\"https:\/\/komunitech.com\/blog\/tutorial\/7-fitur-gemini-api-yang-jarang-dipakai-tapi-bikin-agent-lebih-murah-2026\/\">tujuh fitur Gemini API yang jarang dipakai<\/a>. Terakhir: skor Gemini itu pendapat model, bukan kebenaran \u2014 karena itu ada ambang skor 70, batas 3 link baru per artikel, dan laporan buat direview.<\/p>\n<h2>Aturan injeksi yang aman: jangan rusak HTML yang sudah bagus<\/h2>\n<p>Menilai relevansi itu separuh pekerjaan. Separuh lainnya adalah menyuntikkan link ke HTML tanpa merusaknya, dan godaan terbesar di sini adalah regex. Regex tidak paham struktur HTML: dia bisa menyisipkan link di dalam atribut <code>alt<\/code> gambar, memotong tag yang sedang terbuka, atau membuat link bersarang. Karena itu injeksi harus dilakukan di level parse tree. Aturannya:<\/p>\n<table>\n<tbody>\n<tr>\n<th><strong>Aturan<\/strong><\/th>\n<th><strong>Kenapa<\/strong><\/th>\n<\/tr>\n<tr>\n<td>Hanya di dalam <code>&lt;p&gt;<\/code><\/td>\n<td>Paragraf adalah tempat link kontekstual tinggal; heading, list, dan tabel bukan tempatnya<\/td>\n<\/tr>\n<tr>\n<td>Jangan sentuh teks di dalam <code>&lt;a&gt;<\/code>, <code>&lt;code&gt;<\/code>, dan <code>&lt;pre&gt;<\/code><\/td>\n<td>Link bersarang tidak valid; anchor di dalam contoh kode merusak kode itu sendiri<\/td>\n<\/tr>\n<tr>\n<td>Anchor harus frasa yang sudah ada di teks<\/td>\n<td>Menambah kata baru ke kalimat berarti mengubah tulisan penulis \u2014 bukan tugas skrip audit<\/td>\n<\/tr>\n<tr>\n<td>Jangan self-link, satu pasangan cuma sekali<\/td>\n<td>Artikel menautkan ke dirinya sendiri tidak membantu siapa pun; menautkan artikel yang sama dua kali itu spam<\/td>\n<\/tr>\n<tr>\n<td>Maksimal 3 link baru per artikel per jalan<\/td>\n<td>Artikel yang tiba-tiba dapat 10 link baru terlihat seperti dipompa, bukan dirapikan<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Fungsi <code>injeksi<\/code> di skrip lengkap bekerja begini: untuk tiap rencana link, cari paragraf pertama yang belum punya link dan mengandung frasa anchor, lalu pecah node teks itu jadi tiga bagian dan ganti bagian tengah dengan tag <code>&lt;a&gt;<\/code> baru. Kalau frasa anchor tidak ditemukan persis di teks mana pun, lewati saja \u2014 lebih baik satu link hilang daripada satu kalimat rusak.<\/p>\n<h2>Skrip lengkapnya: audit, skor, injeksi, laporan<\/h2>\n<p>Semua fungsi di atas dirangkai jadi satu file, <code>audit_link.py<\/code>: tarik artikel, hitung inbound, lewati artikel yang inbound-nya sudah 3 atau lebih, shortlist kandidat, skor dengan Gemini, saring skor di bawah 70, injeksi maksimal 3 link, simpan backup, lalu \u2014 hanya dengan flag <code>--apply<\/code> \u2014 tulis balik ke WordPress lewat <code>POST \/wp\/v2\/posts\/&lt;id&gt;<\/code> dengan Application Password. Tanpa flag itu, skrip cuma menulis laporan JSON.<\/p>\n<p>Yang perlu disiapkan: Python 3.10+, <code>pip install requests beautifulsoup4 google-genai pydantic<\/code>, dan kunci API Gemini di <code>GEMINI_API_KEY<\/code>. Buat write-back, buat Application Password di wp-admin dan simpan di <code>WP_APP_PASSWORD<\/code>. Satu hal yang wajib ditegaskan: <strong>skrip di bawah disusun mengikuti dokumentasi resmi, tapi belum dieksekusi terhadap situs produksi mana pun saat artikel ini ditulis.<\/strong> Jalankan dulu dengan dry-run di situs staging, atau baca laporan JSON-nya sebelum memakai <code>--apply<\/code>.<\/p>\n<pre><code>#!\/usr\/bin\/env python3\r\n\"\"\"Audit &amp; auto-fix internal linking WordPress.\r\nDefault: dry-run. Tulis balik hanya dengan --apply.\r\n\"\"\"\r\nimport argparse\r\nimport json\r\nimport os\r\nimport re\r\nimport time\r\nfrom pathlib import Path\r\n\r\nimport requests\r\nfrom bs4 import BeautifulSoup, NavigableString\r\nfrom google import genai\r\nfrom pydantic import BaseModel, Field\r\n\r\nMODEL = \"gemini-3.8-flash\"\r\nMAX_NEW_LINKS = 3\r\nMIN_SKOR = 70\r\n\r\n\r\nclass Penilaian(BaseModel):\r\n    url: str = Field(description=\"URL target\")\r\n    anchor: str = Field(description=\"Frasa di teks sumber\")\r\n    skor: int = Field(description=\"Skor 0-100\")\r\n\r\n\r\nclass HasilSkor(BaseModel):\r\n    penilaian: list[Penilaian]\r\n\r\n\r\ndef teks_bersih(html):\r\n    return BeautifulSoup(html, \"html.parser\").get_text(\" \", strip=True)\r\n\r\n\r\ndef fetch_all_posts(base_url):\r\n    posts, page = [], 1\r\n    while True:\r\n        r = requests.get(\r\n            f\"{base_url}\/wp-json\/wp\/v2\/posts\",\r\n            params={\"per_page\": 100, \"page\": page,\r\n                    \"_fields\": \"id,slug,link,title,categories,content\"})\r\n        r.raise_for_status()\r\n        posts.extend(r.json())\r\n        total_pages = int(r.headers.get(\"X-WP-TotalPages\", 1))\r\n        if page &gt;= total_pages:\r\n            break\r\n        page += 1\r\n        time.sleep(0.2)\r\n    return posts\r\n\r\n\r\ndef hitung_inbound(posts):\r\n    inbound = {p[\"id\"]: 0 for p in posts}\r\n    url_ke_id = {p[\"link\"].rstrip(\"\/\"): p[\"id\"] for p in posts}\r\n    for p in posts:\r\n        soup = BeautifulSoup(p[\"content\"][\"rendered\"], \"html.parser\")\r\n        for a in soup.find_all(\"a\", href=True):\r\n            target = a[\"href\"].rstrip(\"\/\")\r\n            if target in url_ke_id and url_ke_id[target] != p[\"id\"]:\r\n                inbound[url_ke_id[target]] += 1\r\n    return inbound\r\n\r\n\r\ndef kata_kunci(teks):\r\n    stop = {\"dan\", \"yang\", \"untuk\", \"dengan\", \"dari\", \"cara\", \"atau\", \"ini\", \"itu\"}\r\n    return {k for k in re.findall(r\"[a-z]{4,}\", teks.lower())\r\n            if k not in stop}\r\n\r\n\r\ndef shortlist(sumber, posts, maksimal=8):\r\n    kunci_sumber = kata_kunci(sumber[\"title\"][\"rendered\"])\r\n    calon = []\r\n    for p in posts:\r\n        if p[\"id\"] == sumber[\"id\"]:\r\n            continue\r\n        tumpang = len(kunci_sumber &amp; kata_kunci(p[\"title\"][\"rendered\"]))\r\n        sama_kategori = bool(set(sumber[\"categories\"]) &amp; set(p[\"categories\"]))\r\n        if tumpang &gt;= 1 or sama_kategori:\r\n            calon.append((tumpang + (1 if sama_kategori else 0), p))\r\n    calon.sort(key=lambda x: x[0], reverse=True)\r\n    return [p for _, p in calon[:maksimal]]\r\n\r\n\r\ndef skor_kandidat(client, sumber, calon):\r\n    ringkas = lambda p: (\r\n        f\"- {p['title']['rendered']} ({p['link']}): \"\r\n        f\"{teks_bersih(p['content']['rendered'])[:400]}\")\r\n    prompt = (\r\n        \"Nilai relevansi kandidat sebagai target internal link \"\r\n        \"dari artikel sumber. Kembalikan hanya pasangan yang benar-benar \"\r\n        \"relevan. Anchor harus frasa yang sudah ada di teks sumber.nn\"\r\n        f\"SUMBER: {sumber['title']['rendered']}n\"\r\n        f\"{teks_bersih(sumber['content']['rendered'])[:1200]}nn\"\r\n        \"KANDIDAT:n\" + \"n\".join(ringkas(p) for p in calon))\r\n    inter = client.interactions.create(\r\n        model=MODEL, input=prompt,\r\n        response_format={\"type\": \"text\", \"mime_type\": \"application\/json\",\r\n                         \"schema\": HasilSkor.model_json_schema()})\r\n    return HasilSkor.model_validate_json(inter.output_text).penilaian\r\n\r\n\r\ndef sisipkan_satu(paragraf, anchor, url, soup):\r\n    for node in list(paragraf.descendants):\r\n        if not isinstance(node, NavigableString):\r\n            continue\r\n        if any(a.name in (\"a\", \"code\", \"pre\") for a in node.parents):\r\n            continue\r\n        cocok = re.search(re.escape(anchor), str(node), re.IGNORECASE)\r\n        if not cocok:\r\n            continue\r\n        teks = str(node)\r\n        tautan = soup.new_tag(\"a\", href=url)\r\n        tautan.string = teks[cocok.start():cocok.end()]\r\n        node.replace_with(teks[:cocok.start()], tautan, teks[cocok.end():])\r\n        return True\r\n    return False\r\n\r\n\r\ndef injeksi(html, rencana):\r\n    soup = BeautifulSoup(html, \"html.parser\")\r\n    dipakai = set()\r\n    for item in rencana:\r\n        if item.url in dipakai:\r\n            continue\r\n        for p in soup.find_all(\"p\"):\r\n            if p.find(\"a\"):\r\n                continue\r\n            if sisipkan_satu(p, item.anchor, item.url, soup):\r\n                dipakai.add(item.url)\r\n                break\r\n    return str(soup)\r\n\r\n\r\ndef main():\r\n    ap = argparse.ArgumentParser()\r\n    ap.add_argument(\"--site\", required=True)\r\n    ap.add_argument(\"--out\", default=\"laporan-link.json\")\r\n    ap.add_argument(\"--apply\", action=\"store_true\")\r\n    ap.add_argument(\"--user\", default=\"\")\r\n    args = ap.parse_args()\r\n\r\n    client = genai.Client()\r\n    posts = fetch_all_posts(args.site)\r\n    inbound = hitung_inbound(posts)\r\n    laporan = []\r\n\r\n    for p in posts:\r\n        if inbound[p[\"id\"]] &gt;= 3:\r\n            continue\r\n        calon = shortlist(p, posts)\r\n        if not calon:\r\n            continue\r\n        nilai = sorted([x for x in skor_kandidat(client, p, calon)\r\n                        if x.skor &gt;= MIN_SKOR],\r\n                       key=lambda x: x.skor, reverse=True)\r\n        rencana = nilai[:MAX_NEW_LINKS]\r\n        if not rencana:\r\n            continue\r\n        html_baru = injeksi(p[\"content\"][\"rendered\"], rencana)\r\n        Path(\"backup\").mkdir(exist_ok=True)\r\n        Path(f\"backup\/{p['id']}.html\").write_text(\r\n            p[\"content\"][\"rendered\"], encoding=\"utf-8\")\r\n        if args.apply:\r\n            app_pw = os.environ[\"WP_APP_PASSWORD\"]\r\n            r = requests.post(\r\n                f\"{args.site}\/wp-json\/wp\/v2\/posts\/{p['id']}\",\r\n                auth=(args.user, app_pw),\r\n                json={\"content\": html_baru})\r\n            r.raise_for_status()\r\n        laporan.append({\r\n            \"id\": p[\"id\"], \"slug\": p[\"slug\"],\r\n            \"inbound_lama\": inbound[p[\"id\"]],\r\n            \"link_baru\": [{\"url\": x.url, \"anchor\": x.anchor,\r\n                           \"skor\": x.skor} for x in rencana],\r\n            \"ditulis_balik\": bool(args.apply)})\r\n\r\n    Path(args.out).write_text(\r\n        json.dumps(laporan, indent=2, ensure_ascii=False), encoding=\"utf-8\")\r\n    print(f\"{len(posts)} artikel dipindai, \"\r\n          f\"{len(laporan)} artikel dapat link baru.\")\r\n\r\n\r\nif __name__ == \"__main__\":\r\n    main()<\/code><\/pre>\n<p>Cara menjalankannya: pertama <code>python audit_link.py --site https:\/\/situsmu.com\/blog<\/code> buat dry-run. Buka <code>laporan-link.json<\/code> dan periksa pasangan link yang diusulkan \u2014 buka artikel sumber dan targetnya, pastikan tautannya masuk akal. Kalau sudah yakin, jalankan lagi dengan <code>--apply --user nama-user-wp<\/code>. Dan ingat pelajaran dari produksi blog Komunitech, yang didokumentasikan di artikel soal <a href=\"https:\/\/komunitech.com\/blog\/riset\/ai-agent-untuk-konten-seo-alur-riset-sampai-terbit-2026\/\">AI Agent untuk konten SEO<\/a>: jangan pernah membiarkan mesin menebak URL \u2014 semua URL target di skrip ini berasal dari daftar artikel yang sudah terverifikasi lewat REST API, bukan dari ingatan model.<\/p>\n<h2>Berapa biayanya buat 500 artikel?<\/h2>\n<p>Asumsinya: 500 artikel, tiap artikel dibandingkan dengan maksimal 8 kandidat tapi rata-rata cuma 5 yang lolos shortlist. Satu panggilan Gemini membawa judul plus cuplikan sumber (sekitar 300 token), 5 kandidat (sekitar 750 token), dan instruksi prompt (sekitar 150 token) \u2014 total sekitar 1.200 token input dan 150 output. Perkiraan token di sini kasar, tapi cukup buat mengukur orde biayanya.<\/p>\n<table>\n<tbody>\n<tr>\n<th><strong>Komponen<\/strong><\/th>\n<th><strong>Hitungan<\/strong><\/th>\n<th><strong>Gemini 3.8 Flash<\/strong><\/th>\n<th><strong>Gemini 4 Argon<\/strong><\/th>\n<\/tr>\n<tr>\n<td>Token input<\/td>\n<td>2.500 \u00d7 1.200 \u2248 3,0 juta token<\/td>\n<td>3,0 \u00d7 $0,75 = $2,25<\/td>\n<td>3,0 \u00d7 $2,00 = $6,00<\/td>\n<\/tr>\n<tr>\n<td>Token output<\/td>\n<td>2.500 \u00d7 150 \u2248 375 ribu token<\/td>\n<td>0,375 \u00d7 $3,75 = $1,41<\/td>\n<td>0,375 \u00d7 $10,00 = $3,75<\/td>\n<\/tr>\n<tr>\n<td><strong>Total satu audit penuh<\/strong><\/td>\n<td><strong>Harga per 20 Nov 2026<\/strong><\/td>\n<td><strong>\u2248 $3,66<\/strong><\/td>\n<td><strong>\u2248 $9,75<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Jadi satu audit penuh buat 500 artikel biayanya sekitar $3,66 dengan Flash. Pakai Batch API (diskon 50%) dan angkanya turun ke sekitar $1,80, dengan catatan hasilnya tidak instan. Bandingkan dengan biaya manusianya: satu artikel butuh 10 menit buat dibaca dan diputuskan tautannya \u2014 500 artikel itu 83 jam kerja. Catatan: angka di atas memakai harga Flash sebelum kenaikan 1 Januari 2027 \u2014 setelah tanggal itu, total yang sama jadi sekitar $7,30.<\/p>\n<h2>Kalau mentok: troubleshooting<\/h2>\n<table>\n<tbody>\n<tr>\n<th><strong>Gejala<\/strong><\/th>\n<th><strong>Kemungkinan penyebab<\/strong><\/th>\n<th><strong>Perbaikannya<\/strong><\/th>\n<\/tr>\n<tr>\n<td>401 \/ 403 saat <code>--apply<\/code><\/td>\n<td>Application Password salah, atau user tidak punya izin edit<\/td>\n<td>Buat ulang Application Password; pastikan user berperan Editor atau Administrator<\/td>\n<\/tr>\n<tr>\n<td>400 saat menarik artikel<\/td>\n<td><code>per_page<\/code> di atas 100, atau <code>page<\/code> melebihi total<\/td>\n<td>Batasi <code>per_page<\/code> ke 100; berhenti berdasarkan header <code>X-WP-TotalPages<\/code><\/td>\n<\/tr>\n<tr>\n<td>Respons Gemini tidak bisa diparse<\/td>\n<td>Skema tidak terkirim atau model mengembalikan teks di luar JSON<\/td>\n<td>Pastikan <code>response_format<\/code> terisi; coba sekali lagi lalu lewati pasangan itu<\/td>\n<\/tr>\n<tr>\n<td>429 dari Gemini API<\/td>\n<td>Terlalu banyak panggilan dalam waktu singkat<\/td>\n<td>Tambahkan <code>time.sleep()<\/code> antar panggilan, atau pindah ke Batch API<\/td>\n<\/tr>\n<tr>\n<td>Link tidak tersisip padahal skornya tinggi<\/td>\n<td>Anchor tidak ditemukan persis di teks paragraf mana pun<\/td>\n<td>Normal \u2014 lewati. Jangan paksa dengan mengganti kata di kalimat<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Kapan automasi ini TIDAK cocok<\/h2>\n<p><strong>Situs kecil, di bawah 50 artikel.<\/strong> Kalau seluruh situsmu bisa dibaca dalam satu sore, kerjakan manual \u2014 kamu kenal tiap artikel dan link yang kamu pasang dengan tangan akan lebih tepat daripada skor model. <strong>Topik sensitif atau teregulasi.<\/strong> Artikel soal kesehatan, keuangan, atau hukum punya risiko kalau anchor-nya salah tempat; tetap pakai skrip buat audit dan pemetaan, tapi pasang link-nya manual satu-satu. <strong>Tidak ada proses review manusia.<\/strong> Ini yang paling penting: skrip ini dirancang dengan dry-run dan laporan justru karena hasil mesin harus dicek. Kalau rencanamu adalah menjalankan <code>--apply<\/code> lalu tidak pernah membuka laporannya, jangan jalankan skrip ini. Automasi tanpa review bukan efisiensi \u2014 itu penyerahan kendali.<\/p>\n<h2>Pertanyaan yang sering ditanya soal ini<\/h2>\n<h3>Apakah internal link otomatis bisa kena penalti Google?<\/h3>\n<p>Tidak ada penalti khusus \u2014 Google menilai hasilnya, bukan alatnya. Manipulasi itu pola berskala yang dibuat semata-mata buat memengaruhi ranking: ratusan link dengan anchor yang sama persis atau link yang tidak relevan. Selama link-nya relevan dan anchor-nya natural, Google memperlakukannya sama seperti link manual.<\/p>\n<h3>Berapa banyak internal link baru per artikel yang aman?<\/h3>\n<p>Batasnya 3 link baru per artikel per jalan \u2014 angka konservatif, bukan aturan resmi Google. Artikel yang tiba-tiba dapat 10 link baru terlihat seperti dipompa. Kalau masih ada artikel yatim, jalankan lagi bulan depan; internal linking itu perawatan rutin.<\/p>\n<h3>Apakah skor relevansi Gemini bisa dipercaya 100%?<\/h3>\n<p>Tidak. Skor itu pendapat model berdasarkan cuplikan teks \u2014 dia tidak membaca seluruh artikel. Karena itu ada ambang skor 70, batas 3 link, dan laporan JSON buat direview.<\/p>\n<h3>Apakah skrip ini bisa jalan di WordPress.com, bukan self-hosted?<\/h3>\n<p>Bagian bacanya bisa: REST API publik tersedia di WordPress.com juga. Bagian tulis baliknya beda \u2014 Application Password adalah fitur self-hosted, sementara WordPress.com memakai OAuth2. Jalankan audit secara lokal, lalu terapkan manual.<\/p>\n<h3>Kenapa tidak pakai regex saja buat menyisipkan link?<\/h3>\n<p>Karena regex tidak paham struktur HTML \u2014 dia bekerja di level string dan tidak tahu apakah frasa yang ditemukan ada di dalam tag <code>&lt;a&gt;<\/code>, atribut, blok kode, atau shortcode. BeautifulSoup bekerja di level pohon tag, jadi aturan injeksi bisa ditegakkan.<\/p>\n<h3>Berapa sering audit ini perlu dijalankan?<\/h3>\n<p>Cukup tiap ada batch artikel baru yang signifikan, atau sebulan sekali kalau publikasimu rutin. Yang berubah adalah artikel baru \u2014 berpotensi jadi target dan sumber link.<\/p>\n<h2>Penutup: peta dulu, baru suntik<\/h2>\n<p>Urutan kerja di artikel ini sengaja begitu: peta dulu, baru suntik. Kebanyakan orang yang gagal langsung loncat ke bagian menyuntikkan link, tanpa pernah tahu artikel mana yang yatim dan halaman pilar mana yang seharusnya menerima link terbanyak. Hasilnya, link-nya memang bertambah \u2014 tapi otoritasnya tidak mengalir ke mana-mana.<\/p>\n<p>Mulai dari yang kecil: jalankan dry-run di situsmu, baca laporan JSON-nya, dan lihat berapa banyak artikel yatim yang ternyata kamu punya. Review 10 pasangan pertama dengan tanganmu sendiri \u2014 kalau 8 dari 10 terasa natural, lanjutkan; kalau cuma 4 dari 10, naikkan ambang skornya atau perbaiki shortlist-nya.<\/p>\n<p>Kamu sendiri gimana \u2014 sudah pernah mengaudit internal link di situsmu, atau selama ini cuma menambahkan link dari ingatan? Ceritain di kolom komentar.<\/p>\n<h2>Sumber dan bacaan lanjutan<\/h2>\n<ul>\n<li>WordPress REST API Handbook, referensi Posts: <em><a href=\"https:\/\/developer.wordpress.org\/rest-api\/reference\/posts\/\" target=\"_blank\" rel=\"noopener\">https:\/\/developer.wordpress.org\/rest-api\/reference\/posts\/<\/a><\/em> (diakses November 2026)<\/li>\n<li>WordPress REST API Handbook, Pagination: <em><a href=\"https:\/\/developer.wordpress.org\/rest-api\/using-the-rest-api\/pagination\/\" target=\"_blank\" rel=\"noopener\">https:\/\/developer.wordpress.org\/rest-api\/using-the-rest-api\/pagination\/<\/a><\/em> (diakses November 2026)<\/li>\n<li>Dokumentasi Gemini API, halaman pricing: <em><a href=\"https:\/\/ai.google.dev\/gemini-api\/docs\/pricing\" target=\"_blank\" rel=\"noopener\">https:\/\/ai.google.dev\/gemini-api\/docs\/pricing<\/a><\/em> (diakses 20 November 2026)<\/li>\n<li>Dokumentasi Gemini API, Structured outputs: <em><a href=\"https:\/\/ai.google.dev\/gemini-api\/docs\/structured-output\" target=\"_blank\" rel=\"noopener\">https:\/\/ai.google.dev\/gemini-api\/docs\/structured-output<\/a><\/em> (diakses 20 November 2026)<\/li>\n<li>Dokumentasi BeautifulSoup 4.15.0: <em><a href=\"https:\/\/www.crummy.com\/software\/BeautifulSoup\/bs4\/doc\/\" target=\"_blank\" rel=\"noopener\">https:\/\/www.crummy.com\/software\/BeautifulSoup\/bs4\/doc\/<\/a><\/em> (diakses 20 November 2026)<\/li>\n<li>Google Search Central, SEO Starter Guide: <em><a href=\"https:\/\/developers.google.com\/search\/docs\/fundamentals\/seo-starter-guide\" target=\"_blank\" rel=\"noopener\">https:\/\/developers.google.com\/search\/docs\/fundamentals\/seo-starter-guide<\/a><\/em> (diakses November 2026)<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Ratusan artikel tanpa peta internal link itu seperti perpustakaan tanpa katalog: isinya ada, tapi Google dan pembaca tidak tahu mana yang nyambung ke mana. Artikel ini membangun skrip Python yang menarik semua artikel WordPress lewat REST API, memetakan topical authority dan artikel yatim, lalu memakai Gemini API untuk menyuntikkan internal link kontekstual secara aman \u2014 lengkap dengan mode dry-run dan backup sebelum ada yang ditulis balik.<\/p>\n","protected":false},"author":1,"featured_media":3216,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[75],"tags":[],"class_list":["post-3206","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorial"],"acf":[],"_links":{"self":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/3206","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/comments?post=3206"}],"version-history":[{"count":3,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/3206\/revisions"}],"predecessor-version":[{"id":3218,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/3206\/revisions\/3218"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/media\/3216"}],"wp:attachment":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/media?parent=3206"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/categories?post=3206"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/tags?post=3206"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}