GEO PDF Report Generator

GEO PDF Report Generator

tags: [geo, pdf, report, client-deliverable, professional]

Category: development Source: zubair-trabzada/geo-seo-claude

GEO PDF Report Generator

What Is This?

The GEO PDF Report Generator (geo-report-pdf) is a specialized skill for the Happycapy Skills platform designed to convert GEO audit data into a professional, client-ready PDF report. Utilizing the ReportLab library, the skill creates visually rich documents that summarize the results of a GEO audit. The generated PDF report features score gauges, bar charts, platform readiness visualizations, color-coded tables, and a prioritized action plan. This provides stakeholders with a clear, actionable, and visually engaging summary of a website’s GEO readiness and optimization status.

The skill is ideal for agencies, consultants, or developers who need to deliver comprehensive and polished GEO audit findings to clients or internal teams. By automating the report creation process, it ensures consistency, accuracy, and a high level of presentation in client deliverables.

Why Use It?

GEO audits can produce complex datasets with numerous metrics, findings, and recommendations. Manually compiling this data into a professional report is time-consuming and prone to inconsistencies. The GEO PDF Report Generator automates this process by:

  • Saving Time: Generates polished reports in minutes, eliminating the need for manual formatting.
  • Enhancing Professionalism: Produces visually consistent reports with advanced features such as score gauges and color-coded tables.
  • Improving Clarity: Visualizations and structured tables make it easy for clients to understand key findings and priorities.
  • Boosting Client Trust: A well-designed PDF report increases perceived value and trust in your services.

This skill is particularly valuable for anyone needing to provide clear, actionable, and visually appealing GEO audit results as a deliverable.

How to Use It

Prerequisites

Before using the GEO PDF Report Generator, ensure the following:

  • ReportLab Installed:
    Install the ReportLab library with 
    pip install reportlab
  • PDF Generation Script Location:
    The script for generating the PDF is located at 
    ~/.claude/skills/geo/scripts/generate_pdf_report.py
  • GEO Audit Data Ready:
    You must run a full GEO audit (using /geo-audit) and collect the output in the required JSON format.

Step 1: Collect Audit Data

Run the GEO audit and collect the results in the specified JSON schema. For example:

{
    "url": "https://example.com",
    "brand_name": "Example Company",
    "date": "2026-02-18",
    "geo_score": 65,
    "scores": {
        "ai_citability": 62,
        "brand_authority": 78,
        "content_eeat": 74,
        "technical": 72,
        "schema": 45,
        "platform_optimization": 69
    },
    "findings": [
        {"issue": "Missing Schema Markup", "impact": "high", "recommended_action": "Implement schema.org structured data"}
    ],
    "action_plan": [
        {"priority": 1, "task": "Add schema markup", "owner": "Dev Team"}
    ]
}

Step 2: Run the Report Generation Script

Use the PDF generation script to create the report. Example command:

python ~/.claude/skills/geo/scripts/generate_pdf_report.py --input /path/to/audit_data.json --output /path/to/report.pdf
  • --input: Path to your GEO audit JSON file.
  • --output: Desired output path for the PDF report.

Step 3: Deliver the Report

The script will produce a PDF file containing:

  • A summary page with URL, brand, and audit date
  • Overall GEO score and category scores visualized with gauges and bar charts
  • Platform readiness visualizations for mobile, desktop, and other platforms
  • Color-coded tables highlighting findings by severity
  • A prioritized action plan with clear recommendations

You can now deliver this PDF directly to your client or internal stakeholders.

Sample Code Snippet

A minimal example of invoking the script (assumes JSON data is already prepared):

python ~/.claude/skills/geo/scripts/generate_pdf_report.py \
    --input ./geo_audit_result.json \
    --output ./geo_audit_report.pdf

When to Use It

Use the GEO PDF Report Generator in the following scenarios:

  • Client Deliverables: When you need to present GEO audit findings as a formal report to clients.
  • Internal Reviews: For technical teams to review GEO readiness and plan remediation.
  • Periodic Reporting: To track improvements over time and compare audit results.
  • Pre-Sales Demonstrations: To showcase the value of GEO audits to potential clients.

This skill is best used immediately after a full GEO audit has been completed and the results are available in the required JSON format.

Important Notes

  • JSON Schema: The input JSON must strictly follow the required schema. Missing or malformed data can lead to generation errors or incomplete reports.
  • ReportLab Dependency: The script will not function without the ReportLab library installed.
  • Customization: The generated report is professionally styled, but for heavy customization (e.g., branding, additional charts), you may need to modify the script.
  • Data Freshness: Always ensure the audit data is up to date before generating reports.
  • Usage Rights: Review any licensing or client agreements regarding the format and distribution of audit reports.

For more details and to access the source code, visit the GEO PDF Report Generator repository. This ensures you have the latest updates and documentation for advanced usage scenarios.