🛰️ S H A D O W B R O K E R

Interception Globale des Menaces — Plateforme de Renseignement Géospatial en Temps Réel

ShadowBroker est une plateforme de renseignement décentralisée qui agrège, en temps réel, des données OSINT multi-domaines provenant de plus de 60 flux en direct sur une interface cartographique de type « dark ops ». Avions, navires, satellites, zones de conflit, réseaux de vidéosurveillance, brouillage GPS, appareils connectés à Internet, radios de police, nœuds maillés radio et événements géopolitiques majeurs — tous mis à jour en temps réel sur un seul écran, ainsi qu’un protocole de communication obscurci et une infrastructure d’échange d’informations.

🛰️ Description du Projet

Construit avec Next.js, MapLibre GL, FastAPI et Python. Plus de 40 couches de données activables, incluant la détection des changements au sol par SAR, l’OSINT Telegram (prévisualisation de canaux publics géoparcés sur la carte), une boîte à outils de reconnaissance côté serveur (DNS, WHOIS, sanctions, BGP, scan IP, etc.), des couches de risque liées à la chaîne d’approvisionnement, ainsi que des flux de menaces cyber (malwares/C2 et CISA KEV). Plusieurs modes visuels (DEFAULT / SATELLITE / FLIR / NVG / CRT). Clic droit sur n’importe quel point de la Terre pour obtenir un dossier pays, une fiche du chef d’État, une extension de graphe d’entités et la dernière photo satellite Sentinel-2. ShadowBroker n’a ni comptes, ni télémétrie, ni système d’analyse ; le tableau de bord communique avec votre backend auto-hébergé. Les requêtes sensibles de reconnaissance et de Shodan ne transitent jamais par des API tierces depuis le navigateur — elles sont relayées par le backend avec des gardes SSRF et une authentification d’opérateur local. Le canal de commande OpenClaw / agent expose les mêmes backends de reconnaissance ainsi qu’une recherche complète de télémétrie — aucune intégration API séparée n’est nécessaire.

Conçu pour les analystes, les chercheurs, les opérateurs radio et toute personne souhaitant voir à quoi ressemble le monde lorsque tous les signaux publics sont réunis sur une même carte.

🌍 Pourquoi Cela Existe

Une quantité surprenante de données mondiales sont déjà publiques — les signaux ADS-B des aéronefs, les signaux AIS maritimes, les données orbitales des satellites, les capteurs sismiques, les réseaux radio maillés, les flux de radios de police, les stations de surveillance environnementale, la télémétrie des infrastructures Internet, et bien plus encore. Ces données sont dispersées dans des dizaines d’outils et d’API. ShadowBroker les combine en une seule interface.

Le projet n’introduit pas de nouvelles capacités de surveillance — il agrège et visualise des ensembles de données publiques existants. Il est entièrement open source afin que chacun puisse auditer exactement quelles données sont consultées et comment. ShadowBroker n’inclut ni télémétrie de produit, ni systèmes d’analyse, ni comptes. Les clés fournies par l’opérateur restent dans votre déploiement local, mais les fonctionnalités OSINT en temps réel effectuent nécessairement des requêtes sortantes vers les fournisseurs de données publiques que vous activez ou interrogez.

📡 Shodan et Reconnaissance (sécurité d’abord)

