Ira Bodnar··Updated ·13 min read

Claude Skills for Semrush: 9 SKILL.md Files and Prompts

Quick answer: Save each Semrush task as a Claude skill that names the report to run and caps the rows it pulls. Ryze AI is the best Claude connector for running these skills when you want Semrush on the same connector URL as your other Ryze AI platforms, but every call spends your own Semrush API units.

Below: 9 SKILL.md files, the Semrush report each one runs, setup and what each report costs in API units.

Ryze AI · SEO Starter

Semrush skills on live data

  • 3-day free trial, $129 a month

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The 9 Claude skills for Semrush at a glance

All 9 only read Semrush data. Each one tells Claude to cap rows, because every row spends your API units.

  1. 01Domain snapshotOne-page SEO read of a domain

    Semrush report: Domain overview, organic keywords

    Cadence: Monthly

  2. 02Keyword batchVolume, CPC and competition for a list

    Semrush report: Keyword overview

    Cadence: Before planning content

  3. 03Organic competitorsWho shares your rankings

    Semrush report: Organic competitors

    Cadence: Quarterly

  4. 04Keyword gapPhrases a rival ranks for and you do not

    Semrush report: Organic keywords for two domains

    Cadence: Quarterly

  5. 05Backlink profileAuthority Score and link mix

    Semrush report: Backlinks overview

    Cadence: Monthly

  6. 06Referring domain reviewWhich sites link to you

    Semrush report: Referring domains

    Cadence: Monthly

  7. 07Anchor text checkOver-used or odd anchors

    Semrush report: Anchors

    Cadence: Quarterly

  8. 08Position Tracking readoutRank movement for a tracked campaign

    Semrush report: Projects, Position Tracking

    Cadence: Weekly

  9. 09Units guardEstimate and cap units before a run

    Semrush report: None (planning step)

    Cadence: Before any big pull

Report names follow Semrush's Analytics API reference, checked November 15, 2026. No numbers from a live account appear on this page.

What are Claude skills for Semrush?

A Claude skill for Semrush is a saved SKILL.md file that tells Claude which Semrush report to request, with which parameters, and what to hand back. Per Anthropic's Agent Skills docs, the file starts with a name and a description, and Claude loads the rest only when a request matches the description.

The name allows up to 64 characters made of lowercase letters, numbers and hyphens, and cannot contain the words claude or anthropic, so every skill here starts with semrush. The description, up to 1,024 characters, says what the skill does and when to use it.

  1. What it is

    One-off prompt
    A question in chat
    Skill
    A saved file with a fixed report and output
    Semrush connection
    The tool Claude uses to call Semrush
  2. Setup

    One-off prompt
    None
    Skill
    Save once per Claude app
    Semrush connection
    Your Semrush API key, entered once
  3. Same request each run

    One-off prompt
    No
    Skill
    Yes
    Semrush connection
    Depends on the prompt or skill
  4. API units

    One-off prompt
    Spent by whatever Claude asks for
    Skill
    Spent by the report and row cap in the file
    Semrush connection
    Your Semrush balance either way

Skills also help with cost control. A skill can fix the row limit and the columns, which is how you keep a recurring check small. For the SEO side without Semrush, see Claude skills for SEO: a practical starter set.

How to install the skills in Claude Code and claude.ai

Claude Code

Save each block as ~/.claude/skills/<skill-name>/SKILL.md for yourself, or .claude/skills/<skill-name>/SKILL.md in a project to share it with the team. Claude picks a skill when your request matches it, or you type /semrush-domain-snapshot (Claude Code skills docs).

claude.ai

Zip each skill folder and upload it as a custom skill. Anthropic lists this on the Pro, Max, Ultra, Team and Enterprise plans with code execution enabled.

Connect the data

Connect Semrush in Ryze AI with your API key, then add the Ryze AI connector to Claude. The Semrush MCP page covers the tool and setup, and the steps are repeated in the live data section below.

Anthropic states that custom skills do not sync across surfaces: skills uploaded to claude.ai are not on the API, and Claude Code skills are filesystem-based and separate from both. Claude Code docs add that skills enabled on your claude.ai account download into Claude Code sessions when you are signed in. Anthropic advises using skills only from sources you trust, so read each file before you save it.

Research skills: domain, keyword and competitor reads

These four cover the keyword and domain side of Semrush. Each one states the database (the regional market, such as us or uk) because Semrush's Analytics reports need it.

