Connect Semrush to Claude Code
Research domains, keywords, competitors and backlinks with Semrush's SEO and advertising data. Add Toolspoke to Claude Code once and it can use 16 Semrush actions. Your Semrush credential stays in Toolspoke, and you choose which actions Claude Code may call.
Set it up in Claude Code
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
Install Semrush and connect it
Add Semrush to a project in your Toolspoke workspace.
API key. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.
- API key
- Semrush → profile menu (top right) → Subscription info → API units. The key is shown there once your plan includes API units (Semrush One Starter/Pro+, SEO Classic Pro/Guru, or Business with a units package).
Choose what Claude Code may do
All 16 actions only read, and any of them can be switched off for a project.
What you can ask Claude Code for
A few of the Semrush actions that only read, so they are safe to try first.
- Month-by-month history of a domain's rank, organic and paid keywords and traffic in one database
- The keywords a domain buys Google Ads for in one database, with position, volume, CPC and ad URL
- The domains that compete with this one in organic search in one database, ranked by keyword overlap
- One keyword's volume, CPC, competition and result count in one database
What Claude Code can do in Semrush
16 actions read.
Reads
Domain rank
One domain's headline numbers in one regional database: Semrush rank, organic keywords and traffic, paid keywords and traffic, and their estimated cost. Costs 10 API units, the cheapest real report, which is why an install tests itself with it.
Domain ranks
The same headline numbers as domain_rank, for one domain across every regional database at once, one line per database, each line billed. Use domain_rank when you know the market.
Domain rank history
Month-by-month history of a domain's rank, organic and paid keywords and traffic in one database.
Domain organic
The keywords a domain ranks for in Google's organic results in one database, with position, volume, traffic share and landing URL. Billed per line, so keep display_limit small.
Domain adwords
The keywords a domain buys Google Ads for in one database, with position, volume, CPC and ad URL. Billed per line.
Organic competitors
The domains that compete with this one in organic search in one database, ranked by keyword overlap. Semrush calls this report domain_organic_organic.
Keyword overview
One keyword's volume, CPC, competition and result count in one database. Semrush calls this report phrase_this.
Keyword overview all databases
The same keyword overview across every regional database, one billed line each. Semrush calls this report phrase_all.
Keyword organic results
The domains and URLs ranking in Google's organic top 100 for one keyword in one database. Semrush calls this report phrase_organic.
Related keywords
Keywords related to one keyword, with volume and CPC, for content and campaign ideas. Semrush calls this report phrase_related.
Keyword difficulty
Keyword difficulty scores (0-100) for up to 100 keywords in one database. Separate the keywords with semicolons. Semrush calls this report phrase_kdi.
Url organic
The keywords one exact URL ranks for in Google's organic results in one database.
Backlinks overview
Backlink totals for a root domain, host or URL, backlinks, referring domains and IPs, follow and nofollow counts, and authority score.
List backlinks
Individual backlinks pointing at a root domain, host or URL, with source URL, anchor and first and last seen dates. Billed per line.
Referring domains
The domains linking to a root domain, host or URL, with how many backlinks each one sends. Billed per line.
List projects
List the Semrush projects on this account (the containers for Position Tracking and Site Audit), as JSON. Costs API units like any other report.
Semrush in Claude Code: questions
Does Claude Code see my Semrush credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Will 16 actions crowd Claude Code's context?
No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Semrush action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Can I add it once for every project?
Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.
What does it cost?
Tool calls are free on every plan, and a Semrush call does not run in a sandbox, so it bills nothing.
Semrush in your other apps
Try Semrush in Claude Code
Free to start, and tool calls cost nothing on any plan.