How do I install Semust?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Semust need an API key?

No required environment variable is listed on this record.

What transport does Semust use?

Semust runs locally over stdio.

When was Semust last checked?

Last checked 2026-10-27. Semust MCP Server for SEO & ADS professionals.

Semust MCP-Server

Semust MCP Server

Ask Claude about your SEO and advertising data in plain language. This MCP server connects Claude Desktop (and Claude Code, and Cursor) to your Semust account — keywords, pages, traffic trends, SEO reports, Semust Metrik, Google Analytics, Google Ads, Yandex Metrica, Bing Webmaster, and more.

"Show me my top keywords for the last month"

"Which pages are losing traffic?"

"How is my organic traffic compared to last month?"

"Which landing pages convert best?"

"How are my Google Ads campaigns performing?"

How It Works

You ask Claude a question
        |
Claude Desktop (on your machine)
        |
   MCP Server (on your machine) ---- Your API key stays here, never sent to Claude
        |
   Semust API (semust.com)
        |
   Your Google Search Console, Analytics & Ads data
        |
   Results sent back to Claude
        |
Claude answers with SEO insights

Your API key never leaves your machine. Claude only sees the SEO data, not your credentials.

What You Can Ask

Once set up, just talk to Claude naturally:

Traffic & Performance

"How is my site performing this month?"
"Show me daily traffic for the last 30 days"
"Is my traffic growing or declining?"

Keywords

"What are my top 20 keywords?"
"Which keywords are on page 2? Those are my quick wins"
"Find long-tail keyword opportunities"

Google Analytics

"Where does my traffic come from?"
"How is organic vs paid traffic performing?"
"Which landing pages convert best?"
"Show me mobile vs desktop breakdown"
"Which pages have the worst engagement?"

Rank Tracker

"Where do I rank for my keywords?"
"Which keywords gained or lost positions?"
"How many keywords are on page 1?"

AI Rank Tracker

"Am I appearing in Google's AI Overviews?"
"Which competitors are cited in AI answers?"

Indexing Monitor

"Are all my pages indexed?"
"What's my indexing health score?"

Yandex Metrica

"How is my Yandex traffic?"
"What are people searching on Yandex?"
"Show me traffic sources from Yandex"

Semust Metrik (our own analytics — real time)

"How is my site doing this month?"
"Which day did my traffic drop?"
"Where does my traffic come from?"
"Are people clicking more than last month?"
"Who is on my site right now?"
"Which pages are slow for real visitors?"
"How many people go from pricing to signup?"
"What changed on my site last week?"
"Why did my traffic drop — did we change something?"
"What keywords do my competitors rank for that I don't?"

Bing Webmaster

"How are my pages doing on Bing?"
"Show me Bing crawl issues"
"What are my Bing backlinks?"

Google Ads

"How are my campaigns performing?"
"How much am I spending and what's my ROAS?"
"What search terms trigger my ads?"
"Show me ad performance by country"
"Which conversion types am I getting?"

Content Analysis

"Which pages are losing traffic? I need to refresh them"
"Show me my worst performing content"
"Do I have keyword cannibalization issues?"

Reports

"Generate a monthly SEO report for May 2026"
"Which keywords gained or lost traffic this month?"
"Find low CTR keywords I should optimize"
"Give me a complete SEO + analytics report"

Content Ideas

"What questions are people asking that lead to my site?"
"Show me long-tail keywords with 4+ words"

Quick Start

Step 1: Get Your API Key

Make sure you have at least one project with Google Search Console connected, or with Semust Metrik installed — the metrik_* tools need only our own tracking script, no third-party integration at all.

Step 2: Download & Install

Option A: Download ZIP (easiest)

Download ZIP > Extract to a folder you'll remember.

Option B: Git Clone

git clone https://github.com/semust/semust-mcp.git

Then install dependencies:

cd semust-mcp
pip install -r requirements.txt

On macOS and Linux, use pip3 if pip is not found.

Step 3: Configure Claude Desktop

Find your Claude Desktop config file:

Open File Explorer and paste this in the address bar:

%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\

Open claude_desktop_config.json

Open File Explorer and paste this in the address bar:

%APPDATA%\Claude\

Open claude_desktop_config.json

In Finder press Cmd+Shift+G and paste this:

~/Library/Application Support/Claude/

Open claude_desktop_config.json

If claude_desktop_config.json is not there, create it — Claude Desktop only writes the file once you have added a server.

Add mcpServers to the file. If the file already has content, merge this into the existing JSON.

