Automate SEO analysis with SEMrush -- research keywords, analyze domain organic rankings, audit backlinks, assess keyword difficulty, and discover related terms through the Composio SEMrush integration.
SKILL.md
SEMrush Automation
Run SEMrush SEO analytics directly from Claude Code. Analyze domain keywords, audit backlink profiles, research keyword difficulty, discover related terms, and track organic page performance without leaving your terminal.
Add the Composio MCP server to your configuration:
https://rube.app/mcp
Connect your SEMrush account when prompted. The agent will provide an authentication link.
All SEMrush tools require a database parameter specifying the regional database (e.g., us, uk, de). Choose the correct region for your target audience.
Core Workflows
1. Domain Organic Keywords Analysis
Retrieve all organic search keywords for a domain, including positions, traffic estimates, CPC, and keyword difficulty.
Example prompt: "Find related keywords for 'project management' in the US, sorted by search volume"
Known Pitfalls
Pagination is essential:SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS and SEMRUSH_DOMAIN_ORGANIC_PAGES can return very large datasets. Always use display_limit and display_offset instead of assuming a single page is complete.
CSV-style responses: Many SEMrush tools return data as CSV-style text in a single field (e.g., data/keyword_data). You must parse rows and columns before analysis or joining reports.
"ERROR 50 :: NOTHING FOUND": This literal string means the domain or keyword has no data in that database. Treat it as a valid zero-result response, not a transport error.
Batch keyword limits:SEMRUSH_BATCH_KEYWORD_OVERVIEW may return HTTP 400 for problematic or oversized batches (max 255 chars total for the phrase field). Shrink batches or fall back to SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE for individual lookups.
Date format: Historical dates must use YYYYMM15 format for monthly data (e.g., 20231015). Using an incorrect format will return unexpected results.
Regional database matters: Always use the correct regional database for your target audience. Results for us vs uk can differ dramatically in volume, CPC, and rankings.
Column codes: Export columns use short codes (Ph, Nq, Kd, etc.). Avoid over-narrowing export_columns so key metrics like traffic, CPC, position, and difficulty are retained.
Quick Reference
Tool Slug
Description
SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS
Organic keywords for a domain with positions and traffic
