Repository navigation
Problemi comuni
L'analisi risponde 403 o 429. Il sito rifiuta le richieste automatiche. In ordine: attiva il browser (usa_browser, serve uv run playwright install chromium una volta); se rifiuta ancora, il browser con finestra visibile (browser_visibile) con il consenso dell'utente; come ultima risorsa salva le pagine dal tuo browser e usa analizza_pagine_salvate. Con un 429 il server aspetta il Retry-After (fino a 2 minuti) e poi si ferma: non aggira i blocchi.
«Pagina iniziale: HTTP 404». L'indirizzo è sbagliato o è una pagina che non esiste più. Copialo dal browser.
Il browser non parte. Manca Chromium: uv run playwright install chromium. Per il login wp-admin degli strumenti che usano il browser serve un display disponibile (il browser gira con finestra, non headless).
«Nessun prodotto sotto il percorso indicato». Il sito tiene i prodotti fuori dalla sezione indicata (succede per esempio con pagine /l/… e prodotti in /p/…): il campione viene allora dai link della pagina. È un avviso, non un errore.
L'analisi non compare nella tab SEO del plugin. Guarda il campo plugin del report: dice se è stata salvata e perché no. Controlla che WP_SITE_URL, WP_APP_USER e WP_APP_PASSWORD siano nel .env, che il plugin sia la versione 0.1.12 o successiva (la rotta /concorrenti non esiste prima) e che SEO_ANALISI_SALVA_NEL_PLUGIN non sia 0.
«Il tuo sito» non è marcato. L'indirizzo analizzato deve coincidere con WP_SITE_URL (il «www» non conta).
Analisi di un sito locale rifiutata. Gli indirizzi di reti private (localhost, 192.168.x.x) sono rifiutati di proposito. Per provare in locale: SEO_ANALISI_CONSENTI_RETE_PRIVATA=1.
L'assistente non vede uno strumento nuovo. git pull nella cartella del server e riavvio dell'assistente.
Dopo una modifica il sito mostra ancora il vecchio testo. Gli strumenti di scrittura invalidano la cache del sito da soli; se resta tutto vecchio, purga_cache_sito. La tab SEO del plugin non è cacheata dalla versione 0.1.12.