Search1API

Server MCP Search1API

中文文档

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 ada dapat terus menggunakan kunci API dari dasbor Search1API.

Mulai 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 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 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 Agent Plugins 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 memiliki nama host asal tepercaya yang ditambahkan 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 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 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.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 kini 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 MCP Registry disinkronkan; robots.txt disajikan 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 keamanan, dan metadata MCP Registry Resmi
• v0.3.1: Dukungan OAuth 2.1 untuk MCP Jarak Jauh; alat penalaran yang dipensiunkan dihapus
• v0.3.0: Dukungan MCP Jarak Jauh melalui Streamable HTTP; autentikasi kunci API per sesi
• v0.2.0: Dukungan fallback .env 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: Crawling web
• v0.1.0: Rilis awal

Lisensi

MIT