# SEMrush

Source: https://pilot.braike.com/en/docs/regies/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.

<Callout title="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.
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 18 |

## Other tools [#autres]

### `semrush_get_api_units_status` [#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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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. |
