Semrush agent skills for Claude Code, Cursor and RevampKey

3 ready-made playbooks that teach an AI agent how to do real Semrush work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Semrush

Connect Semrush once and all 3 skills install themselves and stay up to date. Mac, Windows and Linux.

All 3 Semrush skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereAsks before writing14 Semrush tools

Use Semrush data with AI, safely and within your API budget

Sets the baseline for working with Semrush through an AI tool: confirms the account and plan first, picks the right tool for the question, and keeps requests inside your API unit budget. It asks before anything that changes your Semrush account.

Use it when

You have just connected Semrush and want to know what to ask first
A Semrush request was refused or ran out of units and you need to know why
You want fast Semrush answers without spending your whole unit allowance

Tools it uses

projects
domain_overview
traffic_overview
organic_research
keyword_research
competitors_research
backlinks_research
paid_search_research
shopping_research
audience_research
position_tracking
site_audit
execute_report
get_report_schema

Example

Check which Semrush projects I can see, then give me the top 20 organic keywords for example.com in the United States, and tell me how many units that cost.

I confirmed two projects are visible under your account. For example.com I pulled the top 20 organic keywords for the United States database, last 12 months, sorted by traffic. The export used about 1,200 units of your 50,000 monthly budget. This list covers only those 20 terms, not every keyword the domain ranks for.

Use in RevampKeyRead the full skill →

Read-only9 Semrush tools

Competitor landscape brief with Semrush

Builds a market brief for a domain or niche: who competes, how much traffic each takes, which themes they win, and what the data cannot prove. It confirms scope and budget before pulling reports.

Use it when

You are preparing a strategy discussion and need to know who the real rivals are.
You want to see which competitor is gaining traffic in a country this quarter.
A new market is opening and you need a landscape before committing budget.

Tools it uses

get_report_schema
competitors_research
domain_overview
traffic_overview
organic_research
paid_search_research
audience_research
shopping_research
backlinks_research

Example

Who are the main organic and paid competitors for example.com in the UK for July 2025, and which themes are they winning that we are not?

I shortlisted 6 direct competitors for example.com in the UK, July 2025, and dropped 3 marketplace and aggregator results as noise. The leader holds about 38 percent of the shortlist's organic traffic, and the target holds 12 percent. The biggest gap is the comparison theme, which 4 rivals own and the target does not appear in. Audience positioning is inferred from term patterns and is not verified.

Use in RevampKeyRead the full skill →

Read-only5 Semrush tools

Check site health and keyword rank trends with AI

Triages your own site's technical issues and keyword position movements over time, separating real regressions from normal noise. It asks before changing any tracking or project settings.

Use it when

Traffic or rankings dropped and you need to know if it is real
You want a health check of your domain after a site change
You need to decide which audit issues to fix now and which to watch

Tools it uses

projects
site_audit
position_tracking
domain_overview
traffic_overview

Example

Our organic traffic dropped in March after the site migration. Check our site health and whether the keyword rankings really fell.

Site audit shows 6 blocking issues, 3 on pages that earn traffic: redirect chains on the old blog URLs and two pages marked noindex. Rankings fell across 41 tracked keywords starting March 12, the day of the migration, which points to indexation rather than content. I would fix the redirects and noindex tags now and re-check positions in two weeks.

Use in RevampKeyRead the full skill →

Get all 3 without copying a file

RevampKey adds the skills when you connect Semrush, updates them for you and removes them when you disconnect.

Download RevampKey

How Semrush skills work

Connect Semrush
The Semrush MCP server gives the agent its tools.
Ask in plain words
“Who are the main organic and paid competitors for example.com in the UK for July 2025, and which themes are they winning that we are not?” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Semrush skills

In RevampKey the skills install themselves when you connect Semrush. In other tools each skill is one folder with a SKILL.md file, and you also need the Semrush MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Semrush. All 3 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Who are the main organic and paid competitors for example.com in the UK for July 2025, and which themes are they winning that we are not?”
Download RevampKeyConnect Semrush · 1 click
Get RevampKey to connect Semrush
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Semrush is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials competitor-landscape-brief site-health-and-rank-check; do curl -fsSL --create-dirs -o .claude/skills/semrush-$s/SKILL.md https://revampkey.com/marketplace/semrush/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Semrush MCP server in Claude Code.

Run this in your project folder to add all 3 skills:

for s in essentials competitor-landscape-brief site-health-and-rank-check; do
  curl -fsSL --create-dirs -o .claude/skills/semrush-$s/SKILL.md https://revampkey.com/marketplace/semrush/skills/$s/SKILL.md
done

Ask in plain language, for example “Who are the main organic and paid competitors for example.com in the UK for July 2025, and which themes are they winning that we are not?”

Into the shared .agents/skills folder

Connect the Semrush MCP server in Cursor.

Run this in your project folder to add all 3 skills:

for s in essentials competitor-landscape-brief site-health-and-rank-check; do
  curl -fsSL --create-dirs -o .agents/skills/semrush-$s/SKILL.md https://revampkey.com/marketplace/semrush/skills/$s/SKILL.md
done

Ask in plain language, for example “Who are the main organic and paid competitors for example.com in the UK for July 2025, and which themes are they winning that we are not?”

Into the shared .agents/skills folder

Connect the Semrush MCP server in Codex.

Run this in your project folder to add all 3 skills:

for s in essentials competitor-landscape-brief site-health-and-rank-check; do
  curl -fsSL --create-dirs -o .agents/skills/semrush-$s/SKILL.md https://revampkey.com/marketplace/semrush/skills/$s/SKILL.md
done

Ask in plain language, for example “Who are the main organic and paid competitors for example.com in the UK for July 2025, and which themes are they winning that we are not?”

Into the shared .agents/skills folder

Connect the Semrush MCP server in VS Code.

Run this in your project folder to add all 3 skills:

for s in essentials competitor-landscape-brief site-health-and-rank-check; do
  curl -fsSL --create-dirs -o .agents/skills/semrush-$s/SKILL.md https://revampkey.com/marketplace/semrush/skills/$s/SKILL.md
done

Ask in plain language, for example “Who are the main organic and paid competitors for example.com in the UK for July 2025, and which themes are they winning that we are not?”

RevampKey or copy the files?

In RevampKey

One click when you connect Semrush
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Semrush MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Semrush skills FAQ

What is a Semrush agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Semrush skill describes one job, which Semrush tools to use in which order, what to check first and when to stop and ask you.

Do the Semrush skills change anything on their own?

2 of the 3 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Semrush.

Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Semrush; elsewhere you copy the folders into your project or skills directory.

Do I need the Semrush MCP server too?

Yes. The skills tell the agent how to do the work; the Semrush MCP server gives it the tools to do it. The Semrush MCP setup guide covers every client.

Semrush MCP server setup · This page as Markdown

Put Semrush’s best workflows in your agent

Download RevampKey, connect Semrush and ask your first question in about a minute.

Download RevampKey Connect Semrush · 1 click

All 3 Semrush skills

Use Semrush data with AI, safely and within your API budget

Use it when

Tools it uses

Competitor landscape brief with Semrush

Use it when

Tools it uses

Check site health and keyword rank trends with AI

Use it when

Tools it uses

Get all 3 without copying a file

How Semrush skills work

How to install Semrush skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Semrush skills FAQ

Put Semrush’s best workflows in your agent

Skills for related tools