Use the block for your operating system — the Python command and the path format are different on each.

macOS / Linux

{
  "mcpServers": {
    "semust": {
      "command": "python3",
      "args": ["/Users/you/semust-mcp/semust_mcp.py"],
      "env": {
        "SEMUST_API_KEY": "your-api-key-here",
        "SEMUST_BASE_URL": "https://api.semust.com/v1/mcp"
      },
      "alwaysAllow": [
        "list_projects",
        "get_keywords", "get_pages", "get_performance",
        "report_cannibalization", "report_monthly_summary", "report_long_tail",
        "report_winner_loser", "report_questions", "report_content_decay",
        "report_striking_distance", "report_low_ctr", "report_thin_content",
        "ga_get_overview", "ga_get_traffic_sources", "ga_get_pages",
        "ga_get_geo", "ga_get_devices", "ga_get_key_events",
        "ga_report_traffic_trends", "ga_report_landing_page_performance",
        "ga_report_channel_comparison", "ga_report_engagement_analysis",
        "gads_get_campaigns", "gads_get_daily_metrics", "gads_get_geo",
        "gads_get_devices", "gads_get_search_terms",
        "gads_report_performance_overview", "gads_report_spend_analysis",
        "gads_report_conversion_breakdown",
        "rank_get_keywords", "rank_get_overview", "rank_get_history",
        "rank_report_gainers_losers", "rank_report_distribution",
        "ai_rank_get_overview", "ai_rank_get_keywords", "ai_rank_get_domains",
        "indexing_get_status", "indexing_get_history",
        "ym_get_overview", "ym_get_traffic", "ym_get_pages",
        "ym_get_geo", "ym_get_devices", "ym_get_search_phrases",
        "bing_get_query_stats", "bing_get_page_stats", "bing_get_crawl_stats",
        "bing_get_crawl_issues", "bing_get_rank_traffic", "bing_get_link_counts",
        "bing_get_keyword_stats", "bing_get_url_traffic", "bing_get_url_links",
        "metrik_get_overview", "metrik_get_timeseries", "metrik_get_breakdown",
        "metrik_get_events", "metrik_compare_events", "metrik_get_goals",
        "metrik_get_products", "metrik_get_revenue_breakdown", "metrik_get_funnel",
        "metrik_get_paths", "metrik_get_web_vitals", "metrik_get_live",
        "metrik_get_usage", "changes_list", "changes_daily",
        "competitor_list_analyses", "competitor_get_analysis", "competitor_get_status"
      ]
    }
  }
}

Windows

{
  "mcpServers": {
    "semust": {
      "command": "python",
      "args": ["C:\\Users\\you\\semust-mcp\\semust_mcp.py"],
      "env": {
        "SEMUST_API_KEY": "your-api-key-here",
        "SEMUST_BASE_URL": "https://api.semust.com/v1/mcp"
      },
      "alwaysAllow": [
        "list_projects",
        "get_keywords", "get_pages", "get_performance",
        "report_cannibalization", "report_monthly_summary", "report_long_tail",
        "report_winner_loser", "report_questions", "report_content_decay",
        "report_striking_distance", "report_low_ctr", "report_thin_content",
        "ga_get_overview", "ga_get_traffic_sources", "ga_get_pages",
        "ga_get_geo", "ga_get_devices", "ga_get_key_events",
        "ga_report_traffic_trends", "ga_report_landing_page_performance",
        "ga_report_channel_comparison", "ga_report_engagement_analysis",
        "gads_get_campaigns", "gads_get_daily_metrics", "gads_get_geo",
        "gads_get_devices", "gads_get_search_terms",
        "gads_report_performance_overview", "gads_report_spend_analysis",
        "gads_report_conversion_breakdown",
        "rank_get_keywords", "rank_get_overview", "rank_get_history",
        "rank_report_gainers_losers", "rank_report_distribution",
        "ai_rank_get_overview", "ai_rank_get_keywords", "ai_rank_get_domains",
        "indexing_get_status", "indexing_get_history",
        "ym_get_overview", "ym_get_traffic", "ym_get_pages",
        "ym_get_geo", "ym_get_devices", "ym_get_search_phrases",
        "bing_get_query_stats", "bing_get_page_stats", "bing_get_crawl_stats",
        "bing_get_crawl_issues", "bing_get_rank_traffic", "bing_get_link_counts",
        "bing_get_keyword_stats", "bing_get_url_traffic", "bing_get_url_links",
        "metrik_get_overview", "metrik_get_timeseries", "metrik_get_breakdown",
        "metrik_get_events", "metrik_compare_events", "metrik_get_goals",
        "metrik_get_products", "metrik_get_revenue_breakdown", "metrik_get_funnel",
        "metrik_get_paths", "metrik_get_web_vitals", "metrik_get_live",
        "metrik_get_usage", "changes_list", "changes_daily",
        "competitor_list_analyses", "competitor_get_analysis", "competitor_get_status"
      ]
    }
  }
}

