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.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. 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).
  3. 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.

Try Semrush in Claude Code

Free to start, and tool calls cost nothing on any plan.