Memahami 2 Cara Claude Code Melakukan Pencarian Online: Panduan Perbandingan WebSearch Bawaan dan 6 Plugin Pencarian MCP Utama

Catatan Penulis: Penjelasan mendalam tentang cara kerja dan batasan alat pencarian web bawaan WebSearch dan WebFetch di Claude Code, serta perbandingan dengan 6 plugin pencarian MCP utama seperti Brave Search, Tavily, dan Exa. Membantu Anda menilai apakah perlu menginstal plugin pencarian MCP tambahan.

Pencarian web Claude Code adalah topik yang banyak diperhatikan pengembang—Claude Code sudah dilengkapi dengan dua alat pencarian web bawaan, WebSearch dan WebFetch. Lalu, apakah masih perlu menginstal plugin pencarian MCP seperti Brave Search MCP, Tavily MCP, dan lainnya? Artikel ini akan menjelaskan mekanisme kerja dan skenario penggunaan kedua cara ini dari tingkat prinsip teknis, membantu Anda membuat pilihan yang paling sesuai dengan alur kerja Anda.

Nilai Inti: Setelah membaca artikel ini, Anda akan memahami dengan jelas batasan kemampuan alat bawaan dan plugin MCP untuk pencarian web Claude Code, serta skenario mana yang cocok untuk setiap solusi.

claude-code-web-search-websearch-mcp-guide-id 图示


Poin Inti Pencarian Jaringan Claude Code

Poin Penjelasan Nilai
Dilengkapi 2 alat jaringan WebSearch (pencarian) + WebFetch (ambil halaman) Siap pakai, tanpa konfigurasi
Plugin MCP pencarian opsional Brave Search, Tavily, Exa, dan 6+ lainnya Kualitas lebih tinggi, lebih banyak fitur
Cukup untuk sebagian besar skenario Pencarian sehari-hari, cek dokumentasi, verifikasi informasi Tidak perlu instalasi tambahan
MCP direkomendasikan untuk skenario spesifik Pengambilan massal, pencarian mendalam dokumentasi teknis, persyaratan privasi Pilih sesuai kebutuhan

Kesimpulan Inti Pencarian Jaringan Claude Code

Kesimpulan awal: Bagi sebagian besar pengembang, kombinasi WebSearch + WebFetch bawaan Claude Code sudah cukup untuk memenuhi kebutuhan pencarian jaringan sehari-hari, tidak perlu menginstal MCP pencarian tambahan. Namun, jika Anda memiliki persyaratan lebih tinggi untuk kualitas pencarian, kontrol hasil pencarian, atau pengambilan halaman web massal, menginstal MCP pencarian (direkomendasikan Brave Search MCP) dapat memberikan peningkatan yang signifikan.

Ini seperti bilah pencarian bawaan browser yang cukup untuk kebanyakan orang, tetapi beberapa orang akan menginstal plugin pencarian khusus untuk pengalaman yang lebih baik—kuncinya terletak pada skenario penggunaan spesifik Anda.


Penjelasan Detail Alat Pencarian Jaringan Bawaan Claude Code

Claude Code memiliki dua alat jaringan yang saling melengkapi: WebSearch bertanggung jawab untuk pencarian, WebFetch bertanggung jawab untuk mengambil konten halaman.

Alat WebSearch: Mesin Pencari

WebSearch adalah pintu masuk pencarian Claude Code, menerima kata kunci pencarian dan mengembalikan judul dan tautan halaman web yang relevan.

Parameter Penjelasan
query Kata kunci pencarian (wajib, minimal 2 karakter)
allowed_domains Hanya mengembalikan hasil dari domain yang ditentukan (opsional)
blocked_domains Mengecualikan hasil dari domain yang ditentukan (opsional)

Cara kerja WebSearch:

  1. Claude Code menerima permintaan pencarian Anda
  2. Membuat percakapan sekunder (secondary conversation), memanggil alat web_search di sisi server Anthropic
  3. Mesin pencari sisi server ini menggunakan backend yang sama dengan fungsi pencarian di Claude.ai versi web
  4. Hasil yang dikembalikan hanya berisi judul dan URL, tidak termasuk konten utama halaman