ShadowBroker inclut un connecteur Shodan optionnel pour l’accès à l’API fournie par l’opérateur (SHODAN_API_KEY) et un panneau Boîte à outils de Reconnaissance pour les recherches OSINT sans clé. Les deux s’exécutent uniquement côté serveur : le navigateur appelle vos routes auto-hébergées /api/osint/* et /api/tools/shodan/* ; les requêtes sortantes sont effectuées par le backend après validation SSRF. La reconnaissance nécessite un accès opérateur local (même modèle de confiance que les toggles de couches et les routes d’administration). Les résultats Shodan s’affichent en tant que couche cartographique distincte et restent soumis aux conditions d’utilisation de Shodan.

🗺️ Cas d’Utilisation Intéressants

Suivre Air Force One, les jets privés des milliardaires et des dictateurs, ainsi que tous les pétroliers, avions ISR et chasseurs militaires diffusant du ADS-B. Air Force One et tous les avions présidentiels/vice-présidentiels qui l’accompagnent sont mis en évidence et surveillés dès leur décollage.
Connecter un agent IA comme co-analyste via le canal de commande agentique signé HMAC de ShadowBroker — compatible avec OpenClaw et tout autre agent parlant le protocole (Claude, GPT, LangChain, personnalisé). L’agent a un accès complet en lecture/écriture aux plus de 40 couches de données, une recherche inter-couche compacte (search_telemetry, search_news), la boîte à outils complète de reconnaissance (osint_lookup pour IP/DNS/WHOIS/sanctions/CVE, etc.), l’extension de graphe d’entités, le placement de marqueurs, le contrôle de la carte, la détection des changements au sol par SAR, le maillage réseau et la livraison d’alertes. Il voit tout ce que l’opérateur voit et peut agir sur la carte en temps réel.
Communiquer sur le testnet InfoNet — le premier maillage de renseignement décentralisé intégré à un outil OSINT. Messagerie obscurcie avec des personnages de porte, échange pair-à-pair via Dead Drop et un terminal CLI intégré. Pas de comptes, pas d’inscription. La confidentialité n’est pas encore garantie — il s’agit d’un testnet expérimental — mais le protocole est opérationnel et en cours de renforcement.
Clic droit n’importe où sur Terre pour obtenir un dossier pays (chef d’État, population, langues), un résumé Wikipédia et la dernière photo satellite Sentinel-2 à 10 m de résolution
Cliquer sur un nœud KiwiSDR et écouter en direct une radio shortwave directement dans le tableau de bord. Cliquer sur un flux de radio de police et écouter en un clic.
Regarder plus de 11 000 caméras de vidéosurveillance dans 6 pays — Londres, New York, Californie, Espagne, Singapour, etc. — en streaming en direct sur la carte
Voir les zones de brouillage GPS en temps réel — dérivées de l’analyse de la dégradation NAC-P des données des transpondeurs aériens
Surveiller les satellites en orbite colorés par type de mission — reconnaissance militaire, SIGINT, SAR, alerte précoce, stations spatiales — avec les réseaux de stations au sol SatNOGS et TinyGS

⚡ Démarrage Rapide (Docker)

Depuis GitHub (par défaut — utilise les images GHCR)```bash

git clone https://github.com/bigbodycobain/Shadowbroker.git cd Shadowbroker docker compose pull docker compose up -d

### Depuis GitLab (utilise GitLab Container Registry)```bash
git clone https://gitlab.com/bigbodycobain/Shadowbroker.git
cd Shadowbroker
docker compose -f docker-compose.yml -f docker-compose.gitlab.yml pull
docker compose -f docker-compose.yml -f docker-compose.gitlab.yml up -d

Les deux chemins produisent des conteneurs identiques — même source, même CI, mêmes images octet pour octet. Choisissez l'écosystème que vous utilisez déjà.

Ouvrez http://localhost:3000 pour voir le tableau de bord ! (Nécessite Docker Desktop ou Docker Engine)

Rejoignez l'essaim privé InfoNet (sb-testnet-0) : Cliquez sur NŒUD dans le tableau de bord, ou exécutez ./meshnode.sh pour un participant sans interface. Pas de liste manuelle de pairs — les valeurs par défaut de la flotte découvrent le seed et récupèrent le manifeste signé automatiquement. Définissez MESH_INFONET_FLEET_JOIN=false dans .env pour un nœud solo privé.

Port du backend déjà utilisé ? Le navigateur a besoin uniquement du port 3000, mais l'API backend est également publiée sur le port hôte 8000 pour les diagnostics locaux. Si une autre application utilise déjà 8000, créez ou modifiez .env à côté de docker-compose.yml et définissez BACKEND_PORT=8001, puis exécutez docker compose up -d.

Nouvelles/UAP/bases/eaux usées vides après plusieurs minutes ? Vérifiez les redémarrages du backend pour cause de OOM avec docker events --since 30m --filter container=shadowbroker-backend --filter event=oom. Le fichier compose par défaut donne 4 Go au backend ; si votre hôte a moins de mémoire, réduisez les flux activés ou définissez BACKEND_MEMORY_LIMIT=3G et attendez-vous à ce que les couches plus lourdes/lentes se réchauffent plus progressivement.

Utilisateurs Podman : Podman fonctionne, mais podman compose est une surcouche et nécessite encore un fournisseur Compose installé. Sur Windows/WSL, si vous voyez looking up compose provider failed, installez podman-compose et exécutez podman-compose pull suivi de podman-compose up -d depuis le dossier cloné Shadowbroker. Sur les shells Linux/macOS/WSL, vous pouvez aussi utiliser ./compose.sh --engine podman pull et ./compose.sh --engine podman up -d.

🔄 Comment mettre à jour

ShadowBroker utilise des images Docker pré-construites — aucune construction locale requise. La mise à jour prend quelques secondes :```bash docker compose pull docker compose up -d

C'est tout. `pull` récupère les dernières images, `up -d` redémarre les conteneurs.

> **Vous venez d'une version plus ancienne ?** Récupérez d'abord le dernier code du dépôt, puis les images :
>
> ```bash
> git pull origin main
> docker compose down
> docker compose pull
> docker compose up -d
> ```
>
> Les utilisateurs de Podman doivent exécuter la commande équivalente de leur fournisseur, par exemple `podman-compose pull` et `podman-compose up -d`, ou utiliser `./compose.sh --engine podman pull` et `./compose.sh --engine podman up -d` depuis un shell compatible bash.

### Intégrité des mises à jour

Les mises à jour Docker sont distribuées via des registres de conteneurs signés. Le programme de mise à jour automatique ZIP hérité vérifie les archives de version via cette chaîne, dans l'ordre :

* `MESH_UPDATE_SHA256` lorsqu'un opérateur définit explicitement un condensé.
* `backend/data/release_digests.json` pour les condensés de version fournis.
* Le fichier `SHA256SUMS.txt` de la version sur GitHub lorsqu'aucun condensé fourni n'est présent.

Les responsables de version doivent exécuter `python backend/scripts/release_helper.py hash <ShadowBroker_vX.Y.Z.zip>` avant de publier, puis publier `SHA256SUMS.txt` et mettre à jour `backend/data/release_digests.json` lors de la livraison d'une cible de mise à jour ZIP. Le programme de mise à jour conserve le chemin de remplacement de l'opérateur intact au lieu d'échouer en cas d'absence de condensés fournis, afin que les installations existantes ne soient pas bloquées par une erreur dans le processus de publication.

### Durcissement CSP

Le frontend de production est livré avec un CSP compatible avec l'hydratation et un CSP strict à nonce uniquement dans `Content-Security-Policy-Report-Only`. Définissez `SHADOWBROKER_STRICT_CSP=1` uniquement après avoir vérifié que la construction exacte s'hydrate correctement dans votre déploiement. Les polices Google d'exécution ne sont pas nécessaires ; le pipeline de polices Next intégré sert la police du tableau de bord depuis la construction de l'application.

### ⚠️ **Bloqué sur l'ancienne version ?**

**Si `git pull` échoue ou que `docker compose up` continue de construire à partir des sources au lieu de récupérer les images**, votre clone est antérieur à une migration du dépôt de mars 2026 qui a réécrit l'historique des commits. Un `git pull` normal ne peut pas résoudre ce problème. Exécutez :```bash
# Back up any local config you want to keep (.env, etc.)
cd ..
rm -rf Shadowbroker
git clone https://github.com/bigbodycobain/Shadowbroker.git
cd Shadowbroker
docker compose pull
docker compose up -d

Comment savoir si vous êtes concerné : Si docker compose up affiche RUN apt-get, RUN npm ci ou RUN pip install — cela signifie qu'il construit à partir des sources au lieu de télécharger des images pré-construites. Vous avez besoin d'un nouveau clone.

Autre dépannage :

Forcer le re-téléchargement : docker compose pull --no-cache
Nettoyer les anciennes images : docker image prune -f
Vérifier les logs : docker compose logs -f backend

☸️ Kubernetes / Helm (Avancé)

Pour les déploiements haute disponibilité ou les clusters de laboratoire domestique, ShadowBroker prend en charge le déploiement via Helm. Ce chart est basé sur le template bjw-s-labs et offre une configuration robuste et modulaire pour le backend et le frontend.

1. Ajouter le dépôt :```bash helm repo add bjw-s-labs https://bjw-s-labs.github.io/helm-charts/ helm repo update

**2. Installer le Chart :**```bash
# Default — pulls images from GHCR
helm install shadowbroker ./helm/chart --create-namespace --namespace shadowbroker

# GitLab registry variant
helm install shadowbroker ./helm/chart --create-namespace --namespace shadowbroker \
  -f helm/chart/values.yaml \
  -f helm/chart/values-gitlab.yaml

3. Fonctionnalités Clés :

Architecture Modulaire : Évolutivité indépendante du backend d’intelligence et du frontend HUD.
Contexte de Sécurité : Fonctionne avec des UIDs restreints (1001) pour le durcissement des conteneurs.
Prêt pour l’Ingress : Compatible avec Traefik, Cert-Manager et Gateway API pour un accès sécurisé et externe à votre nœud d’intelligence.

Remerciements particuliers à @chr0n1x pour avoir contribué à l’architecture Kubernetes initiale.

🌐 Testnet Expérimental — Aucune Garantie de Confidentialité

ShadowBroker v0.9.7 embarque InfoNet (maillage d’intelligence décentralisé + économie de gouvernance Sovereign Shell), un canal de commandement IA agentique (prend en charge OpenClaw et tout agent signant en HMAC), la lecture de snapshots Time Machine et la détection de changements au sol par SAR satellite. Il s’agit d’un testnet expérimental — ni un messager privé, ni un système de gouvernance de production.

✨ Fonctionnalités

🧅 InfoNet — Maillage d’Intelligence Décentralisé + Sovereign Shell (étendu dans v0.9.7)

La première couche de communication d’intelligence et de gouvernance décentralisée intégrée directement dans une plateforme OSINT. Pas de comptes, pas d’inscription, pas d’identité requise. v0.9.7 élève InfoNet d’une couche de chat à une économie de gouvernance complète avec une voie claire vers une plateforme d’intelligence décentralisée préservant la confidentialité.

Couche de communication (depuis v0.9.6) :

Testnet Expérimental InfoNet — Relais de messages global et obfusqué utilisant Tor et Reticulum. Toute personne exécutant ShadowBroker peut émettre et recevoir sur InfoNet. Les messages traversent une couche de relais Wormhole avec des personas de gate, une signature canonique du payload Ed25519 et une obfuscation du transport.
Panneau de Chat Maillé — Interface à trois onglets : INFONET (gate chat avec transport obfusqué), MESH (intégration radio Meshtastic), DEAD DROP (échange de messages pair-à-pair avec boîtes aux lettres par époque basées sur un jeton — voie actuelle la plus forte).
Système de Persona de Gate — Identités pseudonymes avec clés de signature Ed25519, bundles de pré-clés, vérification de contact par mot SAS et signalement d’abus.
Terminal Maillé — CLI intégré : send, dm, commandes de marché, inspection de l’état de la gate. Panneau déplaçable, se réduit dans la barre du haut. Tapez help pour voir toutes les commandes.
Stack Cryptographique — Signature Ed25519, Diffie-Hellman X25519, chiffrement AESGCM avec dérivation de clé HKDF, système d’engagement par chaîne de hachage. Échafaudage du double ratchet DM en cours.

Sovereign Shell — économie de gouvernance (NOUVEAU dans v0.9.7) :

📊 Sources de données et API

🚀 Pour commencer

🐳 Configuration Docker (Recommandée pour l'auto-hébergement)

Le dépôt inclut un fichier docker-compose.yml qui télécharge des images pré-construites depuis GitHub Container Registry.

```bash git clone https://github.com/BigBodyCobain/Shadowbroker.git cd Shadowbroker # Add your API keys in a repo-root .env file (optional — see Environment Variables below) docker compose pull docker compose up -d ``` Ouvrez `http://localhost:3000` pour voir le tableau de bord.

Déploiement public ou sur un LAN ? Aucune configuration nécessaire pour la plupart des configurations. Le frontend proxyfie tous les appels API via le serveur Next.js vers BACKEND_URL, qui par défaut est http://backend:8000 (réseau interne Docker). Le port hôte 8000 n'est publié que pour l'accès API/debug local (127.0.0.1:8000 dans docker-compose.yml). S'il entre en conflit avec un autre service, définissez BACKEND_PORT=8001 dans .env ; laissez BACKEND_URL à http://backend:8000 car c'est le port interne Docker.

Exécution du backend en dehors de Docker (cd backend && python main.py) : le serveur de développement se lie uniquement en boucle locale (127.0.0.1:8000) donc les autres machines sur votre LAN ne peuvent pas atteindre les routes admin/local-trust avec un ADMIN_KEY vide. Définissez dans uniquement lorsque vous avez délibérément besoin de et utilisez un fort pour tout appelant non local. La limite de mémoire du backend est contrôlée par et par défaut est de . Si Docker signale des événements OOM, le backend redémarrera et les couches lentes peuvent sembler vides jusqu'à ce qu'elles se repeuplent.

Utilisateurs de Podman : Ne passez pas l'URL GitHub à podman compose pull ; clonez d'abord le dépôt, cd Shadowbroker, puis exécutez compose à partir de ce dossier. podman compose nécessite également un fournisseur Compose. Si Podman signale looking up compose provider failed, installez-en un :```bash

Linux / macOS / WSL

python3 -m pip install --user podman-compose podman-compose pull podman-compose up -d

Veuillez fournir le contenu Markdown à traduire.```powershell
# Windows PowerShell
py -m pip install --user podman-compose
podman-compose pull
podman-compose up -d

Si vous êtes dans un shell compatible bash, le wrapper inclus peut détecter automatiquement Docker ou Podman :```bash ./compose.sh --engine podman pull ./compose.sh --engine podman up -d

</details>

---

<details>
<summary>🐋 Déploiement autonome (Portainer, Uncloud, NAS, etc.)</summary>

Pas besoin de cloner le dépôt. Utilisez les images pré-construites depuis le GitHub Container Registry. Les images du registre GitLab peuvent être utilisées comme miroir si vous les y publiez.

Créez un fichier `docker-compose.yml` avec le contenu suivant et déployez-le directement — collez-le dans l'éditeur de pile de Portainer, `uncloud deploy`, ou tout hôte Docker :```yaml
## Image registry — uncomment ONE line per service:
##   GitHub  (primary): ghcr.io/bigbodycobain/shadowbroker-backend:latest
##   GitLab  (mirror):  registry.gitlab.com/bigbodycobain/shadowbroker/backend:latest


services:
  backend:
    image: ghcr.io/bigbodycobain/shadowbroker-backend:latest
    # image: registry.gitlab.com/bigbodycobain/shadowbroker/backend:latest
    container_name: shadowbroker-backend
    ports:
      - "${BACKEND_PORT:-8000}:8000"
    environment:
      - AIS_API_KEY=your_aisstream_key          # Required — get one free at aisstream.io
      - OPENSKY_CLIENT_ID=                       # Optional — higher flight data rate limits
      - OPENSKY_CLIENT_SECRET=                   # Optional — paired with Client ID above
      - LTA_ACCOUNT_KEY=                         # Optional — Singapore CCTV cameras
      - SHODAN_API_KEY=                          # Optional — Shodan device search overlay
      - SH_CLIENT_ID=                            # Optional — Sentinel Hub satellite imagery
      - SH_CLIENT_SECRET=                        # Optional — paired with Sentinel Hub ID
      - CORS_ORIGINS=                            # Optional — comma-separated allowed origins
    volumes:
      - backend_data:/app/data
    restart: unless-stopped

  frontend:
    image: ghcr.io/bigbodycobain/shadowbroker-frontend:latest
    # image: registry.gitlab.com/bigbodycobain/shadowbroker/frontend:latest
    container_name: shadowbroker-frontend
    ports:
      - "3000:3000"
    environment:
      - BACKEND_URL=http://backend:8000   # Docker internal networking — no rebuild needed
    depends_on:
      - backend
    restart: unless-stopped

volumes:
  backend_data:

Comment ça fonctionne : Le conteneur frontal proxye toutes les requêtes /api/* via le serveur Next.js vers BACKEND_URL en utilisant le réseau interne de Docker. Le navigateur ne communique jamais qu'avec le port 3000. Le port hôte du backend est réservé à l'accès API/local de débogage et peut être modifié avec BACKEND_PORT=8001 sans changer BACKEND_URL.

BACKEND_URL est une simple variable d'environnement d'exécution (pas une variable NEXT_PUBLIC_* de construction), vous pouvez donc la modifier dans Portainer, Uncloud ou n'importe quel éditeur de compose sans reconstruire l'image. Définissez-la sur l'adresse à laquelle votre backend est accessible depuis l'intérieur du réseau Docker (par exemple http://backend:8000, http://192.168.1.50:8000).

📦 Démarrage rapide (aucun code requis)

Si vous souhaitez simplement exécuter le tableau de bord sans utiliser de commandes terminal :

Allez dans l'onglet Releases sur le côté droit de cette page du dépôt.
Téléchargez le dernier fichier .zip de la version.
Extrayez le dossier sur votre ordinateur.
Windows : Double-cliquez sur start.bat. Mac/Linux : Ouvrez le terminal, tapez chmod +x start.sh, dos2unix start.sh, puis exécutez ./start.sh.
Tout sera automatiquement installé et le tableau de bord se lancera !

Remarques sur le lanceur local :

start.bat / start.sh exécutent l'application sans Docker — ils installent les dépendances et démarrent les deux serveurs directement.
Si les points de terminaison d'identité Wormhole ou de contact DM échouent après une mise à niveau, consultez le dossier docs/mesh/ pour le dépannage.
Pour le témoin racine DM, la transparence et le déploiement de la surveillance des opérateurs, commencez par docs/mesh/wormhole-dm-root-operations-runbook.md.

💻 Configuration développeur

Si vous souhaitez modifier le code ou exécuter à partir des sources :

Prérequis

Node.js 18+ et npm — nodejs.org
Python 3.10, 3.11 ou 3.12 avec pip — python.org (cochez « Ajouter au PATH » lors de l'installation)
- ⚠️ Python 3.13+ peut présenter des problèmes de compatibilité avec certaines dépendances. La version 3.11 ou 3.12 est recommandée.
Clés API pour : aisstream.io (obligatoire), et optionnellement opensky-network.org (OAuth2), lta.gov.sg

Installation```bash

Clone the repository

git clone https://github.com/BigBodyCobain/Shadowbroker.git cd Shadowbroker

Backend setup

cd backend python -m venv venv venv\Scripts\activate # Windows

source venv/bin/activate # macOS/Linux

🎛️ Couches de données

Les 41 couches sont activables/désactivables indépendamment depuis le panneau de gauche :

🔧 Performances

La plateforme est optimisée pour gérer des ensembles de données massifs en temps réel :

Compression Gzip — Les charges utiles API sont compressées d'environ 92 % (11,6 Mo → 915 Ko)
Mise en cache ETag — Les réponses 304 Not Modified évitent l'analyse JSON redondante
Écrêtage par fenêtre d'affichage — Seules les entités dans les limites visibles de la carte (+20% de tampon) sont rendues
Mises à jour impératives de la carte — Les couches à volume élevé (vols, satellites, incendies) contournent la réconciliation React via des appels directs setData()
Rendu par clusters — Les navires, caméras CCTV, tremblements de terre et centres de données utilisent le clustering MapLibre pour réduire le nombre d'entités
Mises à jour de la fenêtre d'affichage avec débounce — 300 ms de débounce pour éviter les à-coups de reconstruction GeoJSON lors du panoramique/zoom ; 2 s de débounce sur les couches denses (satellites, incendies)
Interpolation de position — Animation fluide de 10 s entre les rafraîchissements de données
React.memo — Les composants lourds sont enveloppés pour éviter des rendus inutiles
Précision des coordonnées — Lat/lng arrondies à 5 décimales (~1 m) pour réduire la taille du JSON

📁 Structure du projet

Les nouveaux contributeurs peuvent utiliser docs/contributor-map.md pour un guide d'orientation plus court.``` Shadowbroker/ ├── openclaw-skills/shadowbroker/ # OpenClaw skill — SKILL.md, sb_query.py client, alerts/monitor helpers ├── backend/ │ ├── main.py # FastAPI app, middleware, API routes (~4,000 lines) │ ├── cctv.db # SQLite CCTV camera database (auto-generated) │ ├── config/ │ │ └── news_feeds.json # User-customizable RSS feed list │ ├── services/ │ │ ├── data_fetcher.py # Core scheduler — orchestrates all data sources │ │ ├── ais_stream.py # AIS WebSocket client (25K+ vessels) │ │ ├── carrier_tracker.py # OSINT carrier position estimator (GDELT news scraping) │ │ ├── cctv_pipeline.py # 14-source CCTV camera ingestion pipeline │ │ ├── ssrf_guard.py # SSRF validation for operator recon fetches │ │ ├── sanctions/ofac.py # OpenSanctions OFAC SDN index │ │ ├── osint/lookups.py # Server-side recon lookups (Osiris port) │ │ ├── osint/openclaw_recon.py # OpenClaw dispatch for recon + entity_expand │ │ ├── osint_intel/resolve.py # Entity graph resolver (Wikidata + OFAC) │ │ ├── scm/suppliers.py # Supply-chain risk overlay │ │ ├── intel_feeds/ # Country risk index helpers │ │ ├── fetchers/malware.py # abuse.ch Feodo + URLhaus │ │ ├── fetchers/cyber_status.py # CISA KEV feed │ │ ├── fetchers/telegram_osint.py # Public Telegram channel scrape + geoparse │ │ ├── third_party/osiris/ # MIT attribution for Osiris-derived code │ │ ├── geopolitics.py # GDELT + Ukraine frontline + air alerts │ │ ├── region_dossier.py # Right-click country/city intelligence │ │ ├── radio_intercept.py # Police scanner feeds + OpenMHZ │ │ ├── kiwisdr_fetcher.py # KiwiSDR receiver scraper │ │ ├── sentinel_search.py # Sentinel-2 STAC imagery search │ │ ├── shodan_connector.py # Shodan device search connector │ │ ├── sigint_bridge.py # APRS-IS TCP bridge │ │ ├── network_utils.py # HTTP client with curl fallback │ │ ├── api_settings.py # API key management │ │ ├── news_feed_config.py # RSS feed config manager │ │ ├── fetchers/ │ │ │ ├── flights.py # OpenSky, adsb.lol, GPS jamming, holding patterns │ │ │ ├── geo.py # AIS vessels, carriers, GDELT, fishing activity │ │ │ ├── satellites.py # CelesTrak TLE + SGP4 propagation │ │ │ ├── earth_observation.py # Quakes, fires, volcanoes, air quality, weather │ │ │ ├── infrastructure.py # Data centers, power plants, military bases │ │ │ ├── trains.py # Amtrak + DigiTraffic European rail │ │ │ ├── sigint.py # SatNOGS, TinyGS, APRS, Meshtastic │ │ │ ├── meshtastic_map.py # Meshtastic MQTT + map node aggregation │ │ │ ├── military.py # Military aircraft classification │ │ │ ├── news.py # RSS intelligence feed aggregation │ │ │ ├── financial.py # Global markets data │ │ │ └── ukraine_alerts.py # Ukraine air raid alerts │ │ └── mesh/ # InfoNet / Wormhole protocol stack │ │ ├── mesh_protocol.py # Core mesh protocol + routing │ │ ├── mesh_crypto.py # Ed25519, X25519, AESGCM primitives │ │ ├── mesh_hashchain.py # Hash chain commitment system (~1,400 lines) │ │ ├── mesh_router.py # Multi-transport router (APRS, Meshtastic, WS) │ │ ├── mesh_wormhole_persona.py # Gate persona identity management │ │ ├── mesh_wormhole_dead_drop.py # Dead Drop token-based DM mailbox │ │ ├── mesh_wormhole_ratchet.py # Double-ratchet DM scaffolding │ │ ├── mesh_wormhole_gate_keys.py # Gate key management + rotation │ │ ├── mesh_wormhole_seal.py # Message sealing + unsealing │ │ ├── mesh_merkle.py # Merkle tree proofs for data commitment │ │ ├── mesh_reputation.py # Node reputation scoring │ │ ├── mesh_oracle.py # Oracle consensus protocol │ │ └── mesh_secure_storage.py # Secure credential storage │ ├── routers/ │ │ ├── osint.py # /api/osint/* recon routes (local operator) │ │ ├── entity_graph.py # /api/entity/expand │ │ ├── scm.py # /api/scm-suppliers │ │ └── intel_feeds.py # /api/malware, /api/cyber-threats, /api/telegram-feed, /api/country-risk ├── frontend/ │ ├── public/data/ │ │ └── submarine-cables.json # Static undersea cable GeoJSON │ ├── src/ │ │ ├── app/ │ │ │ └── page.tsx # Main dashboard — state, polling, layout │ │ └── components/ │ │ ├── MaplibreViewer.tsx # Core map — all GeoJSON layers │ │ ├── MeshChat.tsx # InfoNet / Mesh / Dead Drop chat panel │ │ ├── MeshTerminal.tsx # Draggable CLI terminal │ │ ├── NewsFeed.tsx # SIGINT feed + entity detail panels │ │ ├── WorldviewLeftPanel.tsx # Data layer toggles (40+ layers) │ │ ├── ShodanPanel.tsx # Shodan device search overlay │ │ ├── ReconPanel.tsx # Server-side OSINT recon toolkit │ │ ├── ScmPanel.tsx # Supply-chain risk command panel │ │ ├── EntityGraphPanel.tsx # Entity graph on map selection │ │ ├── MaplibreViewer/popups/TelegramOsintPopup.tsx # Threat-intercept styled Telegram pin popups │ │ ├── WorldviewRightPanel.tsx # Search + filter sidebar │ │ ├── AdvancedFilterModal.tsx # Airport/country/owner filtering │ │ ├── MapLegend.tsx # Dynamic legend with all icons │ │ ├── MarketsPanel.tsx # Global financial markets ticker │ │ ├── RadioInterceptPanel.tsx # Scanner-style radio panel │ │ ├── FindLocateBar.tsx # Search/locate bar │ │ ├── ChangelogModal.tsx # Version changelog popup (auto-shows on upgrade) │ │ ├── SettingsPanel.tsx # API Keys + News Feed + Shodan config │ │ ├── ScaleBar.tsx # Map scale indicator │ │ └── ErrorBoundary.tsx # Crash recovery wrapper │ └── package.json

🤝 Contributeurs

ShadowBroker est construit en toute transparence. Ces personnes ont contribué du code concret :

⚠️ Avertissement

Cet outil est entièrement basé sur des données de renseignement open source (OSINT) disponibles publiquement. Aucune donnée classifiée, restreinte ou non publique n'est utilisée. Les positions des transporteurs sont des estimations fondées sur des rapports publics. L'interface utilisateur à thème militaire est purement esthétique.

📜 Licence

Ce projet est destiné à des fins éducatives et de recherche personnelle. Consultez les conditions d'utilisation de chaque fournisseur d'API pour les restrictions d'utilisation des données.

_{Construit avec ☕ et trop d'appels API}

Meshtastic / APRS	PUBLIC	Les transmissions radio RF sont publiques et interceptables par conception.
Gate Chat InfoNet	OBFUSCATION	Les messages sont obfusqués avec des personas de gate et une signature canonique du payload, mais PAS de chiffrement de bout en bout. Les métadonnées ne sont pas masquées bien que conçues via Tor et Reticulum (Travail en cours).
MPs Dead Drop	VOIE ACTUELLE LA PLUS FORTE	Boîte aux lettres par époque basée sur un jeton avec vérification par mot SAS. Voie la plus forte dans cette version, mais pas encore confidentielle avec certitude.
Gouvernance Sovereign Shell	REGISTRE PUBLIC	Pétitions, votes, hachages de mise à jour et mises en jeu de litige sont des événements signés sur une chaîne de hachage publique. Pseudonyme via le persona de gate, mais les actions de gouvernance sont intentionnellement observables.
Primitives de confidentialité (RingCT / stealth / DEX)	PAS ENCORE CÂBLÉES	Les contrats de protocole verrouillés sont en place, mais le schéma cryptographique n’a pas été choisi. La crate Rust `privacy-core` est la cible d’intégration pour un futur sprint.

OpenSky Network	Vols commerciaux et privés	~60s	Oui
adsb.lol	Aéronefs militaires	~60s	Non
aisstream.io	Positions des navires AIS	WebSocket en temps réel	Oui
CelesTrak	Positions orbitales des satellites (TLE + SGP4)	~60s	Non
USGS Earthquake	Événements sismiques mondiaux	~60s	Non
GDELT Project	Événements de conflits mondiaux	~6h	Non
DeepState Map	Ligne de front ukrainienne	~30 min	Non
Shodan	Recherche d'appareils connectés à Internet	À la demande	Oui
OpenSanctions	Index des sanctions OFAC SDN (reconnaissance + graphe d'entités)	Cache 24h	Non
abuse.ch Feodo + URLhaus	URL de C2 / distribution de logiciels malveillants	~5 min (couche optionnelle)	Non
CISA KEV	CVE exploitées connues	~5 min (couche optionnelle)	Non
ip-api.com	Géolocalisation IP (reconnaissance, graphe d'entités)	À la demande	Non
Google Public DNS	Requêtes DNS-over-HTTPS (reconnaissance)	À la demande	Non
RDAP.org	Données d'enregistrement de domaine (reconnaissance)	À la demande	Non
crt.sh	Transparence des certificats (reconnaissance)	À la demande	Non
bgpview.io	Routage BGP/ASN (reconnaissance)	À la demande	Non
TeleGeography (statique)	Routes de câbles sous-marins	Statique	Non
ASFINAG	Webcams autoroutières autrichiennes	~10 min	Non
Amtrak	Positions des trains américains	~60s	Non
DigiTraffic	Positions des trains européens	~60s	Non
Global Fishing Watch	Événements d'activité des navires de pêche	~1h	Oui (`GFW_API_TOKEN`)
Aperçus publics Telegram	Messages des chaînes guerre/OSINT (`telegram_osint`)	~1h	Non (facultatif `TELEGRAM_OSINT_CHANNELS`)
Transport for London, NYC DOT, TxDOT	Caméras de vidéosurveillance (Royaume-Uni, États-Unis)	~10 min	Non
Caltrans, WSDOT, GDOT, IDOT, MDOT	Caméras de vidéosurveillance (5 États américains)	~10 min	Non
DGT Espagne, Ville de Madrid	Caméras de vidéosurveillance (Espagne)	~10 min	Non
LTA Singapour	Caméras de circulation à Singapour	~10 min	Oui
Windy Webcams	Webcams mondiales	~10 min	Non
SatNOGS	Stations au sol satellites amateurs	~30 min	Non
TinyGS	Stations au sol satellites LoRa	~30 min	Non
Meshtastic MQTT	Positions des nœuds radio maillés	Temps réel	Non
APRS-IS	Positions radio amateur	TCP en temps réel	Non
KiwiSDR	Emplacements des récepteurs SDR publics	~30 min	Non
OpenMHZ	Flux scanners police/pompiers	Temps réel	Non
Smithsonian GVP	Volcans de l'Holocène dans le monde	Statique (en cache)	Non
OpenAQ	Stations de qualité de l'air PM2.5	~120s	Non
NOAA / NWS	Alertes météorologiques sévères et polygones	~120s	Non
WRI Global Power Plant DB	Plus de 35 000 centrales électriques	Statique (en cache)	Non
Ensembles de données des bases militaires	Installations militaires mondiales	Statique (en cache)	Non
NASA FIRMS	Points chauds incendie/thermiques NOAA-20 VIIRS	~120s	Non
NOAA SWPC	Indice Kp météo spatiale et événements solaires	~120s	Non
IODA (Georgia Tech)	Alertes de pannes internet régionales	~120s	Non
DC Map (GitHub)	Emplacements des centres de données mondiaux	Statique (cache 7j)	Non
NASA GIBS	Imagerie satellite quotidienne MODIS Terra	Quotidien (délai 24-48h)	Non
Esri World Imagery	Fond de carte satellite haute résolution	Statique (mis à jour périodiquement)	Non
MS Planetary Computer	Scènes Sentinel-2 L2A (clic droit)	À la demande	Non
Copernicus CDSE	Imagerie Sentinel Hub (API Process)	À la demande	Oui (gratuit)
Lumières nocturnes VIIRS	Détection de changement de luminosité nocturne	Statique	Non
RestCountries	Données de profil des pays	À la demande (cache 24h)	Non
Wikidata SPARQL	Données des chefs d'État	À la demande (cache 24h)	Non
API Wikipedia	Résumés de lieux et images d'aéronefs	À la demande (en cache)	Non
OSM Nominatim	Géocodage de noms de lieux (barre LOCATE)	À la demande	Non
Tuiles de fond CARTO	Tuiles de carte sombre	Continu	Non

Vols commerciaux	✅ ON	Compagnies aériennes, fret, aviation générale
Vols privés	✅ ON	Aéronefs privés non commerciaux
Jets privés	✅ ON	Jets d'affaires haut de gamme avec données propriétaires
Vols militaires	✅ ON	Aéronefs militaires et gouvernementaux
Aéronefs suivis	✅ ON	Liste de surveillance d'intérêt spécial
Brouillage GPS	✅ ON	Zones de dégradation NAC-P
Porte-avions / Mil / Cargo	✅ ON	Porte-avions, cargos, pétroliers
Navires civils	✅ ON	Yachts, bateaux de pêche, de plaisance
Croisière / Passagers	✅ ON	Navires de croisière et ferries
Yachts suivis	✅ ON	Superyachts de milliardaires et oligarques
Activité de pêche	✅ ON	Événements de navires Global Fishing Watch
Trains	✅ ON	Positions Amtrak + trains européens
Satellites	✅ ON	Actifs orbitaux par type de mission
SatNOGS	✅ ON	Stations au sol satellites amateurs
TinyGS	✅ ON	Stations au sol satellites LoRa
Tremblements de terre (24h)	✅ ON	Événements sismiques USGS
Points chauds d'incendie (24h)	✅ ON	Anomalies thermiques VIIRS NASA FIRMS
Volcans	✅ ON	Volcans de l'Holocène Smithsonian
Alertes météo	✅ ON	Polygones de conditions météorologiques sévères
Qualité de l'air (PM2.5)	✅ ON	Stations OpenAQ dans le monde
Ligne de front Ukraine	✅ ON	Positions en direct du front de guerre
Alertes aériennes Ukraine	✅ ON	Alertes de raids aériens régionaux
Incidents mondiaux	✅ ON	Événements de conflit GDELT
Réseau de caméras	✅ ON	Plus de 11 000 caméras issues de 13 sources, 6 pays
Pannes Internet	✅ ON	Alertes de connectivité régionale IODA
Centres de données	✅ ON	Emplacements mondiaux de centres de données (2 000+)
Bases militaires	✅ ON	Installations militaires mondiales
Récepteurs KiwiSDR	✅ ON	Récepteurs radio SDR publics
Nœuds Meshtastic	✅ ON	Positions des nœuds radio maillés
APRS	✅ ON	Positionnement radioamateur
Scanners	✅ ON	Flux de scanners police/pompiers
Cycle jour/nuit	✅ ON	Superposition du terminateur solaire
MODIS Terra (quotidien)	❌ OFF	Imagerie satellite quotidienne NASA GIBS
Satellite haute résolution	❌ OFF	Imagerie satellite sub-métrique Esri
Sentinel Hub	❌ OFF	API de processus Copernicus CDSE
Lumières nocturnes VIIRS	❌ OFF	Détection de changements de lumières nocturnes
Centrales électriques	❌ OFF	Plus de 35 000 centrales électriques mondiales
Superposition Shodan	❌ OFF	Résultats de recherche de périphériques Internet
Tendances du fret routier	❌ OFF	Tendances de mouvement de camions Sentinel-2 sur les grandes autoroutes (Analyser ici)
Câbles sous-marins	❌ OFF	Routes mondiales de câbles sous-marins (GeoJSON statique)
C2 de malwares	❌ OFF	Points de menace Feodo + URLhaus d'abuse.ch
Fournisseurs SCM	❌ OFF	Marqueurs de risque de chaîne d'approvisionnement de niveau 1/2 + alertes panneau
Menaces cyber	❌ OFF	Entrées récentes CISA KEV (statistiques dans la charge utile lente)
OSINT Telegram	✅ ON	Canaux Telegram publics de guerre/OSINT — collecte horaire, épingles géolocalisées
SAR	✅ ON	Catalogue radar à synthèse d'ouverture + alertes d'anomalies

Outil	Accès tableau de bord	Commande OpenClaw	Description
Boîte à outils de reconnaissance	Opérateur local (`/api/osint/*`)	`osint_lookup`, `osint_sweep`†	IP, DNS, WHOIS, certificats, BGP, sanctions, CVE, MAC, GitHub, fuites, menaces, balayage de sous-réseau
Graphe d'entités	Opérateur local (`/api/entity/expand`)	`entity_expand`	Wikidata + OFAC + graphe de relations en magasin en direct
Panneau de risque SCM	Opérateur local (`/api/scm-suppliers`)	`get_layer_slice(["scm_suppliers"])`	Synthèse des menaces fournisseurs + marqueurs cartographiques
Découverte d'outils	—	`osint_tools`	Liste les types de recherche de reconnaissance et les schémas d'expansion d'entités

Variable	Où définir	Objectif
`BACKEND_URL`	`environment` dans `docker-compose.yml`, ou variable d'environnement shell	URL que le serveur Next.js utilise pour proxyfier les appels API vers le backend. Par défaut à `http://backend:8000`. Variable d'exécution — pas besoin de reconstruire.
`BACKEND_PORT`	`.env` à la racine du dépôt ou variable d'environnement shell avant `docker compose up`	Port hôte utilisé pour exposer l'API backend pour les diagnostics locaux. Par défaut à `8000` ; définissez `BACKEND_PORT=8001` si le port 8000 est déjà utilisé. Ne change pas `BACKEND_URL` interne à Docker.

Populaires

Shadowbroker

🔍 Toolkit de Reconnaissance et Shodan (dérivé d’Osiris, sécurité avant tout)

🛩️ Suivi Aérien

🚢 Suivi Maritime

🚆 Suivi Ferroviaire (NOUVEAU dans v0.9.6)

🛰️ Espace et Satellites

🌍 Géopolitique et Conflits

🛰️ Imagerie Satellitaire

🛰️ Détection de Changements au Sol par SAR (NOUVEAU)

📻 Radio Logicielle et SIGINT

📷 Surveillance

🔥 Surveillance Environnementale et des Dangers

🌐 Couches et outils supplémentaires

🤖 Canal de commande IA agentique — OpenClaw et agents compatibles (étendu dans v0.9.7)

Optional helper scripts (creates venv + installs dev deps)

Windows PowerShell

.\backend\scripts\setup-venv.ps1

macOS/Linux

./backend/scripts/setup-venv.sh

Optional env check (prints warnings for missing keys)

Windows PowerShell

.\backend\scripts\check-env.ps1

macOS/Linux

./backend/scripts/check-env.sh

Create .env with your API keys

Frontend setup

Pre-commit (Optionnel)

Frontend

@Alienmajik	Support Raspberry Pi 5 — packaging ARM64, notes de déploiement headless, réglages d'exécution pour du matériel de classe Pi	—
@wa1id	Correction d'ingestion CCTV — SQLite threadé, base de données persistante, initialisation au démarrage, cliquabilité des clusters	#92
@AlborzNazari	Sources DGT Espagne + CCTV Madrid, export de renseignements sur les menaces STIX 2.1	#91
@adust09	Couche centrales électriques, couverture de renseignements Asie de l'Est (bases JSDF, enrichissement OACI, actualités Taïwan, classification militaire)	#71, #72, #76, #77, #87
@Xpirix	Améliorations du style et des interactions de LocateBar	#78
@imqdcr	Séparation du bouton navires (4 catégories) + identifiants d'entité MMSI/indicatif stables	—
@csysp	Alertes de menaces dissimulables + identifiants d'entité stables pour GDELT et actualités	#48, #63
@suranyami	Constructions Docker multi-arch parallèles (11min → 3min) + correction BACKEND_URL à l'exécution	#35, #44
@chr0n1x	Architecture Kubernetes / chart Helm pour déploiements haute disponibilité	—