Documentation
Connect your marketing data to Claude, ChatGPT and other LLMs.
Full SEO Audit & Algorithm Updates
Two complementary tools available on the GSC Insights page (/gsc/{id}/insights) — they share the same data sources but answer different questions.
1. Full SEO Audit ("Full SEO audit" button, top right)
Multi-prompt AI audit of the property. Runs 30+ specialized prompts in parallel (curated from the open-source claude-seo project, MIT) covering technical SEO, content, schema, Core Web Vitals, backlinks, E-E-A-T, etc.
What gets audited (per category)
| Category | Examples of prompts | Weight in global score |
|---|---|---|
| Technical | sitemap, hreflang, indexability, schema | 20 |
| Content | cluster, programmatic, e-commerce, geo | 20 |
| E-E-A-T | author, trust, expertise signals | 15 |
| CWV | page speed, SXO, performance | 15 |
| Schema | JSON-LD, structured data | 10 |
| Local / Backlinks / Strategy | maps, link profile, competitor pages | 5 each |
Signals collected before the audit runs
- GSC: top 50 queries, top 50 pages, period-vs-period comparison (last 30d vs prior 30d), sitemap status, URL Inspection on the homepage
- Google Safe Browsing: malware/phishing check on the homepage
- PageSpeed Insights mobile: scores + Core Web Vitals + top opportunities
- Homepage HTML fetch: title, H1, meta description, body text, structured data
- Optional (if API keys configured): Firecrawl scrape, DataForSEO backlink data
Run a new audit
- Click "Full SEO audit" (top right, purple button)
- Modal opens — click "Run audit"
- Wait 60-150 seconds (parallel calls in batches of 6 with rate-limiting)
- Get a global score, AI synthesis, detailed cards per prompt
/admin/ai-usage if admin.Modal footer — what the numbers mean
Format: Ran in 122.7s · 249 396 tokens · $0.0234 OpenRouter
- Duration: total wall-clock time including AI batches and synthesis
- Tokens: input + output, summed across all prompts + the final synthesis
- Cost: real USD cost returned by OpenRouter (
usage.costfield) — NOT an estimate
Each prompt card also shows the model used + its individual cost as a small badge next to the prompt name.
Export & share the report
Footer buttons:
- 📋 Copy markdown: full report to clipboard, paste in Notion / Slack / email
- 📥 Download ▾:
.md(UTF-8 with BOM),.docx(via pandoc, with TOC),.pdf(DomPDF, branded cover page + score card) - ✉ Send by email: subject + intro message + attach md/docx/pdf checkboxes
History tab
Last 10 runs per property (auto-pruned beyond that — keeps the DB lean). Click any past run to reload it in the Current tab. Each row shows score, verdict, duration, token count, cost, model.
2. Google Algorithm Updates (chart annotations)
Google releases major algorithm updates 8-15 times a year (Core, Spam, Helpful Content, Reviews, Site Reputation Abuse). They can shift traffic 30-70% on impacted sites. The chart on /gsc/{id}/insights automatically annotates each update that falls within the visible date range.
Visual on the chart
- A color-coded vertical dashed line at the rollout start date (red = Core, orange = Spam, blue = Helpful Content, purple = Reviews, gray = Site Reputation, cyan = other)
- A "G" round badge at the top of the line — clickable
Click the G — what's in the modal
- Type badge + rollout start date → end date (if completed)
- Update name (e.g. "March 2026 core update")
- Sources: where the data was pulled from (Google Status Dashboard, Search Central blog, SE Roundtable, manual seed)
- 5-line French AI summary: What / Targets / Expected impact / Action / Stabilization delay — generated by the same GSC AI model used for SEO audits
- "Comment lire l'impact ?" tip block
- Direct link to Google's official announcement
Where the data comes from
Synced automatically every 24h (cron at 03:30) from 3 sources merged + deduplicated by type + YYYY-MM:
| Source | Why we use it | Confirmed? |
|---|---|---|
| Google Search Status Dashboard | Official, exact rollout dates, primary truth source since late 2024 | Yes |
| Google Search Central blog (RSS) | Official editorial context, longer descriptions | Yes |
| Search Engine Roundtable (RSS) | 3rd party, fast — catches "unconfirmed" volatility events | Only if matched with source 1 or 2 |
FAQ
Why is my Full SEO audit "warning" with score 55 but no obvious problems?
Some prompts are intentionally strict — they want signals you may not have configured yet (Firecrawl scrape, backlink data via DataForSEO). Check the "Skipped" section at the bottom: skipped prompts don't lower the score, but errors do. If you see "skipped — requires Firecrawl key" you can either ignore (the prompt isn't applicable) or configure the key in /admin/general → Integrations (admin only).
Why did the synthesis say "0/X URLs indexed"?
Old bug, fixed. Google's sitemap.contents[].indexed field has been deprecated since 2018 and always returns "0". The audit now strips this field before sending data to the AI + the system prompt forbids any indexation rate claim.
Can I disable specific prompts?
Yes (admin only): /admin/general → Google Search Console tab. Each prompt has an enable/disable toggle. You can also bulk enable/disable by category.
Can I run an audit without affecting my AI quota?
No — audits always count against your monthly token quota. Exception: admins can bypass the per-property cooldown with ?force=1 on the URL for testing, but it still consumes tokens.
How do I add a Google update I know happened but isn't shown?
Two options: (1) wait for the next daily sync if it's a fresh announcement (will likely appear via the Status Dashboard or Search Central RSS), (2) admin can manually edit the HISTORICAL_SEED array in app/Services/GoogleUpdatesSync.php and re-run "Backfill 24m" in /admin/general → GSC tab.
