Search1API

Search1API MCP Server

中文文档

เซิร์ฟเวอร์ MCP อย่างเป็นทางการสำหรับ Search1API — การค้นหาเว็บ ข่าวสาร การดึงหน้าเว็บ การค้นหา sitemap และหัวข้อมาแรงใน API เดียว

การตรวจสอบสิทธิ์

• ไคลเอนต์ที่รองรับ OAuth สามารถเชื่อมต่อไปยัง Remote MCP URL ได้โดยตรง จากนั้นลงชื่อเข้าใช้และอนุมัติการเข้าถึงในเบราว์เซอร์
• การผสานรวมที่มีอยู่สามารถใช้ API key จาก แดชบอร์ด Search1API ต่อไปได้

เริ่มต้นใช้งาน (Remote MCP)

ไม่จำเป็นต้องติดตั้ง กำหนดค่าไคลเอนต์ MCP ของคุณด้วย remote URL ใช้ OAuth เมื่อไคลเอนต์รองรับ หรือระบุ API key

การตรวจสอบสิทธิ์

รองรับสามวิธี — เลือกใช้วิธีที่ไคลเอนต์ของคุณรองรับ:

วิธี	รูปแบบ
OAuth 2.1	เชื่อมต่อไปยัง https://mcp.search1api.com/mcp โดยไม่ต้องใช้คีย์แล้วทำตามขั้นตอนการลงชื่อเข้าของไคลเอนต์
Authorization Header	Authorization: Bearer YOUR_SEARCH1API_KEY
URL Query Parameter (legacy)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

ควรเลือกใช้ OAuth หรือ Authorization header ข้อมูลประจำตัวใน query parameter อาจถูกเปิดเผยผ่าน URL, บันทึก (logs) และประวัติเชลล์

Claude Desktop

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

Claude.ai (Web)

การตั้งค่า > ตัวเชื่อมต่อ > เพิ่มตัวเชื่อมต่อแบบกำหนดเอง:

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

Cursor

ติดตั้งเป็นปลั๊กอิน Cursor (แนะนำ): โปรเจกต์นี้มี Agent Plugins plugin.json + mcp.json (พกพาได้) และ .cursor-plugin/plugin.json (เมตาดาต้า / โลโก้ Cursor Marketplace) สำหรับ Remote MCP ที่ใช้ OAuth ส่งหรือติดตั้งจาก cursor.directory / Cursor Marketplace จากนั้นลงชื่อเข้าใช้เมื่อได้รับแจ้ง

สำหรับการทดสอบในเครื่อง ให้คัดลอกไฟล์ปลั๊กอินไปยัง ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/) ห้ามสร้าง symlink จากภายนอกไดเรกทอรีนั้น — Cursor ปฏิเสธ symlink ที่ชี้ไปยังเป้าหมายภายนอก

หรือกำหนดค่าด้วยตนเอง:

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

Agent Skill

Agent Skill ย้ายไปที่ search1api-cli แล้ว ติดตั้งด้วย:

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

โหมดโลคัล (stdio)

หากต้องการรันเซิร์ฟเวอร์ในเครื่อง ให้ใช้ Node.js เวอร์ชัน 20 ขึ้นไปกับ npx — ไม่ต้อง clone โค้ด:

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

สำหรับการติดตั้ง HTTP แบบ self-hosted ที่อยู่เบื้องหลังพร็อกซี ให้เพิ่ม hostname ภายในใดๆ ที่เข้าถึงกระบวนการ Node.js ลงในตัวแปรสภาพแวดล้อม MCP_ALLOWED_HOSTS ซึ่งคั่นด้วยเครื่องหมายจุลภาค mcp.search1api.com และที่อยู่ localhost อนุญาตให้ใช้ได้ตามค่าเริ่มต้น ไคลเอนต์ที่ใช้เบราว์เซอร์ซึ่งส่ง header Origin จะต้องเพิ่ม hostname ต้นทางที่เชื่อถือได้ลงในตัวแปร MCP_ALLOWED_ORIGINS ที่คั่นด้วยเครื่องหมายจุลภาคด้วย คำขอจากไคลเอนต์ MCP ฝั่งเซิร์ฟเวอร์โดยปกติจะไม่ส่ง Origin และไม่จำเป็นต้องเพิ่มรายการ

เครื่องมือ

search

