πŸ”§Google OAuth Token

SEO Utils uses Google OAuth Tokens to securely connect to your Google accounts and access Google Search Console data. This allows you to pull GSC data directly into SEO Utils for advanced analysis and reporting that the standard GSC interface doesn't provide.

Connect Your Google Account

Step 1: Access Google OAuth Tokens

Open the SEO Utils app on your machine, and locate the Settings menu in the left sidebar. You will see the Google OAuth Tokens menu.

Click on Google OAuth Tokens menu to manage your connections

Step 2: Connect Your Google Account

Click the "Connect" button in the top-right corner of the Google OAuth Tokens page.

Click the Connect button to start the authorization process

Step 3: Authorize SEO Utils

After clicking Connect, your default web browser will open with Google's authorization page. Follow these steps:

  1. Select your Google account that has access to Google Search Console

  2. Review the permissions that SEO Utils is requesting

  3. Click "Allow" to grant SEO Utils access to your Google Search Console data

Review and allow the requested permissions

SEO Utils only requests read-only access to your Google Search Console data. It cannot modify or delete any data in your GSC account.

Step 4: Authorization Complete

Once you've authorized access, you'll see a success message in your browser. You can close the browser tab and return to SEO Utils.

Authorization successful - you can close this tab

Your connected Google account will now appear in the Google OAuth Tokens list with your email address and profile picture.

Your connected Google account

Managing Multiple Google Accounts

You can connect multiple Google accounts to SEO Utils. This is useful if you manage GSC properties across different Google accounts.

Simply click the "Connect" button again and follow the same authorization process with a different Google account.

Remove a Google Account

To disconnect a Google account:

  1. Find the account you want to remove in the list

  2. Click on the three-dot menu on the right side of the account row

  3. Select "Delete" from the dropdown menu

  4. Confirm the deletion when prompted

Using Google OAuth with GSC Integration

Once you've connected your Google accounts, you can use them with various Google Search Console integration features in SEO Utils:

  • Performance Analytics: Complete search data with advanced regex filtering and more than 16 months of history

  • Keyword Cannibalization Detection: Identify when multiple pages compete for the same keywords, hurting your rankings

  • Bulk Mentions Analysis: Check if target keywords appear in critical SEO elements:

    • Page titles and meta descriptions

    • H1, H2, and other headings

    • Body content and paragraphs

    • Image alt text and captions

  • Optimization Opportunities: Data-driven insights showing:

    • Pages ranking 4-10 that need small tweaks to reach top 3

    • High-impression keywords missing from your content

    • Title/meta description improvements for better CTR

    • Quick wins based on position and mentions analysis

  • Bulk URL Indexing: Submit multiple URLs to Google for indexing at once

  • Sitemap Management: Monitor and manage your XML sitemaps directly

Troubleshooting

Authorization Failed

If the authorization process fails:

  1. Make sure you're selecting a Google account that has access to Google Search Console

  2. Check that you're allowing all the requested permissions

  3. Try clearing your browser cache and cookies, then attempt the connection again

Account Not Showing GSC Properties

If your connected account doesn't show any GSC properties:

  1. Verify that the Google account has been added as a user in Google Search Console

  2. Check that the account has at least "Read" permissions for the properties (needs "Owner" permissions to check index status if using the Auto Indexing tool).

  3. Try disconnecting and reconnecting the account

Token Expired

Google OAuth tokens may occasionally expire. If you see errors about expired tokens:

  1. Simply delete the affected account from the list

  2. Click "Connect" to re-authorize the account

Privacy & Security

  • SEO Utils stores OAuth tokens securely on your local machine

  • Tokens are never transmitted to any external servers except Google's APIs

  • You can revoke access at any time by deleting the account from SEO Utils

Last updated