# SEMrush

Source : https://pilot.braike.com/docs/regies/semrush

Les 18 outils de lecture que Pilot MCP sert pour SEMrush, tirés du serveur.

Pilot MCP sert **18 outils** pour SEMrush, tous en lecture, à tous les forfaits. Leur nom commence par `semrush_`. Le connecteur n'a aucun outil qui écrit.

<Callout title="Ce que dit chaque fiche">
Le nom, la description et les paramètres viennent de la liste que le serveur sert à votre assistant (`tools/list`). Les descriptions sont en anglais : c'est le texte que votre assistant reçoit. Votre assistant n'a pas à remplir les accès à la régie : Pilot les ajoute à chaque appel.
</Callout>

## Familles d'outils [#familles]

| Famille | Outils |
| --- | ---: |
| [Autres outils](#autres) | 18 |

## Autres outils [#autres]

### `semrush_get_api_units_status` [#semrush_get_api_units_status]

**SEMrush: Get API Units Status** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `days` | `integer` | non | Window used to compute Pilot's consumption, in days (default 30). Défaut : `30`. |

### `semrush_get_backlink_anchors` [#semrush_get_backlink_anchors]

**SEMrush: Get Backlink Anchors** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `target` | `string` | oui | Target domain or URL. |
| `target_type` | `string` | non | Valeurs : `"root_domain"`, `"domain"`, `"url"`. Défaut : `"root_domain"`. |
| `limit` | `integer` | non | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Défaut : `100`. |
| `confirm_units` | `boolean` | non | 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** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `target` | `string` | oui | Target domain or URL. |
| `target_type` | `string` | non | Valeurs : `"root_domain"`, `"domain"`, `"url"`. Défaut : `"root_domain"`. |
| `limit` | `integer` | non | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Défaut : `100`. |
| `confirm_units` | `boolean` | non | 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** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `target` | `string` | oui | Target domain or URL, e.g. 'braike.com'. |
| `target_type` | `string` | non | Scope of the analysis: root domain, subdomain, or exact URL. Valeurs : `"root_domain"`, `"domain"`, `"url"`. Défaut : `"root_domain"`. |

### `semrush_get_domain_organic_keywords` [#semrush_get_domain_organic_keywords]

**SEMrush: Get Domain Organic Keywords** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `domain` | `string` | oui | Domain WITHOUT protocol, e.g. 'braike.com'. |
| `database` | `string` | non | 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. Défaut : `"fr"`. |
| `limit` | `integer` | non | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Défaut : `100`. |
| `offset` | `integer` | non | Offset for pagination. Défaut : `0`. |
| `sort` | `string` | non | Sort order, e.g. 'tr\_desc' (traffic descending), 'po\_asc' (position ascending). |
| `confirm_units` | `boolean` | non | 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** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `domain` | `string` | oui | Domain WITHOUT protocol, e.g. 'braike.com'. |
| `database` | `string` | non | 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. Défaut : `"fr"`. |

### `semrush_get_domain_paid_keywords` [#semrush_get_domain_paid_keywords]

**SEMrush: Get Domain Paid Keywords** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `domain` | `string` | oui | Domain WITHOUT protocol, e.g. 'concurrent.com'. |
| `database` | `string` | non | 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. Défaut : `"fr"`. |
| `limit` | `integer` | non | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Défaut : `100`. |
| `confirm_units` | `boolean` | non | 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** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `phrases` | `string[]` | oui | Keywords to evaluate (max 100). Each keyword costs \~50 units. |
| `database` | `string` | non | 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. Défaut : `"fr"`. |
| `confirm_units` | `boolean` | non | 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** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `phrase` | `string` | oui | Exact keyword, e.g. 'logiciel de facturation'. |
| `database` | `string` | non | 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. Défaut : `"fr"`. |

### `semrush_get_keyword_questions` [#semrush_get_keyword_questions]

**SEMrush: Get Keyword Questions** · lecture · rejouable

Questions asked around a phrase ("how", "why"...), with volume. An ideal base for editorial content and FAQs. Billed \~40 units PER ROW. Read-only.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `phrase` | `string` | oui | Seed phrase. |
| `database` | `string` | non | 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. Défaut : `"fr"`. |
| `limit` | `integer` | non | Number of questions to return. Défaut : `50`. |
| `confirm_units` | `boolean` | non | 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** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `domain` | `string` | oui | Domain WITHOUT protocol. |
| `database` | `string` | non | 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. Défaut : `"fr"`. |
| `limit` | `integer` | non | Number of competitors (default 20). Expensive: \~40 units per row. Défaut : `20`. |
| `confirm_units` | `boolean` | non | 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** · lecture · rejouable

Paid competitors of a domain: who buys the same keywords in Google Ads. Billed \~40 units PER ROW. Read-only.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `domain` | `string` | oui | Domain WITHOUT protocol. |
| `database` | `string` | non | 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. Défaut : `"fr"`. |
| `limit` | `integer` | non | Number of competitors to return. Défaut : `20`. |
| `confirm_units` | `boolean` | non | 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** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `target` | `string` | oui | Target domain or URL. |
| `target_type` | `string` | non | Valeurs : `"root_domain"`, `"domain"`, `"url"`. Défaut : `"root_domain"`. |
| `limit` | `integer` | non | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Défaut : `100`. |
| `confirm_units` | `boolean` | non | 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** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `phrase` | `string` | oui | Seed phrase. |
| `database` | `string` | non | 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. Défaut : `"fr"`. |
| `limit` | `integer` | non | Number of keywords to return. Défaut : `50`. |
| `confirm_units` | `boolean` | non | 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** · lecture · rejouable

Traffic sources of a domain (direct, referral, search, social, paid) with their relative weight. \~1 unit per request. Read-only.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `target` | `string` | oui | Domain to analyze. |
| `country` | `string` | non | ISO country code, e.g. 'fr'. |

### `semrush_get_traffic_summary` [#semrush_get_traffic_summary]

**SEMrush: Get Traffic Summary** · lecture · rejouable

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.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `targets` | `string[]` | oui | Domains to analyze (max 200), e.g. \['braike.com','concurrent.com'\]. |
| `country` | `string` | non | 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** · lecture · rejouable

Most visited pages of a domain according to Traffic Analytics. Used to spot a competitor's entry pages. \~1 unit per request. Read-only.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `target` | `string` | oui | Domain to analyze. |
| `country` | `string` | non | ISO country code, e.g. 'fr'. |
| `limit` | `integer` | non | Number of pages to return. Défaut : `50`. |

### `semrush_get_url_organic_keywords` [#semrush_get_url_organic_keywords]

**SEMrush: Get URL Organic Keywords** · lecture · rejouable

Organic keywords ranking on ONE SPECIFIC URL (not the whole domain). Used to diagnose an underperforming page. \~10 units PER ROW. Read-only.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `url` | `string` | oui | Full URL WITH protocol, e.g. 'https://braike.com/tarifs'. |
| `database` | `string` | non | 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. Défaut : `"fr"`. |
| `limit` | `integer` | non | Number of rows to fetch (default 100, max 10000). WARNING: Semrush bills PER ROW, so doubling this value doubles the cost. Défaut : `100`. |
| `confirm_units` | `boolean` | non | Required (true) for heavy calls above the unit threshold, so that a large spend is always an explicit choice. |
