Documentazione estensione Pegasus Hunter
Tutto quello che ti serve per installare l'estensione, generare la chiave API, avviare la prima scansione e capire cosa fa il server con i dati. Aggiornata a v0.9.0.
// Indice
Cosa trovi in questa pagina
// 01 · Installazione
Installare l'estensione in Chrome
L'estensione non è ancora sul Chrome Web Store. La carichi manualmente come "estensione non pacchettizzata" in due minuti.
- 01Scarica e scompatta lo .zip
Clicca il bottone "Scarica l'estensione" in cima a questa pagina. Si tratta di un file .zip di circa 1 MB.
- Salva il file in una cartella permanente (es. ~/Documents/pegasus-extension). Non scompattare dentro Download: se svuoti la cartella, l'estensione smette di funzionare.
- Scompatta lo .zip con doppio click. Otterrai una cartella con manifest.json, background.js, content scripts e icone.
- 02Apri chrome://extensions
Incolla chrome://extensions nella barra degli indirizzi e premi Invio. In alternativa: Menu Chrome → Estensioni → Gestisci estensioni.
- L'URL chrome:// non funziona dai link esterni — devi scriverlo (o incollarlo) tu stesso nella barra degli indirizzi.
- Funziona anche su Chromium derivati (Brave, Edge, Arc): il percorso può cambiare, ma il pannello estensioni esiste in tutti.
- 03Abilita la modalità sviluppatore
In alto a destra del pannello estensioni c'è un interruttore "Modalità sviluppatore". Attivalo.
- Appariranno tre nuovi pulsanti sotto al titolo: Carica estensione non pacchettizzata, Pacchettizza estensione, Aggiorna.
- La modalità sviluppatore non comporta rischi: serve solo a caricare estensioni che non passano dal Chrome Web Store.
- 04Carica la cartella scompattata
Clicca "Carica estensione non pacchettizzata" e seleziona la cartella che hai scompattato al passaggio 1.
- Seleziona la cartella, NON il file manifest.json al suo interno.
- L'icona di Pegasus comparirà nella barra delle estensioni accanto agli indirizzi. Cliccala una volta e fissala con la puntina per averla sempre visibile.
// 02 · Setup chiave API
Generare e incollare la chiave API
L'estensione gira sul tuo computer ma manda i risultati al server Pegasus. La chiave API è il tuo lasciapassare: senza, l'estensione non parte.
- 01Apri la dashboard chiavi API
Accedi al tuo account Pegasus e vai su Chiavi API. Clicca "Crea chiave" e dalle un nome riconoscibile (es. "Chrome — laptop personale").
- 02Copia la chiave UNA VOLTA
Il server ti mostra la chiave completa (formato wsk_…) una sola volta. Copiala subito con il bottone copia. Se chiudi la finestra senza copiare, devi crearne un'altra.
- 03Incollala nell'estensione
Apri l'estensione cliccando l'icona, vai su Impostazioni e incolla la chiave nel campo "Chiave API". Salva. Compare un check verde se la chiave è valida.
Errore "invalid wsk_"
Se vedi un errore di chiave non valida, controlla in ordine: la chiave inizia con wsk_, non hai aggiunto spazi all'inizio o alla fine durante il copia-incolla, e la chiave non è stata revocata. Se hai dubbi, revocala dalla dashboard e creane una nuova — è gratis.
Vai alla dashboard// 03 · Avvio scansione
Lanciare la prima scansione
Dopo aver configurato la chiave API, sei pronto a scansionare. Pegasus lavora sopra Facebook Ads Library: apri la pagina FB, l'estensione fa il resto.
Una o più parole chiave del prodotto o nicchia. Esempi: "posture corrector", "led mask", "crystal earrings". Più la keyword è specifica, più i risultati sono mirati.
Filtro geografico di FB Ads Library. Default Italia. Cambia in funzione del mercato che vuoi analizzare (Stati Uniti, Germania, Francia, ecc.).
Numero massimo di risultati da scrappare per scansione. Default 100. Più alto = più tempo, più token consumati lato server.
Cosa aspettarsi
Una scansione media (limite 100) dura tra 1 e 3 minuti. L'estensione apre FB Ads Library, scrolla automaticamente la lista delle ads, estrae gli URL Shopify collegati e li manda al server. I risultati appaiono in tempo reale sia nell'overlay sia nella tua dashboard Scanner.
// 04 · Overlay live
L'overlay sul browser durante la scansione
Mentre l'estensione lavora vedi un widget fisso in alto a destra sulla pagina di Facebook. Mostra in tempo reale cosa sta scrappando, senza coprire i contenuti della pagina.
Numero di card analizzate, URL Shopify trovati, errori temporanei e percentuale verso il limite impostato.
Interrompi la scansione in qualsiasi momento. I risultati raccolti fino a quel punto restano salvati lato server: non perdi nulla.
Apre in una nuova tab la pagina Scanner della dashboard con il dettaglio completo della scansione corrente.
// 05 · Cosa fa il server
Cosa succede dopo che l'estensione ha scrappato
L'estensione manda al server solo gli URL Shopify pubblici trovati nelle ads. Il server si occupa di tutto il resto, senza che tu debba tenere il browser aperto.
La pagina Scanner della dashboard raccoglie tutte le tue scansioni passate: keyword, paese, numero di risultati, store collegati. Da qui puoi promuovere un prodotto al tracker.
Apri ScannerQuando un prodotto entra nel Tracker, il server lo monitora H24 a intervalli regolari: prezzo, disponibilità, varianti, contatore vendite. Storico completo lato server, accessibile anche a browser chiuso.
Apri Tracker// 06 · Troubleshooting
Problemi comuni e soluzioni
Sei FAQ basate sui casi più frequenti riportati dai primi utenti.
// 07 · Privacy e sicurezza
Cosa l'estensione non fa
Pegasus Hunter è progettata per essere il più trasparente possibile. Tre garanzie tecniche.
L'estensione non accede ai cookie di sessione di Facebook. Resta loggato sul tuo browser senza problemi e senza rischio di sospensione legata a Pegasus.
Lo scraping della pagina FB avviene nel browser, sulla tua macchina. Il server riceve solo gli URL Shopify già estratti — non un dump grezzo della pagina.
L'estensione è open source su GitHub. Puoi leggere il content script, il background worker e il manifest prima di installarla. Issue e PR benvenute.
// 08 · Versionamento
Aggiornamenti e changelog
L'estensione si aggiorna manualmente: quando esce una nuova versione, ti notifichiamo via email e basta scaricare lo .zip aggiornato dalla pagina download, scompattarlo sopra la cartella esistente, e cliccare "Aggiorna" su chrome://extensions.
Changelog completo su GitHub Release →// Pronto a partire?
Hai tutto quello che serve
Scarica l'estensione, genera la chiave dalla dashboard, lancia la prima scansione. Se ti blocchi, scrivi a support@pegasushunter.com.