ค้นหาเว็บด้วย Search1API ผลลัพธ์มีโครงสร้าง id/title/url ที่สามารถอ้างอิงได้ ส่ง URL ของผลลัพธ์ไปยัง crawl เมื่อคุณต้องการเนื้อหาทั้งหน้า

พารามิเตอร์	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
query	ใช่	-	คำค้นหา
max_results	ไม่	10	จำนวนผลลัพธ์
search_service	ไม่	google	google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	ไม่	0	จำนวนผลลัพธ์อันดับต้นๆ ที่จะ crawl เพื่อดึงเนื้อหาเต็ม; การ crawl สำเร็จแต่ละครั้งเพิ่ม 1 เครดิตจากฐานคำขอค้นหา 1 เครดิต
include_sites	ไม่	[]	ไซต์ที่จะรวม
exclude_sites	ไม่	[]	ไซต์ที่จะแยกออก
time_range	ไม่	-	day, month, year

news

ค้นหาบทความข่าว

พารามิเตอร์	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
query	ใช่	-	คำค้นหา
max_results	ไม่	10	จำนวนผลลัพธ์
search_service	ไม่	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	ไม่	0	จำนวนผลลัพธ์อันดับต้นๆ ที่จะ crawl เพื่อดึงเนื้อหาเต็ม; การ crawl สำเร็จแต่ละครั้งเพิ่ม 1 เครดิตจากฐานคำขอข่าว 1 เครดิต
include_sites	ไม่	[]	ไซต์ที่จะรวม
exclude_sites	ไม่	[]	ไซต์ที่จะแยกออก
time_range	ไม่	-	day, month, year

crawl

แยกเนื้อหาจาก URL

พารามิเตอร์	จำเป็น	คำอธิบาย
url	ใช่	URL ที่จะ crawl

sitemap

รับลิงก์ที่เกี่ยวข้องทั้งหมดจาก URL

พารามิเตอร์	จำเป็น	คำอธิบาย
url	ใช่	URL ที่จะรับ sitemap

trending

รับหัวข้อมาแรงจากแพลตฟอร์มยอดนิยม

พารามิเตอร์	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
search_service	ใช่	-	github, hackernews
max_results	ไม่	10	จำนวนรายการ

ประวัติเวอร์ชัน

• v0.5.3: เมตาดาต้าของทรัพยากร OAuth และเครื่องมือไม่ต้องใช้ OIDC session scopes อีกต่อไป; เพิ่มป้ายทะเบียน Smithery และ Glama
• v0.5.2: การตรวจสอบ Origin ของ MCP ทำงานก่อนการแยกวิเคราะห์คำขอและการตรวจสอบสิทธิ์; การติดตั้ง HTTP แบบ self-hosted สามารถกำหนดค่า trusted browser origins ด้วย MCP_ALLOWED_ORIGINS
• v0.5.1: เอกสารประกอบ, manifest ของ LobeHub และเมตาดาต้า MCP Registry ถูกซิงโครไนซ์; robots.txt ให้บริการบน transport host
• v0.5.0: รองรับ MCP 2026-07-28 พร้อมการเจรจาโปรโตคอลอัตโนมัติ; ความเข้ากันได้แบบ stateless สำหรับไคลเอนต์ HTTP ยุค 2025; การตรวจสอบสิทธิ์ระดับคำขอ
• v0.4.0: โครงร่างเอาต์พุตแบบมีโครงสร้าง, โครงร่างความปลอดภัย OAuth, คำอธิบายประกาศด้านความปลอดภัย และเมตาดาต้า Official MCP Registry
• v0.3.1: รองรับ OAuth 2.1 สำหรับ Remote MCP; ลบเครื่องมือ reasoning ที่เลิกใช้แล้ว
• v0.3.0: รองรับ Remote MCP ผ่าน Streamable HTTP; การตรวจสอบสิทธิ์ด้วย API key ต่อเซสชัน
• v0.2.0: รองรับ .env แบบ fallback สำหรับการผสานรวม LibreChat
• v0.1.8: บริการค้นหา X (Twitter) และ Reddit
• v0.1.7: เครื่องมือ trending สำหรับ GitHub และ Hacker News
• v0.1.6: บริการค้นหา Wikipedia
• v0.1.5: พารามิเตอร์และบริการค้นหาใหม่ (arxiv, wechat, bilibili, imdb)
• v0.1.3: การค้นหาข่าว
• v0.1.2: Sitemap
• v0.1.1: การ crawl เว็บ
• v0.1.0: เวอร์ชันแรก

สัญญาอนุญาต

MIT