{"id":"e06cce7e-be3b-485f-aec5-b24226c58fbb","shortId":"hm6NvJ","kind":"skill","title":"rival-search-mcp","tagline":"Deterministic deep research via RivalSearchMCP. 10 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","description":"# RivalSearchMCP\n\nYou have access to 10 research tools via the CLI at `scripts/cli.py`. Run all commands with `uv run scripts/cli.py`.\n\nEvery tool returns deterministic, auditable output. There is no in-server LLM — you're the one doing the synthesis.\n\n## How to invoke tools\n\n```bash\nuv run scripts/cli.py call-tool <tool_name> --flag value\n```\n\n## Available tools\n\n- `web_search` — concurrent search across DuckDuckGo, Bing, Yahoo, Mojeek, Wikipedia. Use for general web queries.\n- `social_search` — Reddit, Hacker News, Stack Overflow, Dev.to, Medium, Product Hunt, Bluesky, Lobste.rs, Lemmy. Use for community discussions.\n- `news_aggregation` — Google News, Bing News, The Guardian, GDELT, DuckDuckGo News. Use for current events. Accepts `--time-range day|week|month|anytime`.\n- `github_search` — search public GitHub repos. Use for code, libraries, projects.\n- `map_website` — crawl a site in `research` / `docs` / `map` mode. Use to explore site structure or documentation.\n- `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.\n- `document_analysis` — extract text from PDFs, Word docs, images (image OCR via EasyOCR). Use for document processing.\n- `research_topic` — two modes: `topic` (search + fetch + findings) and `entity` (fan out to 8 sources for a unified profile). Pass `--session-id` to auto-save findings.\n- `scientific_research` — OpenAlex, CrossRef, arXiv, PubMed, Europe PMC (papers) + Kaggle, HuggingFace, Dataverse, Zenodo (datasets).\n- `research_memory` — persistent workspaces with `start` / `add` / `get` / `list` / `delete`. Use to iterate research across calls.\n\n## When to chain tools\n\n- Found a URL from search? → `content_operations --operation retrieve --url <url>`\n- Want to assess source trust before using results? → `content_operations --operation score --urls '[…]'`\n- Two sources seem to disagree? → `content_operations --operation find_conflicts --urls '[…]'`\n- Found a PDF link? → `document_analysis --url <url>`\n- Need to explore a website? → `map_website --url <url> --mode docs`\n- Doing iterative research? → `research_memory --operation start --topic \"...\"` once, then pass `--session-id` to `research_topic` on every call.\n- Need a unified entity profile in one shot? → `research_topic --mode entity --topic \"OpenAI\"`\n\n## Tool reference\n\nFor full flags, types, and defaults for each tool, read:\n\n- [resources/search.md](resources/search.md) — web_search, social_search, news_aggregation, github_search, map_website\n- [resources/content.md](resources/content.md) — content_operations, document_analysis\n- [resources/research.md](resources/research.md) — research_topic, scientific_research, research_memory\n\n## Output\n\nAll tools return structured text to stdout. Errors go to stderr. Exit codes: 0 success, 1 tool error, 2 connection failed.","tags":["rival","search","mcp","rivalsearchmcp","damionrashford","agent-skills","ai-agent","ai-assistant","claude-code","claude-code-skills","claude-mcp","competitor-analysis"],"capabilities":["skill","source-damionrashford","skill-rival-search-mcp","topic-agent-skills","topic-ai-agent","topic-ai-assistant","topic-claude-code","topic-claude-code-skills","topic-claude-mcp","topic-competitor-analysis","topic-cursor-mcp","topic-deterministic-tools","topic-entity-research","topic-fastmcp","topic-market-intelligence"],"categories":["RivalSearchMCP"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/damionrashford/RivalSearchMCP/rival-search-mcp","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add damionrashford/RivalSearchMCP","source_repo":"https://github.com/damionrashford/RivalSearchMCP","install_from":"skills.sh"}},"qualityScore":"0.489","qualityRationale":"deterministic score 0.49 from registry signals: · indexed on github topic:agent-skills · 79 github stars · SKILL.md body (2,942 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T12:55:20.952Z","embedding":null,"createdAt":"2026-04-18T22:13:04.762Z","updatedAt":"2026-05-02T12:55:20.952Z","lastSeenAt":"2026-05-02T12:55:20.952Z","tsv":"'0':410 '1':412 '10':10,33 '2':415 '5':12,22,26 '8':224 '9':17 'academ':27 'accept':131 'access':31 'across':87,267 'add':259 'aggreg':117,377 'analysi':195,312,387 'analyz':175 'anytim':138 'arxiv':243 'assess':285 'audit':52 'auto':236 'auto-sav':235 'avail':81 'bash':72 'bing':89,120 'blueski':109 'call':77,268,343 'call-tool':76 'chain':271 'cli':38 'code':147,409 'command':43 'communiti':114 'concurr':85 'conflict':179,305 'connect':416 'content':167,185,278,291,301,384 'crawl':152 'crossref':242 'current':129 'dataset':252 'datavers':250 'day':135 'deep':6 'default':365 'delet':262 'determinist':5,51 'dev.to':105 'disagr':191 'disagre':300 'discuss':115 'doc':157,201,323 'document':166,194,209,311,386 'duckduckgo':88,125 'duckduckgo/bing/yahoo/mojeek/wikipedia':16 'easyocr':206 'engin':13 'entiti':220,347,355 'error':404,414 'europ':245 'event':130 'everi':48,342 'exit':408 'explor':162,316 'extract':176,196 'fail':417 'fan':221 'fetch':217 'find':178,218,238,304 'flag':79,362 'found':273,307 'full':183,361 'gdelt':124 'general':95 'get':182,260 'github':139,143,378 'go':405 'googl':118 'google/bing/guardian/gdelt/ddg':25 'guardian':123 'hacker':101 'huggingfac':249 'hunt':108 'id':233,337 'imag':202,203 'in-serv':57 'invok':70 'iter':265,325 'kaggl':248 'lemmi':111 'librari':148 'link':310 'list':261 'llm':60 'lobste.rs':110 'map':150,158,319,380 'mcp':4 'medium':106 'memori':254,328,395 'mode':159,214,322,354 'mojeek':91 'month':137 'need':314,344 'news':24,102,116,119,121,126,376 'ocr':204 'one':64,169,350 'op':172 'openai':357 'openalex':241 'oper':168,279,280,292,293,302,303,329,385 'output':53,396 'overflow':104 'page':184 'paper':247 'pass':230,334 'pdf':309 'pdfs':199 'persist':255 'platform':18 'pmc':246 'process':210 'product':107 'profil':229,348 'project':149 'public':142 'pubm':244 'qualiti':188 'queri':97 'rang':134 'rate':186 're':62 'read':369 'reddit':100 'reddit/hn/stackoverflow/dev.to/medium/producthunt/bluesky/lobste.rs/lemmy':21 'refer':359 'repo':144 'research':7,34,156,211,240,253,266,326,327,339,352,390,393,394 'resources/content.md':382,383 'resources/research.md':388,389 'resources/search.md':370,371 'result':290 'retriev':173,281 'return':50,399 'rival':2 'rival-search-mcp':1 'rivalsearchmcp':9,28 'run':41,46,74 'save':237 'scientif':239,392 'score':177,294 'scripts/cli.py':40,47,75 'search':3,15,20,84,86,99,140,141,216,277,373,375,379 'seem':298 'server':59 'session':232,336 'session-id':231,335 'shot':351 'site':154,163 'six':171 'skill' 'skill-rival-search-mcp' 'social':19,98,374 'sourc':23,187,193,225,286,297 'source-damionrashford' 'stack':103 'start':258,330 'stderr':407 'stdout':403 'stream':174 'structur':164,400 'success':411 'surfac':190 'synthesi':67 'text':197,401 'time':133 'time-rang':132 'tool':11,35,49,71,78,82,170,272,358,368,398,413 'topic':212,215,331,340,353,356,391 'topic-agent-skills' 'topic-ai-agent' 'topic-ai-assistant' 'topic-claude-code' 'topic-claude-code-skills' 'topic-claude-mcp' 'topic-competitor-analysis' 'topic-cursor-mcp' 'topic-deterministic-tools' 'topic-entity-research' 'topic-fastmcp' 'topic-market-intelligence' 'trust':287 'two':213,296 'type':363 'unifi':228,346 'url':275,282,295,306,313,321 'use':93,112,127,145,160,180,207,263,289 'uv':45,73 'valu':80 'via':8,36,205 'want':283 'web':14,83,96,372 'websit':151,318,320,381 'week':136 'wikipedia':92 'word':200 'workspac':256 'yahoo':90 'zenodo':251","prices":[{"id":"56cc3cf7-ee6c-4aef-a893-768799d66232","listingId":"e06cce7e-be3b-485f-aec5-b24226c58fbb","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"damionrashford","category":"RivalSearchMCP","install_from":"skills.sh"},"createdAt":"2026-04-18T22:13:04.762Z"}],"sources":[{"listingId":"e06cce7e-be3b-485f-aec5-b24226c58fbb","source":"github","sourceId":"damionrashford/RivalSearchMCP/rival-search-mcp","sourceUrl":"https://github.com/damionrashford/RivalSearchMCP/tree/main/skills/rival-search-mcp","isPrimary":false,"firstSeenAt":"2026-04-18T22:13:04.762Z","lastSeenAt":"2026-05-02T12:55:20.952Z"}],"details":{"listingId":"e06cce7e-be3b-485f-aec5-b24226c58fbb","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"damionrashford","slug":"rival-search-mcp","github":{"repo":"damionrashford/RivalSearchMCP","stars":79,"topics":["agent-skills","ai-agent","ai-assistant","claude-code","claude-code-skills","claude-mcp","competitor-analysis","cursor-mcp","deterministic-tools","entity-research","fastmcp","market-intelligence","mcp","mcp-server","modelcontextprotocol","osint","research-tools","search-engine","structured-output","web-research"],"license":"mit","html_url":"https://github.com/damionrashford/RivalSearchMCP","pushed_at":"2026-04-17T08:37:08Z","description":"Deterministic research MCP server on FastMCP 3 — 5-engine web search, 9-platform social search, 6 academic DBs, news aggregation, entity profiles, conflict detection, document analysis. No API keys. No in-server LLM. Structured outputs for agent chaining.","skill_md_sha":"e6f320f00cdb2a9239fa39404d6fd25892ad20bc","skill_md_path":"skills/rival-search-mcp/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/damionrashford/RivalSearchMCP/tree/main/skills/rival-search-mcp"},"layout":"multi","source":"github","category":"RivalSearchMCP","frontmatter":{"name":"rival-search-mcp","description":"Deterministic deep research via RivalSearchMCP. 10 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 persistent research workspaces. No API keys required. Use when the user needs web research, competitive analysis, content discovery, or academic paper search."},"skills_sh_url":"https://skills.sh/damionrashford/RivalSearchMCP/rival-search-mcp"},"updatedAt":"2026-05-02T12:55:20.952Z"}}