geo-report-pdf

GEO PDF Report Generator (pandoc pipeline)

Prerequisites

• pandoc — install through Homebrew, Chocolatey, Scoop, apt, or your platform package manager
• Chrome/Chromium-compatible browser — Google Chrome, Microsoft Edge, Chromium, or Brave

No Python dependencies. No ReportLab. No JSON data wrangling.

How It Works

1. Read GEO-AUDIT-REPORT.md in the current directory (created by $geo-audit)
2. Extract cover metadata from the report (brand name, domain, GEO score, date, locations)
3. Run pandoc with the bundled CSS + HTML template to produce a self-contained GEO-REPORT.html
4. Run a Chrome/Chromium-compatible browser in headless mode to print the HTML to GEO-REPORT.pdf

Resolve GEO_ROOT from CODEX_GEO_ROOT, the loaded plugin/repository root, or the classic installer path ${CODEX_HOME:-$HOME/.codex}/skills/geo. The pandoc template ($GEO_ROOT/templates/geo-report-template.html) injects:

• A full-bleed dark navy cover section with the GEO score badge
• Per-section cover metadata (date, business type, locations, platform)
• JavaScript that runs inside Chrome before printing to color-code score cells and severity-tag finding sections

Workflow

Step 1: Check for audit report

Look for GEO-AUDIT-REPORT.md in the current directory. If absent, tell the user to run $geo-audit <url> first.

Step 2: Extract cover metadata from the report

Read the top of GEO-AUDIT-REPORT.md and extract:

Field	Where to find it
brand_name	First H1 title (after "GEO Audit Report:")
domain	Second bold line (e.g. **Domain:** alexamediasolutions.com)
geo_score	Line matching ## Overall GEO Score: XX / 100
score_label	Word after the score on that same line (e.g. "Poor", "Fair", "Good")
date	**Audit Date:** line
business_type	**Business Type:** line
locations	**Locations:** line
platform	**CMS:** line

Step 3: Run pandoc

GEO_ROOT="${CODEX_GEO_ROOT:-}"
if [ -z "$GEO_ROOT" ]; then
  for candidate in "$PWD" "$PWD/.." "$PWD/../.." "${CODEX_SKILLS_DIR:-${CODEX_HOME:-$HOME/.codex}/skills}/geo"; do
    if [ -f "$candidate/templates/geo-report-template.html" ]; then
      GEO_ROOT="$candidate"
      break
    fi
  done
fi
if [ -z "$GEO_ROOT" ]; then
  echo "GEO runtime root not found. Set CODEX_GEO_ROOT to the geo-seo-codex plugin/repo root."
  exit 1
fi

pandoc GEO-AUDIT-REPORT.md \
  --to html5 \
  --standalone \
  --embed-resources \
  --template "$GEO_ROOT/templates/geo-report-template.html" \
  --css "$GEO_ROOT/templates/geo-report-style.css" \
  --metadata title="GEO Audit Report — <brand_name>" \
  --metadata brand_name="<brand_name>" \
  --metadata domain="<domain>" \
  --metadata geo_score="<geo_score>" \
  --metadata score_label="<score_label>" \
  --metadata date="<date>" \
  --metadata business_type="<business_type>" \
  --metadata locations="<locations>" \
  --metadata platform="<platform>" \
  -o GEO-REPORT.html