How djsebby/coporatemapper works
CorporateMapper maps an organisation’s public attack surface into a people directory and phishing-risk view. The main workflow is: a user submits a company website, a background job discovers and prioritises pages, crawls them, extracts people, and stores results in Neo4j; the web UI then presents organisations, profiles, findings, and risk information. Enrichment and demo-profile population are additional capabilities. Several API and enrichment runtime connections are not shown in the excerpts, so those links are marked unverified rather than inferred as definite calls.
Main entry points: App.tsx Directory UI · pipeline.py Discovery pipeline · enrichment.py Enrichment engine · discover.py Site discovery
Components 22
Web application
- Directory UI
frontend/src/App.tsx - People graph
frontend/src/Graph.tsx - Person profile
frontend/src/PersonPanel.tsx - Discovery controls
frontend/src/Discovery.tsx - Enrichment controls
frontend/src/Enrichment.tsx - Recent activity
frontend/src/RecentActivity.tsx
Website discovery
- Discovery pipeline
app/pipeline.py - Site discovery
app/crawler/discover.py - Robots policies
app/crawler/robots.py - Sitemap parsing
app/crawler/sitemap.py - Page crawling
app/crawler/crawler.py - URL prioritiser
app/crawler/prioritiser.py
People and risk
- Person extraction
app/extractor.py - Phishing risk score
app/riskscore/riskscore.py
Profile enrichment
- Enrichment engine
app/enrichment.py - Finding policy
app/enrichment_policy.py - Public sources
app/enrichment_sources.py - Enrichment store
app/enrichment_store.py
Jobs and storage
- Pipeline jobs
app/pipeline_jobs.py - Neo4j connection
app/database.py
Other components
- Operator
- HTTP API
app/api.py
Connections 22
- Operator → Directory UI: uses
README.md - Directory UI → People graph: renders
frontend/src/App.tsx - Directory UI → Person profile: opens
frontend/src/App.tsx - Directory UI → Discovery controls: renders
frontend/src/App.tsx - Directory UI → Enrichment controls: renders
frontend/src/App.tsx - Directory UI → Recent activity: renders
frontend/src/App.tsx - Directory UI → HTTP API: requests
- HTTP API → Pipeline jobs: dispatches
- Pipeline jobs → Discovery pipeline: runs
app/pipeline_jobs.py - Discovery pipeline → Site discovery: discovers URLs
app/pipeline.py - Discovery pipeline → URL prioritiser: ranks URLs
app/pipeline.py - Discovery pipeline → Page crawling: fetches pages
app/pipeline.py - Discovery pipeline → Person extraction: processes pages
app/pipeline.py - Site discovery → Robots policies: checks policies
app/crawler/discover.py - Site discovery → Sitemap parsing: reads sitemaps
app/crawler/discover.py - Page crawling → URL prioritiser: uses ranking
app/crawler/crawler.py - Neo4j connection → Person extraction: constructs
app/database.py - HTTP API → Enrichment engine: exposes operations
- Enrichment engine → Finding policy: applies rules
app/enrichment.py - Enrichment engine → Public sources: queries sources
app/enrichment.py - Enrichment engine → Enrichment store: persists results
app/enrichment.py - Person profile → Phishing risk score: shows score