# rivalsearch

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add rashforddamion/rivalsearch

# Browse available tools
npx -y smithery tool list rashforddamion/rivalsearch

# Get full schema for a tool
npx -y smithery tool get rashforddamion/rivalsearch retrieve_content

# Call a tool
npx -y smithery tool call rashforddamion/rivalsearch retrieve_content '{}'
```

## Direct MCP Connection

Endpoint: `https://rivalsearch--rashforddamion.run.tools`

## Tools (18)

- `retrieve_content` — Enhanced content retrieval with support for single/multiple resources and image extraction.
- `stream_content` — Retrieve streaming content from WebSocket URLs.
- `google_search` — Advanced Google Search with Cloudflare bypass, rich snippets detection, and multi-engine fallback
- `traverse_website` — Comprehensive website traversal with different modes for different use cases.
- `analyze_content` — Analyze content and extract insights.
- `research_topic` — End-to-end research workflow for a topic.
- `search_trends` — Search for Google Trends data for given keywords.
- `get_related_queries` — Get related queries for a keyword.
- `get_interest_by_region` — Get interest by geographic region for a keyword.
- `get_trending_searches` — Get trending searches for a location.
- `export_trends_to_csv` — Export Google Trends data to CSV format (returns data instead of writing to file).
- `export_trends_to_json` — Export Google Trends data to JSON format (returns data instead of writing to file).
- `create_sql_table` — Create SQLite table structure with Google Trends data (returns schema instead of creating files).
- `get_available_timeframes` — Get list of available timeframes for Google Trends queries.
- `get_available_regions` — Get list of available geographic regions.
- `compare_keywords_comprehensive` — Comprehensive comparison of multiple keywords including trends, related queries, and regional interest.
- `generate_llms_txt` — Generate LLMs.txt files for a website following the llmstxt.org specification.
- `comprehensive_research` — Perform comprehensive research using multiple tools and workflows

```bash
# Get full input/output schema for a tool
npx -y smithery tool get rashforddamion/rivalsearch <tool-name>
```

## Resources

- `data://server/status` — Get current server status and capabilities.
- `data://tools/categories` — Get organized tool categories for better discovery.
- `data://performance/metrics` — Get server performance metrics.
- `data://configuration/settings` — Get current server configuration.
- `data://help/usage_examples` — Get usage examples for common workflows.

## Prompts (18)

- `research_workflow_prompt` (topic, depth) — Generate a research workflow prompt for the given topic.
- `content_analysis_prompt` (content_type, analysis_focus) — Generate a content analysis prompt.
- `market_research_prompt` (industry, research_scope) — Generate a market research prompt.
- `technical_research_prompt` (technology, research_type) — Generate a technical research prompt.
- `retrieve_content_prompt` (resource, limit, extract_images) — Guide for enhanced content retrieval using retrieve_content.
- `stream_content_prompt` (url) — Guide for retrieving streaming content using stream_content.
- `google_search_prompt` (query, num_results, use_multi_engine) — Guide for comprehensive Google search using google_search.
- `traverse_website_prompt` (url, mode, max_pages) — Guide for comprehensive website traversal using traverse_website.
- `analyze_content_prompt` (content, analysis_type) — Guide for content analysis using analyze_content.
- `research_topic_prompt` (topic, max_sources) — Guide for end-to-end research using research_topic.
- `search_trends_prompt` (keywords, timeframe, geo) — Guide for Google Trends analysis using search_trends.
- `get_related_queries_prompt` (keyword, timeframe, geo) — Guide for related queries analysis using get_related_queries.
- `get_interest_by_region_prompt` (keyword, resolution, timeframe) — Guide for regional interest analysis using get_interest_by_region.
- `get_trending_searches_prompt` (geo) — Guide for trending searches analysis using get_trending_searches.
- `export_trends_prompt` (keywords, timeframe, geo) — Guide for trends data export using export_trends_to_csv or export_trends_to_json.
- `create_sql_table_prompt` (keywords, timeframe, geo) — Guide for SQL table creation using create_sql_table.
- `compare_keywords_comprehensive_prompt` (keywords, timeframe, geo) — Guide for comprehensive keyword comparison using compare_keywords_comprehensive.
- `generate_llms_txt_prompt` (url) — Guide for LLMs.txt generation using generate_llms_txt.
