Outils Search Console
Performances des requêtes et des pages, pages à faible CTR, inspection d'URL, sitemaps et comparaison avec les annonces.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont la traduction du texte vu par l'assistant, les noms d'outils et de paramètres restent inchangés.
Outils de lecture8 outils
list_search_console_sites
Lecture1 créditsPropriétés Search Console vérifiées que le compte Google connecté peut lire, avec le niveau d'autorisation et la propriété par défaut utilisée lorsque site_url est omis.
Cet outil ne prend aucun paramètre.
search_console_query
Lecture1 créditsRapport de performances Search Console (clics, impressions, ctr %, position moyenne) pour toute plage de dates par requête, page, pays, appareil, date ou searchAppearance, avec filtres AND. compare_previous=true ajoute la période précédente équivalente et la variation par ligne ; order_by=clicks_change avec order=asc liste les plus fortes baisses. Nécessite un compte Google connecté ; sinon renvoie connected=false.
| Paramètre | Type | Description |
|---|---|---|
site_urlFacultatif | string | Propriété Search Console, p. ex. https://example.com/ ou sc-domain:example.com. Omettre pour utiliser la propriété connectée par défaut. |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
daysFacultatif | integer (1–480) | fenêtre se terminant aujourd'hui lorsque les dates sont omises (28 par défaut) |
dimensionsFacultatif | array<query | page | country | device | date | searchAppearance> | [query] par défaut |
filtersFacultatif | array<object> | filtres de dimension combinés par AND (p. ex. query notContains marque, page equals URL) |
exclude_termsFacultatif | array<string> | termes de marque à exclure de query (rapport hors marque) |
pageFacultatif | string | limiter à l'URL d'une page |
countryFacultatif | string | ISO 3166-1 alpha-3, p. ex. TUR |
deviceFacultatif | DESKTOP | MOBILE | TABLET | — |
search_typeFacultatif | web | image | video | news | discover | googleNews | — |
row_limitFacultatif | integer (1–5000) | — |
start_rowFacultatif | integer (0–…) | — |
compare_previousFacultatif | boolean | récupère aussi la période immédiatement précédente de même durée et ajoute précédent/variation par ligne |
order_byFacultatif | clicks | impressions | ctr | position | clicks_change | impressions_change | ctr_change | position_change | — |
orderFacultatif | asc | desc | — |
search_console_top_queries
Lecture1 créditsPrincipales requêtes par clics (ou impressions/ctr/position) sur la période ; passez exclude_terms avec les mots de marque pour une liste hors marque.
| Paramètre | Type | Description |
|---|---|---|
site_urlFacultatif | string | Propriété Search Console, p. ex. https://example.com/ ou sc-domain:example.com. Omettre pour utiliser la propriété connectée par défaut. |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
daysFacultatif | integer (1–480) | fenêtre se terminant aujourd'hui lorsque les dates sont omises (28 par défaut) |
filtersFacultatif | array<object> | filtres de dimension combinés par AND (p. ex. query notContains marque, page equals URL) |
exclude_termsFacultatif | array<string> | termes de marque à exclure de query (rapport hors marque) |
pageFacultatif | string | limiter à l'URL d'une page |
countryFacultatif | string | ISO 3166-1 alpha-3, p. ex. TUR |
deviceFacultatif | DESKTOP | MOBILE | TABLET | — |
limitFacultatif | integer (1–1000) | — |
order_byFacultatif | clicks | impressions | ctr | position | — |
search_console_low_ctr_pages
Lecture2 créditsPages (ou requêtes) à fortes impressions mais faible CTR — candidates à une réécriture du titre/de la meta description. Par défaut : impressions ≥ 1000 et ctr < 2 %. Triées par impressions.
| Paramètre | Type | Description |
|---|---|---|
site_urlFacultatif | string | Propriété Search Console, p. ex. https://example.com/ ou sc-domain:example.com. Omettre pour utiliser la propriété connectée par défaut. |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
daysFacultatif | integer (1–480) | fenêtre se terminant aujourd'hui lorsque les dates sont omises (28 par défaut) |
filtersFacultatif | array<object> | filtres de dimension combinés par AND (p. ex. query notContains marque, page equals URL) |
exclude_termsFacultatif | array<string> | termes de marque à exclure de query (rapport hors marque) |
pageFacultatif | string | limiter à l'URL d'une page |
countryFacultatif | string | ISO 3166-1 alpha-3, p. ex. TUR |
deviceFacultatif | DESKTOP | MOBILE | TABLET | — |
dimensionFacultatif | page | query | — |
min_impressionsFacultatif | number | — |
max_ctrFacultatif | number | pourcentage, 2 par défaut |
limitFacultatif | integer (1–500) | — |
inspect_url
Lecture1 créditsInspection d'URL : indexée ou non, état de couverture, dernière exploration, état robots/indexation, canonique Google vs utilisateur, ergonomie mobile et verdicts des résultats enrichis. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
urlObligatoire | string | URL complète sous la propriété |
site_urlFacultatif | string | Propriété Search Console, p. ex. https://example.com/ ou sc-domain:example.com. Omettre pour utiliser la propriété connectée par défaut. |
list_sitemaps
Lecture1 créditsSitemaps soumis pour la propriété avec la date de dernière soumission/téléchargement, indicateur d'attente, nombre d'avertissements et d'erreurs et décompte par type de contenu.
| Paramètre | Type | Description |
|---|---|---|
site_urlFacultatif | string | Propriété Search Console, p. ex. https://example.com/ ou sc-domain:example.com. Omettre pour utiliser la propriété connectée par défaut. |
gsc_inspect_urls
Lecture2 créditsInspection d'URL par lot : verdict d'indexation, couverture, dernière exploration, URL canonique Google et verdict mobile pour de nombreuses URL en un seul appel, avec un résumé (indexées / non indexées / jamais explorées ; réexplorées depuis une date). Chaque URL est inspectée séparément ; un échec n'arrête pas les autres. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
urlsObligatoire | array<string> | URL complètes sous la propriété |
site_urlFacultatif | string | Propriété Search Console, p. ex. https://example.com/ ou sc-domain:example.com. Omettez-la pour utiliser celle connectée par défaut. |
limitFacultatif | integer (1–50) | nombre d'URL de urls à inspecter (par défaut 20) |
crawled_sinceFacultatif | string | YYYY-MM-DD ; signale les URL que Google a réexplorées à cette date ou après |
search_console_vs_ads
Lecture2 créditsOrganique vs payant sur les mêmes termes : clics/impressions/position Search Console par requête à côté des impressions, clics, dépenses et conversions des termes de recherche Google Ads sur les N derniers jours (28 par défaut). Si Google Ads n'est pas connecté, la colonne payante reste vide avec une note.
| Paramètre | Type | Description |
|---|---|---|
site_urlFacultatif | string | Propriété Search Console, p. ex. https://example.com/ ou sc-domain:example.com. Omettre pour utiliser la propriété connectée par défaut. |
daysFacultatif | integer (1–90) | — |
filtersFacultatif | array<object> | filtres de dimension combinés par AND (p. ex. query notContains marque, page equals URL) |
exclude_termsFacultatif | array<string> | termes de marque à exclure de query (rapport hors marque) |
pageFacultatif | string | limiter à l'URL d'une page |
countryFacultatif | string | ISO 3166-1 alpha-3, p. ex. TUR |
deviceFacultatif | DESKTOP | MOBILE | TABLET | — |
limitFacultatif | integer (1–500) | — |
Outils d'écriture5 outils
submit_sitemap
Écriture2 créditsSoumet (ou resoumet) un sitemap à Search Console. Crée un élément de validation avec un aperçu de la propriété et de l'URL du sitemap ; envoyé à Google uniquement après validation et uniquement avec un compte connecté.
| Paramètre | Type | Description |
|---|---|---|
sitemap_urlObligatoire | string | — |
site_urlFacultatif | string | Propriété Search Console, p. ex. https://example.com/ ou sc-domain:example.com. Omettre pour utiliser la propriété connectée par défaut. |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
delete_sitemap
ÉcritureIrréversible2 créditsRetire un sitemap de Search Console. Passe par l'aperçu et la validation ; appliqué uniquement après approbation de l'utilisateur.
| Paramètre | Type | Description |
|---|---|---|
sitemap_urlObligatoire | string | — |
site_urlFacultatif | string | Propriété Search Console, p. ex. https://example.com/ ou sc-domain:example.com. Omettre pour utiliser la propriété connectée par défaut. |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
gsc_add_site
Écriture2 créditsAjoute un site web comme propriété Search Console. Ouvre un élément de validation ; la propriété est ajoutée non validée et la propriété du site doit encore être validée dans Search Console (DNS ou HTML) avant l'affichage des données.
| Paramètre | Type | Description |
|---|---|---|
site_urlObligatoire | string | https://example.com/ (préfixe d'URL) ou sc-domain:example.com |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
connect_search_console
Écriture0 créditsLance la connexion de Google Search Console : renvoie un lien d'autorisation à usage unique que l'utilisateur ouvre (même parcours que connect_account). Rien n'est connecté tant que l'utilisateur ne s'est pas identifié.
Cet outil ne prend aucun paramètre.
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
select_google_resource
Écriture0 créditsChoisit la ressource Google unique sur laquelle le compte travaille par défaut : une propriété Search Console, une propriété GA4, un établissement Business Profile, une chaîne YouTube ou un conteneur Tag Manager. Sans resource, liste les options. Le choix est validé auprès du compte réel et utilisé chaque fois qu'un outil est appelé sans ressource explicite.
| Paramètre | Type | Description |
|---|---|---|
serviceObligatoire | search_console | ga4 | business_profile | youtube | tag_manager | — |
resourceFacultatif | string | id ou nom issu des options ; omettre pour lister les options et le choix actuel ; 'none' l'efface |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.