# Google Search Console

Connect Search Console inside Prompt Explorer and turn available search-query rows into reviewed prompt drafts.

Canonical: https://docs.equalai.io/integrations/google-search-console
Markdown: https://docs.equalai.io/integrations/google-search-console.md

Google Search Console supplies search queries to [Prompt Explorer](https://docs.equalai.io/ai-visibility/prompt-explorer). This connection helps you choose questions to track; it does not measure AI referrals, execute prompts, or import Google's historical results as AI responses.

## Prerequisites

- A workspace administrator must authorize the Google connection and change its selected site.
- The Google account must have access to a suitable Search Console property.
- The EqualAI project should have the intended website domain configured so its site can be matched correctly.
- Google OAuth must be available in the EqualAI deployment.
- Creating the resulting prompts requires project editing permission and available prompt capacity.

No separate GA4 connection is required for this research method. Search Console and GA4 are distinct data sources.

## Connect and use queries

1. Select the correct project and open **AI Visibility → Prompt Explorer**. The page heading is **Prompt Research**.
2. Find **Google Search Console** and choose **Connect & start** when disconnected, or start the method and use **Connect Google** when offered.
3. Complete Google's account and permission screens with an authorized account.
4. Return to the workflow, confirm the target country/language, and continue to **Configure source**.
5. Confirm **Search Console site**. Use the selector if a choice is available; the query view is restricted to the configured site rather than an unrestricted account-wide browser.
6. Select relevant query rows and a **Prompt style**: Question, Comparison, or Buyer.
7. Choose **Generate drafts**, review the wording and topics, then choose **Create N prompts**.

If reconnection is needed, the workflow can show **Reconnect Google**. You may need an administrator to complete it.

## Understand the query sample

The request covers a date range starting 28 days before the request date and ending on the request date, returning up to 25 query rows. This is a bounded sample, not every query in the property. Upstream reporting delays or privacy filtering can affect availability.

Rows include query text, clicks, impressions, and position. The selected-row average position shown in the workflow is an arithmetic average, not an impression-weighted position for the entire site.

Selecting a target country or language sets prompt-workflow context. It does not add country or language filters to this Search Console data request. Drafts based on a query may be rewritten into a question or comparison rather than copied verbatim.

## Connection removal and saved prompts

The current Prompt Explorer wizard does not offer a dedicated Search Console **Disconnect** button. Do not use Traffic Analytics' disconnect as a substitute for a Search Console-specific control.

For provider-side access removal, an administrator can review and revoke the application's grant in the connected Google account. This prevents future authorized reads once credentials can no longer be used, but does not delete Search Console data or prompts already created in EqualAI. Revocation may affect other features sharing that Google authorization, and a displayed connection status may not change until an access attempt detects the problem.

To restore access, use **Reconnect Google** with the appropriate account and verify the displayed site again.

## Troubleshooting

- **No queries:** check that the configured property is correct and has query data for the requested period.
- **No configured site:** review the project domain and account access, then reconnect as an administrator.
- **Permission or expired authorization error:** reconnect; do not repeatedly generate drafts from an empty table.
- **Generate drafts unavailable:** select at least one query first.
- **Unexpected market:** remember that target-market selection does not filter Search Console rows. Review and edit the resulting prompts before creation.