{"id":48829976,"url":"https://github.com/casoon/auditmyvisitors","last_synced_at":"2026-04-14T20:00:32.032Z","repository":{"id":350621649,"uuid":"1207621927","full_name":"casoon/auditmyvisitors","owner":"casoon","description":"Google Analytics 4 and Search Console reports directly in your terminal — no dashboard, no browser","archived":false,"fork":false,"pushed_at":"2026-04-11T07:57:17.000Z","size":37,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-11T09:23:35.264Z","etag":null,"topics":["analytics","cli","google-analytics","reporting","rust","search-console","seo","terminal"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/casoon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-11T07:04:44.000Z","updated_at":"2026-04-11T07:57:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/casoon/auditmyvisitors","commit_stats":null,"previous_names":["casoon/auditmyvisitors"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/casoon/auditmyvisitors","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casoon%2Fauditmyvisitors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casoon%2Fauditmyvisitors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casoon%2Fauditmyvisitors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casoon%2Fauditmyvisitors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/casoon","download_url":"https://codeload.github.com/casoon/auditmyvisitors/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casoon%2Fauditmyvisitors/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31812977,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"ssl_error","status_checked_at":"2026-04-14T18:05:01.765Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","cli","google-analytics","reporting","rust","search-console","seo","terminal"],"created_at":"2026-04-14T20:00:20.360Z","updated_at":"2026-04-14T20:00:32.007Z","avatar_url":"https://github.com/casoon.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# auditmyvisitors\n\nLocal CLI reporting for Google Analytics 4 and Search Console.\n\n`auditmyvisitors` helps website owners and small teams answer practical questions quickly:\n\n- Where is traffic growing or falling?\n- Which pages have search visibility but weak on-site performance?\n- Which URLs look promising for CTR or landing page improvements?\n- What changed before and after a deploy, content update, or relaunch?\n\nThe current product is intentionally lightweight:\n\n- local-first\n- API-based\n- no backend\n- no BigQuery setup required\n\n```\nauditmyvisitors report overview\n```\n\n```\nOVERVIEW  ·  last 28 days\nProperty: my-website.com\n\nMetric                  Value\nTotal sessions          12,480\n  organic               7,340 (59%)\n  direct                3,120 (25%)\nEngagement rate         64%\n\nSEARCH CONSOLE\nClicks                  2,105\nImpressions             87,400\nCTR                     2.4%\nAvg. position           14.3\n\nINSIGHTS\n⚠ High impressions, but low CTR\n   87,400 impressions at only 2.4% CTR. Consider improving title and meta description.\n```\n\n## Installation\n\n### macOS / Linux — one-line installer\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/casoon/auditmyvisitors/main/install.sh | bash\n```\n\nInstalls `auditmyvisitors` to `/usr/local/bin` (or `~/bin` if no write access).\n\n### Windows\n\nDownload the latest binary from the [releases page](https://github.com/casoon/auditmyvisitors/releases/latest) and add it to your `PATH`.\n\n### Build from source\n\n```bash\n# Requires Rust (https://rustup.rs)\ngit clone https://github.com/casoon/auditmyvisitors\ncd auditmyvisitors\ncargo build --release\n./target/release/auditmyvisitors --help\n```\n\n## Getting started\n\n```bash\n# 1. Log in with Google (opens browser)\nauditmyvisitors auth login\n\n# 2. Select your GA4 and Search Console property\nauditmyvisitors properties select\n\n# 3. Run your first report\nauditmyvisitors report overview\n```\n\n## What it is\n\n`auditmyvisitors` is a local CLI for combined GA4 and Search Console reporting.\n\nIt is built for:\n\n- fast site overviews\n- page-level analysis\n- before/after comparisons\n- opportunity and risk detection\n- exportable reports for sharing\n\nIt is not currently:\n\n- a BI platform\n- a Looker Studio replacement\n- a BigQuery warehouse product\n- a raw-event funnel analysis tool\n\n## Data Scope \u0026 Retention\n\n`auditmyvisitors` currently works primarily with the GA4 Data API and aggregated GA4 reporting data, plus Search Console API data. It does not currently depend on BigQuery raw exports.\n\nThis matters for planning and interpretation:\n\n- GA4 data retention settings mainly affect non-aggregated data, such as Explorations and funnel-style analyses.\n- Standard aggregated GA4 reports are not affected by that retention setting in the same way.\n- If you want the longest available retention in a standard GA4 property, increase it in `Admin \u003e Property \u003e Data settings \u003e Data retention`, set `Event data retention` to `14 months`, then click `Save`.\n- In many setups, `User data retention` is already set to `14 months`; the setting that often still needs attention is `Event data retention`, which is frequently left at `2 months`.\n- You need the `Editor` role to change this setting.\n- Important limitation: standard GA4 properties allow `2 months` or `14 months`; `26/38/50 months` are only available in GA4 360, and Large/XL properties can be limited to `2 months`.\n\nIn practice, that means `auditmyvisitors` is well suited for:\n\n- live reporting\n- comparisons around a specific change date\n- page and landing page analysis\n- opportunity detection on top of standard GA4 and Search Console data\n\nCurrent limits to keep in mind:\n\n- no BigQuery dependency in the core product\n- no raw-event funnels or event-sequence journey analysis\n- no exact query-to-conversion attribution model\n- no warehouse-style joins against CRM, CMS, or product databases\n\nIf BigQuery support is added later, it should extend the product rather than redefine the core workflow.\n\n## Roadmap\n\nThe current roadmap is documented in [ziel.md](/Users/jseidel/GitHub/auditmyvisitors/ziel.md:1). In short:\n\n- `Now`: strengthen overview, page, top-pages, compare, and PDF export on top of GA4 Data API and Search Console API.\n- `Next`: add better segmentation, directory analysis, page-type logic, and scoring.\n- `Later`: optionally add BigQuery-based raw-data and advanced analysis features for teams that need them.\n\n## Commands\n\n### Authentication\n\n```bash\nauditmyvisitors auth login     # Log in via browser\nauditmyvisitors auth status    # Check login status\nauditmyvisitors auth logout    # Remove stored tokens\n```\n\n### Properties\n\n```bash\nauditmyvisitors properties list    # List all available properties\nauditmyvisitors properties select  # Interactively select active property\n```\n\n### Reports\n\n```bash\n# Site overview (default: last 28 days)\nauditmyvisitors report overview\nauditmyvisitors report overview --days 90\n\n# Top pages\nauditmyvisitors report top-pages\nauditmyvisitors report top-pages --limit 50 --sort-by clicks\n\n# Single page detail\nauditmyvisitors report page --url https://example.com/my-page\n\n# Before/after comparison around a change date\nauditmyvisitors report compare --since 2026-03-01 --before 30 --after 30\nauditmyvisitors report compare --url https://example.com/page --since 2026-03-01\n```\n\n### Export\n\n```bash\nauditmyvisitors export pdf --report latest\nauditmyvisitors export pdf --report latest --output ./my-report.pdf\n```\n\n## Privacy\n\nThe tool runs entirely on your local device. There is no server, no backend, no cloud infrastructure.\n\n- OAuth tokens are stored locally at `~/.config/auditmyvisitors/tokens.json`\n- No data is shared with third parties\n- Read-only access to GA4 and Search Console\n\nFull privacy policy: https://auditmyvisitors.casoon.de/datenschutz\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcasoon%2Fauditmyvisitors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcasoon%2Fauditmyvisitors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcasoon%2Fauditmyvisitors/lists"}