Search1API

Server MCP Search1API

中文文档 | Deutsch

Server MCP resmi untuk Search1API — pencarian web, berita, pengambilan halaman, penemuan sitemap, dan topik yang sedang tren dalam satu API.

Autentikasi

• Klien yang mendukung OAuth dapat terhubung langsung ke URL Remote MCP, lalu masuk dan menyetujui akses di browser.
• Integrasi yang sudah ada dapat terus menggunakan kunci API dari dasbor Search1API.
• Setiap permintaan MCP — termasuk penemuan alat (initialize, tools/list) — memerlukan kredensial. Permintaan tanpa autentikasi akan menerima tantangan OAuth, yang digunakan klien untuk memulai proses masuk; pemeriksaan sebelum koneksi dilayani oleh kartu server statis.

Mulai Cepat (Remote MCP)

Tidak perlu instalasi. Konfigurasikan klien MCP Anda dengan URL jarak jauh. Gunakan OAuth jika klien mendukungnya, atau berikan kunci API.

Autentikasi

Tiga metode didukung — gunakan metode yang didukung klien Anda:

Metode	Format
OAuth 2.1	Hubungkan ke https://mcp.search1api.com/mcp tanpa kunci dan ikuti alur masuk klien
Header Authorization	Authorization: Bearer YOUR_SEARCH1API_KEY
Parameter Kueri URL (lama)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Utamakan OAuth atau header Authorization. Kredensial dalam parameter kueri dapat terekspos di URL, log, dan riwayat shell.

UI pencarian dan berita opsional

Remote MCP menyediakan render_results di endpoint standar di atas. Alat data seperti search, news dan ask mengembalikan hasil tanpa menampilkan kartu secara otomatis. Jika daftar sumber berguna, model dapat memilih atau menggabungkan hasil yang sudah ada dan meneruskannya ke render_results. Alat ini mengembalikan kartu sumber di klien MCP Apps dan daftar teks lengkap yang mudah dibaca di tempat lain. Perenderan tidak mengulangi pencarian atau menggunakan kredit pencarian; parameter URL UI tidak diperlukan.

HTTP dan stdio mengiklankan logo Search1API berbentuk persegi melalui metadata serverInfo.icons standar. PNG 512×512 tersedia secara publik di https://mcp.search1api.com/assets/icon-square.png, tanpa autentikasi atau pengalihan. Kartu server dan manifes registri menggunakan ikon yang sama. Klien menentukan apakah ikon akan ditampilkan; ikon ini tidak menggantikan ikon yang disimpan secara terpisah oleh direktori plugin.

Lihat kontrak perenderan untuk argumen, batas, dan perilaku fallback. Paket npm menyertakan perender ini mulai versi 0.8.0. Perbarui instalasi yang sudah ada dan mulai ulang koneksi MCP; npx -y search1api-mcp@latest menjalankan paket terbaru yang telah dipublikasikan.

Setelah mengubah URL, hubungkan kembali atau segarkan definisi alat konektor; klien mungkin menyimpannya dalam cache. Pengaturan URL ini hanya berlaku untuk Remote MCP; perilaku stdio lokal tidak berubah. Lihat UI MCP Apps untuk detail dan status rilis.

Claude Desktop

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude.ai (Web)

Instal Search1API dari direktori Claude, klik Connect, lalu masuk dengan akun Search1API Anda.

Jangan tambahkan https://mcp.search1api.com/mcp melalui Add custom connector: tindakan itu membuat konektor kustom terpisah, yang namanya ditetapkan Claude berdasarkan host URL (mcp.search1api.com) kecuali Anda mengetikkan nama.

Cursor

Instal sebagai plugin Cursor (disarankan): repo ini menyertakan Agent Plugins plugin.json + mcp.json (portabel) dan .cursor-plugin/plugin.json (metadata / logo Cursor Marketplace) untuk Remote MCP dengan OAuth. Kirimkan atau instal dari cursor.directory / Cursor Marketplace, lalu masuk saat diminta.

Untuk pengujian lokal, salin file plugin ke ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/). Jangan buat symlink dari luar direktori tersebut — Cursor menolak target symlink eksternal.

Atau konfigurasikan secara manual:

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Antigravity

Instal sebagai plugin Antigravity: antigravity-plugin/ berisi manifes, mcp_config.json (Remote MCP dengan OAuth), skill Search1API, dan README Marketplace. Instal langsung dari GitHub, lalu masuk saat browser terbuka:

agy plugin install https://github.com/superagents-lab/search1api-mcp/tree/main/antigravity-plugin

Untuk pengujian lokal, jalankan agy plugin validate --strict ./antigravity-plugin dan agy plugin install ./antigravity-plugin dari hasil checkout.

VS Code

{
  "servers": {
    "search1api": {
      "type": "http",
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http search1api https://mcp.search1api.com/mcp \
  --header "Authorization: Bearer YOUR_SEARCH1API_KEY"

Windsurf

{
  "mcpServers": {
    "search1api": {
      "serverUrl": "https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY"
    }
  }
}

Agent Skill

Agent Skill telah dipindahkan ke search1api-cli. Instal dengan:

npm install -g search1api-cli
npx skills add superagents-lab/search1api-cli

Mode Lokal (stdio)

Jika Anda lebih suka menjalankan server secara lokal, gunakan Node.js 20 atau yang lebih baru dengan npx — tidak perlu mengkloning:

{
  "mcpServers": {
    "search1api": {
      "command": "npx",
      "args": ["-y", "search1api-mcp"],
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Untuk deployment HTTP yang di-host sendiri di balik proxy, tambahkan nama host internal yang mengarah ke proses Node.js ke variabel lingkungan MCP_ALLOWED_HOSTS yang dipisahkan dengan koma. mcp.search1api.com dan alamat localhost diizinkan secara default. Klien berbasis browser yang mengirim header Origin juga harus memiliki nama host origin tepercaya yang ditambahkan ke variabel MCP_ALLOWED_ORIGINS yang dipisahkan dengan koma. Permintaan dari klien MCP sisi server biasanya tidak menyertakan Origin dan tidak memerlukan entri.

Alat

search

Cari di web menggunakan Search1API. Hasil mencakup struktur id/title/url yang dapat dikutip. Teruskan URL hasil ke crawl jika Anda memerlukan halaman lengkap.

Parameter	Wajib	Default	Deskripsi
query	Ya	-	Kueri pencarian
max_results	Tidak	10	Jumlah hasil
search_service	Tidak	google	google, bing, bingcn, duckduckgo, yahoo, yandex, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia, grokipedia
page	Tidak	1	Halaman hasil (1-100); hanya bing, bingcn, baidu, dan grokipedia yang mendukung paginasi
crawl_results	Tidak	0	Jumlah hasil teratas yang akan dirayapi untuk mendapatkan konten lengkap; setiap perayapan yang berhasil menambahkan 1 kredit ke permintaan pencarian dasar yang berbiaya 1 kredit
include_sites	Tidak	[]	Situs yang disertakan
exclude_sites	Tidak	[]	Situs yang dikecualikan
time_range	Tidak	-	day, week, month, year

Hasil menyertakan published_date di metadata jika mesin pencari menyediakannya; hasil github menambahkan kind, stars, language, dan num_comments.

news

Cari artikel berita. Hasil hackernews menautkan ke utas diskusi dan menambahkan story_url, points, dan num_comments ke metadata.

Parameter	Wajib	Default	Deskripsi
query	Ya	-	Kueri pencarian
max_results	Tidak	10	Jumlah hasil
search_service	Tidak	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	Tidak	0	Jumlah hasil teratas yang akan dirayapi untuk mendapatkan konten lengkap; setiap perayapan yang berhasil menambahkan 1 kredit ke permintaan berita dasar yang berbiaya 1 kredit
include_sites	Tidak	[]	Situs yang disertakan
exclude_sites	Tidak	[]	Situs yang dikecualikan
time_range	Tidak	-	day, week, month, year

crawl

Ekstrak konten dari URL.

Parameter	Wajib	Deskripsi
url	Ya	URL yang akan dirayapi

sitemap

Dapatkan semua tautan terkait dari URL.

Parameter	Wajib	Deskripsi
url	Ya	URL untuk mendapatkan sitemap

trending

Dapatkan topik yang sedang tren dari platform populer.

Parameter	Wajib	Default	Deskripsi
search_service	Ya	-	github, hackernews
max_results	Tidak	10	Jumlah item

ask

Pencarian agentik: jelaskan kebutuhan dalam bahasa alami, lalu Search1API memilih hingga lima mesin pencari dan rentang waktu, menghapus hasil yang tidak relevan, serta mengembalikan maksimal 10 hasil yang dapat dikutip dan diurutkan berdasarkan relevansi. Hasilnya juga menyertakan intent (kata kunci, mesin pencari, dan rentang waktu yang digunakan) serta errors (mesin pencari yang gagal sementara mesin lainnya berhasil menyelesaikan permintaan). Biayanya 5 kredit per permintaan yang selesai; gunakan search jika Anda sudah mengetahui mesin pencarinya.

Parameter	Wajib	Deskripsi
query	Ya	Permintaan dalam bahasa alami, maksimal 500 karakter

maps

Temukan bisnis dan tempat lokal di Google Maps. Mengembalikan satu halaman berisi hingga 20 tempat sebagai hasil yang dapat dikutip: title adalah nama tempat, url tautan Google Maps-nya, dan metadata memuat alamat, nomor telepon, situs web, kategori, rating, jumlah ulasan, koordinat, jam buka, status buka, dan kisaran harga jika tersedia. Biayanya 3 kredit per halaman, berapa pun jumlah tempat yang dimuatnya.

Parameter	Wajib	Default	Deskripsi
query	Ya	-	Hal yang dicari, seperti "kedai kopi" atau "dokter gigi di Austin"
country	Tidak	us	Kode negara dua huruf
language	Tidak	en	Bahasa hasil, seperti en, de, atau zh-CN
location	Tidak	-	{ latitude, longitude, zoom? } untuk mencari di sekitar suatu titik; wajib untuk halaman 2 dan seterusnya
page	Tidak	1	Halaman Google Maps, 1-6; setiap halaman merupakan panggilan terpisah
max_results	Tidak	20	Jumlah tempat yang dikembalikan dari halaman (1-20); jumlah tempat yang lebih sedikit tidak mengurangi harga

deepcrawl

Baca banyak halaman dari satu situs dalam satu tugas, misalnya bagian dokumentasi. Temukan URL situs melalui sitemap-nya, pertahankan URL yang cocok dengan aturan jalur, lalu kembalikan hingga max_pages halaman sebagai hasil yang dapat dikutip: title, url, dan Markdown halaman di text. Hasilnya juga menyertakan stats (ditemukan, cocok, dilewati, dirayapi, gagal), failed (URL yang tidak dapat dibaca beserta alasannya), API message, dan result_url, file JSON yang memuat setiap halaman secara lengkap. Biayanya 20 kredit per tugas yang dimulai, berapa pun jumlah halaman yang dibaca.

Alat ini menunggu hingga sekitar 45 detik. Jika perayapan masih berjalan, alat akan mengembalikan status: "running" dengan task_id; panggil deepcrawl lagi dengan task_id tersebut untuk mengambil halaman, tanpa biaya dan tanpa memulai perayapan baru. Teks halaman dibatasi hingga 8.000 karakter per halaman dan 80.000 karakter secara keseluruhan; halaman yang dipersingkat memiliki metadata.truncated: true, dan result_url memuat teks lengkapnya.

Parameter	Wajib	Default	Deskripsi
url	Ya, kecuali jika task_id diberikan	-	Situs atau bagian yang akan dirayapi, seperti https://example.com/docs/
max_pages	Tidak	10	Jumlah maksimum halaman yang dibaca (1-50), sesuai urutan penemuan setelah aturan jalur diterapkan; harganya sama untuk jumlah berapa pun
include_paths	Tidak	-	Hingga 20 aturan jalur URL yang dipertahankan. Tanpa *, aturan berupa prefiks jalur pada batas segmen (/docs cocok dengan /docs/api, bukan /docsearch); dengan *, aturan harus cocok dengan seluruh jalur dan * juga cocok dengan /
exclude_paths	Tidak	-	Hingga 20 aturan jalur yang dilewati, dengan sintaks yang sama; pengecualian diutamakan
type	Tidak	sitemap	sitemap menggunakan sitemap situs, atau tautan di halaman awal jika situs tidak memilikinya; all menggunakan setiap tautan yang ditemukan dari URL awal
task_id	Tidak	-	task_id dari perayapan yang masih berjalan; hanya memeriksa statusnya, dan parameter lainnya diabaikan

send_feedback

Laporkan hasil yang salah, kosong, atau tidak lengkap, kesalahan yang tidak dapat Anda atasi, dokumentasi yang tidak sesuai dengan perilaku, atau kemampuan yang belum tersedia kepada tim Search1API. Gratis; tidak menggunakan kredit. Jika server memiliki kredensial Search1API, laporan akan ditautkan ke akun tersebut agar tim dapat menindaklanjutinya. Jangan sertakan kredensial atau data pribadi.

Parameter	Wajib	Deskripsi
message	Ya	Hal yang salah atau yang kurang, hingga 4000 karakter
intent	Tidak	Hal yang ingin Anda capai
category	Tidak	bug, feature_request, docs, other
request_id	Tidak	ID permintaan dari panggilan yang bermasalah
model	Tidak	Nama model Anda

Riwayat Versi

• v0.11.0: Tool deepcrawl baru untuk membaca hingga 50 halaman dari satu situs dalam satu tugas (20 kredit per tugas; pemeriksaan tugas yang sedang berjalan gratis)

• v0.10.0: Tool maps baru untuk pencarian tempat di Google Maps (3 kredit per halaman yang memuat hingga 20 tempat)

• v0.7.0: Tool ask baru untuk pencarian agentik. search menambahkan mesin bingcn, yandex, dan grokipedia, serta parameter page; search dan news menerima time_range: "week" dan meneruskan kolom published_date, GitHub, dan Hacker News dalam hasil metadata

• v0.6.1: Perbaikan bug — penemuan MCP (initialize, tools/list, resources/*, prompts/list, server/discover) kembali memerlukan kredensial. Menyediakannya secara anonim membuat klien yang menyamakan "tools listed" dengan "signed in" menampilkan status terhubung tanpa cara untuk memicu alur OAuth; tantangan 401 kini merespons setiap permintaan yang tidak terautentikasi, sehingga memulihkan proses masuk OAuth saat koneksi dibuat. Visibilitas direktori tidak berubah melalui kartu server statis dan metadata registri

• v0.6.0: Penemuan MCP (initialize, tools/list, resources/*, prompts/list, server/discover) disediakan tanpa kredensial agar klien dan direktori dapat mencantumkan tools sebelum masuk; pemanggilan tool tetap memerlukan OAuth atau kunci API. Mode stdio dimulai tanpa SEARCH1API_KEY dan menyediakan metadata tool, serta hanya menolak saat pemanggilan. Permintaan yang formatnya salah dijawab sebagai JSON-RPC, bukan halaman kesalahan HTML

• v0.5.4: Penerbit OAuth dipindahkan ke clerk.s1.dev dan dapat dikonfigurasi dengan OAUTH_AUTHORIZATION_SERVER; kartu server MCP dipublikasikan di /.well-known/mcp/server-card.json; dokumen penemuan OAuth kini mengirim header cache

• v0.5.3: Metadata resource dan tool OAuth tidak lagi memerlukan cakupan sesi OIDC; lencana registri Smithery dan Glama ditambahkan

• v0.5.2: Validasi MCP Origin kini dijalankan sebelum penguraian permintaan dan autentikasi; deployment HTTP yang di-host sendiri dapat mengonfigurasi origin browser tepercaya dengan MCP_ALLOWED_ORIGINS

• v0.5.1: Dokumentasi, manifes LobeHub, dan metadata MCP Registry disinkronkan; robots.txt disediakan di host transport

• v0.5.0: Dukungan MCP 2026-07-28 dengan negosiasi protokol otomatis; kompatibilitas stateless untuk klien HTTP era 2025; autentikasi tingkat permintaan

• v0.4.0: Skema output terstruktur, skema keamanan OAuth, anotasi keselamatan, dan metadata Official MCP Registry

• v0.3.1: Dukungan OAuth 2.1 untuk Remote MCP; tool penalaran yang sudah dihentikan dihapus

• v0.3.0: Dukungan Remote MCP melalui Streamable HTTP; autentikasi kunci API per sesi

• v0.2.0: Dukungan .env cadangan untuk integrasi LibreChat

• v0.1.8: Layanan pencarian X (Twitter) dan Reddit

• v0.1.7: Tool tren untuk GitHub dan Hacker News

• v0.1.6: Layanan pencarian Wikipedia

• v0.1.5: Parameter dan layanan pencarian baru (arxiv, wechat, bilibili, imdb)

• v0.1.3: Pencarian berita

• v0.1.2: Sitemap

• v0.1.1: Perayapan web

• v0.1.0: Rilis awal

Lisensi

MIT

Kredit UI dan pihak ketiga

Tampilan MCP Apps render_results menampilkan sumber yang ada sebagai kartu dengan judul dan domain. Setiap klien juga menerima teks lengkap dan daftar hasil terstruktur. Komponen ini diadaptasi dari Rare UI, karya Swami Malode. Ketentuan MIT + Commons Clause + Attribution-nya dicantumkan ulang di THIRD_PARTY_NOTICES.md.

Penyiapan UI, origin sandbox, dan pemeriksaan rilis: MCP Apps UI.