nhatduy288/facebook-tool

How nhatduy288/facebook-tool works

Facebook Tool is a local web application for monitoring a configured Facebook profile or Page and optionally liking, sharing, and commenting on new posts. The operator configures the tool and logs in, establishes a three-post baseline, then the engine repeatedly reads and verifies posts, suppresses duplicates, creates jobs, and runs enabled actions; uncertain submissions require reconciliation rather than automatic retry. The graph covers the documented workflow and major subsystems. Some internal links rely on the SOURCE INDEX or README because the relevant source was not excerpted.

Main entry points: main.ts Local server · actions.ts Action adapter · reader.ts Feed reader · engine.ts Workflow engine

Components 19

Local application

Web interface public/app.js
Local server src/main.ts
Workflow engine src/engine.ts
Browser session src/facebook/browser.ts

Feed reading

Feed reader src/facebook/reader.ts
Window verification src/facebook/feed/read-complete-window.ts
Query capture src/facebook/feed/capture.ts
Response parser src/facebook/feed/query-parser.mjs
Window parser src/facebook/feed/window-parser.mjs
Observed query store src/facebook/feed/observed-query-store.ts
Source targets src/facebook/feed/read-target.ts

Post actions

Action adapter src/facebook/actions.ts
Action confirmation src/facebook/confirmation.ts
Share verification src/facebook/share-verification.ts
Post loading src/facebook/post-loading.ts

Configuration and state

Configuration src/config.ts
SQLite state src/store.ts

Other components

Operator
Facebook

Connections 27

Operator → Web interface: configures and controls README.md
Web interface → Local server: calls local API README.md
Local server → Browser session: creates session src/main.ts
Local server → Feed reader: creates reader src/main.ts
Local server → Action adapter: creates adapter src/main.ts
Local server → Workflow engine: creates engine src/main.ts
Local server → SQLite state: opens database src/main.ts
Local server → Web interface: serves assets src/main.ts
Workflow engine → SQLite state: loads configuration and records jobs src/engine.ts
Workflow engine → Feed reader: reads feed README.md
Workflow engine → Action adapter: runs enabled actions README.md
Feed reader → Browser session: uses browser session src/facebook/reader.ts
Feed reader → Source targets: validates source src/facebook/reader.ts
Feed reader → Window verification: reads verified window src/facebook/reader.ts
Window verification → Query capture: uses captured query src/facebook/feed/read-complete-window.ts
Window verification → Observed query store: uses observed query src/facebook/feed/read-complete-window.ts
Query capture → Response parser: parses responses src/facebook/feed/capture.ts
Query capture → Window parser: inspects windows src/facebook/feed/capture.ts
Query capture → Source targets: checks source src/facebook/feed/capture.ts
Feed reader → Facebook: reads Facebook feed README.md
Action adapter → Browser session: uses browser session src/facebook/actions.ts
Action adapter → Action confirmation: checks outcomes src/facebook/actions.ts
Action adapter → Share verification: verifies share audience src/facebook/actions.ts
Action adapter → Post loading: loads target posts src/facebook/actions.ts
Action adapter → Facebook: submits and reconciles actions README.md
Configuration → Source targets: selects source src/config.ts
SQLite state → Configuration: validates and plans src/store.ts

Drawn by GitDiagram on November 11, 2026 from the repository's file tree, README and source files. Read as Markdown ·