Search Console araçları
Sorgu ve sayfa performansı, düşük tıklama oranlı sayfalar, URL denetimi, site haritaları ve reklamla karşılaştırma.
Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü metnin çevirisidir, araç ve parametre adları aynen kalır.
Okuma araçları8 araç
list_search_console_sites
Okuma1 krediBağlı Google hesabının okuyabildiği doğrulanmış Search Console mülkleri; izin düzeyi ve site_url verilmediğinde kullanılan varsayılan mülk ile birlikte.
Bu araç parametre almaz.
search_console_query
Okuma1 krediHerhangi bir tarih aralığı için sorgu, sayfa, ülke, cihaz, tarih ya da searchAppearance kırılımında Search Console performans raporu (tıklama, gösterim, ctr %, ortalama konum), AND filtreleriyle. compare_previous=true önceki eşit dönemi ve satır başına değişimi ekler; order_by=clicks_change ile order=asc en çok kaybedenleri listeler. Bağlı bir Google hesabı gerektirir; yoksa connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
site_urlİsteğe bağlı | string | Search Console mülkü, ör. https://example.com/ ya da sc-domain:example.com. Bağlı varsayılanı kullanmak için boş bırakılır. |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
daysİsteğe bağlı | integer (1–480) | tarihler verilmediğinde bugün biten pencere (varsayılan 28) |
dimensionsİsteğe bağlı | array<query | page | country | device | date | searchAppearance> | varsayılan [query] |
filtersİsteğe bağlı | array<object> | AND ile birleştirilen boyut filtreleri (ör. query notContains marka, page equals URL) |
exclude_termsİsteğe bağlı | array<string> | sorgudan dışlanacak marka terimleri (marka dışı rapor) |
pageİsteğe bağlı | string | tek bir sayfa URL'siyle sınırlar |
countryİsteğe bağlı | string | ISO 3166-1 alpha-3, ör. TUR |
deviceİsteğe bağlı | DESKTOP | MOBILE | TABLET | — |
search_typeİsteğe bağlı | web | image | video | news | discover | googleNews | — |
row_limitİsteğe bağlı | integer (1–5000) | — |
start_rowİsteğe bağlı | integer (0–…) | — |
compare_previousİsteğe bağlı | boolean | hemen önceki eşit uzunluktaki dönemi de getirir ve satır başına önceki/değişim ekler |
order_byİsteğe bağlı | clicks | impressions | ctr | position | clicks_change | impressions_change | ctr_change | position_change | — |
orderİsteğe bağlı | asc | desc | — |
search_console_top_queries
Okuma1 krediDönemin tıklamaya (ya da gösterim/ctr/konuma) göre en iyi sorguları; marka dışı liste için exclude_terms ile marka kelimeleri verilir.
| Parametre | Tip | Açıklama |
|---|---|---|
site_urlİsteğe bağlı | string | Search Console mülkü, ör. https://example.com/ ya da sc-domain:example.com. Bağlı varsayılanı kullanmak için boş bırakılır. |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
daysİsteğe bağlı | integer (1–480) | tarihler verilmediğinde bugün biten pencere (varsayılan 28) |
filtersİsteğe bağlı | array<object> | AND ile birleştirilen boyut filtreleri (ör. query notContains marka, page equals URL) |
exclude_termsİsteğe bağlı | array<string> | sorgudan dışlanacak marka terimleri (marka dışı rapor) |
pageİsteğe bağlı | string | tek bir sayfa URL'siyle sınırlar |
countryİsteğe bağlı | string | ISO 3166-1 alpha-3, ör. TUR |
deviceİsteğe bağlı | DESKTOP | MOBILE | TABLET | — |
limitİsteğe bağlı | integer (1–1000) | — |
order_byİsteğe bağlı | clicks | impressions | ctr | position | — |
search_console_low_ctr_pages
Okuma2 krediGösterimi yüksek ama CTR'si düşük sayfalar (ya da sorgular) — başlık/meta açıklaması yeniden yazılacak adaylar. Varsayılanlar: gösterim ≥ 1000 ve ctr < %2. Gösterime göre sıralı.
| Parametre | Tip | Açıklama |
|---|---|---|
site_urlİsteğe bağlı | string | Search Console mülkü, ör. https://example.com/ ya da sc-domain:example.com. Bağlı varsayılanı kullanmak için boş bırakılır. |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
daysİsteğe bağlı | integer (1–480) | tarihler verilmediğinde bugün biten pencere (varsayılan 28) |
filtersİsteğe bağlı | array<object> | AND ile birleştirilen boyut filtreleri (ör. query notContains marka, page equals URL) |
exclude_termsİsteğe bağlı | array<string> | sorgudan dışlanacak marka terimleri (marka dışı rapor) |
pageİsteğe bağlı | string | tek bir sayfa URL'siyle sınırlar |
countryİsteğe bağlı | string | ISO 3166-1 alpha-3, ör. TUR |
deviceİsteğe bağlı | DESKTOP | MOBILE | TABLET | — |
dimensionİsteğe bağlı | page | query | — |
min_impressionsİsteğe bağlı | number | — |
max_ctrİsteğe bağlı | number | yüzde, varsayılan 2 |
limitİsteğe bağlı | integer (1–500) | — |
inspect_url
Okuma1 krediURL Denetimi: dizine eklenmiş mi, kapsam durumu, son tarama zamanı, robots/dizine ekleme durumu, Google ve kullanıcı kanoniği, mobil kullanılabilirlik ve zengin sonuç kararları. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
urlZorunlu | string | mülk altındaki tam URL |
site_urlİsteğe bağlı | string | Search Console mülkü, ör. https://example.com/ ya da sc-domain:example.com. Bağlı varsayılanı kullanmak için boş bırakılır. |
list_sitemaps
Okuma1 krediMülk için gönderilmiş site haritaları; son gönderim/indirme zamanı, bekliyor işareti, uyarı ve hata sayıları ile içerik türü sayıları.
| Parametre | Tip | Açıklama |
|---|---|---|
site_urlİsteğe bağlı | string | Search Console mülkü, ör. https://example.com/ ya da sc-domain:example.com. Bağlı varsayılanı kullanmak için boş bırakılır. |
gsc_inspect_urls
Okuma2 krediToplu URL Denetimi: tek çağrıda birçok URL için dizin kararı, kapsam, son tarama, Google standart URL'si ve mobil kararı; özetle birlikte (dizinde / dizinde değil / hiç taranmamış; bir tarihten beri yeniden taranan). Her URL ayrı denetlenir; bir hata diğerlerini durdurmaz. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
urlsZorunlu | array<string> | mülk altındaki tam URL'ler |
site_urlİsteğe bağlı | string | Search Console mülkü, ör. https://example.com/ ya da sc-domain:example.com. Boş bırakılırsa bağlı varsayılan kullanılır. |
limitİsteğe bağlı | integer (1–50) | urls içinden kaç tanesinin denetleneceği (varsayılan 20) |
crawled_sinceİsteğe bağlı | string | YYYY-MM-DD; Google'ın bu tarihte ya da sonrasında yeniden taradığı URL'leri işaretler |
search_console_vs_ads
Okuma2 krediAynı terimlerde organik ve ücretli yan yana: sorgu başına Search Console tıklama/gösterim/konum ile son N günün (varsayılan 28) Google Ads arama terimi gösterim, tıklama, harcama ve dönüşümleri. Google Ads bağlı değilse ücretli sütun boş kalır ve not düşülür.
| Parametre | Tip | Açıklama |
|---|---|---|
site_urlİsteğe bağlı | string | Search Console mülkü, ör. https://example.com/ ya da sc-domain:example.com. Bağlı varsayılanı kullanmak için boş bırakılır. |
daysİsteğe bağlı | integer (1–90) | — |
filtersİsteğe bağlı | array<object> | AND ile birleştirilen boyut filtreleri (ör. query notContains marka, page equals URL) |
exclude_termsİsteğe bağlı | array<string> | sorgudan dışlanacak marka terimleri (marka dışı rapor) |
pageİsteğe bağlı | string | tek bir sayfa URL'siyle sınırlar |
countryİsteğe bağlı | string | ISO 3166-1 alpha-3, ör. TUR |
deviceİsteğe bağlı | DESKTOP | MOBILE | TABLET | — |
limitİsteğe bağlı | integer (1–500) | — |
Yazma araçları5 araç
submit_sitemap
Yazma2 krediSearch Console'a bir site haritası gönderir (ya da yeniden gönderir). Mülkü ve site haritası URL'sini gösteren önizlemeli bir onay öğesi oluşturur; Google'a yalnızca onaydan sonra ve yalnızca bağlı hesapla gönderilir.
| Parametre | Tip | Açıklama |
|---|---|---|
sitemap_urlZorunlu | string | — |
site_urlİsteğe bağlı | string | Search Console mülkü, ör. https://example.com/ ya da sc-domain:example.com. Bağlı varsayılanı kullanmak için boş bırakılır. |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_sitemap
YazmaGeri alınamaz2 krediSearch Console'dan bir site haritasını kaldırır. Önizleme ve onaydan geçer; yalnızca kullanıcı onayladıktan sonra uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
sitemap_urlZorunlu | string | — |
site_urlİsteğe bağlı | string | Search Console mülkü, ör. https://example.com/ ya da sc-domain:example.com. Bağlı varsayılanı kullanmak için boş bırakılır. |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
gsc_add_site
Yazma2 krediBir web sitesini Search Console mülkü olarak ekler. Bir onay öğesi açar; mülk doğrulanmamış olarak eklenir ve veri görünmeden önce sahiplik Search Console'da (DNS ya da HTML) doğrulanmalıdır.
| Parametre | Tip | Açıklama |
|---|---|---|
site_urlZorunlu | string | https://example.com/ (URL öneki) ya da sc-domain:example.com |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
connect_search_console
Yazma0 krediGoogle Search Console bağlantısını başlatır: kullanıcının açacağı tek kullanımlık bir yetkilendirme bağlantısı döndürür (connect_account ile aynı akış). Kullanıcı oturum açana kadar hiçbir şey bağlanmaz.
Bu araç parametre almaz.
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
select_google_resource
Yazma0 krediHesabın varsayılan olarak üzerinde çalıştığı tek Google kaynağını seçer: Search Console mülkü, GA4 mülkü, Business Profile konumu, YouTube kanalı ya da Tag Manager kapsayıcısı. resource verilmezse seçenekleri listeler. Seçim canlı hesaba karşı doğrulanır ve bir araç açık kaynak verilmeden çağrıldığında kullanılır.
| Parametre | Tip | Açıklama |
|---|---|---|
serviceZorunlu | search_console | ga4 | business_profile | youtube | tag_manager | — |
resourceİsteğe bağlı | string | seçeneklerdeki id ya da ad; seçenekleri ve mevcut seçimi listelemek için boş bırakın; 'none' seçimi temizler |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.