Documentație · 05

Integrări native + export, formatele care contează.

Aplicația se integrează direct cu Google Search Console, Bing Webmaster, PageSpeed Insights pentru date reale de la utilizatori. Export multi-format (PDF / Excel / Word / CSV / JSON) pentru rapoarte client. Automatizări via Zapier / Make / n8n pentru workflow-uri repetitive.

Conținut în extindere: tutorial cu screenshots OAuth flow, template-uri export, exemple Zapier / Make / n8n se publică la lansarea publică v1.0. Pagina actuală oferă overview integrări + format-uri export disponibile.

Integrare Google Search Console

Integrarea cea mai utilă din aplicație. OAuth flow standard, conexiune o singură dată per Google account, refresh token criptat local.

Ce date import-ează:

  • Performance: queries, click-uri, impresii, CTR, poziție medie pe ultimele 16 luni (limita maximă GSC API).
  • Coverage: pagini indexate, errors, warnings, excluded.
  • Core Web Vitals: date reale CrUX pentru pagini cu trafic.
  • Sitemaps submitted: status, last fetch, errors.

Refresh date: la pornire aplicație + manual din button „Refresh GSC”. Date stocate local în baza SQLite — interogabile offline ulterior.

Integrare Bing Webmaster Tools

Similar cu GSC dar pentru Bing. OAuth flow + import queries + indexed pages + crawl errors. Volumul date e mai mic decât GSC (Bing are ~3% market share global, ~5% în RO), dar valoros pentru: 1) cross-validation date GSC, 2) descoperire queries pe care Google nu le arată (Bing returnează queries cu impresii sub 10), 3) monitor Bing AI / Copilot citation patterns.

Integrare PageSpeed Insights

API Google PSI v5 pentru lab data Lighthouse + field data CrUX. Rulare automată săptămânală pe toate paginile importante (top 50 după trafic), tracking trend pe ultimele 12 săptămâni.

Notă: PSI API are rate limits (25.000 queries/zi free) — pentru site-uri cu 10.000+ pagini sub monitor, recomandăm Pagespeed cu API key proprie (Google Cloud Console).

Export rapoarte multi-format

5 format-uri suportate, fiecare optimizat pentru caz de utilizare specific:

  • PDF: pentru clientul final. Branding personalizat (logo client / agenție în antet), executive summary la început, detalii tehnice la sfârșit. Format profesional, gata de trimis prin email.
  • Excel (.xlsx): pentru analiști. Sheet-uri separate per categorie (Audit issues, Keywords, Backlinks, CWV history). Formule pre-setate pentru calcule custom.
  • Word (.docx): pentru consultants care editează raportul cu comentarii proprii înainte de livrare client. Template editabil, headere consistente, table of contents auto-generat.
  • CSV: pentru import în alte tool-uri (Google Sheets, Looker Studio, BI custom). Un fișier per categorie de date.
  • JSON: pentru automatizări programmatice. Format complet structurat, schema documentat public, importabil în orice script Python / Node / Go.

Automatizări via Zapier / Make / n8n

Aplicația desktop nu expune API REST direct (e local-first), dar suportă export automat pe schedule + watch folder triggers. Exemple workflow-uri:

  • Săptămânal: aplicația exportă raport Excel automat lunea dimineața → folder Dropbox sync → Zapier detectează fișier nou → trimite email către client.
  • Pe Critical issue: audit detectează problemă Critical (ex: noindex accidental pe homepage) → aplicația scrie alert JSON într-un folder watch → n8n trigger → Slack notification către echipă.
  • Lunar: aplicația rulează audit complet → exportă PDF brand → Make ridică PDF → upload în Google Drive client folder → email link client.

Tutorial-uri concrete cu workflow-uri Zapier / Make / n8n + template-uri JSON se publică la lansarea publică v1.0.

Integrări planificate (post-v1.0)

Roadmap public, prioritizate după cererea utilizatorilor:

  • Google Analytics 4 (Q3 2026): import metric-uri trafic + conversie pentru a corela cu rank-uri SEO.
  • Looker Studio data connector (Q4 2026): direct connector pentru dashboards live.
  • Slack notifications (Q3 2026): alert nativ fără Zapier intermediate.
  • Webhooks (Q4 2026): triggers pentru integrări custom.
  • Notion / Coda export (2027): pentru consultanți care țin client docs în acele tool-uri.

Ce NU plănuim integrare directă (și de ce)

  • Ahrefs / SEMrush API: ar însemna să cerem cheile lor + să transmitem date prin platformele lor. Contradicție cu local-first. Folosești ambele tool-uri separat dacă ai nevoie.
  • WordPress plugin: aplicația desktop e separată de site-ul tău; plugin-ul ar însemna code intrusive în WP. Mai bine: export schema markup din aplicație → paste în Yoast / RankMath.
  • Browser extension: out-of-scope pentru desktop app. Dacă vine cerere semnificativă, considerăm la v2.0.

Integrări native esențiale, restul prin export.

Filosofia: integrări directe doar cu surse de date primary (GSC, Bing, PSI). Pentru restul (analytics, BI, notifications, automation), export → consume în tool-ul tău preferat.