Public-post social listening across Facebook + Instagram: search by keyword/hashtag/page; capture post text, engagement, and timestamps; get topic volume, sentiment, themes, and share-of-voice. The commercial alternative to Meta Content Library (academic-only). For brands, PR, and agencies.
0.2 - 2026-09-27 - Reliability: one shared browser per run
Browser tier rebuilt around one shared Chromium per run (src/browser_session.py): each fetch or flow gets an isolated context on the same browser, open pages are capped by run memory (1 below 2 GB, 2 at 2 GB, 3 at 4 GB+), each browser fetch is capped at 60 s and each flow at 120 s, and a circuit breaker switches the tier off after 3 consecutive failures or challenge pages so a blocked run finishes promptly. Previously every escalated request launched its own headful Chromium, several at once, which can exhaust the container's memory and kill the run.
A private Xvfb starts when the image ships one and no display is running (headful passes edges that block headless); --disable-dev-shm-usage keeps renderers alive on the 64 MB container /dev/shm; a missing patchright Chromium falls back to the Playwright build (the Dockerfile now installs both).
The challenge wait checks before sleeping (no fixed 4 s idle per page) and a missing results selector releases the page after 20 s.
browser_telemetry() on the client reports mode, launches, pages served and breaker state.
0.1 - initial build
Public-post social-listening intel across Facebook + Instagram public
Pages/posts. The wedge: Meta's official social-listening path (Meta Content
Library, the CrowdTangle successor) is application-restricted to academic and
non-profit researchers - brands, PR/comms, agencies, and journalists are barred.
This delivers the equivalent public-post listening data from the logged-out
public surface, no application required.
Modes: keyword_listening (topic search + aggregation), page_posts
(recent public posts for given Pages / public IG profiles), hashtag_intel
(public hashtag feeds + topic intel).
Normalized cross-platform post schema keyed by platform + post + public
author (post text, type, engagement, timestamps, hashtags, mentions).
Social-listening enrichment: lexicon sentiment + theme tagging per post,
topic volume over time, top posts/pages, top hashtags, and cross-topic
share-of-voice.
PII minimization on by default: personal-individual authors redacted (name
dropped, handle tokenized); Pages/business/verified accounts retained.