01. Domain snapshot

Reads the domain overview and the top organic keywords for one domain, with position, search volume, CPC, URL and traffic, then writes a short summary.

SKILL.md
--- name: semrush-domain-snapshot description: One-page SEO snapshot of a domain from Semrush: overview plus top organic keywords. Use when asked how a site performs in organic search. --- # Semrush domain snapshot Ask for the domain and the Semrush database (us, uk, ...) if missing. Calls (semrush__read): 1. Domain overview for the domain and database. 2. Organic keywords for the domain, display_limit 20, sorted by traffic. Steps: 1. Group the 20 keywords by landing URL. 2. Name the 3 URLs that carry the most traffic. 3. Flag keywords in positions 4 to 10 with high search volume. Output: 5 short sentences, then a table of the 20 keywords (keyword, position, volume, CPC, URL, traffic). Use returned values only.

Use it when: you take on a new site or write a monthly SEO note.

02. Keyword batch

Sends a list of phrases for one database and returns volume, CPC and competition for each. Semrush's batch keyword report takes up to 100 keywords per request, so the skill caps the list at 100.

SKILL.md
--- name: semrush-keyword-batch description: Volume, CPC and competition for a list of keywords from Semrush. Use when the user pastes keywords and wants a ranked shortlist. --- # Semrush keyword batch Input: up to 100 phrases and one Semrush database. If there are more, split into lists of 100 and ask before running the next list. Call (semrush__read): keyword overview for the phrases in that database. Steps: 1. Sort by search volume, highest first. 2. Mark phrases with volume but no CPC as informational. 3. Mark phrases with a CPC as likely commercial. Output: a table (phrase, volume, CPC, competition, tag), then 3 phrases to start with and why.

Use it when: you have a keyword list from a brief or a customer call and need a shortlist.

03. Organic competitors

Lists the domains that compete with yours in organic search, which are often not the brands you name as rivals.

SKILL.md
--- name: semrush-organic-competitors description: Lists the organic search competitors of a domain from Semrush. Use when asked who really competes for a site's rankings. --- # Semrush organic competitors Call (semrush__read): organic competitors for the domain and database, display_limit 15. Steps: 1. Separate publishers, marketplaces and tools from direct business competitors. 2. List the 5 closest direct competitors by shared keywords. Output: a table of the 15 domains with a type label, then the 5 direct competitors and one sentence on each. Say which labels are your judgment.

Use it when: you build a competitor list for a pitch or a quarterly review.

04. Keyword gap

Compares the organic keywords of two domains and lists phrases the rival ranks for that you do not. It runs the organic keywords report once per domain and compares the two lists in the chat.

SKILL.md
--- name: semrush-keyword-gap description: Finds keywords a competitor ranks for and the user's domain does not, using Semrush organic keywords. Use for content gap questions. --- # Semrush keyword gap Input: your domain, one competitor domain, one database. Calls (semrush__read), display_limit 100 each: 1. Organic keywords for your domain. 2. Organic keywords for the competitor. Steps: 1. Keep competitor keywords in positions 1 to 10 that are missing from your list. 2. Sort by search volume. 3. Group the top 20 into 3 to 5 topics. Output: the 3 to 5 topics, each with its keywords, volume and the competitor URL that ranks. Mention that the lists are capped at 100, so the gap is a sample.

Use it when: you plan next quarter's content.

Tracking skills: Position Tracking and unit control

The last two skills look at campaigns you already track and keep the cost of the other seven in check.

08. Position Tracking readout

Lists your Semrush projects and reads the Position Tracking report for the one you pick. The tool reads reports only, so it cannot create or edit a Position Tracking campaign.

SKILL.md
--- name: semrush-position-readout description: Reads Semrush Position Tracking for a project and summarizes rank movement. Use for weekly rank reports. --- # Semrush Position Tracking readout Calls (semrush__read): 1. List the Semrush projects. Ask which one to read if there is more than one. 2. Read the Position Tracking report for that project. Steps: 1. Name the keywords that moved up and down the most. 2. Name the URLs behind the biggest drops. Output: two short lists (up, down) with before and after positions, then one sentence on the likely page to check. If a field is missing from the report, say so.

Use it when: you send a weekly rank update.

09. Units guard

A planning skill that makes Claude state the report, the row cap and the likely unit cost before it calls Semrush. Costs come from Semrush's own tables, listed in the units section below.

