synabun 1.3.0 → 2.0.0-beta

package/mcp-server/dist/tools/gsc/experience.d.ts

@@ -0,0 +1,135 @@
+/**
+ * GSC Experience + Enhancements + Links.
+ * Tools: gsc_cwv_report, gsc_https_report, gsc_security_issues,
+ *        gsc_manual_actions, gsc_enhancements, gsc_links_report, gsc_links_export
+ */
+import { z } from 'zod';
+export declare const gscCwvReportSchema: {
+    device: z.ZodEnum<["mobile", "desktop"]>;
+    property: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    tabId: z.ZodOptional<z.ZodString>;
+};
+export declare const gscCwvReportDescription = "Read Core Web Vitals report for mobile or desktop. Returns counts of poor / needs-improvement / good URLs and per-issue URL group examples.";
+export declare function handleGscCwvReport(args: {
+    device: string;
+    property?: string;
+    sessionId?: string;
+    tabId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const gscHttpsReportSchema: {
+    property: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    tabId: z.ZodOptional<z.ZodString>;
+};
+export declare const gscHttpsReportDescription = "Read the HTTPS report \u2014 counts of HTTPS vs non-HTTPS URLs and reasons for non-HTTPS URLs with examples.";
+export declare function handleGscHttpsReport(args: {
+    property?: string;
+    sessionId?: string;
+    tabId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const gscSecurityIssuesSchema: {
+    action: z.ZodOptional<z.ZodEnum<["list", "request_review"]>>;
+    property: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    tabId: z.ZodOptional<z.ZodString>;
+};
+export declare const gscSecurityIssuesDescription = "Read Security Issues. action=list returns active + history. action=request_review clicks \"Request review\" (mutating, requires fixed issues).";
+export declare function handleGscSecurityIssues(args: {
+    action?: string;
+    property?: string;
+    sessionId?: string;
+    tabId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const gscManualActionsSchema: {
+    action: z.ZodOptional<z.ZodEnum<["list", "reconsideration"]>>;
+    body: z.ZodOptional<z.ZodString>;
+    property: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    tabId: z.ZodOptional<z.ZodString>;
+};
+export declare const gscManualActionsDescription = "Read Manual Actions. action=list returns penalties (or \"No issues detected\"). action=reconsideration submits a reconsideration request with `body` (mutating).";
+export declare function handleGscManualActions(args: {
+    action?: string;
+    body?: string;
+    property?: string;
+    sessionId?: string;
+    tabId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const gscEnhancementsSchema: {
+    report: z.ZodEnum<[string, ...string[]]>;
+    property: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    tabId: z.ZodOptional<z.ZodString>;
+};
+export declare const gscEnhancementsDescription: string;
+export declare function handleGscEnhancements(args: {
+    report: string;
+    property?: string;
+    sessionId?: string;
+    tabId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const gscLinksReportSchema: {
+    section: z.ZodEnum<["top_linked_external", "top_linking_sites", "top_linking_text", "top_linked_internal"]>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    property: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    tabId: z.ZodOptional<z.ZodString>;
+};
+export declare const gscLinksReportDescription = "Read a Links report section. top_linked_external / top_linking_sites / top_linking_text / top_linked_internal. Returns full table.";
+export declare function handleGscLinksReport(args: {
+    section: string;
+    limit?: number;
+    property?: string;
+    sessionId?: string;
+    tabId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const gscLinksExportSchema: {
+    scope: z.ZodEnum<["external", "internal", "sample_external", "sample_internal"]>;
+    property: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    tabId: z.ZodOptional<z.ZodString>;
+};
+export declare const gscLinksExportDescription = "Trigger Links report Export menu. Browser handles file download.";
+export declare function handleGscLinksExport(args: {
+    scope: string;
+    property?: string;
+    sessionId?: string;
+    tabId?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=experience.d.ts.map

package/mcp-server/dist/tools/gsc/experience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experience.d.ts","sourceRoot":"","sources":["../../../src/tools/gsc/experience.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB,eAAO,MAAM,kBAAkB;;;;;CAK9B,CAAC;AAEF,eAAO,MAAM,uBAAuB,gJAC2G,CAAC;AAEhJ,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GA+BvH;AAID,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAC;AAEF,eAAO,MAAM,yBAAyB,iHACqE,CAAC;AAE5G,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GA8CzG;AAID,eAAO,MAAM,uBAAuB;;;;;CAKnC,CAAC;AAEF,eAAO,MAAM,4BAA4B,mJACuG,CAAC;AAEjJ,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GAsB7H;AAID,eAAO,MAAM,sBAAsB;;;;;;CAMlC,CAAC;AAEF,eAAO,MAAM,2BAA2B,qKAC0H,CAAC;AAEnK,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GAsC3I;AAwBD,eAAO,MAAM,qBAAqB;;;;;CAKjC,CAAC;AAEF,eAAO,MAAM,0BAA0B,QACgI,CAAC;AAExK,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GAuE1H;AAID,eAAO,MAAM,oBAAoB;;;;;;CAMhC,CAAC;AAEF,eAAO,MAAM,yBAAyB,uIACgG,CAAC;AAEvI,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GA0D1I;AAID,eAAO,MAAM,oBAAoB;;;;;CAKhC,CAAC;AAEF,eAAO,MAAM,yBAAyB,qEAC8B,CAAC;AAErE,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GAuBxH"}

package/mcp-server/dist/tools/gsc/experience.js

@@ -0,0 +1,351 @@
+/**
+ * GSC Experience + Enhancements + Links.
+ * Tools: gsc_cwv_report, gsc_https_report, gsc_security_issues,
+ *        gsc_manual_actions, gsc_enhancements, gsc_links_report, gsc_links_export
+ */
+import { z } from 'zod';
+import * as ni from '../../services/neural-interface.js';
+import { text } from '../response.js';
+import { GSC_BASE, encodeProperty, currentProperty, ensureAuth, resolve, wait, pollFor, safeNavigate, TABLE_EXTRACTOR_SCRIPT, readMetricTileScript } from './helpers.js';
+const tabId = z.string().optional();
+async function loadAndExtract(sessionId, tabIdArg, property, path) {
+    const r = await resolve(sessionId, tabIdArg);
+    if ('error' in r)
+        return { err: r.error, r: null };
+    const prop = property || (await currentProperty(r));
+    if (!prop)
+        return { err: 'No active property.', r };
+    const sep = path.includes('?') ? '&' : '?';
+    const nav = await safeNavigate(r, `${GSC_BASE}${path}${sep}resource_id=${encodeProperty(prop)}`);
+    if (nav.error)
+        return { err: `Navigation failed: ${nav.error}`, r };
+    const authErr = await ensureAuth(r);
+    if (authErr)
+        return { err: authErr, r };
+    await pollFor(r, `(() => document.body.innerText.length > 200 ? true : null)()`, 20000, 500);
+    await wait(700);
+    return { err: null, r };
+}
+// ── gsc_cwv_report ────────────────────────────────────────────
+export const gscCwvReportSchema = {
+    device: z.enum(['mobile', 'desktop']),
+    property: z.string().optional(),
+    sessionId: z.string().optional(),
+    tabId,
+};
+export const gscCwvReportDescription = 'Read Core Web Vitals report for mobile or desktop. Returns counts of poor / needs-improvement / good URLs and per-issue URL group examples.';
+export async function handleGscCwvReport(args) {
+    const path = args.device === 'desktop' ? '/core-web-vitals?device=DESKTOP' : '/core-web-vitals?device=MOBILE';
+    const { err, r } = await loadAndExtract(args.sessionId, args.tabId, args.property, path);
+    if (err)
+        return text(err);
+    const noData = await ni.evaluate(r.sessionId, `(() => /Nenhum dado|No data|No CWV data/i.test(document.body.innerText) && !document.querySelector('[role="grid"], [role="table"]'))()`, r.tabId);
+    if (noData.result) {
+        return text(JSON.stringify({ device: args.device, summary: { poor: '0', needsImprovement: '0', good: '0' }, issues: { headers: [], rows: [] }, status: 'no_data' }, null, 2));
+    }
+    const [poorRes, niRes, goodRes, tableRes] = await Promise.all([
+        ni.evaluate(r.sessionId, readMetricTileScript('poor'), r.tabId),
+        ni.evaluate(r.sessionId, readMetricTileScript('needsImprovement'), r.tabId),
+        ni.evaluate(r.sessionId, readMetricTileScript('good'), r.tabId),
+        ni.evaluate(r.sessionId, TABLE_EXTRACTOR_SCRIPT('[role="grid"], [role="table"], table'), r.tabId),
+    ]);
+    const summary = {
+        poor: poorRes.result ?? null,
+        needsImprovement: niRes.result ?? null,
+        good: goodRes.result ?? null,
+    };
+    // Distinguish "no data" (caught above) from "parse failed" — when the
+    // tile reader missed every metric AND no grid rendered, surface that.
+    if (summary.poor === null && summary.needsImprovement === null && summary.good === null && !tableRes.result) {
+        return text(JSON.stringify({ device: args.device, summary, issues: { headers: [], rows: [] }, status: 'parse_failed' }, null, 2));
+    }
+    return text(JSON.stringify({ device: args.device, summary, issues: tableRes.result || { headers: [], rows: [] } }, null, 2));
+}
+// ── gsc_https_report ──────────────────────────────────────────
+export const gscHttpsReportSchema = {
+    property: z.string().optional(),
+    sessionId: z.string().optional(),
+    tabId,
+};
+export const gscHttpsReportDescription = 'Read the HTTPS report — counts of HTTPS vs non-HTTPS URLs and reasons for non-HTTPS URLs with examples.';
+export async function handleGscHttpsReport(args) {
+    const { err, r } = await loadAndExtract(args.sessionId, args.tabId, args.property, '/https');
+    if (err)
+        return text(err);
+    // The HTTPS report often shows a tiny per-row table with HTTPS / Não HTTPS
+    // headers — read counts directly from the row instead of grepping body text.
+    const summary = await ni.evaluate(r.sessionId, `(() => {
+      const cells = Array.from(document.querySelectorAll('th, td, [role="columnheader"], [role="gridcell"], [role="cell"]'));
+      let httpsUrls = null, nonHttpsUrls = null;
+      const norm = (el) => (el.innerText || el.textContent || '').trim();
+      for (let i = 0; i < cells.length; i++) {
+        const t = norm(cells[i]);
+        if (/^HTTPS$/i.test(t)) {
+          // The number is usually in the next sibling column or row.
+          const sib = cells[i + 1] || cells[i].parentElement?.nextElementSibling?.querySelector('td, [role="gridcell"]');
+          if (sib) {
+            const m = norm(sib).match(/-?\\d[\\d.,]*/);
+            if (m) httpsUrls = m[0];
+          }
+        }
+        if (/^(Non[- ]?HTTPS|N[aã]o\\s*HTTPS|HTTP)$/i.test(t)) {
+          const sib = cells[i + 1] || cells[i].parentElement?.nextElementSibling?.querySelector('td, [role="gridcell"]');
+          if (sib) {
+            const m = norm(sib).match(/-?\\d[\\d.,]*/);
+            if (m) nonHttpsUrls = m[0];
+          }
+        }
+      }
+      return { httpsUrls, nonHttpsUrls };
+    })()`, r.tabId);
+    let s = summary.result || { httpsUrls: null, nonHttpsUrls: null };
+    if (s.httpsUrls === null && s.nonHttpsUrls === null) {
+        const [hRes, nRes] = await Promise.all([
+            ni.evaluate(r.sessionId, readMetricTileScript('httpsUrls'), r.tabId),
+            ni.evaluate(r.sessionId, readMetricTileScript('nonHttpsUrls'), r.tabId),
+        ]);
+        s = {
+            httpsUrls: hRes.result ?? null,
+            nonHttpsUrls: nRes.result ?? null,
+        };
+    }
+    const tableRes = await ni.evaluate(r.sessionId, TABLE_EXTRACTOR_SCRIPT('[role="grid"], [role="table"], table'), r.tabId);
+    return text(JSON.stringify({ summary: s, reasons: tableRes.result || { headers: [], rows: [] } }, null, 2));
+}
+// ── gsc_security_issues ───────────────────────────────────────
+export const gscSecurityIssuesSchema = {
+    action: z.enum(['list', 'request_review']).optional().describe('list (default) returns active issues; request_review submits a reconsideration request.'),
+    property: z.string().optional(),
+    sessionId: z.string().optional(),
+    tabId,
+};
+export const gscSecurityIssuesDescription = 'Read Security Issues. action=list returns active + history. action=request_review clicks "Request review" (mutating, requires fixed issues).';
+export async function handleGscSecurityIssues(args) {
+    const { err, r } = await loadAndExtract(args.sessionId, args.tabId, args.property, '/security-issues');
+    if (err)
+        return text(err);
+    const action = args.action || 'list';
+    if (action === 'request_review') {
+        const click = await ni.evaluate(r.sessionId, `(() => { const btns = Array.from(document.querySelectorAll('button, [role="button"]')); const req = btns.find(b => /request\\s*review|solicitar\\s*revisão/i.test(b.textContent || '')); if (req) { req.click(); return true; } return false; })()`, r.tabId);
+        if (!click.result)
+            return text('Request review button not found — no fixable issues, or review already pending.');
+        return text('Review request flow opened. Use browser_snapshot to inspect form, then submit via browser_click.');
+    }
+    const issues = await ni.evaluate(r.sessionId, `(() => {
+      const cards = Array.from(document.querySelectorAll('section, [role="region"], .issue-card'));
+      return cards.map(c => c.innerText.trim().replace(/\\s+/g, ' ').slice(0, 600)).filter(t => t.length > 20);
+    })()`, r.tabId);
+    return text(JSON.stringify({ issues: issues.result || [] }, null, 2));
+}
+// ── gsc_manual_actions ────────────────────────────────────────
+export const gscManualActionsSchema = {
+    action: z.enum(['list', 'reconsideration']).optional(),
+    body: z.string().optional().describe('Reconsideration request body text. Required for action=reconsideration.'),
+    property: z.string().optional(),
+    sessionId: z.string().optional(),
+    tabId,
+};
+export const gscManualActionsDescription = 'Read Manual Actions. action=list returns penalties (or "No issues detected"). action=reconsideration submits a reconsideration request with `body` (mutating).';
+export async function handleGscManualActions(args) {
+    const { err, r } = await loadAndExtract(args.sessionId, args.tabId, args.property, '/manual-actions');
+    if (err)
+        return text(err);
+    const action = args.action || 'list';
+    if (action === 'reconsideration') {
+        if (!args.body)
+            return text('body required for reconsideration.');
+        await ni.evaluate(r.sessionId, `(() => { const btns = Array.from(document.querySelectorAll('button, [role="button"]')); const req = btns.find(b => /request\\s*review|solicitar\\s*reconsider/i.test(b.textContent || '')); if (req) req.click(); })()`, r.tabId);
+        await wait(1500);
+        await ni.evaluate(r.sessionId, `(() => { const ta = document.querySelector('textarea'); if (ta) { ta.focus(); ta.value = ${JSON.stringify(args.body)}; ta.dispatchEvent(new Event('input', { bubbles: true })); } })()`, r.tabId);
+        await wait(400);
+        await ni.evaluate(r.sessionId, `(() => { const btns = Array.from(document.querySelectorAll('button, [role="button"]')); const sub = btns.find(b => /^(submit|enviar)$/i.test((b.textContent || '').trim())); if (sub) sub.click(); })()`, r.tabId);
+        return text('Reconsideration request submitted (verify with browser_snapshot).');
+    }
+    const issues = await ni.evaluate(r.sessionId, `(() => {
+      const main = document.querySelector('[role="main"], main') || document.body;
+      const txt = (main.innerText || '');
+      return {
+        status: /no\\s*issues|nenhum\\s*problema/i.test(txt) ? 'clean' : 'issues_present',
+        text: txt.slice(0, 4000),
+      };
+    })()`, r.tabId);
+    return text(JSON.stringify(issues.result, null, 2));
+}
+// ── gsc_enhancements ──────────────────────────────────────────
+const ENHANCE_PATHS = {
+    breadcrumbs: '/r/breadcrumbs',
+    faq: '/r/faq',
+    sitelinks: '/r/sitelinks-search-box',
+    videos: '/r/videos',
+    products: '/r/product-snippets',
+    recipes: '/r/recipes',
+    review: '/r/review-snippets',
+    events: '/r/events',
+    jobposting: '/r/job-postings',
+    speakable: '/r/speakable',
+    qa: '/r/q-a',
+    logos: '/r/logos',
+    sitenames: '/r/sitenames',
+    dataset: '/r/dataset',
+    practice: '/r/practice-problems',
+    math: '/r/math-solvers',
+    merchant: '/r/merchant-listings',
+};
+export const gscEnhancementsSchema = {
+    report: z.enum(Object.keys(ENHANCE_PATHS)),
+    property: z.string().optional(),
+    sessionId: z.string().optional(),
+    tabId,
+};
+export const gscEnhancementsDescription = `Read a structured-data Enhancements report. Returns valid / warnings / errors counts and per-issue URL examples. Reports: ${Object.keys(ENHANCE_PATHS).join(', ')}.`;
+export async function handleGscEnhancements(args) {
+    const path = ENHANCE_PATHS[args.report];
+    if (!path)
+        return text(`Unknown enhancement report: ${args.report}`);
+    const { err, r } = await loadAndExtract(args.sessionId, args.tabId, args.property, path);
+    if (err)
+        return text(err);
+    // Scope summary tile reads to the top-of-report metric region so we don't
+    // catch numbers from issue rows (which include "5xx" / "500", etc).
+    const summaryRes = await ni.evaluate(r.sessionId, `(() => {
+      const main = document.querySelector('[role="main"], main') || document.body;
+      // Find a region above the issues grid that contains the chart + tiles.
+      const grid = main.querySelector('[role="grid"], [role="table"], table');
+      const allRegions = Array.from(main.querySelectorAll('section, [role="region"], [role="group"], div'));
+      // Prefer a region that contains a chart (canvas/svg) AND comes before the grid.
+      let scope = null;
+      for (const region of allRegions) {
+        if (!region.querySelector('canvas, svg')) continue;
+        if (grid && (region.contains(grid) || region.compareDocumentPosition(grid) & Node.DOCUMENT_POSITION_FOLLOWING)) {
+          scope = region;
+          break;
+        }
+      }
+      // Fallback: the first heading group that mentions valid/warning/error.
+      if (!scope) {
+        const headings = Array.from(main.querySelectorAll('h2, h3, [role="heading"]'));
+        const h = headings.find(x => /valid|aviso|warning|erro|error/i.test(x.textContent || ''));
+        if (h) scope = h.closest('section, [role="region"], div') || h.parentElement;
+      }
+      if (!scope) scope = main;
+      const txt = (scope.innerText || '').replace(/\\s+/g, ' ');
+      // Inline label-to-number readers — replicate readMetricTileScript scope-bound.
+      const labels = {
+        valid: ${JSON.stringify(['Valid', 'Válido', 'Válidos', 'Válidas', 'Itens válidos', 'Entidades válidas'])},
+        warnings: ${JSON.stringify(['Warning', 'Warnings', 'Aviso', 'Avisos'])},
+        errors: ${JSON.stringify(['Error', 'Errors', 'Erro', 'Erros', 'Entidades inválidas'])},
+      };
+      const numRe = /-?\\d[\\d.,]*/;
+      const findFor = (alts) => {
+        const alt = alts.slice().sort((a,b) => b.length - a.length).map(s => s.replace(/[.*+?^\${}()|[\\]\\\\]/g, '\\\\$&')).join('|');
+        const exact = new RegExp('^\\\\s*(?:' + alt + ')\\\\s*[:：]?\\\\s*$', 'i');
+        const re = new RegExp(alt, 'i');
+        const candidates = Array.from(scope.querySelectorAll('div, span, p, dt, label, h2, h3, td, th'));
+        const exacts = candidates.filter(n => exact.test((n.textContent || '').trim()));
+        const fallback = candidates.filter(n => re.test(n.textContent || ''));
+        const nodes = exacts.length ? exacts : fallback.slice(0, 6);
+        for (const node of nodes) {
+          let cur = node;
+          for (let depth = 0; cur && depth < 6; depth++, cur = cur.parentElement) {
+            const t = (cur.innerText || cur.textContent || '');
+            if (re.test(t) && numRe.test(t)) {
+              const stripped = t.replace(re, ' ');
+              const m = stripped.match(numRe);
+              if (m) return m[0].trim();
+            }
+          }
+        }
+        return null;
+      };
+      return {
+        valid: findFor(labels.valid),
+        warnings: findFor(labels.warnings),
+        errors: findFor(labels.errors),
+      };
+    })()`, r.tabId);
+    const tableRes = await ni.evaluate(r.sessionId, TABLE_EXTRACTOR_SCRIPT('[role="grid"], [role="table"], table'), r.tabId);
+    const summary = summaryRes.result
+        || { valid: null, warnings: null, errors: null };
+    return text(JSON.stringify({ report: args.report, summary, issues: tableRes.result || { headers: [], rows: [] } }, null, 2));
+}
+// ── gsc_links_report ──────────────────────────────────────────
+export const gscLinksReportSchema = {
+    section: z.enum(['top_linked_external', 'top_linking_sites', 'top_linking_text', 'top_linked_internal']),
+    limit: z.coerce.number().int().positive().optional().describe('Max rows to scroll-load (default 100).'),
+    property: z.string().optional(),
+    sessionId: z.string().optional(),
+    tabId,
+};
+export const gscLinksReportDescription = 'Read a Links report section. top_linked_external / top_linking_sites / top_linking_text / top_linked_internal. Returns full table.';
+export async function handleGscLinksReport(args) {
+    const { err, r } = await loadAndExtract(args.sessionId, args.tabId, args.property, '/links');
+    if (err)
+        return text(err);
+    const sectionLabels = {
+        top_linked_external: /Top linked pages|Páginas mais vinculadas/i,
+        top_linking_sites: /Top linking sites|Sites com mais links/i,
+        top_linking_text: /Top linking text|Texto âncora mais comum/i,
+        top_linked_internal: /Internally linked|Páginas com links internos/i,
+    };
+    const re = sectionLabels[args.section];
+    // Each section has a "more" link; click it to navigate to the full-table view.
+    await ni.evaluate(r.sessionId, `(() => {
+      const cards = Array.from(document.querySelectorAll('section, [role="region"], div'));
+      const card = cards.find(c => ${re.toString()}.test(c.textContent || ''));
+      if (card) {
+        const more = card.querySelector('a, button, [role="link"], [role="button"]');
+        if (more && /more|mais/i.test(more.textContent || '')) more.click();
+      }
+    })()`, r.tabId);
+    // Wait for navigation to a drilldown URL OR for a single full-page grid
+    // with rows to appear. Without this, extraction races the overview cards.
+    await pollFor(r, `(() => {
+      if (/\\/links\\/(?:drilldown|details|external)/.test(location.pathname + location.search)) return true;
+      const main = document.querySelector('[role="main"], main') || document.body;
+      const grids = main.querySelectorAll('[role="grid"], [role="table"], table');
+      // Drilldown view typically has exactly one grid with > 1 row.
+      if (grids.length === 1) {
+        const rows = grids[0].querySelectorAll('[role="row"]:not(:has([role="columnheader"])), tbody tr');
+        if (rows.length > 0) return true;
+      }
+      return null;
+    })()`, 8000, 400);
+    const limit = args.limit ?? 100;
+    for (let i = 0; i < 8; i++) {
+        const count = await ni.evaluate(r.sessionId, `(() => document.querySelectorAll('[role="main"] [role="grid"] [role="row"], [role="main"] [role="table"] tr, main [role="grid"] [role="row"], main [role="table"] tr').length)()`, r.tabId);
+        if (Number(count.result || 0) >= limit)
+            break;
+        await ni.scroll(r.sessionId, { direction: 'down', distance: 1500 }, r.tabId);
+        await wait(600);
+    }
+    const tableRes = await ni.evaluate(r.sessionId, TABLE_EXTRACTOR_SCRIPT('[role="main"] [role="grid"], [role="main"] [role="table"], main [role="grid"], main [role="table"]'), r.tabId);
+    const t = (tableRes.result || { headers: [], rows: [] });
+    t.rows = t.rows.slice(0, limit);
+    return text(JSON.stringify({ section: args.section, table: t }, null, 2));
+}
+// ── gsc_links_export ──────────────────────────────────────────
+export const gscLinksExportSchema = {
+    scope: z.enum(['external', 'internal', 'sample_external', 'sample_internal']).describe('Export scope from the Links report Export menu.'),
+    property: z.string().optional(),
+    sessionId: z.string().optional(),
+    tabId,
+};
+export const gscLinksExportDescription = 'Trigger Links report Export menu. Browser handles file download.';
+export async function handleGscLinksExport(args) {
+    const { err, r } = await loadAndExtract(args.sessionId, args.tabId, args.property, '/links');
+    if (err)
+        return text(err);
+    await ni.evaluate(r.sessionId, `(() => { const btns = Array.from(document.querySelectorAll('button, [role="button"]')); const exp = btns.find(b => /export\\s*external\\s*links|exportar\\s*links\\s*externos/i.test(b.textContent || '') || /^export$|^exportar$/i.test((b.textContent || '').trim())); if (exp) exp.click(); })()`, r.tabId);
+    await wait(800);
+    const labels = {
+        external: /external links|links externos/i,
+        internal: /internal links|links internos/i,
+        sample_external: /sample.*external|amostra.*externos/i,
+        sample_internal: /sample.*internal|amostra.*internos/i,
+    };
+    const re = labels[args.scope];
+    await ni.evaluate(r.sessionId, `(() => { const items = Array.from(document.querySelectorAll('[role="menuitem"], a, button')); const t = items.find(i => ${re.toString()}.test(i.textContent || '')); if (t) t.click(); })()`, r.tabId);
+    await wait(2000);
+    return text(`Links export triggered: ${args.scope}. Download in browser default dir.`);
+}
+//# sourceMappingURL=experience.js.map

package/mcp-server/dist/tools/gsc/experience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experience.js","sourceRoot":"","sources":["../../../src/tools/gsc/experience.ts"],"names":[],"mappings":"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"}

package/mcp-server/dist/tools/gsc/helpers.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Google Search Console — shared helpers.
+ *
+ * GSC paths use English slugs regardless of UI locale; selectors prefer
+ * material-icon ligatures, stable aria roles, and structural anchors over
+ * translated label text. The locale dictionary below centralises label
+ * matching across en + pt-BR so report parsers stay locale-tolerant.
+ */
+export declare const GSC_BASE = "https://search.google.com/search-console";
+export type Resolved = {
+    sessionId: string;
+    tabId?: string;
+};
+export declare function wait(ms: number): Promise<void>;
+export declare function resolve(sessionId?: string, tabId?: string, autoCreate?: boolean): Promise<Resolved | {
+    error: string;
+}>;
+/** URL-encoded `resource_id` segment for use in any GSC URL. */
+export declare function encodeProperty(property: string): string;
+/**
+ * Read the current property from the URL bar (`?resource_id=…`).
+ * Returns null if not on a GSC page or property missing.
+ */
+export declare function currentProperty(r: Resolved): Promise<string | null>;
+/**
+ * Build a GSC URL for `path` keeping the active `resource_id` in the query.
+ * Pass an explicit `property` to override.
+ */
+export declare function gscUrl(r: Resolved, path: string, property?: string): Promise<string>;
+/**
+ * Verify session is on accounts.google.com — caller must be signed in.
+ * Returns error string if redirected to login, otherwise null.
+ */
+export declare function ensureAuth(r: Resolved): Promise<string | null>;
+/**
+ * Poll a JS predicate every `interval` ms until it returns truthy.
+ * `script` MUST evaluate to JSON-serializable value; truthy → success,
+ * `null`/`undefined`/`false` → keep polling. Returns last value or null on timeout.
+ */
+export declare function pollFor<T = unknown>(r: Resolved, script: string, timeoutMs?: number, interval?: number): Promise<T | null>;
+export declare const LOCALE_LABELS: Record<string, string[]>;
+/** Build a single combined regex (case-insensitive) matching any locale form for `key`. */
+export declare function metricRegex(key: keyof typeof LOCALE_LABELS | string): RegExp;
+/**
+ * Build a JS source string that finds a metric tile by label and returns
+ * the FIRST numeric value within the tile (not all numbers in the parent).
+ *
+ * The tile is detected by walking up from the matched label node to the
+ * smallest ancestor that also contains a numeric child — which mirrors the
+ * GSC metric-card structure (label + big number stacked).
+ */
+export declare function readMetricTileScript(key: keyof typeof LOCALE_LABELS | string): string;
+/**
+ * Extract a GSC accessibility-tree grid as `{ headers, rows }`.
+ * `scopeSelector` should target a `[role="grid"]` or its container.
+ *
+ * - Strips nested tooltip/icon text from header cells (GSC often inlines a
+ *   help-icon tooltip into the column header textContent).
+ * - Header fallback: when no `[role="columnheader"]`/`th` exists, treats the
+ *   first body row as the header row (some report tables are pure tr-based).
+ * - List fallback: when no grid/table is found, attempts to extract rows from
+ *   `[role="listitem"]`/`mat-list-item`/`li` cards in the scope.
+ */
+export declare const TABLE_EXTRACTOR_SCRIPT: (scope: string) => string;
+/**
+ * Navigate with a one-time retry on Playwright timeout. GSC's first paint
+ * occasionally exceeds the underlying 15s `domcontentloaded` budget; a
+ * second attempt almost always succeeds.
+ */
+export declare function safeNavigate(r: Resolved, url: string): Promise<{
+    error?: string;
+}>;
+/** Click a sidebar nav item by its material-icon ligature (locale-independent). */
+export declare function clickSidebarIcon(r: Resolved, iconText: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=helpers.d.ts.map

package/mcp-server/dist/tools/gsc/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/gsc/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,QAAQ,6CAA6C,CAAC;AAEnE,MAAM,MAAM,QAAQ,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAsB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED,wBAAsB,OAAO,CAC3B,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,UAAO,GAChB,OAAO,CAAC,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAIvC;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQzE;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1F;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOpE;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,CAAC,GAAG,OAAO,EACvC,CAAC,EAAE,QAAQ,EACX,MAAM,EAAE,MAAM,EACd,SAAS,SAAQ,EACjB,QAAQ,SAAM,GACb,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAanB;AAOD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA6BlD,CAAC;AAMF,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,OAAO,aAAa,GAAG,MAAM,GAAG,MAAM,CAM5E;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,OAAO,aAAa,GAAG,MAAM,GAAG,MAAM,CA4BrF;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,WA2D7C,CAAC;AAER;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAOxF;AAED,mFAAmF;AACnF,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiB9G"}