Geo Report Pdf

GEO PDF Report Generator (pandoc pipeline)

Prerequisites

• pandoc — brew install pandoc
• Google Chrome — must be installed at /Applications/Google Chrome.app/

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 Chrome headless to print the HTML to GEO-REPORT.pdf

The pandoc template (~/.claude/skills/geo/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 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

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

Replace ` placeholders with values extracted in Step 2. If a field is not found in the report, omit that --metadata` flag — the template has sensible defaults.

Step 4: Run Chrome headless

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless=new \
  --disable-gpu \
  --no-sandbox \
  --print-to-pdf="$(pwd)/GEO-REPORT.pdf" \
  --print-to-pdf-no-header \
  --no-pdf-header-footer \
  --virtual-time-budget=5000 \
  "file://$(pwd)/GEO-REPORT.html"

Step 5: Report completion

Tell the user:

• GEO-REPORT.pdf was generated in the current directory
• File size
• Optionally: open GEO-REPORT.pdf to preview it

What the PDF Contains

• Cover page — Dark navy gradient, brand name, domain, GEO score badge (colored by score), audit date, business type, locations, CMS platform
• Score tables — Cells containing XX/100 are color-coded: ≥80 green, ≥65 blue, ≥50 amber, ≥35 orange, ` block
• Which sections get page breaks — Edit the breakBefore array in the template's `` block

Troubleshooting

| Problem | Fix | |---|---| | pandoc: command not found | brew install pandoc | | Chrome not found | Check path: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome | | PDF is blank / empty | Increase --virtual-time-budget to 8000 | | Cover metadata missing | Check GEO-AUDIT-REPORT.md has the standard header format | | Fonts not loading | PDF is rendered offline; system fonts are used as fallback — this is expected |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: zubair-trabzada
• Source: zubair-trabzada/geo-seo-claude
• License: MIT
• Homepage: https://www.skool.com/aiworkshop

Install and usage instructions live in the source repository linked above.