Ask Claude about your SEO and advertising data in plain language. This MCP server connects Claude Desktop (and Claude Code, and Cursor) to your account — keywords, pages, traffic trends, SEO reports, Semust Metrik, Google Analytics, Google Ads, Yandex Metrica, Bing Webmaster, and more.
"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?"
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.
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
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:
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
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
GSC data has a 2-day delay — Claude handles this automatically. Semust Metrik has no delay; today's data is available today
Config file not found
Make sure Claude Desktop is installed and has been opened at least once
Semust Metrik installed, and/or Google Search Console, Google Analytics, Google Ads, Yandex Metrica or Bing Webmaster connected, on at least one project
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Pertanyaan
Bagaimana cara menginstal Semust?
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Apakah Semust memerlukan kunci API?
Tidak ada variabel lingkungan wajib yang tercantum di catatan ini.
Transport apa yang digunakan Semust?
Semust berjalan secara lokal melalui stdio.
Kapan Semust terakhir diperiksa?
Terakhir diperiksa 2026-10-27. Semust MCP Server for SEO & ADS professionals.