Integrazione Yandex Webmaster

Leggi le query di ricerca di Yandex Webmaster per URL su un host che hai verificato, e conserva le righe accanto alla tua scansione. Sola lettura, con token OAuth, gratuito entro la quota dell'API Webmaster.

Cosa fa

Query per URL

webmaster-url-queries restituisce le query di ricerca per una pagina esatta (--url) o per un gruppo di pagine (--url-contains). Le righe di URL e query restano separate. CTR e posizione media non si sommano tra le pagine.

  • --max-urls e --max-queries-per-url impostano tetti espliciti, e la risposta dichiara quando ha troncato.
  • --start-date e --end-date filtrano le righe giornaliere.
  • Yandex tiene la sua finestra mobile, quindi un intervallo vecchio è rifiutato come non disponibile.

Accesso

Ti serve l'ID di un host verificato nel tuo account Yandex Webmaster e un token OAuth per quell'account. Il token va in YANDEX_WEBMASTER_TOKEN o nel suo file di token. SpiderHead non crea account né accede per te. provider-discover può elencare gli host che il token vede.

  • La richiesta è in sola lettura e non scrive nulla su Yandex.
  • Senza ID host il comando non gira.
  • SpiderHead verifica l'host contro il tuo account prima di chiedere le query.

Conservale accanto alla scansione

sources-sync può conservare le evidenze giornaliere di Webmaster in uno storico SQLite locale, così accumuli dati oltre ciò che l'API restituisce in una volta. evidence-join allega le righe chiave URL a una scansione ed elenca le candidate orfane da rivedere. Nessuno dei due passaggi cambia la scansione.

  • Usa --source webmaster oppure webmaster_history con sources-sync.
  • URL solo scansione, solo esterne e senza chiave restano nominate e separate.
  • Le righe conservate possono contenere query e URL, quindi tieni i file fuori da Git.

Tre passaggi, una scansione salvata

  1. Puntalo a un host verificato

    Il comando richiede un ID host Yandex Webmaster per un sito che hai verificato, più il token OAuth configurato in locale. Senza l'ID host non gira.

  2. Tira le query per una URL

    Chiedi una pagina esatta con --url, oppure un gruppo con --url-contains. I tetti sono espliciti: --max-urls e --max-queries-per-url, con --start-date e --end-date facoltativi.

  3. Unisci le righe alla tua scansione

    Conserva separate le righe di URL e query. Il passo evidence-join allega le righe chiave URL a una scansione ed elenca le candidate orfane da rivedere senza cambiare la scansione.

Un solo comando

bash
seohead webmaster-url-queries --url https://example.com/

Prima installa SpiderHead: guida all'installazione. Ogni comando funziona anche come strumento MCP per agenti AI.

Cosa ti serve

  • Un ID host verificato in Yandex Webmaster (--host-id)
  • Un token OAuth Yandex con accesso a quell'host
  • Una URL esatta o una sottostringa di URL

Limiti

  • Si possono leggere solo gli host verificati nel tuo account.
  • Yandex conserva i dati delle query per una finestra mobile limitata. Un intervallo che finisce più di 14 giorni fa è rifiutato.
  • I risultati sono troncati, e un risultato troncato è marcato come tale.
  • Le altre operazioni Webmaster, come indicizzazione e diagnostica, girano tramite provider-collect, non con questo comando.

Domande

Serve un host Yandex Webmaster verificato?
Sì. Il comando prende un ID host verificato (--host-id) e un token OAuth configurato sul tuo computer. SpiderHead non crea account né accede per te.
Cambia qualcosa in Yandex o sul mio sito?
No. È una richiesta in sola lettura. Restituisce statistiche di query per le URL che nomini e non scrive nulla su Yandex né sul sito.
Clic e posizioni vengono sommati tra le pagine?
No. Ogni URL conserva le sue righe di query. CTR e posizione media non si sommano tra le pagine, e la risposta dichiara i tetti applicati.
Quanto costa?
Niente oltre la quota dell'API Yandex Webmaster. Il toolkit elenca il provider come gratuito entro quella quota.
Posso conservare uno storico oltre la finestra dell'API?
Sì, con sources-sync. Conserva le evidenze giornaliere di Webmaster in uno storico SQLite locale, così puoi accumulare dati nel tempo. Non può recuperare i giorni che Yandex non restituisce più.
Posso usarlo da un assistente AI?
Sì. Il server MCP locale espone la stessa operazione come seo_webmaster_url_queries.