Skip to content

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

  1. 1Sign in to ApexGenius and connect Semrush
  2. 2Add the ApexGenius MCP server to Claude Code
  3. 3Start using Semrush in Claude Code
  1. 1Semrush

    Connect Semrush to ApexGenius

    Connect Semrush

    Create an API key in Semrush. You paste it into ApexGenius once.

  2. 2ApexGenius

    Connect ApexGenius to Claude Code

    Copy the MCP address

    On Start, pick API key, open Manual setup, and copy the MCP address.

  3. 3ApexGenius

     

    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.

  1. Run the command. Claude Code prints an Added line.
  2. Start Claude Code, run /mcp, choose apexgenius and follow the sign-in in your browser. From a shell, claude mcp login apexgenius does the same.
  3. Approve access on the ApexGenius page.
Run in your terminal
claude mcp add --transport http --scope user apexgenius https://server.autom8.pro/mcp

Check 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.

Start free
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

  1. 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 full Semrush API keys page before sign-in, with a red box around Log in.
    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)
  2. Open Semrush in Connections. Sign in to ApexGenius, open Connections, choose Semrush, and select Connect.
  3. 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.
  4. Check the connection. Open Tools, then ask your AI the question below. Compare the answer with Semrush and check Tool Activity.
Connect Semrush →

2. Connect ApexGenius to Claude Code

Use this server address when adding the connection:

https://server.autom8.pro/mcp

The 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 apexgenius prints 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-browser to force that.
  • Headless runs. A claude -p run has no /mcp panel and cannot run the sign-in. Sign in once from an interactive session, or with claude mcp login, first.
  • Signing out. Clear authentication in the /mcp menu, or claude 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.
A generated anonymous terminal illustration showing a setup command, ApexGenius added, browser authorization, and ready to use.
Generated terminal example. Use the exact copy button on this page; the image only shows what kind of screen to expect.Open full-size image (opens in a new tab)

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.

How the route works
Claude Code
Claude CodeApexGenius MCP route
Show a Semrush domain overview for my website in the US database. Run only that one report.
ApexGenius
Working with ApexGenius1 tool search · 3 reads
RequestDomain overview
Account scopeAuthorized connections checked
apex_search_toolsSemrush domain reports · Find the Semrush report routeComplete
apex_call_read_tooldomain_overview · Find domain overview reportsComplete
apex_call_read_toolget_report_schema · Read the report parametersComplete
apex_call_read_toolexecute_report · Run the one reportComplete
Claude Code

Illustrative 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 route
Claude Code

What 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), then get_report_schema (read), then execute_report (read).

  • Organic competitors

    Which domains compete with my website in organic search? Keep it to the top ten.

    Runs competitors_research (read), then execute_report (read).

  • Keyword ideas

    Find related keywords for "project management software" with search volume. Limit it to 20 rows.

    Runs keyword_research (read), then get_report_schema (read), then execute_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 read
  • domain_overviewread
  • traffic_overviewread
  • competitors_researchread

Keywords and ads

4 read
  • organic_researchread
  • keyword_researchread
  • paid_search_researchread
  • shopping_researchread

Links and audience

2 read
  • backlinks_researchread
  • audience_researchread

Projects and tracking

3 read
  • projectsread
  • position_trackingread
  • site_auditread

Run a report

2 read
  • get_report_schemaread
  • execute_reportread

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.

Start free

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.

Connect Semrush to Claude Code today

Start free

1,000 free credits. No card required. Disconnect any time.