Google Business Profile Kpi Analyzer

Google Business Profile KPI Analyzer is now set up as a real Apify Actor for batch reporting, with a separate local browser dashboard for interactive review.

It is built around this KPI framework:

Google Business Profile KPIs = Local Visibility + Customer Actions + Conversion Intent

What it does

The project ingests Google Business Profile export data, normalizes it, calculates derived KPI rates, compares date ranges, explains what each KPI means, and generates business-ready reporting.

It covers:

• Local visibility
• Customer actions
• Conversion intent
• Search query insights
• Review and reputation analysis
• Trend comparison
• Opportunities and risks
• Prioritized next actions
• Final health scoring

Runtime Modes

1. Apify Actor mode

$npm start

This runs /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/main.js:1, which:

• reads Actor input
• loads JSON bundles or uploaded CSV/JSON exports
• builds the analysis report
• pushes one output item to the default dataset
• stores full report artifacts in the default key-value store
• exits cleanly

Stored records include:

• OUTPUT
• REPORT
• REPORT_MARKDOWN
• INPUT_NORMALIZED
• SUMMARY

2. Local dashboard mode

$npm run web

Then open http://localhost:3000.

This serves the interactive dashboard in /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/index.html:1 and /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/app.js:1.

Why the Apify run was hanging before

The earlier build used npm start to launch /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/server.js:1, which opened a local web server and waited forever on localhost:3000. That is correct for a local browser app, but it is the wrong runtime behavior for an Apify Actor because the process never completes and no result gets written to Output or Storage.

That issue is now fixed by making npm start run the batch Actor entrypoint instead.

Input Options

The Actor accepts:

• inputJson
  • a combined JSON bundle pasted directly into the Actor input
• sourceFiles
  • uploaded CSV or JSON files using the Apify file upload field
• useSampleData
  • a bundled sample dataset for test runs
• date range overrides
  • currentRangeStart
  • currentRangeEnd
  • previousRangeStart
  • previousRangeEnd

The local dashboard also supports:

• pasted JSON bundle input
• direct local CSV upload
• direct local JSON upload

Output Structure

The report is organized into:

1. Business Profile Overview
2. Local Visibility Metrics
3. Customer Action Metrics
4. Conversion Intent Metrics
5. Search Query Insights
6. Review and Reputation Insights
7. Trend Comparison
8. Opportunities and Risks
9. Recommended Next Actions

It also includes:

• KPI summary
• executive summary
• actions breakdown
• top search queries
• branded vs discovery analysis when possible
• recommendations prioritized by impact
• final health score

Test

$npm test

This runs:

• the analytics engine test
• the Actor integration test

Files

• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/main.js:1
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/.actor/actor.json
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/.actor/INPUT_SCHEMA.json
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/.actor/output_schema.json
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/.actor/dataset_schema.json
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/.actor/key_value_store_schema.json
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/INPUT_SCHEMA.json:1
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/src/analytics.js:1
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/index.html:1
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/app.js:1
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/server.js:1
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/sample-data/gbp-sample-bundle.json:1
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/schemas/input-schema.json:1
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/schemas/output-schema.json:1
• /Users/apple/Documents/GitHub/google-business-profile-kpi-analyzer/apify-store-listing.md:1