Phantom Reach

Abstract

1. Introduction

Type a business name. Phantom Reach pulls its real public footprint — Google Business Profile, reviews, competitors, site speed, technology stack, social presence, and more — then hands it to a frontier AI model that reasons like a seasoned growth consultant and writes the report for you. Pitch-ready PDF, DOCX, PPTX, or XLSX, every time.

It runs entirely on your machine: local SQLite storage, keys managed from an in-app Settings page, and zero synthetic data — if a source key is missing, that module is honestly reported as unavailable instead of faked. No Supabase, no Stripe, no cloud lock-in.

And because everything lives in plain local files, you can hand the whole project to your AI coding assistant and tell it to run audits, dig deeper, and write follow-up research for you. Jump to the agentic workflow ↓

2. Objective

Free, open-source local business intelligence audits for marketers and agencies. Run on your machine with real public data, and agentic workflow

This project demonstrates how TypeScript can be applied to a real-world Digital Marketing & SEO problem.

3. Key Features / Modules

• Multi-module digital audit — Google Business Profile, reviews, competitors, PageSpeed/performance, social presence, technology stack, and business enrichment.
• AI executive analysis — bring your own OpenAI, Anthropic, or Google AI key and a frontier model synthesizes the data into a consultant-style narrative.
• Local-first — SQLite storage, no Supabase/SaaS required for normal use.
• In-app key management — add and test data-source keys from /settings, no restart needed.
• Truthful coverage — missing keys mark a source unavailable; never synthetic fallback data.
• Multi-format exports — PDF, DOCX, PPTX, and XLSX for any completed report.
• Agent-friendly by design — readable report JSON and a documented playbook so AI assistants can run and extend audits.

4. Technology Stack

• Framework: Next.js 15 (App Router), React 18, TypeScript 5
• Storage: SQLite via better-sqlite3
• Styling: Tailwind CSS
• Exports: @react-pdf/renderer, docx, pptxgenjs, exceljs
• AI (optional): OpenAI, Anthropic, Google GenAI SDKs
• Testing: Vitest, Playwright

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/calesthio/PhantomReach.git
cd PhantomReach

1. /audits — audit history
2. /audits/new — run a new audit
3. /audits/{reportId} — rendered audit report
4. /settings — API keys and local workspace settings

npm run local

http://127.0.0.1:3000

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Export reports to Google Sheets or PDF
• Schedule weekly automated reports
• Add competitor comparison

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which marketing or SEO problem does this tool solve?
2. Which data sources or APIs does it use (Search Console, Analytics, social platforms)?
3. Which metrics or KPIs does it report and how are they calculated?
4. How could the output help a business make decisions?
5. How would you schedule it to run automatically?

9. Source Code & License

This project is developed by calesthio and published on GitHub under the GNU Affero General Public License v3.0. Please follow the license terms and credit the original author when you use or modify this code.