Search1API MCP Server

中文文档

The official MCP server for Search1API — web search, news, page retrieval, sitemap discovery, and trending topics in one API.

Authentication

• OAuth-aware clients can connect to the Remote MCP URL directly, then sign in and approve access in the browser.
• Existing integrations can continue to use an API key from the Search1API dashboard.

Quick Start (Remote MCP)

No installation required. Configure your MCP client with the remote URL. Use OAuth when the client supports it, or provide an API key.

Authentication

Three methods are supported — use whichever your client supports:

Prefer OAuth or the Authorization header. Query-parameter credentials can be exposed in URLs, logs, and shell history.

Claude Desktop

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

Claude.ai (Web)

Settings > Connectors > Add custom connector:

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

Cursor

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

The Agent Skill has moved to search1api-cli. Install it with:

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

Local Mode (stdio)

If you prefer to run the server locally, use Node.js 20 or newer with npx — no cloning required:

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

For self-hosted HTTP deployments behind a proxy, add any internal hostnames

that reach the Node.js process to the comma-separated MCP_ALLOWED_HOSTS

environment variable. mcp.search1api.com and localhost addresses are allowed

by default.

Tools

search

Search the web using Search1API. Results include a citable

id/title/url structure. Pass a result URL to crawl when you need the

full page.

news

Search for news articles.

crawl

Extract content from a URL.

sitemap

Get all related links from a URL.

trending

Get trending topics from popular platforms.

Version History

• v0.5.1: Duplicate fetch tool removed; pass search result URLs directly to crawl
• v0.5.0: MCP 2026-07-28 support with automatic protocol negotiation; stateless compatibility for 2025-era HTTP clients; request-level authentication
• v0.4.0: Initial search/fetch compatibility, structured output schemas, OAuth security schemes, safety annotations, and Official MCP Registry metadata
• v0.3.1: OAuth 2.1 support for Remote MCP; retired reasoning tool removed
• v0.3.0: Remote MCP support via Streamable HTTP; per-session API key authentication
• v0.2.0: Fallback .env support for LibreChat integration
• v0.1.8: X (Twitter) and Reddit search services
• v0.1.7: Trending tool for GitHub and Hacker News
• v0.1.6: Wikipedia search service
• v0.1.5: New search parameters and services (arxiv, wechat, bilibili, imdb)
• v0.1.3: News search
• v0.1.2: Sitemap
• v0.1.1: Web crawling
• v0.1.0: Initial release

License

MIT