Search1API MCP Server

中文文档

The official MCP server for Search1API — web search, news, crawling, and more in one API.

Get Your API Key

1. Register at Search1API
2. Get your API key from the dashboard

Quick Start (Remote MCP)

No installation required. Just configure your MCP client with the remote URL and your API key.

Authentication

Two methods are supported — use whichever your client supports:

Method	Format
Authorization Header	Authorization: Bearer YOUR_SEARCH1API_KEY
URL Query Parameter	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

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

This repo also includes an Agent Skill that teaches agents how to use Search1API effectively — with decision strategies (when to search vs. crawl, how to tune parameters for different intents), multi-step workflows, and constraints.

The skill works in two modes: it prefers MCP tools when available, and falls back to bundled shell scripts for agents that don't support MCP (e.g. OpenClaw).

npx skills add fatwang2/search1api-mcp

Even if you're already using the MCP server above, the skill adds a strategy layer that helps agents make smarter decisions — like adjusting max_results based on research depth, choosing the right search_service for a query, or running a multi-step search → crawl → synthesize workflow. See the skills/ directory for details.

Quick start — copy and send this to your Agent:

I want to use Search1API for web search and content retrieval. Install the skill (npx skills add fatwang2/search1api-mcp), help me complete the setup, and run a quick test to verify it works.

Update skills:

Update my installed skills to the latest version: npx skills update

Local Mode (stdio)

If you prefer to run the server locally, use npx — no cloning required:

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

Tools

search

Search the web using Search1API.

Parameter	Required	Default	Description
query	Yes	-	Search query
max_results	No	10	Number of results
search_service	No	google	google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	No	0	Number of results to crawl for full content
include_sites	No	[]	Sites to include
exclude_sites	No	[]	Sites to exclude
time_range	No	-	day, month, year

news

Search for news articles.

Parameter	Required	Default	Description
query	Yes	-	Search query
max_results	No	10	Number of results
search_service	No	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	No	0	Number of results to crawl for full content
include_sites	No	[]	Sites to include
exclude_sites	No	[]	Sites to exclude
time_range	No	-	day, month, year

crawl

Extract content from a URL.

Parameter	Required	Description
url	Yes	URL to crawl

sitemap

Get all related links from a URL.

Parameter	Required	Description
url	Yes	URL to get sitemap

reasoning

Deep thinking and complex problem solving with DeepSeek R1.

Parameter	Required	Description
content	Yes	The question or problem

trending

Get trending topics from popular platforms.

Parameter	Required	Default	Description
search_service	Yes	-	github, hackernews
max_results	No	10	Number of items

Version History

• 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.4: Reasoning tool with DeepSeek R1
• v0.1.3: News search
• v0.1.2: Sitemap
• v0.1.1: Web crawling
• v0.1.0: Initial release

License

MIT