Important: Replace the path with the actual location of semust_mcp.py on your machine. It must be an absolute path — Claude Desktop does not expand ~, so ~/semust-mcp/... fails.

macOS / Linux: Get the path by running pwd inside the semust-mcp folder. If python3 is not found, run which python3 and use what it prints (usually /usr/bin/python3, or /opt/homebrew/bin/python3 with Homebrew). There is no python command on a modern macOS — using it is the most common reason the server fails to start.

Windows: Use double backslashes: C:\\Users\\you\\semust-mcp\\semust_mcp.py. If python is not recognised, use the full Python path instead, e.g. C:\\Users\\you\\AppData\\Local\\Programs\\Python\\Python312\\python.exe

alwaysAllow: This list lets Claude use Semust tools without asking for permission each time. All tools are read-only and safe to auto-approve. Remove this field if you prefer to approve each tool call manually.

Quit Claude Desktop completely and reopen it — on Windows right-click the system tray icon > Quit, on macOS press Cmd+Q or choose Claude > Quit. Closing the window is not enough on either.

Step 4: Verify

In a new Claude chat, look for the tools icon (hammer/wrench) near the text input. Click it — you should see "semust-mcp" with 56 tools.

Type: "Show me my projects" — Claude should list your Semust projects.

Security

What	Where	Who can see it
Your API key	`.env` file or Claude Desktop config on your machine	Only you
MCP server	Runs as a local process on your machine	Only you
SEO data (keywords, pages, etc.)	Sent from Semust API to Claude via MCP	You and Claude
Your API key	Never sent to Claude or Anthropic	No one else

The MCP server runs locally on your computer — it is not a cloud service
Your Semust API key is used only for direct requests from your machine to api.semust.com
Claude sees the SEO data responses but never your API key or authentication credentials
The .env file is in .gitignore — it won't be accidentally committed to git
The server refuses to start if SEMUST_BASE_URL is http:// (non-localhost) — your key is never sent in plaintext
Protect your Claude Desktop config file — anyone with read access to it can read your API key
SEO data passed to Claude is treated as user-trusted content; if your Search Console contains spam queries with embedded instructions, the model may act on them — this is inherent to all MCP tools that surface third-party data

Available Tools (74)

Projects

Tool	Description
`list_projects`	List all projects with integration status — always runs first

Search Console — Data

Tool	Description
`get_keywords`	Top keywords by clicks with growth metrics
`get_pages`	Top pages by clicks with growth metrics
`get_performance`	Daily traffic overview with before/after comparison

Search Console — Reports

Tool	Description
`report_cannibalization`	Pages competing for the same keyword
`report_monthly_summary`	Full monthly SEO report with YoY comparison
`report_long_tail`	Long-tail keyword opportunities (3+ words)
`report_winner_loser`	Keywords gaining or losing traffic
`report_questions`	Question-type queries (FAQ/content ideas)
`report_content_decay`	Pages losing traffic over time
`report_striking_distance`	Keywords on page 2-3 (quick wins)
`report_low_ctr`	Low CTR items with click improvement potential
`report_thin_content`	Underperforming content for audit

Google Analytics — Data

Tool	Description
`ga_get_overview`	Core metrics (users, sessions, bounce rate) with comparison
`ga_get_traffic_sources`	Traffic by channel, source, medium, campaign, referrer
`ga_get_pages`	Top pages, entry pages, exit pages
`ga_get_geo`	Visitors by country, region, or city
`ga_get_devices`	Device category, browser, or OS breakdown
`ga_get_key_events`	Key events (conversions) with counts

Google Analytics — Reports

Tool	Description
`ga_report_traffic_trends`	Daily metrics with growth analysis and patterns
`ga_report_landing_page_performance`	Landing page conversion rates (organic)
`ga_report_channel_comparison`	Channel comparison with previous period
`ga_report_engagement_analysis`	Page engagement quality tiers

Google Ads — Data

