Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



4 Commits

Repository files navigation

Google Search Console URL Inspection Automator

This script allows you to extract information programatically from Google Search Console's URL Inspection Tool.

The script is based on the original URL Inspector Automator for Python from Hamlet Batista.


Clone this repository in your machine using git, Github's CLI or by manually dowloading it.

git clone

# OR also

gh repo clone


The mechanism of the script is quite simple. First, install the neccessary modules from your terminal

npm install

There are two files that you need for the script to work:

  1. Update the “urls.csv” file with a list of urls from a site that it’s verified in your Google Search Console account.

  2. Update the “credentials.js” file with the email address you use for Search Console, the password and the URL from the property you’d like to check.

    2.1 If you wish to check a domain property instead of a URL property set the site variable to:

"Update credentials URL Inspection Automator"

By default, the script runs in headless mode, but if you’d like to see the script in action, simply change the variable makeHeadless in line 11 of the index.js file to false.

const makeHeadless = false;

Once you have edited those files start the script using npm start

npm start


When the script has finished, you will see two new files in your folder: a “results.csv” and a results.json”.

results.csv from URL Inspection Automator output

Both files will contain the following information but in different formats for convenience:

  • The Coverage category.
  • The index state of your URL as reported by GSC.
  • The description of the index state.
  • The last reported date & time Googlebot crawled your URL.
  • If the URL was found in your XML sitemap.
  • The referring pages Googlebot found linking to your URL.
  • The Canonical URL declared by the canonical tag in your page (if any).
  • The Canonical URL Google has chosen.

If you have exceeded your 100 URLs quota per property, per day (Search Console limitation) you will also get a screenshot of the message and the script will stop.


This script allows you to extract information programatically from Google Search Console's URL Inspection Tool.






No releases published


No packages published