claude-code-web-search-websearch-mcp-guide-id 图示

Alat WebFetch: Pengambilan Konten Halaman

WebFetch menerima URL yang diketahui dan pertanyaan spesifik, mengambil konten halaman tersebut dan mengembalikan jawaban ringkasan yang ditargetkan untuk pertanyaan tersebut.

Parameter Penjelasan
url URL halaman target (wajib, ≤2000 karakter)
prompt Pertanyaan spesifik tentang konten halaman (wajib)

Alur pemrosesan internal WebFetch:

  1. Validasi URL: Pemeriksaan panjang, peningkatan HTTP otomatis ke HTTPS, penghapusan informasi kredensial
  2. Pemeriksaan keamanan domain: Memanggil endpoint domain_info untuk memeriksa daftar hitam, mempertimbangkan robots.txt
  3. Pengambilan halaman: Menggunakan Axios lokal, pengalihan domain yang sama dilacak otomatis, pengalihan lintas domain memerlukan penanganan terpisah
  4. Konversi konten: HTML dikonversi ke Markdown melalui pustaka Turndown, dipotong otomatis jika melebihi 100KB
  5. Ringkasan AI: Diproses oleh Claude Haiku 3.5, mengembalikan jawaban ringkasan yang ditargetkan untuk pertanyaan Anda

Detail desain kunci:

  • Cache 15 menit: URL yang sama yang diakses ulang dalam 15 menit akan menggunakan cache
  • Batas ukuran sekitar 10MB: Ukuran halaman maksimum saat pengambilan
  • Tidak mengembalikan konten asli: WebFetch hanya mengembalikan jawaban ringkasan, tidak mengembalikan HTML atau Markdown asli

🎯 Tujuan desain: Anthropic sengaja merancang untuk tidak mengembalikan konten asli, dengan tiga alasan: (1) Halaman lengkap biasanya 10-100KB, mendorong langsung ke model utama biayanya tinggi dan memenuhi konteks kode; (2) Membatasi permukaan serangan injeksi petunjuk; (3) Kepatuhan hak cipta—referensi dibatasi hingga 125 karakter.

Keterbatasan Alat Pencarian Jaringan Bawaan Claude Code

Keterbatasan Penjelasan Tingkat Dampak
Operasi dua langkah Pertama WebSearch mencari, lalu WebFetch mengambil konten ⭐⭐ Sedang
Tidak ada konten asli WebFetch hanya mengembalikan ringkasan, tidak mengembalikan HTML/Markdown asli ⭐⭐⭐ Tinggi
Hasil pencarian terbatas WebSearch mengembalikan jumlah hasil terbatas, hanya berisi judul dan URL ⭐⭐ Sedang
Pengalihan lintas domain Pengalihan lintas domain tidak dilacak otomatis, memerlukan permintaan tambahan ⭐ Rendah
Batasan platform WebSearch tidak tersedia di AWS Bedrock/Google Vertex ⭐⭐ Skenario spesifik
Tidak ada operasi massal Tidak mendukung pencarian massal atau pengambilan halaman massal ⭐⭐ Sedang

Perbandingan Plugin MCP Pencarian Jaringan untuk Claude Code

Jika alat bawaan tidak memenuhi kebutuhan, berikut adalah 6 plugin MCP pencarian utama:

Plugin MCP Fitur Inti Kuota Gratis Skenario Terbaik
Brave Search MCP Rekomendasi resmi Anthropic, indeks independen, privasi diutamakan 2.000 kali/bulan Pencarian umum, sensitif privasi
Tavily MCP Hasil dioptimalkan AI, ekstraksi konten inti otomatis 1.000 kali/bulan Dokumentasi teknis, kueri pengembangan
Exa MCP Pencarian semantik, kemampuan pencarian kode kuat Gratis & open source Pencarian kode, penelitian akademis
Perplexity Ask MCP Digerakkan LLM, jawaban komprehensif + kutipan $1/M tokens Jawaban komprehensif untuk masalah kompleks
Open-WebSearch MCP Multi-mesin open source (Bing/DuckDuckGo dll) Sepenuhnya gratis Anggaran terbatas, pencarian dasar
Firecrawl MCP Pengambilan web + pemrosesan AI, 8 alat Ada lapisan gratis Pengambilan massal, ekstraksi data

