SEMrush
The 18 read-only tools Pilot MCP serves for SEMrush, taken from the server.
Pilot MCP serves 18 tools for SEMrush, all read-only, on every plan. Their names start with semrush_. The connector has no tool that writes.
What each entry shows
The name, description and parameters come from the list the server serves to your assistant (tools/list). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
Tool families
| Family | Tools |
|---|---|
| Other tools | 18 |
Other tools
semrush_get_api_units_status
SEMrush: Get API Units Status · read-only · idempotent
Remaining Semrush API unit balance plus the consumption already committed by Pilot. FREE CALL (0 units): always make it BEFORE a series of reports, to know whether the client's unit budget allows the planned analysis. Semrush units are bought by the client and do not refill on their own.
| Parameter | Type | Required | Description |
|---|---|---|---|
days | integer | no | Window used to compute Pilot's consumption, in days (default 30). Default: 30. |
semrush_get_backlink_anchors
SEMrush: Get Backlink Anchors · read-only · idempotent
Anchors of a target's inbound links, with the number of backlinks and domains per anchor. Reveals anchor over-optimization. ~40 units PER ROW. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
target | string | yes | Target domain or URL. |
target_type | string | no | Values: "root_domain", "domain", "url". Default: "root_domain". |
limit | integer | no | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Default: 100. |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
semrush_get_backlinks
SEMrush: Get Backlinks · read-only · idempotent
List of the backlinks pointing to a domain or a URL (source, anchor, follow/nofollow, date). ~40 units PER ROW: expensive, keep limit low. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
target | string | yes | Target domain or URL. |
target_type | string | no | Values: "root_domain", "domain", "url". Default: "root_domain". |
limit | integer | no | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Default: 100. |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
semrush_get_backlinks_overview
SEMrush: Get Backlinks Overview · read-only · idempotent
Overview of a domain's link profile: number of backlinks, referring domains, authority score, follow/nofollow split. Flat ~40 units per request (not per row). Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
target | string | yes | Target domain or URL, e.g. 'braike.com'. |
target_type | string | no | Scope of the analysis: root domain, subdomain, or exact URL. Values: "root_domain", "domain", "url". Default: "root_domain". |
semrush_get_domain_organic_keywords
SEMrush: Get Domain Organic Keywords · read-only · idempotent
Keywords a domain ranks for organically (position, volume, CPC, ranking URL, estimated traffic). The core of SEO analysis. Billed ~10 units PER ROW: keep limit low. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | yes | Domain WITHOUT protocol, e.g. 'braike.com'. |
database | string | no | Semrush regional database: 'fr' (France), 'us', 'uk', 'de', 'es', 'it', 'be'... PITFALL: querying a .fr domain on the 'us' database returns empty data without any error. Default: "fr". |
limit | integer | no | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Default: 100. |
offset | integer | no | Offset for pagination. Default: 0. |
sort | string | no | Sort order, e.g. 'tr_desc' (traffic descending), 'po_asc' (position ascending). |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
semrush_get_domain_overview
SEMrush: Get Domain Overview · read-only · idempotent
Overview of a domain: estimated organic and paid traffic, number of ranking keywords, estimated advertising budget. The most useful report for a first diagnosis. Low cost (~10 units). Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | yes | Domain WITHOUT protocol, e.g. 'braike.com'. |
database | string | no | Semrush regional database: 'fr' (France), 'us', 'uk', 'de', 'es', 'it', 'be'... PITFALL: querying a .fr domain on the 'us' database returns empty data without any error. Default: "fr". |
semrush_get_domain_paid_keywords
SEMrush: Get Domain Paid Keywords · read-only · idempotent
Keywords a domain buys in Google Ads (position, volume, CPC, ad text, destination URL). Used to read a competitor's paid strategy. Billed ~20 units PER ROW. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | yes | Domain WITHOUT protocol, e.g. 'concurrent.com'. |
database | string | no | Semrush regional database: 'fr' (France), 'us', 'uk', 'de', 'es', 'it', 'be'... PITFALL: querying a .fr domain on the 'us' database returns empty data without any error. Default: "fr". |
limit | integer | no | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Default: 100. |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
semrush_get_keyword_difficulty
SEMrush: Get Keyword Difficulty · read-only · idempotent
Difficulty index (KD %) for a list of keywords: estimates the effort needed to rank. EXPENSIVE REPORT (~50 units PER keyword): only call it on an already filtered list. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
phrases | string[] | yes | Keywords to evaluate (max 100). Each keyword costs ~50 units. |
database | string | no | Semrush regional database: 'fr' (France), 'us', 'uk', 'de', 'es', 'it', 'be'... PITFALL: querying a .fr domain on the 'us' database returns empty data without any error. Default: "fr". |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
semrush_get_keyword_overview
SEMrush: Get Keyword Overview · read-only · idempotent
Overview of a keyword: search volume, CPC, competition level, number of results. The report to use to qualify an intent before investing. Low cost (~10 units). Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
phrase | string | yes | Exact keyword, e.g. 'logiciel de facturation'. |
database | string | no | Semrush regional database: 'fr' (France), 'us', 'uk', 'de', 'es', 'it', 'be'... PITFALL: querying a .fr domain on the 'us' database returns empty data without any error. Default: "fr". |
semrush_get_keyword_questions
SEMrush: Get Keyword Questions · read-only · idempotent
Questions asked around a phrase ("how", "why"...), with volume. An ideal base for editorial content and FAQs. Billed ~40 units PER ROW. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
phrase | string | yes | Seed phrase. |
database | string | no | Semrush regional database: 'fr' (France), 'us', 'uk', 'de', 'es', 'it', 'be'... PITFALL: querying a .fr domain on the 'us' database returns empty data without any error. Default: "fr". |
limit | integer | no | Number of questions to return. Default: 50. |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
semrush_get_organic_competitors
SEMrush: Get Organic Competitors · read-only · idempotent
Organic competitors of a domain: who ranks for the same keywords, with the level of overlap. Billed ~40 units PER ROW, so keep limit very low (10-20 is enough). Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | yes | Domain WITHOUT protocol. |
database | string | no | Semrush regional database: 'fr' (France), 'us', 'uk', 'de', 'es', 'it', 'be'... PITFALL: querying a .fr domain on the 'us' database returns empty data without any error. Default: "fr". |
limit | integer | no | Number of competitors (default 20). Expensive: ~40 units per row. Default: 20. |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
semrush_get_paid_competitors
SEMrush: Get Paid Competitors · read-only · idempotent
Paid competitors of a domain: who buys the same keywords in Google Ads. Billed ~40 units PER ROW. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | yes | Domain WITHOUT protocol. |
database | string | no | Semrush regional database: 'fr' (France), 'us', 'uk', 'de', 'es', 'it', 'be'... PITFALL: querying a .fr domain on the 'us' database returns empty data without any error. Default: "fr". |
limit | integer | no | Number of competitors to return. Default: 20. |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
semrush_get_referring_domains
SEMrush: Get Referring Domains · read-only · idempotent
Referring domains pointing to a target, with their authority score. More useful than the raw backlink list to judge a link profile. ~40 units PER ROW. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
target | string | yes | Target domain or URL. |
target_type | string | no | Values: "root_domain", "domain", "url". Default: "root_domain". |
limit | integer | no | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Default: 100. |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
semrush_get_related_keywords
SEMrush: Get Related Keywords · read-only · idempotent
Keywords semantically related to a phrase, with volume and CPC. Used to build a semantic universe or find variants. Billed ~40 units PER ROW: keep limit low. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
phrase | string | yes | Seed phrase. |
database | string | no | Semrush regional database: 'fr' (France), 'us', 'uk', 'de', 'es', 'it', 'be'... PITFALL: querying a .fr domain on the 'us' database returns empty data without any error. Default: "fr". |
limit | integer | no | Number of keywords to return. Default: 50. |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
semrush_get_traffic_sources
SEMrush: Get Traffic Sources · read-only · idempotent
Traffic sources of a domain (direct, referral, search, social, paid) with their relative weight. ~1 unit per request. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
target | string | yes | Domain to analyze. |
country | string | no | ISO country code, e.g. 'fr'. |
semrush_get_traffic_summary
SEMrush: Get Traffic Summary · read-only · idempotent
Traffic Analytics: estimated visits, unique visitors, pages per visit, average duration and bounce rate for one or more domains. Very cheap (~1 unit per domain), the one to prefer for comparing competitors. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
targets | string[] | yes | Domains to analyze (max 200), e.g. ['braike.com','concurrent.com']. |
country | string | no | ISO country code to restrict the analysis, e.g. 'fr'. Empty = worldwide. |
semrush_get_traffic_top_pages
SEMrush: Get Traffic Top Pages · read-only · idempotent
Most visited pages of a domain according to Traffic Analytics. Used to spot a competitor's entry pages. ~1 unit per request. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
target | string | yes | Domain to analyze. |
country | string | no | ISO country code, e.g. 'fr'. |
limit | integer | no | Number of pages to return. Default: 50. |
semrush_get_url_organic_keywords
SEMrush: Get URL Organic Keywords · read-only · idempotent
Organic keywords ranking on ONE SPECIFIC URL (not the whole domain). Used to diagnose an underperforming page. ~10 units PER ROW. Read-only.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | yes | Full URL WITH protocol, e.g. 'https://braike.com/tarifs'. |
database | string | no | Semrush regional database: 'fr' (France), 'us', 'uk', 'de', 'es', 'it', 'be'... PITFALL: querying a .fr domain on the 'us' database returns empty data without any error. Default: "fr". |
limit | integer | no | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Default: 100. |
confirm_units | boolean | no | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |