https://github.com/samjuk/google-index-checker
Golang script to help identify accidentally indexed subdomains
https://github.com/samjuk/google-index-checker
Last synced: 9 months ago
JSON representation
Golang script to help identify accidentally indexed subdomains
- Host: GitHub
- URL: https://github.com/samjuk/google-index-checker
- Owner: SamJUK
- Created: 2025-06-13T23:37:09.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-13T23:52:49.000Z (about 1 year ago)
- Last Synced: 2025-06-14T00:26:29.352Z (about 1 year ago)
- Language: Go
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Google Index Checker
A small Golang script to help identify accidentally indexed subdomains. Using a [Google Custom Search Engine](https://developers.google.com/custom-search/v1/overview) and domain inclusion and exclusion filters.
> NOTE: Google Custom Search Engines results can sometimes differ from the actual Google results. Dunno why, but occasionally worth running a manual check in google as well. See the following section #Manual Search Query
## Usage
To use this tool, you need to setup our own google custom search engine and associated API key. See the following [Google document](https://developers.google.com/custom-search/v1/overview) on how to do that.
In the below examples, we are using the following scenario:
- Primary domain is `example.com`
- `www.example.com` and `www2.example.com` are the only domains expected to be indexed
### Authentication
You need to provide the Google CSE ID (Custom Search Engine) and Google API key to the script. This can either be done via environment variables, or through CLI flags.
Recommendation, is setting them via a ENV file.
Name | ENV VAR | CLI FLAG | CLI SHORT FLAG
--- | --- | --- | ---
Custom Search Engine ID | `GOOGLE_CSE_ID` | `--google-cse-id` | `-c`
Google API Key | `GOOGLE_API_KEY` | `--google-api-key` | `-k`
### Docker
Assuming you have your Google tokens setup in a `.env` file.
```sh
docker run --env-file .env samjuk/google-index-checker -d example.com -n www.example.com -n www2.example.com
```
## Manual Search Query
Alternatively, you can run the Google search query directly with the following query.
```
site:example.com -site:www.example.com -site:www2.example.com
```