On this page
Your site is live. Google is starting to crawl it. Now connect real search data so Wire can tell you what is working and what is not. This lesson is part of the workshop sequence and feeds directly into improving your content.
Before you start
You need a Google Search Console account with your site verified. If you do not have one yet, go to search.google.com/search-console and add your site. Verification takes a few minutes.
Connect Wire to Search Console
Once your site is verified in Search Console, the whole connection is two commands:
python -m wire.chief gsc-auth # one-time: opens browser, writes token.json
python -m wire.chief data # pulls metrics into .wire/gsc.db
gsc-auth launches the Google OAuth flow in your browser, you grant Wire read-only access, and it drops a token.json next to your wire.yml. You only run it once. After that, data uses the refresh token automatically.
First time through? You need a GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in .env before gsc-auth will run. Creating them is a one-time Google Cloud setup — the full walkthrough (Google Cloud project → enable Search Console API → OAuth consent → Desktop app credentials) lives in the getting started guide. Wire refuses to fall back to anything silent: if the creds are missing, gsc-auth exits loud and tells you exactly what to create.
Tell your agent
Pull search data for my site and run a full audit. Tell me what needs attention.
What happens
- Wire connects to Google Search Console and downloads your ranking data. Every keyword, every page, every position, clicks, and impressions.
- It stores this in a local database (
.wire/gsc.db). This costs nothing and runs in seconds. - Wire audits your site against the search data and gives you a report.
What the audit tells you
The audit groups issues by priority:
- Cannibalization. Two pages compete for the same keyword. Google cannot decide which one to rank, so both lose. Wire recommends merging them.
- Thin content. Pages with fewer than 300 words rarely rank. Wire flags them for expansion.
- Missing metadata. Pages without descriptions or with titles that are too long lose clicks in search results.
- Dead pages. Pages that get zero impressions after weeks. Consider merging them into stronger pages or removing them.
The audit is free. No AI credits, no API calls. It reads the data that is already in your database.
Go deeper
- SEO reference covers thresholds, evidence, and what each metric means
- Analytics integration explains everything Wire does with search data
- Workflow shows where audit fits in the full pipeline