Baidu Webmaster Tools in italiano: guida alla console

Apri ziyuan.baidu.com, l'interfaccia è tutta in cinese semplificato e sono cinque minuti che cerchi il selettore della lingua. Non c'è. Baidu Webmaster Tools non ha mai avuto un'interfaccia in inglese, e nulla lascia pensare che arriverà.

Questa guida è la console spiegata in italiano: come si chiama ogni schermata, a cosa serve, a quale funzione di Google Search Console corrisponde e dove il processo si blocca davvero per un'azienda europea o britannica.

Partiamo dal nome

Dello stesso prodotto circolano tre nomi, e da lì nasce buona parte della confusione.

百度站长平台 (Baidu Zhanzhang Pingtai, «piattaforma webmaster di Baidu») è il nome vecchio. Quasi tutti gli articoli in inglese usano ancora questo.
百度搜索资源平台 (Baidu Sousuo Ziyuan Pingtai, «piattaforma delle risorse di ricerca di Baidu») è il nome attuale, quello che oggi compare sul sito.
Baidu Webmaster Tools è il nome con cui lo chiamano tutti fuori dalla Cina, questo articolo compreso.

Tutti e tre portano a ziyuan.baidu.com. Se un tutorial ti manda su zhanzhang.baidu.com è datato, ma il redirect funziona ancora.

Da non confondere con 百度统计 (Baidu Tongji), lo strumento di analytics di Baidu, che ha un accesso separato. Webmaster Tools si occupa di indicizzazione e scansione. Tongji del traffico.

Leggere la console senza sapere il cinese

La traduzione del browser ti porta piuttosto lontano. Chrome ed Edge traducono la piattaforma in modo accettabile, Safari se la cava. Tre avvertenze prima di affidartici:

Le voci di menu che sono immagini non vengono tradotte. Diverse icone e diversi badge di stato sono grafiche. Se dopo la traduzione un pulsante resta in cinese, il motivo è questo.
Non copiare mai uno snippet di codice tradotto. Il meta tag di verifica, il JavaScript del push automatico e il token dell'API sono stringhe esatte. Traduci la pagina per leggerla, poi disattiva la traduzione prima di copiarne qualsiasi cosa.
I messaggi di errore si traducono male. Gli errori di scansione di Baidu sono stringati già in cinese. La tabella qui sotto è più affidabile di qualunque resa automatica.

La documentazione di Baidu, la knowledge base 搜索学堂 (Search College), esiste solo in cinese, e anche l'assistenza si aspetta il cinese.

Il requisito dell'account, detto chiaramente

