PythonPSI 1.6.1

CLI + API for Google PageSpeed Insights

PyPSI

CLI 🖥 + API for Google PageSpeed Insights

Installation

pip install PythonPSI

Usage

psi <SITE_URL> <OPTION1> <OPTION2> ...

Example:

psi google.com --category seo --stratergy desktop --locale en

CLI

$ psi --help

    Usage: psi [OPTIONS] URL

    Options:
    --api_key TEXT        Required to use the API in an automated way and make
                            multiple requests per second

    --category TEXT       A Lighthouse category to run; if none are given, only
                            Performance category will be run

    --metrics TEXT        Returns metrics of a particular field in response
                            object

    --locale TEXT         The locale used to localize formatted results
    --stratergy TEXT      The analysis strategy (desktop or mobile) to use, and
                            desktop is the default

    --threshold TEXT      Threshold score to pass the PageSpeed test. Useful for
                            setting a performance budget.

    --links TEXT          If passed adds links with more info about
                            opportunities. Useful for checking documentation about
                            opportunities.

    --utm_campaign TEXT   Campaign name for analytics.
    --utm_source TEXT     Campaign source for analytics.
    --captcha_token TEXT  The captcha token passed when filling out a captcha.
    --help                Show this message and exit.

API Usage

from PythonPSI.api import PSI

PSI('google.com', category='seo', locale='en', stratergy='desktop')
# Returns JSON output

• PSI - Required arguments: 1, Optional arguments: 9

  • URL:
    • Required
    • Default: None
  • api_key:
    • Optional
    • Default: None
  • category:
    • Optional
    • Default: performance
    • Options: accessibility, best_practices, performance, pwa, seo
  • metrics:
    • Optional
    • Default: None
    • Options: kind, captchaResult, id, loadingExperience, originLoadingExperience, analysisUTCTimestamp, lighthouseResult, version
  • locale:
    • Optional
    • Default: en
  • stratergy:
    • Optional
    • Default: desktop
    • Options: desktop, mobile
  • threshold:
    • Optional
    • Default: None
    • Options: INT 0-100
  • links:
    • Optional
    • Default: false
    • Options: true, false
  • utm_campaign:
    • optional
    • Default: None
  • utm_source:
    • Optional
    • Default: None
  • captcha_token:
    • Optional
    • Default: None