Questions fréquentes

Quel est le port par défaut de serposcope ?

Serposcope crée un service web sur le port 7134. Vous pouvez y accéder à l'URL suivante : http://127.0.0.1:7134/.

Comment mettre à jour serposcope ?

Avant chaque mise à jour, nous vous recommandons d'effectuer une sauvegarde de la base de données depuis l'interface admin (fonction sauvegarde) ou en copiant le répertoire de données (voir ci-dessous).

Ensuite, il suffit d'installer par dessus l'ancienne installation, Serposcope migrera automatiquement les données.

Comment exporter ou accéder à la base de données via SQL ?

Il est possible d'effectuer une sauvegarde et une restauration de la base de données depuis l'interface admin de Serposcope.

Serposcope utilise h2 database (vous pouvez également utiliser mysql). Vous trouverez des outils et plus d'information sur cette base de données sur leur site web. La base de données est stockée dans le répertoire de données vous pouvez faire une sauvegarde en copiant le fichier db.mv.db quand serposcope est arrêté.

Comment récupérer mon mot de passe admin ?

En cas de mot passe perdu, il faut créer un fichier nommé password-reset.txt (lettres minuscules) dans le répertoire de données.

  • Ubuntu/debian /var/lib/serposcope/password-reset.txt
  • Windows C:\ProgramData\serposcope\password-reset.txt
  • Autre OS/version generique, dans le répertoire utilisateur serposcope /Users/bob/serposcope/password-reset.txt ou /home/bob/serposcope/password-reset.txt

Consultez la documentation à propos du répertoire de données, ou bien, essayez de localiser les logs de serposcope et recherchez la chaine de caractères suivante : serposcope.datadir

Où sont les logs ?

Vous pouvez accéder aux logs depuis serposcope dans l'interface d'administration puis logs. Consulter les informations sur le répertoire de données pour y accéder via le système de fichiers.

Serposcope est lent, comment le rendre plus rapide ?

  • En réduisant ou désactivant la pause dans les options réseau de Google.
  • En utilisant un plus grand nombre de résultats par page et un plus petit nombre de pages dans les options réseau de Google (Les résultats de recherches peuvent légèrement varier suite à cette modification).
  • En ajoutant plus de proxy et d'ip failover.
  • En spécifiant maximum threads dans les options réseau de Google pour activer le multithreading.

Remarques concernant le multithreading : serposcope n'utilisera pas un même proxy dans plusieurs thread simultanément. En conséquence, le nombre réel de thread maximum est limité par le nombre de proxys disponibles.

Comment éviter de se faire blacklister/désactiver ses proxys ?

Serposcope désactive temporairement les proxies s'ils sont blacklistés par Google, ou bien, si Google présente un captcha et qu'aucun service pour gérer les captchas n'est configuré. Pour éviter ce genre de problèmes vous pouvez :

  • Configurer un service qui gére les captchas.
  • Augmenter la pause dans les options réseau de google.
  • Ajouter plus de proxy et d'ip failover.
  • Réduire le nombre de pages, augmenter le nombre de résultats par page.

Comment gérer les captchas ?

Si vous effectuez trop de requêtes trop rapidement avec la même IP, vous pouvez voir apparaitre ce message dans les logs ERROR_CAPTCHA_NO_SOLVER. Vous pouvez configurer un service externe pour résoudre les captchas, serposcope supporte 3 services :

Depuis la version 2.5.0 vous pouvez configurer plusieurs services en même temps. Si un service venait à être indisponible, Serposcope basculera automatiquement sur un des autres services configurés. Nous vous recommandons de configurer au moins 2 API dont un utilisant le service anti-captcha.com (le seul à gérer les nouveaux captchas Recaptcha v2 / NoCaptcha de Google).

Nous incluerons de nouveaux services dans un futur proche.

Comment est calculé le score ?

Chaque mot clef positionné augmente le score en fonction de sa position. Le score finale est la moyenne du score des recherches, c'est une note entre 0 et 100.

rank #1 = 100 points
rank #2 = 90 points
rank #3 = 80 points
rank #4-#5 = 70 points
rank #6-#10 = 60 points
rank #11-#20 = 40 points
rank #21-#30 = 30 points
rank #31-#50 = 20 points
rank #51-#100 = 10 points
rank #100+ = 5 points
unranked = 0 points

C'est une fonctionnalité expérimentale, nous sommes ouvert à toutes suggestions.

Combien de mot-clés serposcope peut surveiller ?

Il n'y a pas de limite, nous avons effectué des tests avec plus de 100 000 mot-clés. Néanmoins, si vous surveillez plus de 1000 mot-clés nous vous recommandons d'utiliser une base de données MySQL plutôt que la base de données embarquée.

Comment utiliser MySQL ?

Vous devez indiquer à serposcope d'utiliser MySQL dans le fichier serposcope.conf. Un exemple de configuration valide :

serposcope.db.url=jdbc:mysql://HOSTNAME/DATBASE?user=USER&password=PASS&allowMultiQueries=true

Consulter la documentation sur la configuration avancée pour plus d'information.

Les sauvegardes effectuées depuis l'interface admin sont compatibles à la fois sur H2 et MySQL. Vous pouvez donc utiliser ces sauvegardes pour migrer de H2 à MySQL ou vice versa.

J'ai installé serposcope, mais rien ne se passe.

Serposcope crée un service web sur le port 7134. Vous pouvez y accéder à l'URL suivante : http://127.0.0.1:7134/.

Si vous ne parvenez pas à accéder au service, vérifiez vos logs. Ces derniers peuvent contenir des messages d'erreur intéressants, consulter la documentation d'installation pour trouver le répertoire des logs. Ils doivent être nommés en fonction de leur date au format suivant : 2010-10-20.log.

Sur Windows, vérifier d'abord les logs dans le répertoire logs du répertoire de données. Il y a d'autres fichiers de logs nommés commons-daemon.2010-10-20.log mais ils fournissent peu d'informations intéressantes.

Si serposcope ne démarre pas du tout, sans aucun message d'erreur et qu'aucun fichier de logs n'est créé, alors Java n'est probablement pas installé sur le système, ou bien la version de Java n'est pas assez récente (nécessite Java 1.8 au minimum).

Error java.net.BindException: address already in use

Un autre logiciel est déjà en écoute sur le port 7134. Utilisez la commande netstat pour identifier le logiciel. Vous pouvez changer le port d'écoute dans le fichier serposcope.conf.

Cette erreur peut également apparaitre si vous avez lancé plusieurs instances de serposcope à la fois.

Error java.io.FileNotFoundException: serposcope-2.0.0.jar (No such file or directory)

Cette erreur apparait lorsque le fichier serposcope.jar est effacé alors que le logiciel est démarré.

Exception java.lang.UnsupportedClassVersionError : Unsupported major.minor version 52.0

Cette erreur apparait lorsque la version de java utilisée n'est pas assez récente. Serposcope nécessite java > 1.8.

Pour voir la version java, utilisez la commande java -version :

admin@localhost:~$ java -version
java version "1.8.0_66"