Search-Hub — Admin

➕ Nouvelle app

Nom

Type

Limite / jour

Apps

🔑 Nouveau token

App

Libellé (optionnel)

Expire dans (jours, vide = jamais)

Plusieurs tokens par app = rotation sans coupure.

Tokens

Statistiques d'usage

Recherches (14 jours)

Par app

Logs récents

🤖 Fournisseur IA

Fournisseur

Libellé (optionnel)

Clé API

Modèle (optionnel)

Définir par défaut

Utilisé pour la synthèse IA des résultats (paramètre ?ai=1).

Fournisseurs

📥 Abonnés

Base B2C consentie (double opt-in). L'export ne contient que les confirmés.

🚫 Exclusions

Ne jamais prospecter ni contacter. Une exclusion globale vaut pour toutes les apps — c'est ainsi qu'une opposition se propage à tous vos services. Un domaine couvre ses sous-domaines et bloque aussi les emails de ce domaine ; un SIREN bloque l'entreprise entière. Les désinscriptions alimentent cette liste automatiquement.

Type

Valeur

Portée

Motif

⚙️ Réglages

Modifiable à chaud — aucun redéploiement nécessaire.

MailHub — URL

MailHub — clé API

Résultats max par recherche

Limite recherche (req/min)

Limite inscription (req/min)

🎯 Prospection

Vérifier les MX des emails collectés

Un email dont le domaine ne reçoit pas de courrier est écarté des prospects. Premier levier de délivrabilité.

Retrouver le site des entreprises Sirene

Consomme le quota du moteur de recherche (Google CSE : 100 requêtes/jour). Sans clé Google ou Brave configurée dans l'onglet Moteurs, cette résolution ne donnera rien depuis un datacenter.

Pages RGE par requête

100 entreprises par page. Le répertoire RGE fournit l'email directement, sans moteur de recherche ni scraping.

Pages Sirene par requête

25 entreprises par page. Triplé automatiquement quand un filtre de date est actif.

Débit vers l'API Sirene (req/s)

À diviser par le nombre de processus PM2 : le débit est compté par processus.

Attente max dans la file Sirene (ms)

Au-delà, l'appel est refusé au lieu d'attendre : la page est partielle mais la position de collecte est conservée. Mieux qu'un 504 qui la ferait perdre.

Recherches de site par requête

Budget de temps par requête (ms)

Rester sous le délai du reverse proxy : un 504 ferait perdre sa position à une collecte automatique.

Quota /api/prospects (appels/jour/app)

Quota /api/leads (appels/jour/app)

0 = illimité. Le quota quotidien de l'app (onglet Apps) reste un plafond : la valeur la plus basse s'applique. Au-delà : HTTP 429.

🌍 Marché mondial (jeunes entreprises tech)

Activer le marché mondial (market=world)

Y Combinator et Hacker News : deux sources publiques qui donnent le site web directement, donc sans aucune clé ni moteur de recherche.

Sources actives

Pays exclus (codes ISO, séparés par des virgules)

Un pays inconnu n'est jamais exclu : on n'écarte personne sur une supposition. Le Canada n'est pas exclu mais signalé (consent_required).

Jours de Hacker News lus par requête

Lots Y Combinator lus par requête

Fraîcheur du corpus Y Combinator (heures)

Score minimum Hacker News

0 = tout prendre. Relever à 3 ou 5 réduit le bruit des projets personnels.

Enrichir via l'API GitHub

Une URL de dépôt donne le login d'organisation, dont l'API publique livre le site et l'email en une requête. Plafond de 60 requêtes/heure sans clé.

Enrichissements GitHub par requête

🛡️ Alertes sécurité

Emails d'alerte (séparés par des virgules)

Reçoivent les alertes critiques (abus de clé API…). Envoi via MailHub.

Seuil d'échecs clé API (par IP / 10 min)

Les moteurs de recherche se configurent dans l'onglet 🔍 Moteurs.

🛡️ Journal de sécurité

Filtrer par gravité

Chargement…

🔍 Moteurs de recherche

Ordre d'essai : Entreprises FR → Google / Brave / SearXNG (si configurés) → Mojeek → DuckDuckGo → DDG Lite.

⚠️ Bon à savoir

