v0.12.0 — Search Console, seasonality & landing-page speed

AdLoop v0.12.0 — Search Console, seasonality & landing-page speed

Three new capability areas, 64 tools (61 → 64) — and none of the new ones need a single additional OAuth scope beyond Search Console's read scope.

🔍 Google Search Console integration (2 new tools)

Contributed by @ZLeventer (#20, closes #18). list_gsc_sites discovers your Search Console properties; run_gsc_report delivers organic search analytics — clicks, impressions, CTR, and average position by query, page, country, device, or date, with filtering and all search types (web, image, video, news, Discover).

The reason this matters for an ads tool: paid/organic cannibalization. The orchestration rules ship a ready-made pattern — cross-reference organic queries where you rank top-3 against your paid keywords and quantify what you're paying for clicks you'd likely get anyway (with the honest caveats about brand-term incrementality). Plus keyword mining from high-impression/low-position organic queries, and organic-drop diagnosis that cross-references GTM publish history.

Setup: enable the Search Console API in your GCP project. Upgrading OAuth users: one re-auth for the new scope (INSUFFICIENT_SCOPES errors now tell you exactly what to do).

📈 Keyword seasonality — the practical "Google Trends"

discover_keywords(include_monthly_volumes=true) now attaches per-month search volume history (last 24 months, top-20 ideas) — data Keyword Planner always returned and AdLoop previously threw away — plus an automatic seasonality insight naming the peak months when a keyword's demand runs ≥40% above its own average ("'advent calendar' peaks in December at 5.1× its monthly average — plan the ramp-up, not the peak").

Zero new scopes, zero setup. Ask your AI "when does demand for X peak and when should I ramp budget?"

⚡ Landing-page speed: analyze_page_speed

PageSpeed Insights for your ad landing pages: Lighthouse performance score, lab Core Web Vitals (LCP/CLS/TBT/FCP), CrUX field data from real Chrome users (p75 values + FAST/AVERAGE/SLOW ratings) where the page has enough traffic, and the top improvement opportunities ranked by estimated savings.

Slow landing pages depress Quality Score and burn paid clicks before the page renders — now your AI can check that in the same conversation where it sees your CPCs. No OAuth involved; works keyless, or set pagespeed.api_key for stable quota.

🔧 Also in this release

• GTM config defaults: set gtm.account_id / gtm.container_id once and every Tag Manager tool stops asking for IDs (explicit args still win).
• Deployment-aware auth errors: hosted (AdLoop Cloud) users get "reconnect in your dashboard" guidance instead of local token-file advice.
• GSC auth goes through the credentials-provider protocol with its own scope set (multi-tenant safe).

Upgrade

pip install -U adloop
adloop update-rules   # new GSC, seasonality, and page-speed orchestration patterns

---

☁️ All 64 tools are live on AdLoop Cloud — free during beta, two-click Google connect, EU-hosted.