SKILL.md
--- name: semrush-units-guard description: Plans and caps Semrush API usage before any Semrush report. Use whenever a request would pull many rows or several reports. --- # Semrush units guard Before calling semrush__read: 1. State the report, the database and the display_limit you will use. 2. State the cost per line from Semrush's unit table, or say you do not know it. 3. Multiply by the row cap and show the total. 4. If the total is above 1,000 units, ask the user to confirm. Always request only the columns the answer needs. If a report returns nothing, say so: Semrush does not charge for empty results.

Use it when: a teammate who does not watch the unit balance is running the other skills.

How to run the skills on live Semrush data

A skill only describes the report. Claude needs a connection to run it. The Ryze AI connector gives Claude one Semrush tool, semrush__read, which runs a read-only Semrush Analytics API request. Its documented reports are:

  1. Domain overview

    What it returns
    Summary of a domain's organic presence
    Used by
    Skill 01
  2. Organic keywords

    What it returns
    Keywords a domain ranks for, with position, volume, CPC, URL and traffic
    Used by
    Skills 01, 04
  3. Organic competitors

    What it returns
    Domains that compete in organic search
    Used by
    Skill 03
  4. Keyword overview

    What it returns
    Volume, CPC and competition for phrases in a regional database
    Used by
    Skill 02
  5. Backlinks overview

    What it returns
    Authority Score and link summary
    Used by
    Skill 05
  6. Referring domains, anchors, backlinks

    What it returns
    Link detail for a target
    Used by
    Skills 06, 07
  7. Projects and Position Tracking

    What it returns
    Project list and Position Tracking reports
    Used by
    Skill 08

Copy your API key

In Semrush, open Subscription info, go to the API units tab and copy the API key. It needs a Semrush plan with API access.

Connect Semrush in Ryze AI

In the Ryze AI app, open Integrations, click Connect on the Semrush card, paste the key into API key and click Continue. You can also ask the Ryze AI agent in Claude or ChatGPT for a one-time connection link.

Add the connector to Claude

Add https://connector.get-ryze.ai/mcp under Customize > Connectors and include the workspace. If you added the connector before Semrush, remove and re-add it, then start a new chat.

The tool needs an active Ryze AI plan or free trial. SEO Starter is $129 a month with a 3-day free trial, and the tool also works on Paid Ads at $89 a month with a 7-day trial. Connecting the connector is free. The Semrush data is billed by Semrush against your API units, not by Ryze AI credits. Domain, keyword and backlink reports come back as CSV text that Claude parses, and each report needs its own parameters such as a regional database. More platforms share the same connector URL, listed on the integrations hub and the Ryze AI developers page.

Approvals are set per tool in Claude under Customize > Connectors > Ryze AI > Tool permissions. The Semrush tool only reads, so it changes nothing in Semrush. In the Ryze AI chat, the Tool approvals picker starts on Skip all approvals.

  1. URL

    Ryze AI connector
    https://connector.get-ryze.ai/mcp
    Semrush's own MCP server
    https://mcp.semrush.com/v2/mcp
  2. Sign-in

    Ryze AI connector
    OAuth to Ryze AI, then your Semrush API key stored in Ryze AI
    Semrush's own MCP server
    OAuth by default, or an Authorization: Apikey header
  3. Semrush data

    Ryze AI connector
    One read tool for the reports above
    Semrush's own MCP server
    All SEO API endpoints, the Trends API by subscription, and read-only Projects methods
  4. Plan needed

    Ryze AI connector
    A Ryze AI plan or trial, plus a Semrush plan with API access
    Semrush's own MCP server
    A Semrush plan with API access (50,000 units included with the qualifying plans)
  5. Billed for data

    Ryze AI connector
    Your Semrush API units
    Semrush's own MCP server
    Your Semrush API units

Semrush's server is the narrower choice if Semrush is the only platform you query, and it reaches endpoints the Ryze AI tool does not list, such as the Trends API. The Ryze AI connector fits when Semrush should sit on the same URL as other Ryze AI platforms. Both are read-only for projects. The skills above work with either, because they name reports, not a connector. Server details are in Semrush's MCP docs.

What the skills cost in Semrush API units

