Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fatwang2/search1api-mcp


https://github.com/fatwang2/search1api-mcp

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

# Search1API MCP Server

A Model Context Protocol (MCP) server that provides search and crawl functionality using Search1API.

https://github.com/user-attachments/assets/58bc98ae-3b6b-442c-a7fc-010508b5f028

## Features

- Web search functionality through Search1API
- Web page content extraction
- Website sitemap extraction
- Seamless integration with Claude Desktop

## Tools

### 1. Search Tool
- Name: `search`
- Description: Search the web using Search1API
- Parameters:
* `query` (required): Search query
* `max_results` (optional, default: 10): Number of results to return
* `search_service` (optional, default: "google"): Search service to use

### 2. Crawl Tool
- Name: `crawl`
- Description: Extract content from a URL using Search1API
- Parameters:
* `url` (required): URL to crawl

### 3. Sitemap Tool
- Name: `sitemap`
- Description: Get all related links from a URL
- Parameters:
* `url` (required): URL to get sitemap

## Setup Guide

### 1. Get Search1API Key
1. Register at [Search1API](https://www.search1api.com/)
2. Choose a pricing plan (starts from $0.99)
3. After payment, copy your API key from the confirmation email

### 2. Configure Claude Desktop
Update your Claude configuration file (`claude_desktop_config.json`) with the following content:

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

Configuration file location:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

## Version History

- v0.1.2: Added sitemap functionality
- v0.1.1: Added web crawling functionality
- v0.1.0: Initial release with search functionality

## License

This project is licensed under the MIT License - see the LICENSE file for details.