Access a full suite of Semrush domain, keyword, and backlink reports - everything from organic rankings to ad copy history - directly inside your Gumloop workflows.
What is Semrush MCP?
When you create a Semrush MCP node, Gumloop uses AI to generate a custom node that speaks Semrush natively. Ask questions in everyday language and the node will translate your prompt into the correct Semrush API call, fetch the data, and return structured results you can pass to the rest of your workflow.What Can It Do for You?
- Reveal a domain’s top keywords, ads, pages, and competitors
- Compare multiple domains by shared or unique keywords
- Research keyword volume, difficulty, SERP results, and related phrases
- Audit backlink profiles, referring domains, and historical link trends
Available Tools
| Tool | What It Does | Example Use |
|---|---|---|
| Get Domain Rank Report | Returns the most popular domains ranked by traffic | ”Get the domain rank report for the United States database, return domain and traffic share” |
| Get Winners Losers Report | Shows domains with the biggest gains and losses in keyword rankings, traffic, and ad budget | ”For uk.co database, get this week’s winners and losers report, return domain, position changes, and traffic change” |
| Get Domain Keywords | Lists organic or paid keywords driving traffic to a domain, subdomain, subfolder, or URL | ”List the top 20 organic keywords for hubspot.com, return keyword, position, and traffic %“ |
| Get Domain Ad Copies | Retrieves unique ad copies used in a domain’s paid search campaigns | ”Get ad copies for nike.com, return headline, description, and landing page URL” |
| Get Domain Competitors | Finds a domain’s competitors in organic or paid search | ”Find organic competitors for zapier.com, return competitor domain and common keywords” |
| Get Domain Ad History | Shows keywords a domain has bid on during the last 12 months | ”Show google.com’s ad history for the US database, return keyword, month, and average position” |
| Compare Domains By Keywords | Compares up to five domains by common, unique, or all keywords | ”Compare shopify.com, wix.com, and bigcommerce.com by unique keywords, return domain and unique keyword count” |
| Get Domain Overview Data | Provides high-level stats across all regional databases for a domain | ”Get an overview for tesla.com, return organic traffic, paid traffic, and backlinks” |
| Get Organic Pages | Lists unique pages of a domain ranking in Google’s top 100 organic results | ”Get organic pages for nerdwallet.com, return URL and estimated traffic” |
| Get Domain Organic Subdomains | Returns subdomains ranking in Google’s top 100 organic results | ”List organic subdomains for wikipedia.org, return subdomain and traffic share” |
| Get Domain Pla Keywords | Retrieves keywords used in product listing ads for a domain | ”Get PLA keywords for bestbuy.com, return keyword and CPC” |
| Get Domain Pla Copies | Provides unique product listing ad copies from a domain’s shopping campaigns | ”Get PLA ad copies for homedepot.com, return title and price” |
| Get Domain Pla Competitors | Finds a domain’s competitors in Google Shopping results | ”Find PLA competitors for wayfair.com, return competitor domain and overlap %“ |
| Get Keyword Overview | Supplies overview metrics for a keyword in a specific or all databases | ”Keyword overview for ‘electric bikes’ across all databases, return volume, CPC, and trend” |
| Get Keyword Search Results | Returns organic or paid SERP results for a keyword | ”Get organic search results for ‘best crm software’, return position, URL, and title” |
| Research Related Keywords | Generates related keywords, broad matches, or question phrases | ”Research related keywords for ‘meal kit’, return keyword and search volume” |
| Get Keyword Ads History | Lists domains that bid on a keyword during the last 12 months | ”Show ads history for keyword ‘iphone 15’, return domain and months advertised” |
| Get Keyword Difficulty Score | Calculates the keyword difficulty index | ”Get keyword difficulty for ‘project management software’, return difficulty score” |
| Get Subdomain Competitors | Finds competitors for a subdomain in organic or paid search | ”Find competitors for blog.hubspot.com in organic search, return competitor and common keywords” |
| Get Backlinks Overview | Summarizes backlinks including referring domains and IPs | ”Backlinks overview for moz.com, return total backlinks and referring domains” |
| Get Backlinks List | Provides detailed backlink data pointing to a domain | ”Get backlinks list for semrush.com, return source URL, target URL, and anchor text” |
| Analyze Backlinks Data | Returns backlink analysis such as TLD, geo, or anchor distribution | ”Analyze backlinks for stripe.com, return top referring TLDs and counts” |
| Get Backlinks Pages | Lists indexed pages of the queried domain | ”Get backlink pages for nytimes.com, return page URL and backlinks count” |
| Get Backlinks Competitors | Finds backlink competitors for a domain | ”Find backlink competitors for coursera.org, return competitor and common referring domains” |
| Get Backlinks Authority Score Profile | Retrieves authority score profile for a domain | ”Get authority score profile for adobe.com, return score and category percentile” |
| Get Backlinks Categories Profile | Shows website category distribution of backlinks | ”Get backlink category profile for cnn.com, return category and backlink share” |
| Get Domain Categories | Lists categories a domain belongs to | ”Get domain categories for etsy.com, return category and confidence” |
| Get Backlinks Historical Data | Provides monthly historical trends of backlinks and referring domains | ”Get 24-month backlink history for github.com, return month, backlinks, and referring domains” |
Credit Costs
| Tool | Credits Per Use |
|---|---|
| Get Domain Rank Report | 4 |
| Get Winners Losers Report | 4 |
| Get Domain Keywords | 3 |
| Get Domain Ad Copies | 3 |
| Get Domain Competitors | 4 |
| Get Domain Ad History | 4 |
| Compare Domains By Keywords | 8 |
| Get Domain Overview Data | 5 |
| Get Organic Pages | 3 |
| Get Domain Organic Subdomains | 3 |
| Get Domain Pla Keywords | 3 |
| Get Domain Pla Copies | 3 |
| Get Domain Pla Competitors | 4 |
| Get Keyword Overview | 5 |
| Get Keyword Search Results | 3 |
| Research Related Keywords | 3 |
| Get Keyword Ads History | 4 |
| Get Keyword Difficulty Score | 8 |
| Get Subdomain Competitors | 4 |
| Get Backlinks Overview | 5 |
| Get Backlinks List | 3 |
| Analyze Backlinks Data | 6 |
| Get Backlinks Pages | 3 |
| Get Backlinks Competitors | 4 |
| Get Backlinks Authority Score Profile | 5 |
| Get Backlinks Categories Profile | 5 |
| Get Domain Categories | 5 |
| Get Backlinks Historical Data | 10 |
How to Use
1
Create Your Semrush MCP Node
Go to your node library, search for Semrush, and click “Create a node with AI”
2
Add Your Prompt
Drag the Semrush node onto the canvas and write a clear, single-action prompt (see examples below).
3
Test Your Node
Run the node and review the output. Adjust filters or fields as needed.
4
Save and Reuse
Save the working Semrush node to your library so you can drop it into any future workflow.
Example Prompts
With 28 available tools, these examples showcase common use cases. Experiment with natural language to discover more possibilities. Competitive AnalysisStart with a specific question (one domain or one keyword) and request only the fields you need. This keeps responses fast and minimizes credit usage.
Troubleshooting
If your Semrush node isn’t behaving as expected, try the tips below.Keep Prompts Simple and Specific
- Good: “Get keyword overview for ‘solar panels’, return volume and CPC”
- Bad: “Give me an SEO strategy for solar panels including keyword data, competitor analysis, and a 12-month content calendar”
While the bad prompt might work, it’s more efficient to break it into separate nodes. Semrush MCP works best with focused, single-action prompts.
Match What Semrush Can Do
- Good: “Get domain ad history for booking.com, return keyword and months_bid”
- Bad: “Post the best performing booking.com ads to my Slack channel”
Semrush MCP focuses on SEO and marketing data. For posting to Slack, combine it with Slack Message Sender in your workflow.
Break Complex Tasks Into Steps
Instead of trying to do everything in one prompt (which might cause timeouts or unexpected results):1
Step 1: Gather Shared Keywords
Compare domains by keywords: domain1.com, domain2.com, domain3.com, return shared_keywords
2
Step 2: Backlink Gap Analysis
Get backlinks competitors for domain1.com, return competitor and referring_domains_gap
3
Step 3: Topic Ideation
Ask AI: “Based on the shared keyword list and backlink gaps, suggest 10 content topics”
In your workflow, connect these nodes sequentially. The shared keywords from Step 1 feed into the Ask AI prompt in Step 3, while backlink gaps from Step 2 provide additional context.
Focus on Data Retrieval
Semrush MCP is great at getting information from Semrush. For writing analyses or reports, hand the data to Ask AI. Example:- Good prompt: “Get keyword difficulty score for ‘ai writing software’, return difficulty”
- Bad prompt: “Write a full blog post about AI writing software and include Semrush keyword data”
Use Semrush MCP for data retrieval, then pass the results to Ask AI for content creation.
Troubleshooting Node Creation
Empty Outputs
Empty Outputs
In the node creation window, click “Request changes” and ask the AI to add debug logs and verify the API response.
Incorrect Results
Incorrect Results
In the node creation window, click “Request changes” and describe what you expected versus what you received.
Errors
Errors
First click “Fix with Gummie”. If multiple attempts fail, simplify your prompt or contact support.
Iterate with Request Changes
Iterate with Request Changes
MCP node creation often requires a few tweaks. Use “Request changes” (in the node creation window) to refine filters, output fields, or pagination.
Need More Help?
- Watch What are MCP Nodes video tutorial
- Check out MCP Best Practices in Gumloop University
- Join the Gumloop Community for support
- View the Semrush MCP setup guide for Claude and Cursor
- Contact support at support@gumloop.com