claude-code-web-search-websearch-mcp-guide-id 图示

Penjelasan Detail Brave Search MCP Pencarian Jaringan

Brave Search MCP adalah plugin MCP pencarian yang direkomendasikan secara resmi oleh Anthropic dan merupakan plugin pencarian yang paling banyak digunakan. Plugin ini termasuk dalam repositori modelcontextprotocol/servers resmi Anthropic.

Keunggulan Inti:

  • Menggunakan indeks pencarian independen Brave (bukan reseller Google/Bing), hasil pencarian lebih beragam
  • Privasi diutamakan, tidak melacak perilaku pencarian pengguna
  • Lapisan gratis 2.000 kueri per bulan, cukup untuk pengembang individu
  • Umpan balik komunitas menunjukkan kualitas pencarian lebih baik daripada WebSearch bawaan Claude Code

Penjelasan Detail Tavily MCP Pencarian Jaringan

Tavily adalah mesin pencari yang dirancang khusus untuk AI Agent, dan plugin MCP-nya sangat ahli dalam kueri dokumentasi teknis dan pengembangan.

Keunggulan Inti:

  • Hasil pencarian dioptimalkan AI, mengekstrak konten inti secara langsung
  • Mendukung ekstraksi konten (extract), peta situs (map), dan fungsi pengambilan (crawl)
  • Akurasi untuk kueri dokumentasi teknis lebih tinggi daripada mesin pencari umum
  • 1.000 kueri gratis per bulan

Perbandingan Solusi Pencarian Online Claude Code: Bawaan vs MCP

Pilih Alat Bawaan atau Plugin MCP

Kriteria Penilaian Pilih WebSearch/WebFetch Bawaan Pilih Plugin Pencarian MCP
Frekuensi Pencarian Pencarian sesekali, verifikasi informasi Pencarian intensif, riset mendalam
Kualitas Hasil Cukup untuk kebutuhan dasar Butuh kualitas lebih tinggi/lebih banyak hasil
Konten Asli Tidak butuh HTML/Markdown lengkap Butuh konten halaman lengkap
Mesin Pencari Tidak spesifik mesin pencari Butuh mesin tertentu (Brave/Google)
Operasi Batch Tidak butuh pencarian batch Butuh pencarian atau pengambilan batch
Persyaratan Privasi Tidak ada persyaratan khusus Butuh perlindungan privasi
Kesiapan Konfigurasi Tidak mau konfigurasi tambahan Mau menghabiskan 5 menit untuk konfigurasi

Cocokkan dengan skenario tipikal:

  • Cari dokumentasi API untuk pengembangan sehari-hari → Alat bawaan cukup
  • Verifikasi solusi untuk informasi error tertentu → Alat bawaan cukup
  • Tulis artikel teknis butuh riset mendalam → Rekomendasi Tavily MCP
  • Butuh pencarian dengan perlindungan privasi → Rekomendasi Brave Search MCP
  • Ambil informasi situs web kompetitor secara batch → Rekomendasi Firecrawl MCP
  • Pencarian kode dan penelitian akademik → Rekomendasi Exa MCP
  • Butuh jawaban komprehensif bukan sekadar link → Rekomendasi Perplexity MCP

💡 Saran praktis: Claude Code mendukung konfigurasi beberapa plugin pencarian MCP sekaligus, dan akan memilih alat yang paling sesuai berdasarkan konten kueri. Jika kamu peduli dengan kualitas pencarian, rekomendasi setidaknya instal satu Brave Search MCP sebagai pelengkap. Melalui APIYI apiyi.com untuk memanggil model Claude dengan logika pencarian kustom, juga bisa diimplementasikan solusi pencarian online yang lebih fleksibel.


Instalasi dan Konfigurasi Pencarian Online MCP Claude Code

Instalasi Brave Search MCP (Direkomendasikan)