Prima ancora che la console conti qualcosa, ti serve un account Baidu (百度账号), e la registrazione passa da una verifica via SMS su un numero di cellulare della Cina continentale. I numeri di Hong Kong, Taiwan, Regno Unito o Unione Europea non vengono accettati in fase di registrazione. A seconda di cosa fai dopo, Baidu può chiederti anche la 实名认证 (verifica dell'identità reale) con un documento d'identità cinese o una licenza commerciale cinese (营业执照).

L'ostacolo è tutto qui, e vale la pena dirlo senza giri di parole: per la maggior parte delle aziende europee e britanniche il percorso si ferma a questo punto. Tutto quello che segue presuppone o che tu abbia già accesso alla console tramite una società o un partner cinese, o che tu voglia capire in cosa consiste davvero il lavoro prima di decidere se affidarlo a qualcuno. In fondo c'è una nota per il secondo caso.

La console, schermata per schermata

Ecco la navigazione, con l'etichetta cinese che vedi a video e la funzione corrispondente.

| Etichetta cinese | Significato | A cosa serve | Equivalente Google più vicino | | --- | --- | --- | --- | | 用户中心 | Centro utente | Account, siti, notifiche | Impostazioni account | | 站点管理 | Gestione siti | Aggiungere, verificare e rimuovere proprietà | Elenco delle proprietà | | 站点属性 | Proprietà del sito | Nome, logo, categoria, contatto | Niente di equivalente | | 链接提交 | Invio link | Sitemap, URL manuali, push via API | Sitemap più Indexing API | | 死链提交 | Invio link morti | Segnalare a Baidu gli URL non più esistenti | Più o meno lo strumento di rimozione | | 抓取诊断 | Diagnostica di scansione | Recuperare un URL come fa Baiduspider | Controllo URL, test in tempo reale | | 抓取频次 | Frequenza di scansione | Ogni quanto passa Baiduspider, e richiesta di modifica | Statistiche di scansione | | 抓取异常 | Errori di scansione | Recuperi falliti, con il relativo codice | Errori di indicizzazione delle pagine | | robots | robots.txt | Testare e aggiornare il file robots | Report robots.txt | | 索引量 | Volume di indice | Quante pagine ha in archivio Baidu | Numero di pagine indicizzate | | 流量与关键词 | Traffico e parole chiave | Impressioni, clic e query | Report sul rendimento | | 移动适配 | Adattamento mobile | Dichiarare le coppie di URL desktop e mobile | Niente di equivalente | | 网站改版 | Restyling del sito | Dichiarare un cambio di struttura degli URL | Cambio di indirizzo | | HTTPS认证 | Certificazione HTTPS | Registrare la versione HTTPS del sito | Niente di equivalente |

Alcune di queste voci si aprono solo quando la proprietà ha già uno storico di scansione, quindi un sito nuovo mostra meno strumenti dello screenshot di un tutorial del 2019.

Verificare un dominio

站点管理 → 添加网站 aggiunge una proprietà, poi scegli uno dei tre metodi di verifica. Baidu verifica l'host esatto: example.com e www.example.com sono due proprietà, e ogni sottodominio di lingua è un'altra ancora.

文件验证 (verifica tramite file). Baidu ti fornisce un file con un nome tipo baidu_verify_code-xxxxxxxx.html. Mettilo nella radice del dominio e lascialo lì per sempre. È il metodo da scegliere, se puoi.

HTML标签验证 (verifica tramite meta tag). Un tag nell'<head> della home page:

<meta name="baidu-site-verification" content="code-xxxxxxxx" />

CNAME验证 (verifica tramite CNAME). Baidu ti dà un hostname da puntare ai suoi server con un record CNAME. Più lento, perché dipende dalla propagazione DNS, ma sopravvive a una ricostruzione del sito.

Poi premi il pulsante di verifica e Baidu fa la richiesta da un indirizzo IP cinese. Ed è da lì che arrivano quasi tutti i fallimenti.

Perché la verifica fallisce quando il file è chiaramente al suo posto

Il file di verifica si apre benissimo nel tuo browser, e Baidu continua a dire che non lo trova. Quattro cause, nell'ordine in cui di solito si rivelano quella giusta.

Il tuo WAF o la tua CDN sta bloccando il traffico cinese. Molti siti europei bloccano per geolocalizzazione i range CN, oppure limitano i bot sconosciuti, senza che nessuno ricordi più che quella regola era stata attivata. La richiesta di Baidu parte dalla Cina continentale e riceve un 403 che tu non vedi mai. Controlla le regole sull'edge prima di ogni altra cosa.

Il robots.txt esclude Baiduspider. Certi file robots copiati da un modello bloccano ogni crawler che non sia Google o Bing. Il crawler di Baidu è Baiduspider, e per le risorse usa anche Baiduspider-render.

Una single page application restituisce lo shell dell'app. Se il tuo router risponde a ogni percorso sconosciuto con index.html e un 200, Baidu riceve un HTML che non è il file di verifica e lo rifiuta. Servi quel file come vero file statico, prima del router.

Un tag manager inietta il meta tag. Il fetcher di Baidu è molto meno paziente con JavaScript di Googlebot. Se il meta tag non è nell'HTML che esce dal server, consideralo assente.

Se vuoi la conferma che a Baiduspider venga servito davvero il contenuto, verifica il visitatore invece di fidarti dello user agent: una risoluzione DNS inversa sull'IP che fa la richiesta deve restituire un hostname *.baidu.com o *.baidu.jp, e una risoluzione diretta su quell'hostname deve riportare allo stesso IP.

Inviare URL: quattro strade

链接提交 è la parte di console che userai davvero, e raccoglie quattro meccanismi distinti.

Sitemap. Incolli l'URL assoluto della sitemap. Baidu accetta XML ed elenchi in testo semplice. È la strada più lenta e la quota non è generosa, ma è quella che continua a funzionare senza manutenzione.

手动提交 (invio manuale). Incolli gli URL in un campo, uno per riga. Va bene per un lancio o per una manciata di pagine nuove. C'è un tetto giornaliero.

主动推送 (push attivo). L'API, e la via più rapida. La console ti dà un token e tu invii in POST gli URL separati da a capo, in testo semplice:

curl -H 'Content-Type: text/plain' --data-binary @urls.txt \
  "http://data.zz.baidu.com/urls?site=https://example.com&token=YOUR_TOKEN"

La risposta è in JSON. success è quanti URL sono stati accettati, remain quel che resta della quota di giornata, e not_same_site conta gli URL che non corrispondono alla proprietà verificata, quasi sempre per una discrepanza sul www. Collegalo al passaggio di pubblicazione invece di lanciarlo a mano.

自动推送 (push automatico). Un piccolo snippet JavaScript da incollare nelle pagine. Ogni visita spinge quell'URL verso Baidu. Costa un tag script e recupera le pagine che il processo di build si è dimenticato, quindi si abbina bene al push attivo anziché sostituirlo.

Quello che la console non può fare al posto tuo

Farsi indicizzare e posizionarsi sono due problemi diversi, e Webmaster Tools aiuta solo sul primo.

Un sito solo in inglese difficilmente si posizionerà su Baidu, per quanto pulito sia l'invio. Baidu privilegia nettamente i contenuti in cinese semplificato, e il cinese tradotto a macchina rende male.
L'hosting conta. I siti serviti dall'interno della Cina, cosa che richiede una licenza ICP e quindi una società cinese, si caricano più in fretta per gli utenti cinesi e ottengono risultati misurabilmente migliori.
Le risorse di terze parti bloccate rompono le pagine. Google Fonts, Google Tag Manager, i video YouTube incorporati e diverse CDN non si caricano dalla Cina continentale. La tua pagina può essere perfetta vista da qui e rotta per il pubblico a cui la stai sottoponendo.
Il rendering lato client è un handicap concreto. Per Baidu il rendering lato server non è un optional.

Niente di tutto questo compare come errore nella console. Compare come un volume di indice che cresce e un report delle parole chiave che resta vuoto.

Se il numero di telefono ti blocca

Per la maggior parte delle aziende che leggono queste righe la console non è la parte difficile. L'account sì. E nessuna guida cambia il fatto che Baidu vuole un numero di cellulare della Cina continentale per quell'SMS.

Se il tuo obiettivo è semplicemente far registrare il sito e sapere cosa ne ha fatto Baidu, il problema dell'account non devi risolverlo affatto. Il nostro servizio di registrazione su Baidu prende il tuo dominio, gestisce l'intero invio e ti riferisce cosa ha davvero indicizzato Baidu, a un prezzo fisso per dominio. Quello che serve a noi: una sola verifica di proprietà del dominio. Quello che ricevi: l'invio e il report, non un accesso. Le credenziali dell'account non fanno parte del servizio.

Se la domanda è più ampia, uno sviluppo pronto per la Cina, contenuti in cinese semplificato, un hosting che regga dietro il Great Firewall, allora prenota una call e definiamo il perimetro come si deve.