damionrashford/RivalSearchMCP

# RivalSearchMCP [](LICENSE)    [](https://www.linkedin.com/in/damion-rashford)      **Advanced MCP server for web research, content discovery, social media analysis, and AI-powered research.** ## 它做什么 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. ## ✅ 为何有用 - 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 ## 💡 示例查询 Once connected, try asking your AI assistant: ## 📦 如何开始 RivalSearchMCP runs as a **remote MCP server** hosted on FastMCP. Just follow the steps below to install, and go. ### 连接到实时服务器 [](https://cursor.com/en-US install-mcp?name=RivalSearchMCP&config=eyJ1cmwiOiJodHRwczovL1JpdmFsU2VhcmNoTUNQLmZhc3RtY3AuYXBwL21jcCJ9) Or add this configuration manually: **For Cursor:** ``` { "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` ### 使用 FastMCP CLI 本地安装 **Prerequisites:** ``` # 安装 UV（现代 Python 包管理器） curl -LsSf https://astral.sh/uv/install.sh | sh # 安装 FastMCP CLI（可选但推荐） uv tool install fastmcp ``` **Method 1: One-Command Install (Easiest)** ``` # 克隆仓库 git clone https://github.com/damionrashford/RivalSearchMCP.git cd RivalSearchMCP # 直接安装到你的 MCP 客户端： 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)** ``` git clone https://github.com/damionrashford/RivalSearchMCP.git cd RivalSearchMCP # 使用 FastMCP CLI 直接运行 fastmcp run server.py # Auto-detects entrypoint, uses STDIO # 或以 HTTP 模式运行用于测试 fastmcp run server.py --transport http --port 8000 ``` **Method 3: Development with Inspector** ``` # 使用 MCP Inspector 运行用于测试 fastmcp dev server.py ``` **Method 4: Manual UV Setup** ``` git clone https://github.com/damionrashford/RivalSearchMCP.git cd RivalSearchMCP uv sync # 添加到 Claude Desktop 或 Cursor 配置： { "RivalSearchMCP": { "command": "uv", "args": [ "--directory", "/full/path/to/RivalSearchMCP", "run", "python", "server.py" ] } } ``` ## 🛠 可用工具（总计 10 个） ### 搜索与发现（5 个工具） - `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 ### 内容分析（3 个工具） - `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) ### 研究与科学（2 个工具） - `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) ## 代理技能 RivalSearchMCP ships with a **Claude Code Agent Skill** — a self-contained CLI that lets AI agents use all 10 tools without MCP configuration. ### 作为 Claude Code 技能使用 Copy the skill into your Claude Code skills directory: ``` # 项目级（在当前仓库中工作时可用） cp -r skills/rival-search-mcp .claude/skills/ # 全局（在所有项目中可用） cp -r skills/rival-search-mcp ~/.claude/skills/ ``` Claude will automatically discover the skill and use the CLI when you ask for web research, competitor analysis, or content discovery. ### 直接使用 CLI The CLI is self-contained with inline dependencies — just run with `uv`: ``` uv run skills/rival-search-mcp/scripts/cli.py call-tool web_search --query "your query" uv run skills/rival-search-mcp/scripts/cli.py call-tool social_search --query "AI agents" --platforms reddit uv run skills/rival-search-mcp/scripts/cli.py call-tool news_aggregation --query "tech news" --time-range week uv run skills/rival-search-mcp/scripts/cli.py list-tools ``` ### 技能结构 ``` skills/rival-search-mcp/ ├── SKILL.md # Agent instructions (auto-loaded by Claude Code) ├── scripts/ │ └── cli.py # Standalone CLI with all 10 tools └── resources/ ├── search.md # web_search, social_search, news, github, map_website ├── content.md # content_operations, document_analysis └── research.md # research_topic, scientific_research, research_agent ``` ## ⚡ 关键特性 - **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 ## 💬 常见问题

Is RivalSearchMCP really free?

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.

Do I need API keys?

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

What MCP clients are supported?

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

Can I self-host this?

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

## 📚 文档 For detailed guides and examples, visit the **[Full Documentation](https://damionrashford.github.io/RivalSearchMCP)**. ## 💡 问题、反馈与支持 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)** ## 归属与许可 This is an open source 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. ## ⭐ 喜欢这个项目？给它一颗星！ If you find RivalSearchMCP useful, please consider giving it a star. It helps others discover the project and motivates continued development! [](https://github.com/damionrashford/RivalSearchMCP)

标签：AI研究, AI辅助研究, DNS解析, FastMCP, GitHub Stars, Hacker News, MCP服务器, OCR识别, Python, Reddit, 内容发现, 匿名搜索, 反检测, 多引擎搜索, 大模型研究, 威胁情报, 市场分析, 开发者工具, 开源项目, 文档解析, 新闻聚合, 无API密钥, 无后门, 社交分析, 社交媒体监控, 竞争情报, 趋势监测, 逆向工具