Langkah 1: Dapatkan Kunci API

Kunjungi halaman Brave Search API: brave.com/search/api, daftar akun gratis untuk dapatkan Kunci API (gratis 2.000 kali/bulan).

Langkah 2: Tambahkan MCP Server

# Jalankan di terminal Claude Code
claude mcp add brave-search \
  npx -y @anthropic/mcp-brave-search \
  --api-key KUNCI_API_ANDA

Lihat metode instalasi Tavily MCP
# Dapatkan Tavily API Key: tavily.com
# Tambahkan Tavily MCP Server
claude mcp add tavily-search \
  npx -y tavily-mcp@latest \
  --api-key KUNCI_TAVILY_ANDA

Tavily tier gratis menyediakan 1.000 kueri per bulan, cocok untuk skenario pencarian dokumentasi teknis.

Lihat metode instalasi Exa MCP
# Dapatkan Exa API Key: exa.ai
# Tambahkan Exa MCP Server
claude mcp add exa-search \
  npx -y exa-mcp-server \
  --api-key KUNCI_EXA_ANDA

Exa ahli dalam pencarian semantik dan pencarian kode, cocok untuk kueri penelitian.

Manajemen Konfigurasi MCP

# Lihat MCP Servers yang sudah terinstal
claude mcp list

# Hapus MCP Server tertentu
claude mcp remove brave-search

# Konfigurasi tingkat proyek (berbagi tim)
claude mcp add --scope project brave-search \
  npx -y @anthropic/mcp-brave-search

# Konfigurasi tingkat pengguna (hanya personal, tersimpan di ~/.claude.json)
claude mcp add --scope local brave-search \
  npx -y @anthropic/mcp-brave-search \
  --api-key KUNCI_ANDA

Saran keamanan: Konfigurasi MCP yang mengandung Kunci API disarankan menggunakan --scope local disimpan di konfigurasi personal, hindari kebocoran Kunci API ke repositori proyek. Konfigurasi berbagi tim gunakan --scope project, masukkan Kunci API melalui variabel lingkungan.

Contoh Praktis Pencarian Online dengan Claude Code

Menggunakan WebSearch Bawaan

Ketika Anda mengajukan pertanyaan yang memerlukan informasi online di Claude Code, secara otomatis akan memanggil WebSearch:

# Tanyakan langsung di Claude Code
> Bantu saya cari perubahan terbaru pada Server Components di React 19

# Claude Code secara otomatis memanggil WebSearch
# Kemudian memanggil WebFetch untuk mengambil ringkasan konten halaman terkait
# Terakhir, menyintesis informasi untuk menjawab pertanyaan Anda

Menggunakan Plugin Pencarian MCP

Setelah menginstal Brave Search MCP, Claude Code akan secara otomatis memilih untuk menggunakannya di antara alat yang tersedia:

# Setelah menginstal Brave Search MCP
> Cari pengumuman keamanan Node.js terbaru

# Claude Code mungkin memilih menggunakan Brave Search MCP
# Mengembalikan hasil pencarian yang lebih kaya
# Berisi lebih banyak informasi konteks

Mencapai Pencarian Online Kustom melalui API

Jika Anda perlu mengimplementasikan kemampuan pencarian online serupa di proyek Anda sendiri, dapat dicapai melalui Claude API yang dikombinasikan dengan alat pencarian:

import openai
import requests

def search_and_analyze(query: str) -> str:
    """Menggabungkan mesin pencari dan Claude untuk mencapai analisis pencarian online"""
    # Langkah 1: Menggunakan API pencarian untuk mendapatkan hasil
    # Dapat menggunakan Brave Search API, Tavily API, dll.
    search_results = requests.get(
        "https://api.search.brave.com/res/v1/web/search",
        headers={"X-Subscription-Token": "KUNCI_BRAVE_ANDA"},
        params={"q": query, "count": 5}
    ).json()

    # Langkah 2: Memberikan hasil pencarian kepada Claude untuk dianalisis
    client = openai.OpenAI(
        api_key="KUNCI_API_ANDA",
        base_url="https://vip.apiyi.com/v1"
    )

    context = "\n".join([
        f"- {r['title']}: {r['url']}"
        for r in search_results.get("web", {}).get("results", [])
    ])

    response = client.chat.completions.create(
        model="claude-sonnet-4-6",
        messages=[
            {"role": "system", "content": "Berdasarkan hasil pencarian berikut, jawab pertanyaan pengguna."},
            {"role": "user", "content": f"Hasil pencarian:\n{context}\n\nPertanyaan: {query}"}
        ]
    )
    return response.choices[0].message.content

