Showcase

Google Analytics 4 & Search Console reporting for website owners

Usage: auditmyvisitors [OPTIONS] [COMMAND]

Commands:
  auth        Manage Google authentication
  properties  List or select GA4 / Search Console properties
  report      Generate reports
  export      Export reports
  snapshot    Manage local snapshots for trend tracking
  help        Print this message or the help of the given subcommand(s)

Options:
      --verbose  Enable verbose logging
  -h, --help     Print help
  -V, --version  Print version

Generate reports

Usage: auditmyvisitors report [OPTIONS] <COMMAND>

Commands:
  overview       Overall traffic overview for a time range
  top-pages      Top pages ranked by sessions
  page           Detailed report for a single URL
  compare        Before/after comparison around a change date
  opportunities  Prioritised opportunities for traffic growth
  queries        Query-level search performance analysis
  ai-traffic     AI referral traffic breakdown
  channels       Traffic channel breakdown with engagement metrics
  clusters       Topic cluster analysis across pages and queries
  decay          Content decay detection — pages losing search performance
  devices        Traffic by device category (desktop, mobile, tablet)
  countries      Traffic by country
  help           Print this message or the help of the given subcommand(s)

Options:
      --verbose  Enable verbose logging
  -h, --help     Print help

Top pages ranked by sessions

Usage: auditmyvisitors report top-pages [OPTIONS]

Options:
  -d, --days <DAYS>        Number of days to look back (default: 28)
  -n, --limit <LIMIT>      How many pages to show (default: 20)
      --sort-by <SORT_BY>  Sort by: sessions (default), clicks, impressions [default: sessions]
      --verbose            Enable verbose logging
  -h, --help               Print help

Query-level search performance analysis

Usage: auditmyvisitors report queries [OPTIONS]

Options:
  -d, --days <DAYS>        Number of days to look back (default: 28)
  -n, --limit <LIMIT>      How many queries to show (default: 30)
      --sort-by <SORT_BY>  Sort by: clicks (default), impressions, ctr, position [default: clicks]
      --verbose            Enable verbose logging
  -h, --help               Print help

Before/after comparison around a change date

Usage: auditmyvisitors report compare [OPTIONS] --since <SINCE>

Options:
      --url <URL>        The page URL (or omit for full-site comparison)
      --before <BEFORE>  Days before the change date to include [default: 30]
      --after <AFTER>    Days after the change date to include [default: 30]
      --since <SINCE>    The change date (YYYY-MM-DD), e.g. a deploy date
      --verbose          Enable verbose logging
  -h, --help             Print help

Export a full PDF report (fetches live data)

Usage: auditmyvisitors export pdf [OPTIONS]

Options:
  -d, --days <DAYS>      Number of days to look back (default: 28)
  -n, --limit <LIMIT>    How many top / weakest pages to include (default: 20, max: 200) [default: 20]
  -o, --output <OUTPUT>  Output file path (default: ./output/<property>-YYYY-MM-DD.pdf)
      --verbose          Enable verbose logging
  -h, --help             Print help

Export report data as CSV

Usage: auditmyvisitors export csv [OPTIONS] --report <REPORT>

Options:
  -r, --report <REPORT>  Which report to export: top-pages, queries, opportunities, channels, clusters, devices, countries, decay
  -d, --days <DAYS>      Number of days to look back (default: 28)
  -n, --limit <LIMIT>    How many rows to include (default depends on report)
  -o, --output <OUTPUT>  Output file path (default: stdout)
      --verbose          Enable verbose logging
  -h, --help             Print help