How getmaxun/maxun works
Maxun is a web-data platform for building and running browser-based extraction robots, then retrieving and comparing their outputs. The main workflow runs from the visual dashboard through its API to server-side run orchestration and browser/workflow execution, with persisted results for later review. README-documented branches include AI extraction, scraping, crawling, search, monitoring, document parsing, schedules, and integrations. Some of those implementations were not sampled; their paths and capability links are shown where the tree or README supports them, without asserting unverified internal calls.
Main entry points: task-runner.ts Run orchestrator · routes/storage.ts Robot and run routes · api/storage.ts Dashboard API client · server.ts HTTP and socket server
Components 21
Dashboard
- Visual dashboard
src/pages/MainPage.tsx - Dashboard API client
src/api/storage.ts - Run comparison
src/hooks/useRunDiff.ts
API and orchestration
- HTTP and socket server
server/src/server.ts - Robot and run routes
server/src/routes/storage.ts - Public API routes
server/src/api/record.ts - Run orchestrator
server/src/task-runner.ts
Browser and extraction
- Browser sessions
server/src/browser-management/controller.ts - Workflow interpreter
maxun-core/src/interpret.ts - Workflow preprocessor
maxun-core/src/preprocessor.ts
Persistence and delivery
- Run records
server/src/models/Run.ts - Database connection
server/src/storage/db.ts - Object storage
server/src/storage/mino.ts
Product capabilities
- AI workflow enrichment
server/src/sdk/workflowEnricher.ts - Page scraping
server/src/markdownify/scrape.ts - Document parsing
server/src/workflow-management/classes/DocumentInterpreter.ts - Scheduled runs
server/src/workflow-management/scheduler/index.ts - Sheets integration
server/src/workflow-management/integrations/gsheet.ts - Airtable integration
server/src/workflow-management/integrations/airtable.ts - Search and monitoring
server/src/routes/storage.ts
Other components
- User
Connections 21
- User → Visual dashboard: build and manage
README.md - Visual dashboard → Dashboard API client: requests data
src/pages/MainPage.tsx - Dashboard API client → Robot and run routes: HTTP requests
src/api/storage.ts - HTTP and socket server → Robot and run routes: mounts routes
server/src/server.ts - HTTP and socket server → Public API routes: mounts API
server/src/server.ts - Robot and run routes → Run orchestrator: starts queued runs
server/src/routes/storage.ts - Run orchestrator → Browser sessions: creates browser
server/src/task-runner.ts - Run orchestrator → Workflow interpreter: executes workflow
- Workflow interpreter → Workflow preprocessor: preprocesses workflow
maxun-core/src/interpret.ts - Run orchestrator → Page scraping: scrapes pages
server/src/task-runner.ts - Run orchestrator → Sheets integration: exports results
server/src/task-runner.ts - Run orchestrator → Airtable integration: exports results
server/src/task-runner.ts - Robot and run routes → Scheduled runs: schedules workflow
server/src/routes/storage.ts - Robot and run routes → Document parsing: creates document robot
server/src/routes/storage.ts - User → AI workflow enrichment: describe extraction
README.md - User → Search and monitoring: search or monitor
README.md - Run orchestrator → Run records: updates run state
server/src/task-runner.ts - Run records → Database connection: uses connection
server/src/models/Run.ts - Run orchestrator → Object storage: stores outputs
server/src/task-runner.ts - Run comparison → Dashboard API client: fetches run diff
src/hooks/useRunDiff.ts - User → Run comparison: review changes
README.md