Saran: Melalui APIYI apiyi.com memanggil Claude API yang dikombinasikan dengan layanan pencarian seperti Brave Search API, dapat membangun solusi pencarian online yang lebih fleksibel. Platform menyediakan kuota uji coba gratis dan antarmuka yang kompatibel dengan OpenAI, cocok untuk validasi cepat solusi.


Teknik Lanjutan Pencarian Online dengan Claude Code

Teknik 1: Menggunakan Filter Domain untuk Mengoptimalkan Pencarian

WebSearch Claude Code mendukung filter domain, dapat mengontrol secara presisi ruang lingkup pencarian:

# Hanya mencari dokumentasi resmi
> Cari di docs.python.org untuk metode penggunaan asyncio

# Claude Code akan menggunakan parameter allowed_domains
# Membatasi hasil hanya dari docs.python.org

Teknik 2: Kolaborasi Multi-Mesin Pencari MCP

Claude Code mendukung konfigurasi beberapa mesin pencari MCP secara bersamaan, akan memilih secara otomatis berdasarkan jenis kueri:

  • Pertanyaan umum → Secara otomatis memilih Brave Search atau WebSearch bawaan
  • Dokumentasi teknis → Secara otomatis memilih Tavily (jika sudah diinstal)
  • Contoh kode → Secara otomatis memilih Exa (jika sudah diinstal)

Teknik 3: WebFetch Membaca Langsung URL yang Diketahui

Jika Anda sudah mengetahui URL halaman target, dapat melewati langkah pencarian, langsung meminta Claude Code menggunakan WebFetch:

# Membaca langsung konten URL yang ditentukan
> Tolong baca https://docs.anthropic.com/claude/docs dan beri tahu saya perubahan API terbaru

🎯 Saran Teknis: Jika Anda sering perlu menggunakan kemampuan pencarian online dalam alur CI/CD, disarankan melalui platform APIYI apiyi.com memanggil Claude API yang dikombinasikan dengan API pencarian Brave atau Tavily, membangun alur otomatis untuk mendapatkan informasi. Platform mendukung antarmuka yang kompatibel dengan OpenAI, memudahkan integrasi dengan toolchain yang ada.


Pertanyaan Umum

Q1: Apakah WebSearch di Claude Code sama dengan fitur pencarian di situs web Claude.ai?

Ya, keduanya menggunakan mesin pencari backend yang sama. Alat WebSearch di Claude Code memanggil alat web_search dari sisi server Anthropic, yang berbagi backend pencarian yang sama dengan fitur pencarian di situs web Claude.ai. Perbedaan utamanya adalah WebSearch di Claude Code hanya mengembalikan judul dan URL, sedangkan situs web Claude.ai akan langsung menampilkan ringkasan hasil pencarian.

Q2: Setelah menginstal MCP pencarian, alat pencarian mana yang akan diprioritaskan oleh Claude Code?

Claude Code akan secara otomatis memilih alat pencarian yang paling sesuai berdasarkan konten kueri dan konteksnya. Jika Anda menginstal Brave Search MCP dan WebSearch bawaan secara bersamaan, Claude Code mungkin akan memilih secara fleksibel berdasarkan jenis kueri. Anda juga dapat menentukan secara eksplisit alat mana yang akan digunakan dalam petunjuk. Dalam penggunaan praktis, umpan balik komunitas menunjukkan bahwa setelah menginstal alat pencarian MCP, Claude Code cenderung lebih memilih alat MCP karena biasanya memberikan hasil yang lebih kaya. Jika Anda perlu membangun skema pencarian kustom melalui API, APIYI apiyi.com menyediakan antarmuka pemanggilan model Claude yang terpadu.

