Inspiration
Every day, people scroll past viral claims, cherry-picked statistics, and emotionally loaded headlines without a fast way to verify what is actually true. Opening separate tabs to cross-check sources breaks reading flow, so most misleading framing goes unchecked. We wanted to build an impartial digital "arbiter" that lives directly inside the browser—giving readers instant, source-backed clarity on any highlighted sentence in seconds.
What it does
PageArbiter is a lightweight Manifest V3 Chrome Extension that acts as a real-time fact-checker and rhetorical bias auditor:
- Right-Click Context Audit: Highlight any claim, paragraph, or social media post on any webpage, right-click, and select "Verify claim with PageArbiter" to trigger an instant check in Chrome's native Side Panel.
- Source-Grounded Verdicts: Uses Gemini 2.5 Flash paired with Google Search Grounding to cross-reference claims against live web data and issue a clear ruling (
TRUE,FALSE,MISLEADING, orUNVERIFIED). - Bias & Framing Detection: Goes beyond binary fact-checking by flagging emotional framing, cherry-picked data, and logical fallacies.
- Clickable Citations: Displays direct links to the underlying live web sources so users can inspect the evidence themselves.
How we built it
- Chrome Extension (Manifest V3): Built with vanilla JavaScript, HTML5, and modern CSS using the Chrome
sidePanel,contextMenus, andstorageAPIs for a zero-friction, dark-mode UI that stays open alongside any article. - AI & Live Grounding: Integrated the Gemini 2.5 Flash REST API with
google_searchgrounding enabled, enforcing structured JSON responses so verdicts, bias breakdowns, and evidence render cleanly without a separate backend server. - Privacy-First Architecture: User API keys and session states stay strictly inside
chrome.storage.local—with zero third-party tracking servers or databases.
Challenges we ran into
- Structured JSON + Search Grounding: Combining live Google Search grounding with strict JSON formatting required careful prompt constraints and response sanitization to prevent markdown wrappers from breaking
JSON.parse(). - Seamless Side Panel State Sync: Ensuring that highlighting a new claim while the side panel was already open automatically triggered a fresh audit required listening to
chrome.storage.onChangedevents between the background service worker and the side panel UI.
Accomplishments that we're proud of
- Zero-Backend Architecture: Anyone can load the unpacked extension and run real-time, search-grounded audits locally with zero server latency or hosting overhead.
- Dual Fact + Rhetoric Auditing: Pairing factual verification with rhetorical framing analysis in a clean Side Panel interface that runs in under 3 seconds.
What we learned
- How to orchestrate event-driven communication across Chrome Manifest V3 service workers, context menus, and the native Side Panel API.
- How to extract and deduplicate
groundingMetadata.groundingChunksfrom Gemini's Search Grounding responses to surface verifiable citations cleanly in the UI.
What's next for PageArbiter
- Inline Page Highlighting: Automatically highlighting verified vs. misleading sentences directly inside the active webpage DOM.
- One-Click Full Page Scan: Summarizing the overall credibility score and framing bias of an entire article with a single click.
Built With
- chrome
- css3
- gemini-api
- html5
- javascript