Senuto MCP Server

Model Context Protocol (MCP) server for Senuto API - providing comprehensive SEO visibility analysis and keyword research tools.

Features

Visibility Analysis Tools (10 endpoints)

• get_positions_data: Get detailed keyword statistics including positions, visibility metrics, search volume, CPC, and historical data
• get_domain_statistics: Get essential domain metrics (Top 3/10/50, visibility, domain rank, ads equivalent)
• get_competitors: Analyze competing domains with detailed SEO metrics comparison
• get_cannibalization_keywords: Detect keyword cannibalization where multiple URLs compete for the same keywords
• get_subdomains: Analyze subdomain visibility distribution and performance
• get_characteristics_table: Segment keywords by length, trends, volume, difficulty, and SERP features
• get_positions_history_chart: Get historical position tracking data for visualization
• get_keyword_history: Track position history for specific keywords over time
• get_url_sections: Analyze keyword distribution across URL structure (/blog/, /products/, etc.)
• get_urls: Get individual URL performance with keywords and visibility metrics

Keyword Explorer Tools (2 endpoints)

• get_questions: Discover question-based keywords with featured snippet opportunities
• get_groups: Get semantic keyword clusters for topic planning and content strategy

Utility Tools (3 endpoints)

• get_countries_list: Get all available countries/markets for analysis
• suggest_domains: Domain suggester for competitor discovery

Quick Start

New to MCP servers? Check out our Quick Start Guide for a 5-minute setup!

Installation

npm install
npm run build

Configuration

Getting Your API Key

1. Log in to your Senuto account at https://app.senuto.com
2. Navigate to API settings
3. Generate or copy your API key

Environment Variables

Set up your environment variables. The following variables are required:

SENUTO_API_KEY=your_api_key_here
SENUTO_API_URL=https://api.senuto.com  # Optional, defaults to https://api.senuto.com

Note: The API key should be kept secure and never committed to version control.

Usage

Using with Claude Desktop

Add to your Claude Desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "senuto": {
      "command": "node",
      "args": ["/absolute/path/to/senuto-mcp/dist/index.js"],
      "env": {
        "SENUTO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

All tools support multiple countries:

• 200: Poland (Base 2.0, default)
• 1: Poland (legacy database)
• 50: USA
• 164: UK

Core Visibility Analysis

get_positions_data - Get keyword ranking data

• Parameters: domain, fetch_mode, country_id, page, limit
• Returns: Detailed keyword statistics with positions, visibility, volume, CPC, difficulty

get_domain_statistics - Get domain health metrics

• Parameters: domain, fetch_mode, country_id, days_compare_mode
• Returns: Top 3/10/50 counts, visibility, domain rank, ads equivalent

get_competitors - Analyze competition

• Parameters: domain, fetch_mode, country_id, page, limit
• Returns: Competitor list with SEO metrics and common keywords

SEO Audit Tools

get_cannibalization_keywords - Find cannibalization issues

• Parameters: domain, fetch_mode, country_id
• Returns: Keywords where multiple URLs compete, with severity analysis

get_subdomains - Analyze subdomain performance

• Parameters: domain, fetch_mode, country_id, page, limit
• Returns: Subdomain visibility distribution

get_url_sections - Analyze URL structure

• Parameters: domain, fetch_mode, country_id, page, limit
• Returns: Performance by URL sections (/blog/, /products/, etc.)

get_urls - Individual URL analysis

• Parameters: domain, fetch_mode, country_id, page, limit
• Returns: URL-level keywords and visibility data

Keyword Research

get_characteristics_table - Keyword segmentation

• Parameters: domain, fetch_mode, country_id, characteristics
• Characteristics types: words_count, trends, searches, difficulty, keyword_params, serp_params
• Returns: Keyword distribution by selected characteristic

get_questions - Question keyword discovery

• Parameters: keyword, country_id, limit, page
• Returns: Question keywords with featured snippet opportunities

get_groups - Semantic keyword clusters

• Parameters: keyword, country_id, limit, page
• Returns: Topic clusters with search volume and difficulty

Historical Tracking

get_positions_history_chart - Historical rankings

• Parameters: domain, fetch_mode, country_id, date_min, date_max, date_interval
• Returns: Time-series data for Top 3/10/50 tracking

get_keyword_history - Individual keyword tracking

• Parameters: domain, fetch_mode, country_id, keyword_id, kid
• Returns: Complete position history for specific keyword

Utilities

get_countries_list - Available markets

• Returns: All supported countries with codes

suggest_domains - Domain discovery

• Parameters: value, country_id
• Returns: Similar domains and competitors

For detailed usage examples and query patterns, see EXAMPLES.md

Development

# Install dependencies
npm install

# Build the project
npm run build

# Test API connection
npm run test

# Run in development mode with auto-reload
npm run dev

# Watch mode for TypeScript compilation
npm run watch

API Documentation

For full API documentation, visit: Senuto API Docs

Roadmap

Completed features:

• [x] Visibility Analysis - Positions Data
• [x] Domain Statistics
• [x] Competitor Analysis
• [x] Keyword Cannibalization Detection
• [x] Subdomain Analysis
• [x] Keyword Characteristics & Segmentation
• [x] Historical Position Tracking
• [x] URL & Section Analysis
• [x] Keyword Explorer - Questions
• [x] Keyword Explorer - Semantic Groups
• [x] Domain Suggester

Future planned features:

• [ ] Rank Tracker integration
• [ ] SERP Analysis tools (SERP screenshots, feature extraction)
• [ ] Content Planner features
• [ ] Export functionality (CSV, Excel)
• [ ] Batch operations support
• [ ] Backlink analysis
• [ ] Site audit tools

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines on how to add new features and submit pull requests.

Changelog

See CHANGELOG.md for a list of changes and version history.

License

MIT - See LICENSE for details.

Support

• Documentation: Senuto API Docs
• Email Support: [email protected]
• Senuto Support: https://senuto.com/support

senuto-mcp

senuto-mcp