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.
Used by 2,000+ marketers
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.
- 01Domain snapshotOne-page SEO read of a domain
Semrush report: Domain overview, organic keywords
Cadence: Monthly
- 02Keyword batchVolume, CPC and competition for a list
Semrush report: Keyword overview
Cadence: Before planning content
- 03Organic competitorsWho shares your rankings
Semrush report: Organic competitors
Cadence: Quarterly
- 04Keyword gapPhrases a rival ranks for and you do not
Semrush report: Organic keywords for two domains
Cadence: Quarterly
- 05Backlink profileAuthority Score and link mix
Semrush report: Backlinks overview
Cadence: Monthly
- 06Referring domain reviewWhich sites link to you
Semrush report: Referring domains
Cadence: Monthly
- 07Anchor text checkOver-used or odd anchors
Semrush report: Anchors
Cadence: Quarterly
- 08Position Tracking readoutRank movement for a tracked campaign
Semrush report: Projects, Position Tracking
Cadence: Weekly
- 09Units guardEstimate and cap units before a run
Semrush report: None (planning step)
Cadence: Before any big pull
| # | Skill | Job | Semrush report | Cadence |
|---|---|---|---|---|
| 01 | Domain snapshot | One-page SEO read of a domain | Domain overview, organic keywords | Monthly |
| 02 | Keyword batch | Volume, CPC and competition for a list | Keyword overview | Before planning content |
| 03 | Organic competitors | Who shares your rankings | Organic competitors | Quarterly |
| 04 | Keyword gap | Phrases a rival ranks for and you do not | Organic keywords for two domains | Quarterly |
| 05 | Backlink profile | Authority Score and link mix | Backlinks overview | Monthly |
| 06 | Referring domain review | Which sites link to you | Referring domains | Monthly |
| 07 | Anchor text check | Over-used or odd anchors | Anchors | Quarterly |
| 08 | Position Tracking readout | Rank movement for a tracked campaign | Projects, Position Tracking | Weekly |
| 09 | Units guard | Estimate and cap units before a run | None (planning step) | 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.
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
Setup
- One-off prompt
- None
- Skill
- Save once per Claude app
- Semrush connection
- Your Semrush API key, entered once
Same request each run
- One-off prompt
- No
- Skill
- Yes
- Semrush connection
- Depends on the prompt or skill
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
| One-off prompt | Skill | Semrush connection | |
|---|---|---|---|
| What it is | A question in chat | A saved file with a fixed report and output | The tool Claude uses to call Semrush |
| Setup | None | Save once per Claude app | Your Semrush API key, entered once |
| Same request each run | No | Yes | Depends on the prompt or skill |
| API units | Spent by whatever Claude asks for | Spent by the report and row cap in the file | 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.
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.
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.
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.
Use it when: you plan next quarter's content.
Backlink skills: authority, referring domains and anchors
These three read the link data Semrush exposes. Semrush's backlink reports take a target that can be a root domain, a subdomain or a single URL, so each skill asks which one.
05. Backlink profile
Reads the backlinks overview with Authority Score and writes a short profile. Semrush bills this report as a fixed cost per request in its unit tables, which makes it a cheap first call.
Use it when: you size up your site or a competitor before spending more units on detail.
06. Referring domain review
Lists the domains that link to a target and separates the ones worth keeping from the ones to look at by hand.
Use it when: a monthly link report is due.
07. Anchor text check
Reads the anchors report and shows how often branded, URL and keyword anchors occur, so an over-used exact-match phrase stands out.
Use it when: a site has had a link campaign and you want a second look.
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.
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.
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:
Domain overview
- What it returns
- Summary of a domain's organic presence
- Used by
- Skill 01
Organic keywords
- What it returns
- Keywords a domain ranks for, with position, volume, CPC, URL and traffic
- Used by
- Skills 01, 04
Organic competitors
- What it returns
- Domains that compete in organic search
- Used by
- Skill 03
Keyword overview
- What it returns
- Volume, CPC and competition for phrases in a regional database
- Used by
- Skill 02
Backlinks overview
- What it returns
- Authority Score and link summary
- Used by
- Skill 05
Referring domains, anchors, backlinks
- What it returns
- Link detail for a target
- Used by
- Skills 06, 07
Projects and Position Tracking
- What it returns
- Project list and Position Tracking reports
- Used by
- Skill 08
| Report | What it returns | Used by |
|---|---|---|
| Domain overview | Summary of a domain's organic presence | Skill 01 |
| Organic keywords | Keywords a domain ranks for, with position, volume, CPC, URL and traffic | Skills 01, 04 |
| Organic competitors | Domains that compete in organic search | Skill 03 |
| Keyword overview | Volume, CPC and competition for phrases in a regional database | Skill 02 |
| Backlinks overview | Authority Score and link summary | Skill 05 |
| Referring domains, anchors, backlinks | Link detail for a target | Skills 06, 07 |
| Projects and Position Tracking | Project list and Position Tracking reports | 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.
URL
- Ryze AI connector
- https://connector.get-ryze.ai/mcp
- Semrush's own MCP server
- https://mcp.semrush.com/v2/mcp
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
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
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)
Billed for data
- Ryze AI connector
- Your Semrush API units
- Semrush's own MCP server
- Your Semrush API units
| Ryze AI connector | Semrush's own MCP server | |
|---|---|---|
| URL | https://connector.get-ryze.ai/mcp | https://mcp.semrush.com/v2/mcp |
| Sign-in | OAuth to Ryze AI, then your Semrush API key stored in Ryze AI | OAuth by default, or an Authorization: Apikey header |
| Semrush data | One read tool for the reports above | All SEO API endpoints, the Trends API by subscription, and read-only Projects methods |
| Plan needed | A Ryze AI plan or trial, plus a Semrush plan with API access | A Semrush plan with API access (50,000 units included with the qualifying plans) |
| Billed for data | Your Semrush API units | 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.
Organic keywords (current data)
- Units per Semrush docs
- 10 per line
- Skill
- 01, 04
Keyword overview
- Units per Semrush docs
- 10 per line
- Skill
- 02
Organic competitors (current data)
- Units per Semrush docs
- 40 per line
- Skill
- 03
Backlinks overview
- Units per Semrush docs
- 40 per request
- Skill
- 05
Referring domains
- Units per Semrush docs
- 40 per line
- Skill
- 06
Backlinks list
- Units per Semrush docs
- 40 per line
- Skill
- Not used here
| Report | Units per Semrush docs | Skill |
|---|---|---|
| Organic keywords (current data) | 10 per line | 01, 04 |
| Keyword overview | 10 per line | 02 |
| Organic competitors (current data) | 40 per line | 03 |
| Backlinks overview | 40 per request | 05 |
| Referring domains | 40 per line | 06 |
| Backlinks list | 40 per line | 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
Checked November 15, 2026
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.




