SiteBrief/Documentation

Search Insights

Google Search Console data — clicks, impressions, CTR, average position, and top queries — displayed directly on each site's dashboard page.

ℹ️
Note:Search Insights is a Pro and Agency feature. Connect your Google account once in Integrations — data appears on every site automatically.

What it shows

After connecting Google Search Console, each site detail page shows a Search Insights panel with data from the last 28 days:

MetricWhat it means
ClicksTotal organic clicks from Google Search
ImpressionsHow many times your site appeared in search results
Avg CTRClick-through rate — clicks ÷ impressions
Avg PositionAverage ranking position in search results (lower = better)
AI Insight2-3 sentence plain-English analysis of your search performance, powered by Claude AI
Top QueriesTop 10 search terms driving traffic, with per-query metrics
Top PagesTop 10 landing pages from organic search

A mini chart shows daily clicks and impressions over the last 28 days, so you can spot traffic drops or growth at a glance.

AI Insight

When your site has search data (at least some clicks or impressions), SiteBrief automatically generates an AI Insight— a 2-3 sentence plain-English summary of what's happening with your organic performance.

It looks at your totals, week-over-week trend, top query, and top page, then surfaces what's interesting: whether traffic is growing or dropping, which query is closest to a breakthrough position, and one concrete thing to watch. No bullet points, no dry metrics — it reads like a note from a colleague who just checked your analytics.

💡
Tip:AI Insight only appears when your site has at least some GSC data. Newly verified properties with zero impressions will not show an insight yet.

The insight is generated fresh each time the panel loads. It uses Claude AI (Anthropic) and runs entirely within SiteBrief — no data is sent to third parties other than the Anthropic API.

Setup

One-time setup — takes under 2 minutes:

  • Step 1: Go to Integrations → click Connect Google → authorize with your Google account.
  • Step 2: Make sure the site is verified in Google Search Console under the same Google account.
  • Step 3: Open any site in SiteBrief → scroll to Search Insights. Data loads automatically.
💡
Tip:SiteBrief matches your site URL against your GSC properties automatically — no manual property ID needed. It supports both domain properties (sc-domain:example.com) and URL prefix properties (https://example.com/).

Google Search Console verification

If your site is not yet in GSC, you need to verify ownership first:

  • Go to search.google.com/search-console → Add property
  • Choose Domain (recommended — covers all subdomains and protocols) or URL prefix
  • For domain properties on Cloudflare: Google can add the TXT record automatically via Cloudflare integration
  • After verification, come back to SiteBrief — Search Insights will load on the next page open
⚠️
Warning:GSC data has a 2–3 day delay. Newly verified properties may show no data for the first 24–48 hours while Google processes historical data.

Automatic traffic drop tasks

Every Monday SiteBrief automatically scans GSC data for all your connected sites and compares the last 7 days of clicks to the previous 7 days. If organic traffic dropped by more than 25% (with at least 30 clicks the previous week as a baseline), it creates a task in your Kanban board automatically.

ConditionAction
Traffic dropped >25% week-over-weekTask created with priority: medium
Traffic dropped >50% week-over-weekTask created with priority: high
Same site already has a drop task this weekSkipped — no duplicate
Previous week had fewer than 30 clicksSkipped — not enough data

The task title is 📉 Organic traffic dropped X% this week — site name, the description includes the click numbers, the top query and position, and a note to check recent deploys or algorithm updates.

💡
Tip:You can find auto-created tasks in the Tasks section — they are tagged with source ai so you can filter them separately from manually created tasks.

Data freshness

Search Insights fetches live data from the GSC API each time you open the site page — no caching. Google Search Console data itself is typically delayed by 2–3 days, so the most recent dates in the chart may show lower numbers until Google finalizes them.

I connected Google but see "Site not found in Search Console"
Make sure the site is verified in GSC under the same Google account you connected. The site URL in SiteBrief must match the property URL in GSC (e.g. https://example.com must match sc-domain:example.com or https://example.com/).
I see zeros for clicks and impressions
This is normal for newly verified properties. GSC data takes 24–48 hours to appear after verification, and historical data can take up to 3 days to process fully.
Can I connect multiple Google accounts?
Currently one Google account per SiteBrief account. All your GSC properties under that account are automatically matched to your monitored sites.
Does this work for subdomains?
Yes — if you have a domain property (sc-domain:example.com) in GSC it covers all subdomains. URL prefix properties (https://sub.example.com/) only cover that specific subdomain.
Is my Google data shared with anyone?
No. SiteBrief reads GSC data using your OAuth token and displays it only to you. No data is stored — it is fetched fresh from the API each time.
How does the AI Insight work?
After loading your GSC data, SiteBrief sends aggregated metrics (totals, week-over-week trend, top query, top page) to Claude AI (Anthropic) to generate a short plain-English summary. Your full query list and page URLs are not sent — only the top-level numbers. The insight is generated on demand each time the panel opens.
The AI Insight does not appear — why?
AI Insight only shows when your site has at least some clicks or impressions in the last 28 days. If both are zero (e.g. a brand-new GSC property), the insight is skipped. It will appear automatically once Google starts reporting data.