iflow-mcp_damionrashford-rivalsearchmcp 1.0.1
Advanced web research and content discovery MCP server
Requires Python: >=3.10

# RivalSearchMCP

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](LICENSE)
![MCP Server](https://img.shields.io/badge/MCP-Server-blue?style=for-the-badge)
![Python](https://img.shields.io/badge/Python-3.9+-3776AB?logo=python&logoColor=white&style=for-the-badge)
![FastMCP](https://img.shields.io/badge/FastMCP-Powered-green?style=for-the-badge)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue?logo=linkedin&style=for-the-badge)](https://www.linkedin.com/in/damion-rashford)

![GitHub Stars](https://img.shields.io/github/stars/damionrashford/RivalSearchMCP?style=social)
![GitHub Forks](https://img.shields.io/github/forks/damionrashford/RivalSearchMCP?style=social)
![GitHub Issues](https://img.shields.io/github/issues/damionrashford/RivalSearchMCP?style=social)
![Last Commit](https://img.shields.io/github/last-commit/damionrashford/RivalSearchMCP?style=social)
![Visitor Count](https://visitor-badge.laobi.icu/badge?page_id=damionrashford.RivalSearchMCP)

**Advanced MCP server for web research, content discovery, social media analysis, and AI-powered research.**

> 🆓 **100% Free & Open Source** — No API keys, no subscriptions, no rate limits. Just add one URL and go.

## What It Does

RivalSearchMCP provides comprehensive tools for accessing web content, performing multi-engine searches across DuckDuckGo, Yahoo, and Wikipedia, analyzing websites, social media, news, GitHub repositories, and documents with OCR. It includes 10 specialized tools organized into key categories for comprehensive web research capabilities.

## ✅ Why It's Useful

- Access web content and perform searches with anti-detection measures
- Analyze website content and structure with intelligent crawling
- Conduct end-to-end research workflows with progress tracking
- Search social media platforms (Reddit, Hacker News, Dev.to, Product Hunt, Medium)
- Aggregate news from multiple sources with no authentication required
- Analyze documents (PDF, Word, Text, Images) with OCR support
- Search social media and news across 8 platforms simultaneously
- Integrate with AI assistants for enhanced web research

## 💡 Example Query

Once connected, try asking your AI assistant:

> "Use RivalSearchMCP to research FastAPI vs Django. Search the web, check Reddit and Hacker News discussions, find recent news articles, search GitHub repositories, and analyze academic papers. Then use the research agent to generate a comprehensive comparison report."

## 📦 How to Get Started

RivalSearchMCP runs as a **remote MCP server** hosted on FastMCP. Just follow the steps below to install, and go.

### Connect to Live Server

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=RivalSearchMCP&config=eyJ1cmwiOiJodHRwczovL1JpdmFsU2VhcmNoTUNQLmZhc3RtY3AuYXBwL21jcCJ9)

Or add this configuration manually:

**For Cursor:**
```json
{
  "mcpServers": {
    "RivalSearchMCP": {
      "url": "https://RivalSearchMCP.fastmcp.app/mcp"
    }
  }
}
```

**For Claude Desktop:**
- Go to Settings → Add Remote Server
- Enter URL: `https://RivalSearchMCP.fastmcp.app/mcp`

**For VS Code:**
- Add the above JSON to your `.vscode/mcp.json` file

**For Claude Code:**
- Use the built-in MCP management: `claude mcp add RivalSearchMCP --url https://RivalSearchMCP.fastmcp.app/mcp`

### Local Installation with FastMCP CLI

**Prerequisites:**
```bash
# Install UV (modern Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install FastMCP CLI (optional but recommended)
uv tool install fastmcp
```

**Method 1: One-Command Install (Easiest)**
```bash
# Clone repository
git clone https://github.com/damionrashford/RivalSearchMCP.git
cd RivalSearchMCP

# Install directly to your MCP client:
fastmcp install claude-desktop server.py   # For Claude Desktop
fastmcp install cursor server.py           # For Cursor
fastmcp install claude-code server.py      # For Claude Code
```

**Method 2: Quick Run (No Installation)**
```bash
git clone https://github.com/damionrashford/RivalSearchMCP.git
cd RivalSearchMCP

# Run directly with FastMCP CLI
fastmcp run server.py  # Auto-detects entrypoint, uses STDIO

# Or run in HTTP mode for testing
fastmcp run server.py --transport http --port 8000
```

**Method 3: Development with Inspector**
```bash
# Run with MCP Inspector for testing
fastmcp dev server.py
```

**Method 4: Manual UV Setup**
```bash
git clone https://github.com/damionrashford/RivalSearchMCP.git
cd RivalSearchMCP
uv sync

# Add to Claude Desktop or Cursor config:
{
  "RivalSearchMCP": {
    "command": "uv",
    "args": [
      "--directory",
      "/full/path/to/RivalSearchMCP",
      "run",
      "python",
      "server.py"
    ]
  }
}
```

## 🛠 Available Tools (10 Total)

### Search & Discovery (5 tools)
- `web_search` — Multi-engine search across DuckDuckGo, Yahoo, and Wikipedia with intelligent fallbacks
- `social_search` — Search Reddit, Hacker News, Dev.to, Product Hunt, and Medium (NO AUTH)
- `news_aggregation` — Aggregate news from Google News, DuckDuckGo News, and Yahoo News (NO AUTH)
- `github_search` — Search GitHub repositories with 60/hour rate limiting (NO AUTH)
- `map_website` — Intelligent website exploration with research, documentation, and mapping modes

### Content Analysis (3 tools)
- `content_operations` — Consolidated tool for retrieving, streaming, analyzing, and extracting content from URLs
- `research_topic` — End-to-end research workflow for comprehensive topic analysis
- `document_analysis` — Extract text from PDF, Word, Text files, and Images with EasyOCR (NO AUTH, 50MB limit)

### Research & Scientific (2 tools)
- `scientific_research` — Academic paper search and dataset discovery across arXiv, Semantic Scholar (NO AUTH)
- `research_agent` — AI research agent with autonomous tool calling using OpenRouter (7 tools available)

## ⚡ Key Features

- **Multi-Engine Search**: 3 search engines (DuckDuckGo, Yahoo, Wikipedia) with automatic fallbacks
- **Social Media Research**: Search across 5 platforms (Reddit, Hacker News, Dev.to, Product Hunt, Medium)
- **News Aggregation**: 3 news sources (Google News, DuckDuckGo News, Yahoo News)
- **GitHub Integration**: Repository search with built-in rate limiting
- **Document Analysis**: PDF, Word, Text, and Images with EasyOCR (zero-install, auto-downloads models)
- **AI Research Agent**: Autonomous research agent that uses 7 tools and generates 4000+ character reports
- **Content Processing**: Advanced content extraction and analysis with workflow hints
- **Scientific Discovery**: Academic paper and dataset search across arXiv and Semantic Scholar
- **Zero Authentication**: All 10 tools work without any API keys or authentication

## 💬 FAQ

<details>
<summary><strong>Is RivalSearchMCP really free?</strong></summary>

Yes! RivalSearchMCP is 100% free and open source under the MIT License. There are no API costs, no subscriptions, and no rate limits. You can use the hosted server or run it locally.
</details>

<details>
<summary><strong>Do I need API keys?</strong></summary>

No. RivalSearchMCP works completely without any API keys, authentication, or configuration. Just add the URL and use all 10 tools immediately.
</details>

<details>
<summary><strong>What MCP clients are supported?</strong></summary>

RivalSearchMCP works with any MCP-compatible client including Claude Desktop, Cursor, VS Code, and Claude Code.
</details>

<details>
<summary><strong>Can I self-host this?</strong></summary>

Absolutely! Clone the repo, install dependencies, and run `python server.py`. Full instructions are in the Getting Started section above.
</details>

## 📚 Documentation

For detailed guides and examples, visit the **[Full Documentation](https://damionrashford.github.io/RivalSearchMCP)**.

## 🤝 Contributing

Contributions are welcome! Whether it's fixing bugs, adding new research tools, or improving documentation, your help is appreciated.

1. **Fork the Project**
2. **Create your Feature Branch** (`git checkout -b feature/AmazingFeature`)
3. **Commit your Changes** (`git commit -m 'Add some AmazingFeature'`)
4. **Push to the Branch** (`git push origin feature/AmazingFeature`)
5. **Open a Pull Request**

## 💡 Issues, Feedback & Support

Found a bug, have a feature request, or want to share how you're using RivalSearchMCP? We'd love to hear from you!

- **Report a bug** — Help us improve by reporting issues
- **Request a feature** — Suggest new capabilities you'd find useful
- **Share your use case** — Tell us how you're using RivalSearchMCP

👉 **[Open an Issue](https://github.com/damionrashford/RivalSearchMCP/issues)**

## Attribution & License

This is an open source project under the **MIT License**. If you use RivalSearchMCP, please credit it by linking back to [RivalSearchMCP](https://github.com/damionrashford/RivalSearchMCP). See [LICENSE](LICENSE) file for details.

## ⭐ Like this project? Give it a star!

If you find RivalSearchMCP useful, please consider giving it a star. It helps others discover the project and motivates continued development!

[![Star this repo](https://img.shields.io/github/stars/damionrashford/RivalSearchMCP?style=social)](https://github.com/damionrashford/RivalSearchMCP)