Free, open-source Magento 2 performance analyzer CLI — scans any store from your terminal with no account, no cloud, and no data leaving your machine.
Developed and maintained by EaseCloud — cloud-native, AI-driven, and Magento infrastructure solutions.
pip install easecloud-mageperf
mageperf analyze https://your-store.com- Magento detection — fingerprints version, edition, and deployment mode;
--forceoverrides for hardened stores - Performance analysis — Core Web Vitals via Google PageSpeed Insights API (optional)
- Security checks — exposed admin paths, debug mode, insecure headers
- Configuration checks — caching, JS/CSS merging, CDN, production mode
- Search engine detection — flags likely MySQL search engine usage (critical performance issue on large catalogs)
- Extension audit — 25+ known performance-heavy extensions flagged with actionable guidance
- Report comparison — diff two reports to measure improvement:
mageperf compare <before> <after> - Selective analysis —
--checks magentoor--checks performanceto run subsets - Local reports — stored in
~/.easecloud/mageperf/reports/as JSON - Browser UI — rich report viewer served locally on port 4780
- JSON output — pipe results into scripts or AI agents
pip install easecloud-mageperfnpx @easecloud/mageperf analyze https://your-store.com
# or install globally
npm install -g @easecloud/mageperfdocker run --rm easecloud/mageperf analyze https://your-store.comcurl -fsSL https://raw.githubusercontent.com/easecloudio/mageperf/main/install.sh | bash# Analyze a store
mageperf analyze https://your-store.com
# Analyze and open the browser UI when done
mageperf analyze https://your-store.com --open
# Force analysis when Magento fingerprints are hardened
mageperf analyze https://your-store.com --force
# Run only performance checks (skip Magento config/security)
mageperf analyze https://your-store.com --checks performance
# JSON output (pipe into jq, scripts, AI agents)
mageperf analyze https://your-store.com --format json | jq .overall_score
# List saved reports (numbered for easy reference)
mageperf list
# Open report by number from the list
mageperf open 1
# Compare two reports to measure improvement
mageperf compare <before-id> <after-id>
# Open the local report UI
mageperf serve| Command | Description |
|---|---|
mageperf analyze <url> |
Run a full analysis |
mageperf list |
List saved reports (numbered) |
mageperf open <id|number> |
Open a report in the browser UI (UUID or list index) |
mageperf compare <id1> <id2> |
Diff two reports: score delta, resolved findings |
mageperf serve |
Start the local report UI server |
mageperf delete <id> |
Delete a single report |
mageperf clean |
Delete all saved reports |
mageperf config set <key> <value> |
Set a config value |
mageperf config get <key> |
Get a config value |
| Flag | Default | Description |
|---|---|---|
--format |
summary |
Output format: summary, json, table |
--output <file> |
— | Write JSON report to a file |
--open |
off | Open browser UI after analysis |
--no-pagespeed |
off | Skip Google PageSpeed API calls |
--force |
off | Skip Magento detection gate (for hardened stores) |
--checks <subset> |
all |
Comma-separated checks to run: performance, magento, all |
--timeout <secs> |
20 | HTTP request timeout in seconds |
Config is stored in ~/.easecloud/mageperf/config.json.
# Set your Google PageSpeed API key (optional, improves accuracy)
mageperf config set pagespeed-api-key YOUR_KEY
# Change the local UI port (default: 4780)
mageperf config set server-port 4780Get a free PageSpeed API key at Google Cloud Console.
Without a key, mageperf falls back to direct HTTP analysis.
Analysis runs in five layers:
- Magento detection — headers, HTML patterns, JS indicators, known paths;
--forcebypasses if the store hardens its fingerprint - Performance — PageSpeed Insights API (optional) or direct HTTP timing
- Security — admin URL exposure, debug headers, error reporting
- Configuration — caching strategy, JS/CSS bundling, deployment mode
- Search engine — detects likely MySQL catalog search via response timing and headers; flags it as a critical finding on large catalogs
All checks use only publicly available data. No credentials, no admin access required.
Any check that fails (timeout, connection error) surfaces in the terminal output with its error message rather than silently defaulting to zero.
Overall Score: 74/100
Performance 82 ████████░░
Security 61 ██████░░░░
Config 79 ███████░░░
2 critical issues found. Run with --open to view full report.
Report saved: ~/.easecloud/mageperf/reports/abc123.json
Comparing two reports:
$ mageperf compare <before-id> <after-id>
Score Comparison
Baseline : https://store.com [2026-04-01] score=55 grade=C
Compared : https://store.com [2026-04-14] score=74 grade=B
Category Before After Delta
Overall 55 74 +19
Performance 50 82 +32
Security 60 61 +1
Config 55 79 +24
Resolved (1):
✓ Enable CSS merging
git clone https://github.com/easecloudio/mageperf.git
cd mageperf
pip install -e ".[dev]"
# Run tests
pytest tests/ -v
# Build the UI (requires Node 18+)
cd ui && npm install && npm run buildmageperf/ Python package
cli.py Typer CLI entry point
config.py Config management (~/.easecloud/mageperf/)
core/ Analysis engine
magento_checker.py
performance_checker.py
analysis_orchestrator.py
scoring_service.py
storage/ Local JSON report store
server/ stdlib HTTP server + pre-built UI
static/ Pre-built Next.js UI
tests/ pytest test suite (73 tests)
ui/ Next.js 15 UI source (TypeScript)
Dockerfile Docker image build
install.sh Universal install script
package.json npm wrapper (@easecloud/mageperf)
EaseCloud is a cloud consulting and solutions company specializing in:
- Magento 2 performance optimization and infrastructure
- Cloud-native application development on AWS, GCP, and Azure
- AI and automation integrations
- DevOps, infrastructure management, and CI/CD
- Data analytics and BI platform consulting
We built mageperf to give the Magento community a transparent, no-signup performance tool while demonstrating our expertise in store optimization and cloud infrastructure.
If your team is running a high-traffic Magento store or needs help closing the gaps mageperf surfaces, get in touch — we provide consulting, caching strategy, Core Web Vitals tuning, and managed infrastructure for merchants at scale.
📧 support@easecloud.io 🌐 easecloud.io
Found a bug or have a feature request?
Please include:
- Magento version and edition (if known)
mageperfversion (mageperf --version)- Steps to reproduce
- Expected vs actual behavior
- Any error messages or terminal output
See CONTRIBUTING.md.
MIT © EaseCloud