damionrashford/RivalSearchMCP / plugins/rival-search-mcp-skills/skills/rival-search-mcp
rival-search-mcp
VerifiedDeterministic deep research via RivalSearchMCP. 9 tools: 5-engine web search (DuckDuckGo/Bing/Yahoo/Mojeek/Wikipedia), 9-platform social search (Reddit/HN/StackOverflow/Dev.to/Medium/ProductHunt/Bluesky/Lobste.rs/Lemmy), 5-source news (Google/Bing/Guardian/GDELT/DDG), 5 academic DBs (OpenAlex/CrossRef/arXiv/PubMed/EuropePMC), GitHub search, website mapping, content extraction with OCR, and research topic synthesis. No API keys required. Use when the user needs web research, competitive analysis, content discovery, or academic paper search.
RivalSearchMCP
You have access to 9 research tools via the CLI at scripts/cli.py. Run all commands with uv run scripts/cli.py.
Every tool returns deterministic, auditable output. There is no in-server LLM — you're the one doing the synthesis.
How to invoke tools
uv run scripts/cli.py call-tool <tool_name> --flag value
Available tools
web_search— concurrent search across DuckDuckGo, Bing, Yahoo, Mojeek, Wikipedia. Use for general web queries.social_search— Reddit, Hacker News, Stack Overflow, Dev.to, Medium, Product Hunt, Bluesky, Lobste.rs, Lemmy. Use for community discussions.news_aggregation— Google News, Bing News, The Guardian, GDELT, DuckDuckGo News. Use for current events. Accepts--time-range day|week|month|anytime.github_search— search public GitHub repos. Use for code, libraries, projects.map_website— crawl a site inresearch/docs/mapmode. Use to explore site structure or documentation.content_operations— one tool, six ops (retrieve,stream,analyze,extract,score,find_conflicts). Use to get full page content, rate source quality, or surface disagreements between sources.document_analysis— extract text from PDFs, Word docs, images (image OCR via EasyOCR). Use for document processing.research_topic— end-to-end research workflow for a topic, combining search, content retrieval, and analysis.scientific_research— OpenAlex, CrossRef, arXiv, PubMed, Europe PMC (papers) + Kaggle, HuggingFace, Dataverse, Zenodo (datasets).
When to chain tools
- Found a URL from search? →
content_operations --operation retrieve --url <url> - Want to assess source trust before using results? →
content_operations --operation score --urls '[…]' - Two sources seem to disagree? →
content_operations --operation find_conflicts --urls '[…]' - Found a PDF link? →
document_analysis --url <url> - Need to explore a website? →
map_website --url <url> --mode docs - Need a unified entity profile in one shot? →
research_topic --mode entity --topic "OpenAI"
Tool reference
For full flags, types, and defaults for each tool, read:
- resources/search.md — web_search, social_search, news_aggregation, github_search, map_website
- resources/content.md — content_operations, document_analysis
- resources/research.md — research_topic, scientific_research
Output
All tools return structured text to stdout. Errors go to stderr. Exit codes: 0 success, 1 tool error, 2 connection failed.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |