Connect Claude Code to Semrush
Connect Claude Code to Semrush: 1. Sign in to ApexGenius and connect Semrush. 2. Add the ApexGenius MCP server. 3. Start using Semrush in Claude Code.
1,000 free credits · No card required
How to connect Semrush to Claude Code
- 1Sign in to ApexGenius and connect Semrush
- 2Add the ApexGenius MCP server to Claude Code
- 3Start using Semrush in Claude Code
- 1
Connect Semrush to ApexGenius
Connect Semrush
Create an API key in Semrush. You paste it into ApexGenius once.
- 2
Connect ApexGenius to Claude Code
Copy the MCP address
On Start, pick API key, open Manual setup, and copy the MCP address.
- 3
Approve access
ApexGenius opens its approval page. Review the access, then approve.
Add the ApexGenius MCP server to Claude Code
Claude Code stores MCP servers in ~/.claude.json. With --scope user the server is available in every project. Without it, only in the project where you ran the command.
- Run the command. Claude Code prints an Added line.
- Start Claude Code, run
/mcp, choose apexgenius and follow the sign-in in your browser. From a shell,claude mcp login apexgeniusdoes the same. - Approve access on the ApexGenius page.
claude mcp add --transport http --scope user apexgenius https://server.autom8.pro/mcpCheck it. Run claude mcp list. Each server shows a status, such as Connected or Needs authentication. claude mcp get apexgenius shows the detail.
Steps follow Claude Code documentation, Connect Claude Code to tools via MCP (opens in a new tab), read November 12, 2026.
Then ask Claude Code
Show a Semrush domain overview for my website in the US database. Run only that one report.
Written setup, step by stepShow
Before you start
- A Semrush plan with API access. SEO data needs Semrush One Starter or Pro+, or SEO Classic Pro or Guru. SEO Classic Business and Semrush One Advanced need an API units package. Traffic and market data need a Trends API plan.
- A Semrush API key from your Semrush profile under API Keys.
1. Connect Semrush to ApexGenius
- Copy an API key in Semrush. In Semrush, click your profile icon at the top right, then choose API Keys in the My profile sidebar. Copy an existing key, or choose + Create API key for a new v4 key. A new key is shown in full only once, so copy it right away.

The API keys page asks you to log in first. After you sign in, copy a key from My profile, API Keys.Open full-size image (opens in a new tab) - Open Semrush in Connections. Sign in to ApexGenius, open Connections, choose Semrush, and select Connect.
- Enter the API key. Paste the key. ApexGenius supplies the mcp.semrush.com address, checks the key with Semrush's MCP, and stores it encrypted.
- Check the connection. Open Tools, then ask your AI the question below. Compare the answer with Semrush and check Tool Activity.
2. Connect ApexGenius to Claude Code
Use this server address when adding the connection:
https://server.autom8.pro/mcpThe steps are above, under Add the ApexGenius MCP server to Claude Code. These notes apply to Claude Code only.
- Over SSH or without a browser.
claude mcp login apexgeniusprints the authorization URL when it finds no local browser. Open it on your own machine, then paste the full redirect URL from the address bar back at the prompt. Add--no-browserto force that. - Headless runs. A
claude -prun has no/mcppanel and cannot run the sign-in. Sign in once from an interactive session, or withclaude mcp login, first. - Signing out. Clear authentication in the
/mcpmenu, orclaude mcp logout apexgenius, removes the stored sign-in. - Access. When ApexGenius asks what Claude Code may use, choose Read only for the first test, or Custom to limit it to the tools you need.

3. Verify one safe read
Show a Semrush domain overview for my website in the US database. Run only that one report.
Show a Semrush domain overview for my website in the US database. Run only that one report.Compare the numbers with Domain Overview in Semrush. Every report spends Semrush API units, including this one. Check your balance under My Profile > Subscription info > Summary.
Full guide: the Semrush setup guide.
What it looks like in Claude Code
Illustration of a task, not a recorded customer result. Your answers come from the account and dates you choose.
apex_search_toolsSemrush domain reports · Find the Semrush report routeCompleteapex_call_read_tooldomain_overview · Find domain overview reportsCompleteapex_call_read_toolget_report_schema · Read the report parametersCompleteapex_call_read_toolexecute_report · Run the one reportCompleteIllustrative example: the overview returns the domain’s organic and paid search summary for the US database. One report ran and spent Semrush API units. Nothing was changed.
Read-only routeWhat to ask Claude Code about Semrush
- Domain overview
Show a Semrush domain overview for my website in the US database. Run only that one report.
Runs
domain_overview(read), thenget_report_schema(read), thenexecute_report(read). - Organic competitors
Which domains compete with my website in organic search? Keep it to the top ten.
Runs
competitors_research(read), thenexecute_report(read). - Keyword ideas
Find related keywords for "project management software" with search volume. Limit it to 20 rows.
Runs
keyword_research(read), thenget_report_schema(read), thenexecute_report(read).
These 3 questions use 5 of Semrush’s 14 operations. The full list is below.
- List my Semrush projects and summarize the latest Position Tracking results for one of them. (read)
What Claude Code can do in Semrush
14 operations: 14 read. Every operation looks things up and changes nothing, so Claude Code cannot change Semrush through ApexGenius.
Domains and traffic
3 readdomain_overviewreadList the domain overview reports you can run for a domain.
traffic_overviewreadList the website traffic reports you can run.
competitors_researchreadList the competitor reports you can run for a domain.
Keywords and ads
4 readorganic_researchreadList the organic search reports you can run for a domain.
keyword_researchreadList the keyword research reports you can run.
paid_search_researchreadList the paid search reports you can run.
shopping_researchreadList the shopping research reports you can run.
Links and audience
2 readbacklinks_researchreadList the backlink reports you can run.
audience_researchreadList the audience reports you can run.
Projects and tracking
3 readprojectsreadList the reports you can run on your Semrush projects.
position_trackingreadList the Position Tracking reports you can run.
site_auditreadList the Site Audit reports you can run.
Run a report
2 readget_report_schemareadRead the parameters one report takes before you run it.
execute_reportreadRun one report and return its data. Spends Semrush API units.
You choose the access. When you approve Claude Code, pick Full access, Read only, or Custom.
Semrush's MCP is read-only. It reads reports and project data. It cannot create projects, change settings or edit anything in Semrush, so there is nothing to undo.
Every report spends API units from your Semrush plan, the same as a direct API request. Semrush charges no extra fee for MCP. Ask for fewer rows to spend fewer units.
The key covers your Semrush account. One saved connection holds one key; connect again for a second account.
Disconnecting stops ApexGenius access. It does not restore units a report already spent. Manage or revoke the key itself in Semrush under API Keys.
Questions about connecting Claude Code to Semrush
Updated November 12, 2026.
How do I connect Claude Code to Semrush?
Sign in to ApexGenius and connect Semrush. In Claude Code, run claude mcp add --transport http --scope user apexgenius https://server.autom8.pro/mcp, then run /mcp and sign in. Then ask Claude Code: “Show a Semrush domain overview for my website in the US database. Run only that one report.” Start with a read, so nothing changes.
How do I check that Claude Code can use Semrush?
Run claude mcp list in your terminal. apexgenius should show Connected. If it shows Needs authentication, run /mcp inside Claude Code, or claude mcp login apexgenius in your shell, and finish the browser sign-in. Then ask: “Show a Semrush domain overview for my website in the US database. Run only that one report.”
Which Semrush plans work?
SEO data needs Semrush One Starter, Semrush One Pro+, SEO Classic Pro or SEO Classic Guru. Those plans include 50,000 API units that refresh on your renewal date. SEO Classic Business and Semrush One Advanced work with an API units package. Traffic and market data need a Trends API plan, Basic or Premium.
Does it use my Semrush API units?
Yes. Each report uses the same API units as a direct Semrush API request, and Semrush charges no extra MCP fee. Check your balance in Semrush under My Profile > Subscription info > Summary.
Where do I find my Semrush API key?
In Semrush, click your profile icon at the top right and choose API Keys in the My profile sidebar. Copy a key, or choose + Create API key for a new v4 key. A new key is shown in full only once.
Can my AI change anything in Semrush?
No. Semrush's MCP only reads. It can read your projects but cannot create projects, change settings or edit data, so there is nothing to undo.
Why an API key instead of signing in to Semrush?
ApexGenius connects with the API key method Semrush documents for AI agents. The key is sent only to mcp.semrush.com and stored encrypted. You manage the key itself in Semrush under API Keys.
More connections like this one
Claude Code with other apps
ChatGPT Ads
Google Ads
Google Analytics
Blotato
Bing Webmaster
YouTube
YouTube Analytics
Google Search Console
All 48 apps Claude Code can use
TypeSafeSupabase
Mobbin
Cal.com
SlackDiscord
GitHub
Stripe
Context.dev
Attio
Notion
Apify
Linear
Jira
HQ Rental
Google Forms
Google Meet
Google Tasks
Gmail
Google Calendar
Google Chat
Google Docs
Google Drive
Google Sheets
Google Slides
Apollo
Calendly
ClickUp
monday.com
Atlassian Rovo
Polymarket
OP.GGSalesforce
n8n
Confluence
ElevenLabs
FreshBooks
Trello
GitLab
HubSpot
Connect Semrush to Claude Code today
Start free1,000 free credits. No card required. Disconnect any time.