The Google Indexing Script is a TypeScript-based tool designed to accelerate Google's discovery of website pages by leveraging the Google Indexing API. The script automates the process of submitting URLs to Google, with the stated goal of achieving indexation within 48 hours. It operates by interfacing with Google's official APIs rather than employing workarounds or unofficial methods.
The script has a critical limitation that users must understand before implementation: it only functions with pages containing either JobPosting or BroadcastEvent structured data. Additionally, the tool facilitates indexation notification to Google but does not influence search rankings, making it a discovery mechanism rather than a ranking enhancement tool. Users must have sitemaps already submitted to Google Search Console for the script to identify pages for indexation.
Setup requirements include Node.js installation, an active Google Search Console account with verified sites, and a Google Cloud project with appropriate API access. The preparation process involves enabling both the Google Search Console API and Web Search Indexing API within a Google Cloud project, creating a service account with Owner permissions, and downloading credentials as a JSON file. The script supports multiple authentication methods: storing credentials in a .gis directory within the home folder, using environment variables, or passing credentials as command-line arguments, with the first method being the recommended approach.
The repository is written in TypeScript and can be used in three primary ways: as a command-line interface installed globally, by cloning and building the repository locally, or as an npm module integrated into other projects. The tool includes API documentation available through JSDoc for developers who want to incorporate it into their own applications. Node.js version 20 or later is preferred for optimal compatibility.
The script includes quota management functionality, as the Google Indexing API enforces rate limits depending on account tier. By default, the tool exits when rate limits are exceeded, but users can configure retry mechanisms for read requests that operate on a per-minute basis. The script intelligently avoids redundant submissions by only indexing pages not already indexed, and it can be executed multiple times without adverse effects. Sites with large page counts may require extended processing time.
According to GitGenius activity tracking, the repository has received consistent maintenance with a median issue and pull request response latency of 3.6 hours across 14 tracked items, though mean latency extends to 847.6 hours, indicating occasional delays on some items. The primary maintainer goenning has logged 8 events, with contributors antoinekm and 213dfgd providing 5 and 4 events respectively. The repository shares contributors with notable projects including microsoft/playwright, yt-dlp/yt-dlp, and oven-sh/bun, suggesting cross-pollination within the developer community.
The project is distributed under the MIT License and is sponsored by SEO Gets, a platform accessible at seogets.com. The tool addresses a specific need within the SEO automation and webmaster tooling space, providing programmatic access to Google's indexing capabilities for developers and site administrators seeking to expedite content discovery.
