Search1API

เซิร์ฟเวอร์ MCP ของ Search1API

เอกสารภาษาจีน

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

การรับรองความถูกต้อง

• ไคลเอนต์ที่รองรับ OAuth สามารถเชื่อมต่อไปยัง Remote MCP URL ได้โดยตรง จากนั้นลงชื่อเข้าใช้และอนุมัติการเข้าถึงในเบราว์เซอร์
• การผสานรวมที่มีอยู่สามารถใช้คีย์ API จาก แดชบอร์ด Search1API ต่อไปได้
• ทุกคำขอ MCP — รวมถึงการค้นพบเครื่องมือ (initialize, tools/list) — ต้องมีข้อมูลรับรอง คำขอที่ไม่ผ่านการรับรองความถูกต้องจะได้รับการท้าทาย OAuth ซึ่งเป็นวิธีที่ไคลเอนต์ใช้เพื่อเริ่มการลงชื่อเข้าใช้ การตรวจสอบก่อนการเชื่อมต่อจะให้บริการโดย การ์ดเซิร์ฟเวอร์ แบบคงที่แทน

เริ่มต้นอย่างรวดเร็ว (Remote MCP)

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

การรับรองความถูกต้อง

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

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

ควรใช้ OAuth หรือส่วนหัวการอนุญาต ข้อมูลรับรองในพารามิเตอร์คิวรีอาจถูกเปิดเผยใน URL บันทึก และประวัติเชลล์

Claude Desktop

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

Claude.ai (เว็บ)

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

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

ทักษะตัวแทน

ทักษะตัวแทนได้ย้ายไปที่ search1api-cli แล้ว ติดตั้งด้วย:

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

โหมดท้องถิ่น (stdio)

หากคุณต้องการเรียกใช้เซิร์ฟเวอร์ในเครื่อง ให้ใช้ Node.js 20 หรือใหม่กว่าพร้อม npx — ไม่ต้องโคลน:

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

สำหรับการปรับใช้ HTTP ที่โฮสต์เองหลังพร็อกซี ให้เพิ่มชื่อโฮสต์ภายในใดๆ ที่เข้าถึงกระบวนการ Node.js ลงในตัวแปรสภาพแวดล้อม MCP_ALLOWED_HOSTS ที่คั่นด้วยเครื่องหมายจุลภาค mcp.search1api.com และที่อยู่ localhost ได้รับอนุญาตตามค่าเริ่มต้น ไคลเอนต์ที่ใช้เบราว์เซอร์ที่ส่งส่วนหัว Origin ต้องเพิ่ม ชื่อโฮสต์ต้นทางที่เชื่อถือได้ลงในตัวแปร 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	จำนวนผลลัพธ์ยอดนิยมที่จะรวบรวมเพื่อเนื้อหาเต็ม แต่ละการรวบรวมที่สำเร็จเพิ่ม 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	จำนวนผลลัพธ์ยอดนิยมที่จะรวบรวมเพื่อเนื้อหาเต็ม แต่ละการรวบรวมที่สำเร็จเพิ่ม 1 เครดิตจากคำขอข่าว 1 เครดิตพื้นฐาน
include_sites	ไม่	[]	ไซต์ที่จะรวม
exclude_sites	ไม่	[]	ไซต์ที่จะแยกออก
time_range	ไม่	-	day, month, year

crawl

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

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

sitemap

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

พารามิเตอร์	จำเป็น	คำอธิบาย
url	ใช่	URL เพื่อรับไซต์แมป

trending

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

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

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

• v0.6.1: แก้ไขบั๊ก — การค้นพบ MCP (initialize, tools/list, resources/*, prompts/list, server/discover) ต้องมีข้อมูลรับรองอีกครั้ง การให้บริการโดยไม่ระบุชื่อทำให้ไคลเอนต์ที่ถือว่า "รายการเครื่องมือ" เท่ากับ "ลงชื่อเข้าใช้" แสดงสถานะเชื่อมต่อโดยไม่มีวิธีเรียกใช้ขั้นตอน OAuth การท้าทาย 401 ตอบทุกคำขอที่ไม่ผ่านการรับรองความถูกต้อง คืนค่าการลงชื่อเข้าใช้ OAuth ที่เวลาเชื่อมต่อ การมองเห็นไดเรกทอรีไม่เปลี่ยนแปลงผ่านการ์ดเซิร์ฟเวอร์แบบคงที่และข้อมูลเมตาของรีจิสทรี
• v0.6.0: การค้นพบ MCP (initialize, tools/list, resources/*, prompts/list, server/discover) ให้บริการโดยไม่ต้องมีข้อมูลรับรองเพื่อให้ไคลเอนต์และไดเรกทอรีสามารถแจกแจงเครื่องมือก่อนลงชื่อเข้าใช้ การเรียกเครื่องมือยังต้องใช้ OAuth หรือคีย์ API โหมด stdio เริ่มต้นโดยไม่มี SEARCH1API_KEY และให้บริการข้อมูลเมตาของเครื่องมือ ปฏิเสธเฉพาะที่เวลาเรียก คำขอที่ผิดรูปแบบตอบเป็น JSON-RPC แทนหน้าแสดงข้อผิดพลาด HTML
• v0.5.4: ผู้ออก OAuth ย้ายไปที่ clerk.s1.dev และกำหนดค่าได้ด้วย OAUTH_AUTHORIZATION_SERVER; การ์ดเซิร์ฟเวอร์ MCP เผยแพร่ที่ /.well-known/mcp/server-card.json; เอกสารการค้นพบ OAuth ส่งส่วนหัวแคชแล้ว
• v0.5.3: ข้อมูลเมตาทรัพยากรและเครื่องมือ OAuth ไม่ต้องใช้ขอบเขตเซสชัน OIDC อีกต่อไป เพิ่มป้ายรีจิสทรี Smithery และ Glama
• v0.5.2: การตรวจสอบ Origin ของ MCP ทำงานก่อนการแยกวิเคราะห์คำขอและการรับรองความถูกต้อง การปรับใช้ HTTP ที่โฮสต์เองสามารถกำหนดค่าต้นทางเบราว์เซอร์ที่เชื่อถือได้ด้วย MCP_ALLOWED_ORIGINS
• v0.5.1: เอกสาร, แถลงการณ์ LobeHub และข้อมูลเมตาของ MCP Registry ซิงค์กัน; robots.txt ให้บริการบนโฮสต์การขนส่ง
• v0.5.0: รองรับ MCP 2026-07-28 พร้อมการเจรจาโปรโตคอลอัตโนมัติ ความเข้ากันได้แบบไร้สถานะสำหรับไคลเอนต์ HTTP ยุค 2025 การรับรองความถูกต้องระดับคำขอ
• v0.4.0: สคีมาเอาต์พุตที่มีโครงสร้าง สคีมาความปลอดภัย OAuth คำอธิบายประกอบความปลอดภัย และข้อมูลเมตาของ MCP Registry อย่างเป็นทางการ
• v0.3.1: รองรับ OAuth 2.1 สำหรับ Remote MCP; ลบเครื่องมือการใช้เหตุผลที่เลิกใช้แล้ว
• v0.3.0: รองรับ Remote MCP ผ่าน Streamable HTTP; การรับรองความถูกต้องด้วยคีย์ API ต่อเซสชัน
• v0.2.0: รองรับ .env สำรองสำหรับการผสานรวม 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: ไซต์แมป
• v0.1.1: การรวบรวมเว็บ
• v0.1.0: การเปิดตัวครั้งแรก

ใบอนุญาต

MIT