Tool	Description
`gads_get_campaigns`	Campaign performance with metrics and sorting
`gads_get_daily_metrics`	Daily impressions, clicks, cost, conversions
`gads_get_geo`	Performance by country/geography
`gads_get_devices`	Device breakdown (mobile, desktop, tablet)
`gads_get_search_terms`	Search terms triggering ads (Search campaigns)

Google Ads — Reports

Tool	Description
`gads_report_performance_overview`	Account overview with rankings and type breakdown
`gads_report_spend_analysis`	Spend trends and per-campaign cost breakdown
`gads_report_conversion_breakdown`	Conversion actions with counts and values

Rank Tracker

Tool	Description
`rank_get_keywords`	Keyword rankings with position and changes
`rank_get_overview`	Distribution, visibility score, yesterday's changes
`rank_get_history`	Daily average position history
`rank_report_gainers_losers`	Keywords that gained/lost rankings
`rank_report_distribution`	Position distribution breakdown

AI Rank Tracker

Tool	Description
`ai_rank_get_overview`	AI Overview visibility summary and score
`ai_rank_get_keywords`	Per-keyword AI Overview presence and positions
`ai_rank_get_domains`	Top domains cited in AI Overviews

Indexing Monitor

Tool	Description
`indexing_get_status`	Health score, indexed/not-indexed, coverage, warnings
`indexing_get_history`	Daily indexing counts over time

Yandex Metrica

Tool	Description
`ym_get_overview`	Comprehensive analytics: visitors, pageviews, bounce rate, daily trends
`ym_get_traffic`	Traffic source breakdown (sources, search engines, social)
`ym_get_pages`	Page performance (top, landing, exit, titles)
`ym_get_geo`	Geographic visitor data (countries, regions, cities)
`ym_get_devices`	Device/browser/OS breakdown
`ym_get_search_phrases`	Yandex search keywords driving visits

Semust Metrik

First-party analytics from Semust's own tracking script. Real time — unlike every other source here, today's data is available today. Aggregate only: individual visitor profiles and session journeys are deliberately not exposed.

Tool	Description
`metrik_get_overview`	Visitors, visits, pageviews, bounce rate, duration — with period-over-period change
`metrik_get_timeseries`	Daily series, one row per day
`metrik_get_breakdown`	Any dimension: pages, sources, channels, UTM, countries, cities, devices, browsers, OS
`metrik_get_events`	Event counts by type — clicks, form submits, outbound links
`metrik_compare_events`	Event counts across two periods, with change and percentage
`metrik_get_goals`	Goal completions and conversion rates
`metrik_get_products`	Product-level sales, units and revenue
`metrik_get_revenue_breakdown`	Revenue by country or device
`metrik_get_funnel`	A funnel defined in the conversation, measured on the spot
`metrik_get_paths`	The page sequences visitors actually follow
`metrik_get_web_vitals`	Core Web Vitals from real visitors — LCP, CLS, INP, FCP, TTFB
`metrik_get_live`	Active visitors right now, plus whether the script has ever reported
`metrik_get_usage`	This month's billable event count

Change Monitor

What changed on your own site — the signal no third-party SEO tool has. Pair it with the traffic tools to turn "rankings moved" into "rankings moved after you edited these pages".

Tool	Description
`changes_list`	Detected changes: titles, H1s, canonicals, schema, content, new pages
`changes_daily`	How much the site changed each day — the series to align with traffic

Competitor Analysis

Read-only. A new analysis spends credits, so only the user can start one — these tools show what has already been run, and quote what a new run would cost.

Tool	Description
`competitor_list_analyses`	Past keyword-gap analyses with gap and shared counts
`competitor_get_analysis`	One analysis in full — the keyword matrix and per-domain picture
`competitor_get_status`	What a new run would cost and whether the credits are there

Bing Webmaster

Tool	Description
`bing_get_query_stats`	Search query statistics with clicks, impressions, CTR, position
`bing_get_page_stats`	Page-level search performance
`bing_get_crawl_stats`	Crawl statistics over time
`bing_get_crawl_issues`	Crawl errors and issues
`bing_get_rank_traffic`	Daily impressions and clicks trend
`bing_get_link_counts`	Inbound link counts per URL
`bing_get_keyword_stats`	Keyword volume data (requires keyword param)
`bing_get_url_traffic`	Per-URL traffic data (requires url param)
`bing_get_url_links`	Inbound links for a specific URL (requires url param)

Claude Code Setup

Claude Code registers MCP servers from the command line, so there is no config file to edit. Steps 1 and 2 of the Quick Start are the same — get your API key and install the dependencies — then run:

