Read-only by design
The public package omits account-changing commands and exposes only state inspection helpers.
Read-only social feed monitoring.
A narrow public extraction for inspecting feed cards and note metrics through Chrome DevTools without publishing, commenting, liking, favoriting, login management, or cookie handling.
$ xhs-readonly-monitor list-feeds --port 9222
{
"feeds": [],
"tracked_count": 0,
"discovery_count": 0
}Task-scoped tabs
The monitor opens its own tab for a run and closes that tab during cleanup.
Fixture tested
Core parsing logic is covered with synthetic initial-state payloads.
Extraction boundary
This repo demonstrates useful monitoring while keeping private browser state and write-capable automation out of the public package.
Allowed: open a task tab, read page state, normalize metrics, close the task tab.
Excluded: login, cookies, publish, comment, reply, like, favorite, follow, or message actions.
Excluded: real account identifiers, sessions, private watchlists, and saved browser profiles.