Q3: Apakah ada perbedaan pencarian terhubung antara pengguna gratis dan berbayar?

Alat pencarian terhubung bawaan Claude Code (WebSearch/WebFetch) tersedia untuk semua pengguna Claude Code, tidak membedakan antara gratis dan berbayar. Namun, frekuensi penggunaannya akan dipengaruhi oleh batas penggunaan Claude Code Anda (paket Pro/Max memiliki batas yang berbeda). Kuota plugin pencarian MCP bergantung pada batas lapisan gratis dari masing-masing layanan pencarian (misalnya Brave 2.000 kali/bulan, Tavily 1.000 kali/bulan), dan tidak terkait dengan paket langganan Claude.


Ringkasan

3 poin inti pencarian terhubung Claude Code:

  1. Alat bawaan sudah cukup: Kombinasi WebSearch + WebFetch bawaan Claude Code dapat memenuhi 80% kebutuhan pencarian terhubung. WebSearch bertanggung jawab untuk mencari dan mengembalikan tautan, WebFetch bertanggung jawab untuk mendapatkan ringkasan jawaban halaman. Keduanya bekerja sama membentuk alur pencarian yang lengkap.
  2. MCP pencarian adalah pelengkap: Brave Search MCP (rekomendasi resmi, gratis 2.000 kali/bulan) dan Tavily MCP (pandai dalam dokumentasi teknis) adalah dua plugin pencarian yang paling layak diinstal, dapat memberikan peningkatan signifikan dalam kualitas pencarian dan kekayaan hasil.
  3. Pilih sesuai kebutuhan: Cari dokumentasi untuk pengembangan sehari-hari → gunakan alat bawaan; penelitian mendalam dan pengambilan data massal → instal MCP; perlu mengintegrasikan pencarian dalam alur otomatisasi → panggil Claude API melalui APIYI apiyi.com yang dikombinasikan dengan API layanan pencarian.

Filosofi desain pencarian terhubung Claude Code adalah "menjaga agen utama tetap ringan". Alat bawaan telah mencapai keseimbangan yang baik antara keamanan, kepatuhan hak cipta, dan kinerja. Pilih apakah akan menginstal MCP pencarian tambahan sesuai kebutuhan aktual Anda, hindari konfigurasi yang berlebihan.


📚 Referensi

  1. Analisis Mendalam Claude Code Web Tools: Prinsip implementasi internal WebSearch dan WebFetch

    • Tautan: mikhail.io/2025/10/claude-code-web-tools/
    • Penjelasan: Analisis rekayasa balik implementasi teknis alat koneksi internet Claude Code
  2. Dokumentasi Resmi Web Search Tool: Penjelasan alat pencarian Claude API

    • Tautan: platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool
    • Penjelasan: Dokumentasi API resmi alat WebSearch dari Anthropic
  3. Dokumentasi Resmi Web Fetch Tool: Penjelasan alat pengambilan halaman Claude API

    • Tautan: platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool
    • Penjelasan: Dokumentasi API resmi alat WebFetch dari Anthropic
  4. Panduan Integrasi Plugin Pencarian MCP: Perbandingan berbagai layanan pencarian MCP dan tutorial instalasi

    • Tautan: intuitionlabs.ai/articles/mcp-servers-claude-code-internet-search
    • Penjelasan: Perbandingan detail dan saran penggunaan untuk 8 plugin pencarian MCP
  5. Brave Search MCP: MCP pencarian yang direkomendasikan resmi oleh Anthropic

    • Tautan: brave.com/search/api/guides/use-with-claude-desktop-with-mcp/
    • Penjelasan: Panduan instalasi dan penggunaan Brave Search MCP

Penulis: Tim Teknis APIYI
Diskusi Teknis: Silakan bagikan pengalaman konfigurasi pencarian internet Claude Code Anda di bagian komentar. Untuk lebih banyak materi pengembangan AI, kunjungi pusat dokumentasi APIYI docs.apiyi.com

Similar Posts