Des proxys alignés sur l'identité
Une IP résidentielle américaine sur un navigateur réglé sur Europe/Amsterdam, cela se vérifie en une ligne, et c'est une incohérence facile à commettre par accident. Donnez à Clearcote un proxy avec geoip activé : il recherche l'IP de sortie et règle le fuseau horaire, les langues et l'adresse WebRTC en conséquence, avant le chargement de la première page.
La prise en charge des proxys et geoip sont inclus dans toutes les formules.
Une option pour tout aligner
import { launch } from "clearcote";
const browser = await launch({
fingerprint: "account-42",
proxy: { server: "http://gateway:8080", username: "u", password: "p" },
geoip: true, // timezone + languages + WebRTC follow the exit IP
});Points clés
geoip en une option
L'IP de sortie est recherchée dans la base hors ligne geoip-all-in-one, et le fuseau horaire, la langue principale, Accept-Language et l'adresse WebRTC sont définis pour cette région.
Une seule locale partout
Accept-Language, navigator.language, Intl.DateTimeFormat et toLocaleString suivent la même langue, dans la page comme dans les workers.
SOCKS5 avec identifiants
Chromium standard ne sait pas s'authentifier auprès d'un proxy SOCKS5. Le build sous licence implémente dans le moteur le handshake par nom d'utilisateur et mot de passe (RFC 1929) : aucun relais local n'est nécessaire. Passez les identifiants dans des champs séparés, ou dans l'adresse du proxy avec le SDK 0.31.1 ou plus récent.
WebRTC sans fuite
Par défaut, WebRTC ne peut pas faire passer de trafic en dehors du proxy : votre propre adresse reste privée. Avec geoip (ou webrtcIp) activé, il déclare à la place l'adresse du proxy, comme le ferait un navigateur réellement situé derrière. Le build sous licence tient le trafic WebRTC à l'écart de votre propre connexion même dans ce cas ; le build ouvert, non, si bien qu'un relais choisi par la page peut encore voir votre adresse.
Une géolocalisation assortie
--fingerprint-location fixe des coordonnées en complément du fuseau horaire, pour que l'API Geolocation et l'horloge concordent.
Ou évitez d'acheter des proxys
Les navigateurs hébergés incluent un proxy résidentiel, avec ciblage par pays, État et ville, et sessions persistantes (sticky).
Pourquoi la localisation doit concorder
La localisation apparaît à plusieurs endroits indépendants : l'adresse IP, le fuseau horaire, les en-têtes de langue, le format des nombres et des dates, WebRTC et, si elle est autorisée, la géolocalisation. Un détecteur n'a pas besoin de savoir où vous êtes. Il lui suffit que deux de ces éléments se contredisent.
geoip fait de l'IP de sortie la source de vérité. Au lancement, le SDK résout l'adresse de sortie du proxy, la recherche dans une base hors ligne et règle le reste en conséquence : dès la première page, la locale est cohérente.
Vérifiez toujours la sortie avant de faire confiance à une session. Un proxy qui laisse silencieusement passer le trafic en cas d'échec (fail open) l'envoie depuis votre propre IP, et plus aucune autre précaution ne compte. Une seule requête vers un service d'écho d'IP au lancement suffit.
Cas d'usage
Résultats propres à une région
Prix, résultats de recherche et disponibilités tels que les voit un visiteur de ce pays.
Comptes liés à une région
Gardez l'IP, le fuseau horaire et la langue d'un compte identiques à chaque session.
Vérification des publicités et des contenus
Voyez la publicité, la page ou l'offre présentée à un visiteur d'une ville donnée.
QA de localisation
Vérifiez les dates, les devises et les traductions telles que les reçoivent les visiteurs locaux.
Clearcote est conçu pour la confidentialité, les tests, la recherche et l'automatisation licite. Vous êtes responsable de l'usage que vous en faites et du respect des conditions d'utilisation des sites que vous visitez.
Offres qui l'incluent
La prise en charge des proxys, l'alignement automatique du fuseau horaire et de la langue, et un WebRTC qui déclare l'adresse du proxy sont inclus dans toutes les formules. Tenir le trafic WebRTC à l'écart de votre propre connexion pendant ce temps, ainsi que SOCKS5 avec identifiants, nécessite le build sous licence (gratuit avec GitHub).
Comparer les offresFAQ
Que fait geoip exactement ?
Il résout l'IP de sortie du proxy, la recherche dans la base hors ligne geoip-all-in-one, puis définit un fuseau horaire, une liste de langues (Accept-Language, navigator.languages), une géolocalisation et une IP WebRTC correspondant à cette région. Si la région ne peut pas être résolue, le lancement s'arrête sur une erreur au lieu de démarrer avec l'horloge et la langue de votre propre machine.
Clearcote prend-il en charge les proxys SOCKS5 avec authentification ?
Oui, sur le build sous licence. Passez le nom d'utilisateur et le mot de passe dans des champs de proxy séparés, ou dans l'adresse (socks5://user:pass@host:port) avec le SDK 0.31.1 ou plus récent ; les SDK plus anciens perdaient les identifiants écrits dans l'adresse avant qu'ils n'atteignent le navigateur. Clearcote implémente dans le moteur l'authentification SOCKS5 par nom d'utilisateur et mot de passe, ce que ne fait pas Chromium standard : vous n'avez donc pas besoin de relais local.
WebRTC va-t-il divulguer ma vraie IP ?
Pas par défaut. Le SDK configure WebRTC pour qu'il ne puisse pas envoyer d'UDP en dehors du proxy, ce qui garde votre propre adresse privée. Avec geoip (ou webrtcIp), il déclare à la place l'adresse du proxy, comme le ferait un navigateur derrière cette IP. Le build sous licence n'envoie toujours aucun trafic WebRTC par votre propre connexion ; le build ouvert, si, dès que geoip est activé, et un relais choisi par la page pourrait alors lire votre vraie adresse. Voir ce qu'est une fuite WebRTC.
Quels types de proxy fonctionnent ?
Les proxys HTTP et SOCKS5, avec ou sans identifiants (les identifiants SOCKS5 nécessitent le build sous licence). Les sorties résidentielles ou mobiles correspondent le mieux à un navigateur grand public ; les navigateurs hébergés incluent des sorties résidentielles.
Dois-je définir le fuseau horaire moi-même ?
Pas avec geoip. Si vous préférez le définir à la main, passez timezone et acceptLanguage (Python : accept_language) ; Intl et toLocaleString suivent alors aussi la langue.
Aller plus loin dans la documentation
Fonctionnalités associées
Démarrez un navigateur Clearcote dans le cloud en un seul appel d'API et connectez Playwright ou Puppeteer via CDP. IP résidentielle incluse, facturation au GB de trafic.
Un seed par compte : le même appareil à chaque session, un autre pour le compte suivant, avec des cookies et un stockage qui persistent d'une exécution à l'autre.
Le handshake TLS et les trames HTTP/2 viennent de la pile réseau propre à Chromium, et les champs dépendant de la version suivent la version de Chrome annoncée par votre persona.
Canvas, WebGL, WebGPU, audio, polices, écran et matériel dérivés d'un seul seed dans le moteur C++, avec la locale et le fuseau horaire assortis : chaque surface concorde avec toutes les autres.
À lire aussi
Essayer Clearcote
S'utilise tel quel avec Playwright et Puppeteer, cohérent jusqu'au handshake TLS, avec un build open source comme point de départ.
Gratuit pour un navigateur avec GitHub. Sans carte.