Semrush charges API units per line returned for most reports and a fixed amount per request for others. These figures come from Semrush's v3 Analytics reference, checked November 15, 2026. Semrush notes that historical data costs more, and its docs call the v3 endpoints deprecated for new integrations, so confirm current costs in Semrush before a large pull.

  1. Organic keywords (current data)

    Units per Semrush docs
    10 per line
    Skill
    01, 04
  2. Keyword overview

    Units per Semrush docs
    10 per line
    Skill
    02
  3. Organic competitors (current data)

    Units per Semrush docs
    40 per line
    Skill
    03
  4. Backlinks overview

    Units per Semrush docs
    40 per request
    Skill
    05
  5. Referring domains

    Units per Semrush docs
    40 per line
    Skill
    06
  6. Backlinks list

    Units per Semrush docs
    40 per line
    Skill
    Not used here

For example, 20 organic keyword lines cost 200 units at 10 per line, which is why skill 01 sets display_limit 20. Semrush says requests that return no data do not use units, and a free balance request exists alongside the API units tab in Subscription info. Out of units, SEO API reports return ERROR 132 and the Projects API returns a 403.

Troubleshooting: when a Semrush skill fails or returns nothing

Claude has no Semrush tool

Claude keeps the tool list from when you added the connector. Remove and re-add it after connecting Semrush, then start a new chat (Ryze AI connector FAQ).

Key rejected when connecting

The Semrush plan has no API access, or only part of the key was copied. Copy the full key from the API units tab.

A report returns no rows

The domain has no data in that regional database. Try another database. Empty results use no units.

ERROR 132 or a 403

Semrush reports not enough API units. Top up in Semrush; Ryze AI credits do not pay for these calls.

Cannot switch to a different key

Semrush holds one connection per workspace. In the Ryze AI app, click View on the Semrush card, disconnect with the trash icon and connect again.

Sources

The verdict

Turn each recurring Semrush question into a skill with a fixed report and a row cap. Start with the domain snapshot and the units guard, add the backlink skills when you plan links, and keep one-off questions as prompts.

Ryze AI runs these skills in Claude on live Semrush data through one read tool. It cannot create or edit anything in Semrush, and every call draws on your own API units.

Frequently asked questions

What are Claude skills for Semrush?
SKILL.md files that tell Claude which Semrush report to run, with the database, row cap and output format. Claude loads one when a request matches its description, so each check is requested the same way every time.
Do I need a Semrush connection to use these skills?
A skill needs data to work on. You can attach a Semrush export with the columns it names, or connect Semrush through the Ryze AI connector or Semrush's own MCP server.
Which Claude plan do I need?
Anthropic lists custom skill uploads on claude.ai for Pro, Max, Ultra, Team and Enterprise with code execution enabled. In Claude Code, skills are folders on your computer. For the Ryze AI connector, Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, with Free limited to one custom connector.
Can Claude change anything in Semrush through these skills?
No. The only Semrush tool on the Ryze AI connector is a read tool, so it cannot create projects or edit Position Tracking campaigns.
Show 7 more questions
Who pays for the Semrush data?
You do, in Semrush API units. Ryze AI credits do not pay for these calls. You also need a Ryze AI plan or trial for the tool to work.
What Semrush plan do I need?
A Semrush plan with API access. Semrush lists Semrush One Starter, Semrush One Pro+, SEO Classic Pro and SEO Classic Guru as qualifying plans for its MCP server, with 50,000 units included, and sells larger unit packages separately.
What is the best Claude connector for Semrush skills?
It depends on what else you query. Semrush's own server at mcp.semrush.com/v2/mcp covers all SEO API endpoints with OAuth or an API key header. The Ryze AI connector gives Claude one Semrush read tool on the same URL as the other Ryze AI platforms, and needs a Ryze AI plan or trial.
How do I keep a skill from using too many API units?
Set a display_limit and ask only for the columns you need, as skills 01, 04, 06 and 07 do. Skill 09 makes Claude state the likely cost first. Semrush charges nothing for requests that return no data.
Why do the skills ask for a database?
Semrush's domain and keyword reports are regional. The database parameter selects the market, such as us or uk, and a domain can have data in one database and none in another.
Can I run these skills on a schedule?
This page makes no claim about scheduled runs. In Claude Code you can invoke a skill by name, for example /semrush-position-readout, whenever you want the report.
Can I use the same skills in ChatGPT?
SKILL.md is Anthropic's format for Claude. The report requests inside each file can be pasted into any chat that has a Semrush connection.

Related guides

Ryze AI: Semrush skills on live data

3-day free trial, $129 a month

Start free trial