Les moteurs web scrapés (DuckDuckGo, Mojeek) sont bloqués depuis les serveurs/datacenters (Hostinger) → 0 résultat. Pour de la prospection B2B France, utilise le moteur Entreprises FR ci‑dessous (gratuit, indépendant, sans blocage). Pour de la recherche web générale en prod, ajoute une clé Google CSE.

🏢 Entreprises FR (recommandé prospection)

Actif

Moteur intégré à search‑hub, basé sur OpenStreetMap — aucune clé, gratuit, fonctionne depuis un datacenter. Cherche par métier + ville (ex. « plombier Lyon », « électricien Nantes ») et renvoie de vraies entreprises françaises avec leur site web, prêtes pour la prospection (scraping d'emails). France + DOM‑TOM.

🏛️ Entreprises FR — Sirene (INSEE)

Annuaire officiel des entreprises (données Sirene via data.gouv) — gratuit, sans clé. Donne SIRET, code NAF, effectif, dirigeant, adresse pour un ciblage précis et des listes de leads. ⚠️ Pas de site web (l'INSEE n'en stocke pas) → complémentaire d'OpenStreetMap. Endpoint : /api/companies.

📧 Prospection : entreprises + emails (recommandé)

Le bout du bout : trouve les entreprises FR (métier + ville) et scrape leurs emails pro. Renvoie des prospects prêts à contacter (email + NAF + effectif). C'est ce que DeviCrafto consomme pour envoyer via MailHub. Endpoint : /api/prospects.

vérifier les MX

🎯 Leads : ciblage + site web (pont OSM × Sirene)

Le meilleur des deux : part des entreprises avec site (OSM) et les enrichit du SIRET/NAF/effectif (Sirene). Prêt pour la prospection : site à scraper + ciblage. Endpoint : /api/leads.

Google Programmable Search (recherche web générale, gratuit 100/j)

Clé API : console.cloud.google.com → APIs & Services → Credentials → Create API key, puis active Custom Search API (dans Library).
Moteur (cx) : programmablesearchengine.google.com → Add → « Search the entire web » → copie le Search engine ID.
Colle les deux ci‑dessous et Enregistrer.

Clé API Google

ID du moteur (cx)

Autres moteurs (optionnel)

Brave Search — clé API

SearXNG — URL d'instance

Tester les moteurs

Teste chaque moteur depuis le serveur et affiche lequel répond (ou l'erreur).

📘 Documentation API

Authentification par en-tête x-api-key (clé d'app ou token).

Recherche

GET /api/search?q=…&count=10&ai=1

Inscription B2C (double opt-in)

POST /api/subscribe { "email": "…" }

Abonnés confirmés (base consentie)

GET /api/subscribers

Prospection — entreprises + emails vérifiés (MX)

GET /api/prospects?q=plombier Lyon&offset=0

Leads — entreprises seules (plus rapide, plus profond)

GET /api/leads?q=plombier Lyon&offset=0

Annuaire Sirene

GET /api/companies?q=plombier Lyon&page=1

Liste d'exclusion

POST /api/suppressions { "kind": "email", "value": "…" }

🔁 Collecte automatique

Rappelez l'endpoint avec offset = le next_offset reçu, tant que has_more est vrai. Ne calculez jamais l'offset vous-même : le pool avance de ce qui a été examiné, pas de ce qui a été renvoyé.

Une page courte ou vide avec has_more: true est normale — toutes les entreprises n'ont pas de site ni d'email publié. Le seul signal d'arrêt est has_more: false.

Conservez le dernier next_offset d'un jour sur l'autre : c'est ce qui fait progresser la collecte au lieu de reprendre les mêmes entreprises. Repartez de 0 si vous changez la requête ou un filtre.

Ciblage jeunes entreprises : max_age_months=24. Le filtre est appliqué ici, pas par Sirene qui ne sait pas filtrer sur la date — environ 5 % d'un pool est concerné, donc c'est le nombre d'appels successifs qui fait le volume, pas count.

Quotas : débit par minute et quota journalier par app, compté séparément par endpoint (réglables dans ⚙️ Réglages). Au-delà : 429.

Swagger / OpenAPI

Spécification OpenAPI 3.0.3 — à importer dans Postman, Swagger UI, etc. Accessible sans authentification.

Spécification (JSON)

Swagger UI

Doc pour agents IA (llms.txt)

À donner en contexte à un agent qui consomme l'API : pagination, pièges, quotas et usage responsable, en texte brut.

Connexion