rival-search-mcp

# RivalSearchMCP You have access to 10 research tools via the CLI at `scripts/cli.py`. Run all commands with `uv run scripts/cli.py`. ## How to invoke tools ```bash uv run scripts/cli.py call-tool <tool_name> --flag value ``` ## Available tools - `web_search` — search Yahoo and DuckDuckGo. Use for general web queries. - `social_search` — search Reddit, Hacker News, Dev.to, Product Hunt, Medium. Use for community discussions and opinions. - `news_aggregation` — search Google News. Use for current events and recent coverage. - `github_search` — search public GitHub repos. Use for finding code, libraries, projects. - `map_website` — crawl and map a website. Use to explore site structure or documentation. - `content_operations` — retrieve, analyze, or extract from a URL. Use to get full page content after finding URLs. - `document_analysis` — extract text from PDFs, Word docs, images (OCR). Use for document processing. - `research_topic` — automated multi-source research on a topic. Use for broad research. - `scientific_research` — search arXiv, PubMed, Semantic Scholar, Kaggle, HuggingFace. Use for academic papers and datasets. - `research_agent` — AI agent that orchestrates all tools autonomously. Use for comprehensive deep research. Requires OPENROUTER_API_KEY. ## When to chain tools - Found a URL from search? → `content_operations --operation retrieve --url <url>` - Found a PDF link? → `document_analysis --url <url>` - Need to explore a website? → `map_website --url <u...