claude mcp add --scope user semust \
  -e SEMUST_API_KEY=your-api-key-here \
  -e SEMUST_BASE_URL=https://api.semust.com/v1/mcp \
  -- python3 /absolute/path/to/semust-mcp/semust_mcp.py

On Windows, replace python3 with the full path to python.exe and use the Windows path format from Step 3.

--scope user makes the server available in every project. Use --scope local to limit it to the current project, or --scope project to put it in a .mcp.json the rest of your team shares — with project scope, leave out the -e flags and use the .env file below so your key is not committed.

Keeping the key out of the command. Instead of the -e flags, you can put a .env file next to semust_mcp.py:

SEMUST_API_KEY=your-api-key-here
SEMUST_BASE_URL=https://api.semust.com/v1/mcp

The server reads it on startup, and it looks next to its own file rather than in the current directory, so it is found whichever folder Claude Code launches it from.

A virtualenv is worth it here. Pointing the command at a venv's interpreter keeps the server's dependencies off your system Python and makes it immune to your PATH:

cd /path/to/semust-mcp
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
claude mcp add --scope user semust -- /path/to/semust-mcp/.venv/bin/python /path/to/semust-mcp/semust_mcp.py

Verify: run claude mcp list — you should see semust: ... - ✔ Connected. Inside Claude Code, reload the window (VS Code: Developer: Reload Window) or restart the CLI, then type /mcp to see the server and its 56 tools. Ask "Show me my Semust projects" to confirm it works.

Cursor Setup

Add the same MCP server in Cursor: Settings > MCP Servers > Add Server (stdio type).

Use the same command, args, and env values from the Claude Desktop config above — including picking the block that matches your operating system.

Troubleshooting

Problem	Solution
`No module named 'mcp.server.fastmcp'`	You are on a copy older than 1.4.1, which could not start once mcp 2.x came out. Update `semust_mcp.py`, or pin the old version with `pip install "mcp<2"`
Tools icon not showing	Quit Claude Desktop fully — system tray on Windows, Cmd+Q on macOS — then reopen
`python` not recognized	On macOS/Linux use `python3` (`which python3` gives the full path); on Windows use the full path to `python.exe` (see Step 3)
Server fails to start, path not found	The path in `args` must be absolute and match your OS — `/Users/you/...` on macOS, `C:\\Users\\you\\...` on Windows. `~` is not expanded
"Invalid API key" (401)	Double-check your key in Semust Settings
"User not active" (403)	You need a paid plan — semust.com/fiyatlar
"Search Console not connected"	Connect GSC in Semust > Project Settings > Integrations
"Google Analytics not connected"	Connect GA4 in Semust > Project Settings > Integrations
"Google Ads not connected"	Connect Google Ads in Semust > Project Settings > Integrations
"Yandex Metrica not connected"	Connect Yandex Metrica in Semust > Project Settings > Integrations
"Bing Webmaster not connected"	Connect Bing Webmaster in Semust > Project Settings > Integrations
"Semust Metrik is not active"	Create a tracking key in Semust > Project Settings > Semust Metrik, then install the script on your site
Metrik tools return zeros	Ask Claude to check `metrik_get_live`. If `tracking.has_data` is false the key exists but the script was never installed — that is not the same as having no traffic
Claude asks permission for every tool	Add `alwaysAllow` to your config (see Step 3 above)
No data / empty results

Requirements

Python 3.10+
Claude Desktop, Claude Code, or Cursor
A Semust account with an active subscription
Semust Metrik installed, and/or Google Search Console, Google Analytics, Google Ads, Yandex Metrica or Bing Webmaster connected, on at least one project

License

MIT — see LICENSE

Diesen Server hinzufügen

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Semust?

Does Semust need an API key?

What transport does Semust use?

When was Semust last checked?

Documentation

Semust MCP Server

How It Works

What You Can Ask

Quick Start

Step 1: Get Your API Key

Step 2: Download & Install

Step 3: Configure Claude Desktop

Step 4: Verify

Security

Available Tools (74)

Projects

Search Console — Data

Search Console — Reports

Google Analytics — Data

Google Analytics — Reports

Google Ads — Data

Google Ads — Reports

Rank Tracker

AI Rank Tracker

Indexing Monitor

Yandex Metrica

Semust Metrik

Change Monitor

Competitor Analysis

Bing Webmaster

Claude Code Setup

Cursor Setup

Troubleshooting

Requirements

License