Search1API

Server MCP Search1API

Dokumentasi Bahasa Mandarin

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

Autentikasi

• Klien yang mendukung OAuth dapat terhubung langsung ke URL MCP Jarak Jauh, lalu masuk dan menyetujui akses di peramban.
• 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 memicu tantangan OAuth, yang merupakan cara klien memicu proses masuk; pemeriksaan sebelum koneksi dilayani oleh kartu server statis sebagai gantinya.

Memulai Cepat (MCP Jarak Jauh)

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 yang didukung klien Anda:

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

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

Claude Desktop

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

Claude.ai (Web)

Pengaturan > Konektor > Tambahkan konektor kustom:

https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Cursor

Instal sebagai plugin Cursor (disarankan): repositori ini menyertakan Plugin Agen plugin.json + mcp.json (portabel) dan .cursor-plugin/plugin.json (metadata/logo Cursor Marketplace) untuk MCP Jarak Jauh dengan OAuth. Kirim 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"
      }
    }
  }
}

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"
    }
  }
}

Keterampilan Agen

Keterampilan Agen 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 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 dihosting sendiri di belakang proxy, tambahkan nama host internal apa pun yang menjangkau proses Node.js ke variabel lingkungan MCP_ALLOWED_HOSTS yang dipisahkan koma. Alamat mcp.search1api.com dan localhost diizinkan secara default. Klien berbasis peramban yang mengirim header Origin juga harus menambahkan nama host asal tepercaya mereka ke variabel MCP_ALLOWED_ORIGINS yang dipisahkan koma. Permintaan dari klien MCP sisi server biasanya menghilangkan Origin dan tidak memerlukan entri.

Alat

search

Cari web menggunakan Search1API. Hasil menyertakan struktur id/title/url yang dapat dikutip. Berikan URL hasil ke crawl saat Anda memerlukan halaman lengkap.

Parameter	Wajib	Default	Deskripsi
query	Ya	-	Kueri pencarian
max_results	Tidak	10	Jumlah hasil
search_service	Tidak	google	google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	Tidak	0	Jumlah hasil teratas yang akan di-crawl untuk konten lengkap; setiap crawl yang berhasil menambah 1 kredit ke permintaan pencarian dasar 1 kredit
include_sites	Tidak	[]	Situs yang disertakan
exclude_sites	Tidak	[]	Situs yang dikecualikan
time_range	Tidak	-	day, month, year

news

Cari artikel berita.

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 di-crawl untuk konten lengkap; setiap crawl yang berhasil menambah 1 kredit ke permintaan berita dasar 1 kredit
include_sites	Tidak	[]	Situs yang disertakan
exclude_sites	Tidak	[]	Situs yang dikecualikan
time_range	Tidak	-	day, month, year

crawl

Ekstrak konten dari URL.

Parameter	Wajib	Deskripsi
url	Ya	URL yang akan di-crawl

sitemap

Dapatkan semua tautan terkait dari URL.

Parameter	Wajib	Deskripsi
url	Ya	URL untuk mendapatkan sitemap

trending

Dapatkan topik tren dari platform populer.

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

Riwayat Versi

• v0.6.1: Perbaikan bug — penemuan MCP (initialize, tools/list, resources/*, prompts/list, server/discover) memerlukan kredensial lagi. Melayani secara anonim membuat klien yang menyamakan "alat terdaftar" dengan "sudah masuk" menampilkan status terhubung tanpa cara memicu alur OAuth; tantangan 401 sekarang menjawab setiap permintaan tanpa autentikasi, memulihkan masuk OAuth saat koneksi. Visibilitas direktori tidak berubah melalui kartu server statis dan metadata registri
• v0.6.0: Penemuan MCP (initialize, tools/list, resources/*, prompts/list, server/discover) dilayani tanpa kredensial sehingga klien dan direktori dapat menghitung alat sebelum masuk; panggilan alat tetap memerlukan OAuth atau kunci API. Mode stdio dimulai tanpa SEARCH1API_KEY dan melayani metadata alat, menolak hanya saat pemanggilan. Permintaan yang salah format dijawab sebagai JSON-RPC alih-alih halaman kesalahan HTML
• v0.5.4: Penerbit OAuth dipindahkan ke clerk.s1.dev dan dapat dikonfigurasi dengan OAUTH_AUTHORIZATION_SERVER; kartu server MCP diterbitkan di /.well-known/mcp/server-card.json; dokumen penemuan OAuth sekarang mengirim header cache
• v0.5.3: Metadata sumber daya dan alat OAuth tidak lagi memerlukan lingkup sesi OIDC; lencana registri Smithery dan Glama ditambahkan
• v0.5.2: Validasi Origin MCP sekarang berjalan sebelum penguraian permintaan dan autentikasi; deployment HTTP yang dihosting sendiri dapat mengonfigurasi asal peramban tepercaya dengan MCP_ALLOWED_ORIGINS
• v0.5.1: Dokumentasi, manifes LobeHub, dan metadata Registri MCP disinkronkan; robots.txt dilayani di host transport
• v0.5.0: Dukungan MCP 2026-07-28 dengan negosiasi protokol otomatis; kompatibilitas tanpa status untuk klien HTTP era 2025; autentikasi tingkat permintaan
• v0.4.0: Skema keluaran terstruktur, skema keamanan OAuth, anotasi keselamatan, dan metadata Registri MCP Resmi
• v0.3.1: Dukungan OAuth 2.1 untuk MCP Jarak Jauh; alat penalaran yang dihentikan dihapus
• v0.3.0: Dukungan MCP Jarak Jauh 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: Alat 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