webmaster-mcp 0.1.0 → 0.1.1

package/dist/providers/google/auth.js

@@ -1,10 +1,16 @@
-import { randomBytes, createHash } from 'node:crypto';
 import { spawn } from 'node:child_process';
-import { Hono } from 'hono';
+import { createHash, randomBytes } from 'node:crypto';
 import { serve } from '@hono/node-server';
+import { Hono } from 'hono';
 import { WebmasterError } from '../../core/errors.js';
 import { jsonFetch } from '../../core/scheduler.js';
-export function openBrowser(url) { const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'rundll32.exe' : 'xdg-open'; const args = process.platform === 'win32' ? ['url.dll,FileProtocolHandler', url] : [url]; const child = spawn(command, args, { stdio: 'ignore', detached: true }); child.on('error', () => { }); child.unref(); }
+export function openBrowser(url) {
+    const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'rundll32.exe' : 'xdg-open';
+    const args = process.platform === 'win32' ? ['url.dll,FileProtocolHandler', url] : [url];
+    const child = spawn(command, args, { stdio: 'ignore', detached: true });
+    child.on('error', () => { });
+    child.unref();
+}
 export async function authenticateGoogle(store, account, write = false, fetcher = fetch) {
     const clientId = process.env.GOOGLE_CLIENT_ID, clientSecret = process.env.GOOGLE_CLIENT_SECRET;
     if (!clientId)
@@ -12,46 +18,103 @@ export async function authenticateGoogle(store, account, write = false, fetcher
     const state = randomBytes(24).toString('base64url'), verifier = randomBytes(48).toString('base64url');
     const challenge = createHash('sha256').update(verifier).digest('base64url');
     let resolveCode, rejectCode;
-    const codePromise = new Promise((resolve, reject) => { resolveCode = resolve; rejectCode = reject; });
+    const codePromise = new Promise((resolve, reject) => {
+        resolveCode = resolve;
+        rejectCode = reject;
+    });
     const app = new Hono();
-    app.get('/callback', c => { if (c.req.query('state') !== state) {
-        return c.text('Invalid OAuth state.', 400);
-    } const code = c.req.query('code'); if (!code) {
-        rejectCode(new WebmasterError('AUTH_FAILED', 'OAuth authorization was declined.'));
-        return c.text('Authorization failed.', 400);
-    } resolveCode(code); return c.text('Authorization complete. You can close this tab.'); });
-    const server = await new Promise(resolve => { const s = serve({ fetch: app.fetch, port: 0, hostname: '127.0.0.1' }, () => resolve(s)); });
+    app.get('/callback', (c) => {
+        if (c.req.query('state') !== state) {
+            return c.text('Invalid OAuth state.', 400);
+        }
+        const code = c.req.query('code');
+        if (!code) {
+            rejectCode(new WebmasterError('AUTH_FAILED', 'OAuth authorization was declined.'));
+            return c.text('Authorization failed.', 400);
+        }
+        resolveCode(code);
+        return c.text('Authorization complete. You can close this tab.');
+    });
+    const server = await new Promise((resolve) => {
+        const s = serve({ fetch: app.fetch, port: 0, hostname: '127.0.0.1' }, () => resolve(s));
+    });
     let timer;
     try {
         const address = server.address();
         if (!address || typeof address === 'string')
             throw new Error('No callback port');
         const redirect = `http://127.0.0.1:${address.port}/callback`;
-        const scope = write ? 'https://www.googleapis.com/auth/webmasters' : 'https://www.googleapis.com/auth/webmasters.readonly';
+        const scope = write
+            ? 'https://www.googleapis.com/auth/webmasters'
+            : 'https://www.googleapis.com/auth/webmasters.readonly';
         const authorization = new URL('https://accounts.google.com/o/oauth2/v2/auth');
-        authorization.search = new URLSearchParams({ client_id: clientId, redirect_uri: redirect, response_type: 'code', scope, access_type: 'offline', prompt: 'consent', state, code_challenge: challenge, code_challenge_method: 'S256' }).toString();
+        authorization.search = new URLSearchParams({
+            client_id: clientId,
+            redirect_uri: redirect,
+            response_type: 'code',
+            scope,
+            access_type: 'offline',
+            prompt: 'consent',
+            state,
+            code_challenge: challenge,
+            code_challenge_method: 'S256',
+        }).toString();
         process.stderr.write(`Open this URL if your browser does not start:\n${authorization.href}\n`);
         openBrowser(authorization.href);
-        const code = await Promise.race([codePromise, new Promise((_, reject) => { timer = setTimeout(() => reject(new WebmasterError('AUTH_FAILED', 'OAuth callback timed out after two minutes.')), 120000); })]);
-        const body = new URLSearchParams({ client_id: clientId, code, code_verifier: verifier, redirect_uri: redirect, grant_type: 'authorization_code' });
+        const code = await Promise.race([
+            codePromise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new WebmasterError('AUTH_FAILED', 'OAuth callback timed out after two minutes.')), 120000);
+            }),
+        ]);
+        const body = new URLSearchParams({
+            client_id: clientId,
+            code,
+            code_verifier: verifier,
+            redirect_uri: redirect,
+            grant_type: 'authorization_code',
+        });
         if (clientSecret)
             body.set('client_secret', clientSecret);
         const data = await jsonFetch(fetcher, 'https://oauth2.googleapis.com/token', { method: 'POST', body });
         if (!data.access_token)
             throw new WebmasterError('AUTH_FAILED', 'Google did not issue an access token.');
-        const credentials = { accessToken: data.access_token, refreshToken: data.refresh_token, expiresAt: Date.now() + Number(data.expires_in ?? 3600) * 1000, scope };
+        const credentials = {
+            accessToken: data.access_token,
+            refreshToken: data.refresh_token,
+            expiresAt: Date.now() + Number(data.expires_in ?? 3600) * 1000,
+            scope,
+        };
         await store.set('google', account, credentials);
     }
     finally {
         if (timer)
             clearTimeout(timer);
-        await new Promise(resolve => server.close(() => resolve()));
+        await new Promise((resolve) => server.close(() => resolve()));
     }
 }
-export async function googleToken(store, account, fetcher = fetch) { const c = await store.get('google', account); if (!c?.accessToken)
-    throw new WebmasterError('AUTH_FAILED', 'Google is not connected. Run auth google.'); if (!c.expiresAt || c.expiresAt > Date.now() + 60000)
-    return c.accessToken; if (!c.refreshToken)
-    throw new WebmasterError('AUTH_FAILED', 'Google token expired. Run auth google again.'); const clientId = process.env.GOOGLE_CLIENT_ID; if (!clientId)
-    throw new WebmasterError('AUTH_FAILED', 'GOOGLE_CLIENT_ID is required to refresh the token.'); const body = new URLSearchParams({ client_id: clientId, refresh_token: c.refreshToken, grant_type: 'refresh_token' }); if (process.env.GOOGLE_CLIENT_SECRET)
-    body.set('client_secret', process.env.GOOGLE_CLIENT_SECRET); const data = await jsonFetch(fetcher, 'https://oauth2.googleapis.com/token', { method: 'POST', body }); if (!data.access_token)
-    throw new WebmasterError('AUTH_FAILED', 'Google token refresh failed.'); const updated = { ...c, accessToken: data.access_token, expiresAt: Date.now() + Number(data.expires_in ?? 3600) * 1000 }; await store.set('google', account, updated); return updated.accessToken; }
+export async function googleToken(store, account, fetcher = fetch) {
+    const c = (await store.get('google', account));
+    if (!c?.accessToken)
+        throw new WebmasterError('AUTH_FAILED', 'Google is not connected. Run auth google.');
+    if (!c.expiresAt || c.expiresAt > Date.now() + 60000)
+        return c.accessToken;
+    if (!c.refreshToken)
+        throw new WebmasterError('AUTH_FAILED', 'Google token expired. Run auth google again.');
+    const clientId = process.env.GOOGLE_CLIENT_ID;
+    if (!clientId)
+        throw new WebmasterError('AUTH_FAILED', 'GOOGLE_CLIENT_ID is required to refresh the token.');
+    const body = new URLSearchParams({ client_id: clientId, refresh_token: c.refreshToken, grant_type: 'refresh_token' });
+    if (process.env.GOOGLE_CLIENT_SECRET)
+        body.set('client_secret', process.env.GOOGLE_CLIENT_SECRET);
+    const data = await jsonFetch(fetcher, 'https://oauth2.googleapis.com/token', { method: 'POST', body });
+    if (!data.access_token)
+        throw new WebmasterError('AUTH_FAILED', 'Google token refresh failed.');
+    const updated = {
+        ...c,
+        accessToken: data.access_token,
+        expiresAt: Date.now() + Number(data.expires_in ?? 3600) * 1000,
+    };
+    await store.set('google', account, updated);
+    return updated.accessToken;
+}

package/dist/providers/google/index.js

@@ -1,5 +1,5 @@
-import { providerScheduler, jsonFetch } from '../../core/scheduler.js';
 import { metric } from '../../core/normalize/index.js';
+import { jsonFetch, providerScheduler } from '../../core/scheduler.js';
 import { validateSite, validateUrl } from '../../core/validation.js';
 import { authenticateGoogle, googleToken } from './auth.js';
 export class GoogleProvider {
@@ -15,21 +15,101 @@ export class GoogleProvider {
         this.fetcher = fetcher;
         this.write = write;
     }
-    supports(c) { return ['sites', 'performance', 'queries', 'pages', 'sitemaps', 'urlInspection', 'indexing'].includes(c); }
-    authenticate() { return authenticateGoogle(this.store, this.account, this.write, this.fetcher); }
-    async isAuthenticated() { return !!(await this.store.get('google', this.account)); }
-    async request(url, body) { return this.scheduler.run(async () => jsonFetch(this.fetcher, url, { method: body ? 'POST' : 'GET', headers: { Authorization: `Bearer ${await googleToken(this.store, this.account, this.fetcher)}`, ...(body ? { 'Content-Type': 'application/json' } : {}) }, body: body ? JSON.stringify(body) : undefined })); }
-    async getSites() { const data = await this.request('https://www.googleapis.com/webmasters/v3/sites'); return (data.siteEntry ?? []).map((s) => ({ site: s.siteUrl, engine: this.id, account: this.account, permission: s.permissionLevel })); }
-    async search(input, dimensions) { validateSite(input.site); const site = encodeURIComponent(input.site); const result = []; const limit = Math.min(input.limit ?? 25000, 25000); for (let startRow = 0; startRow < limit; startRow += 25000) {
-        const data = await this.request(`https://www.googleapis.com/webmasters/v3/sites/${site}/searchAnalytics/query`, { startDate: input.from, endDate: input.to, dimensions, rowLimit: Math.min(25000, limit - startRow), startRow });
-        const rows = data.rows ?? [];
-        result.push(...rows.map((r) => metric({ engine: this.id, site: input.site, account: this.account, ...Object.fromEntries(dimensions.map((d, i) => [d, r.keys?.[i]])), clicks: r.clicks, impressions: r.impressions, ctr: r.ctr, position: r.position })));
-        if (rows.length < Math.min(25000, limit - startRow))
-            break;
-    } return result; }
-    getPerformance(input) { return this.search(input, ['date']); }
-    getPages(input) { return this.search(input, ['page']); }
-    getQueries(input) { return this.search(input, ['query']); }
-    async getSitemaps(site) { validateSite(site); const d = await this.request(`https://www.googleapis.com/webmasters/v3/sites/${encodeURIComponent(site)}/sitemaps`); return (d.sitemap ?? []).map((s) => ({ engine: this.id, site, url: s.path, submitted: s.lastSubmitted, status: s.isPending ? 'pending' : undefined })); }
-    async inspectUrl(site, url) { validateUrl(site, url); const d = await this.request('https://searchconsole.googleapis.com/v1/urlInspection/index:inspect', { siteUrl: site, inspectionUrl: url }); const status = d.inspectionResult?.indexStatusResult; return { engine: this.id, site, url, state: status?.verdict === 'PASS' ? 'indexed' : status?.verdict === 'FAIL' || status?.verdict === 'NEUTRAL' ? 'not_indexed' : 'unknown', reason: status?.coverageState, inspectedAt: status?.lastCrawlTime }; }
+    supports(c) {
+        return ['sites', 'performance', 'queries', 'pages', 'sitemaps', 'urlInspection', 'indexing'].includes(c);
+    }
+    authenticate() {
+        return authenticateGoogle(this.store, this.account, this.write, this.fetcher);
+    }
+    async isAuthenticated() {
+        return !!(await this.store.get('google', this.account));
+    }
+    async request(url, body) {
+        return this.scheduler.run(async () => jsonFetch(this.fetcher, url, {
+            method: body ? 'POST' : 'GET',
+            headers: {
+                Authorization: `Bearer ${await googleToken(this.store, this.account, this.fetcher)}`,
+                ...(body ? { 'Content-Type': 'application/json' } : {}),
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        }));
+    }
+    async getSites() {
+        const data = await this.request('https://www.googleapis.com/webmasters/v3/sites');
+        return (data.siteEntry ?? []).map((s) => ({
+            site: s.siteUrl,
+            engine: this.id,
+            account: this.account,
+            permission: s.permissionLevel,
+        }));
+    }
+    async search(input, dimensions) {
+        validateSite(input.site);
+        const site = encodeURIComponent(input.site);
+        const result = [];
+        const limit = Math.min(input.limit ?? 25000, 25000);
+        for (let startRow = 0; startRow < limit; startRow += 25000) {
+            const data = await this.request(`https://www.googleapis.com/webmasters/v3/sites/${site}/searchAnalytics/query`, {
+                startDate: input.from,
+                endDate: input.to,
+                dimensions,
+                rowLimit: Math.min(25000, limit - startRow),
+                startRow,
+            });
+            const rows = data.rows ?? [];
+            result.push(...rows.map((r) => metric({
+                engine: this.id,
+                site: input.site,
+                account: this.account,
+                ...Object.fromEntries(dimensions.map((d, i) => [d, r.keys?.[i]])),
+                clicks: r.clicks,
+                impressions: r.impressions,
+                ctr: r.ctr,
+                position: r.position,
+            })));
+            if (rows.length < Math.min(25000, limit - startRow))
+                break;
+        }
+        return result;
+    }
+    getPerformance(input) {
+        return this.search(input, ['date']);
+    }
+    getPages(input) {
+        return this.search(input, ['page']);
+    }
+    getQueries(input) {
+        return this.search(input, ['query']);
+    }
+    async getSitemaps(site) {
+        validateSite(site);
+        const d = await this.request(`https://www.googleapis.com/webmasters/v3/sites/${encodeURIComponent(site)}/sitemaps`);
+        return (d.sitemap ?? []).map((s) => ({
+            engine: this.id,
+            site,
+            url: s.path,
+            submitted: s.lastSubmitted,
+            status: s.isPending ? 'pending' : undefined,
+        }));
+    }
+    async inspectUrl(site, url) {
+        validateUrl(site, url);
+        const d = await this.request('https://searchconsole.googleapis.com/v1/urlInspection/index:inspect', {
+            siteUrl: site,
+            inspectionUrl: url,
+        });
+        const status = d.inspectionResult?.indexStatusResult;
+        return {
+            engine: this.id,
+            site,
+            url,
+            state: status?.verdict === 'PASS'
+                ? 'indexed'
+                : status?.verdict === 'FAIL' || status?.verdict === 'NEUTRAL'
+                    ? 'not_indexed'
+                    : 'unknown',
+            reason: status?.coverageState,
+            inspectedAt: status?.lastCrawlTime,
+        };
+    }
 }

package/dist/providers/yandex/auth.js

@@ -1,9 +1,26 @@
+import { secretPrompt } from '../../core/auth/prompt.js';
 import { WebmasterError } from '../../core/errors.js';
 import { openBrowser } from '../google/auth.js';
-import { secretPrompt } from '../../core/auth/prompt.js';
-export function yandexAuthorizationUrl() { const clientId = process.env.YANDEX_CLIENT_ID; if (!clientId)
-    throw new WebmasterError('INVALID_INPUT', 'Set YANDEX_CLIENT_ID for a Yandex OAuth app with webmaster:hostinfo permission.'); const url = new URL('https://oauth.yandex.com/authorize'); url.searchParams.set('response_type', 'token'); url.searchParams.set('client_id', clientId); return url.href; }
-export function beginYandexAuth() { const url = yandexAuthorizationUrl(); process.stderr.write(`Open Yandex OAuth and copy the displayed token:\n${url}\n`); openBrowser(url); }
-export async function saveYandexToken(store, account, token) { if (!/^[A-Za-z0-9._~-]{10,}$/.test(token))
-    throw new WebmasterError('INVALID_INPUT', 'Invalid Yandex OAuth token format.'); await store.set('yandex', account, { accessToken: token }); }
-export async function authenticateYandex(store, account) { beginYandexAuth(); await saveYandexToken(store, account, await secretPrompt('Yandex OAuth token: ')); }
+export function yandexAuthorizationUrl() {
+    const clientId = process.env.YANDEX_CLIENT_ID;
+    if (!clientId)
+        throw new WebmasterError('INVALID_INPUT', 'Set YANDEX_CLIENT_ID for a Yandex OAuth app with webmaster:hostinfo permission.');
+    const url = new URL('https://oauth.yandex.com/authorize');
+    url.searchParams.set('response_type', 'token');
+    url.searchParams.set('client_id', clientId);
+    return url.href;
+}
+export function beginYandexAuth() {
+    const url = yandexAuthorizationUrl();
+    process.stderr.write(`Open Yandex OAuth and copy the displayed token:\n${url}\n`);
+    openBrowser(url);
+}
+export async function saveYandexToken(store, account, token) {
+    if (!/^[A-Za-z0-9._~-]{10,}$/.test(token))
+        throw new WebmasterError('INVALID_INPUT', 'Invalid Yandex OAuth token format.');
+    await store.set('yandex', account, { accessToken: token });
+}
+export async function authenticateYandex(store, account) {
+    beginYandexAuth();
+    await saveYandexToken(store, account, await secretPrompt('Yandex OAuth token: '));
+}

package/dist/providers/yandex/index.js

@@ -1,6 +1,6 @@
 import { WebmasterError } from '../../core/errors.js';
-import { providerScheduler, jsonFetch } from '../../core/scheduler.js';
-import { metric, finite } from '../../core/normalize/index.js';
+import { finite, metric } from '../../core/normalize/index.js';
+import { jsonFetch, providerScheduler } from '../../core/scheduler.js';
 import { validateSite, validateUrl } from '../../core/validation.js';
 import { authenticateYandex } from './auth.js';
 export class YandexProvider {
@@ -14,57 +14,159 @@ export class YandexProvider {
         this.account = account;
         this.fetcher = fetcher;
     }
-    supports(c) { return ['sites', 'performance', 'queries', 'pages', 'sitemaps', 'urlInspection', 'indexing'].includes(c); }
-    authenticate() { return authenticateYandex(this.store, this.account); }
-    async isAuthenticated() { return !!(await this.store.get('yandex', this.account)); }
-    async request(path, body) { const credential = await this.store.get('yandex', this.account); if (!credential?.accessToken)
-        throw new WebmasterError('AUTH_FAILED', 'Yandex is not connected. Run auth yandex.'); return this.scheduler.run(() => jsonFetch(this.fetcher, `https://api.webmaster.yandex.net/v4/${path}`, { method: body ? 'POST' : 'GET', headers: { Authorization: `OAuth ${credential.accessToken}`, ...(body ? { 'Content-Type': 'application/json' } : {}) }, body: body ? JSON.stringify(body) : undefined })); }
-    async userId() { const d = await this.request('user'); return String(d.user_id); }
-    async host(site) { validateSite(site); const user = await this.userId(); const d = await this.request(`user/${encodeURIComponent(user)}/hosts`); const found = (d.hosts ?? []).find((h) => h.ascii_host_url === site || h.unicode_host_url === site); if (!found)
-        throw new WebmasterError('PERMISSION_DENIED', 'Site is not in this Yandex account.'); return { user, host: found.host_id }; }
-    async getSites() { const user = await this.userId(); const d = await this.request(`user/${encodeURIComponent(user)}/hosts`); return (d.hosts ?? []).filter((h) => h.verified).map((h) => ({ site: h.ascii_host_url, engine: this.id, account: this.account })); }
-    async getPerformance(input) { const { user, host } = await this.host(input.site); const url = new URL(`https://api.webmaster.yandex.net/v4/user/${encodeURIComponent(user)}/hosts/${encodeURIComponent(host)}/search-queries/all/history`); for (const x of ['TOTAL_SHOWS', 'TOTAL_CLICKS', 'AVG_SHOW_POSITION'])
-        url.searchParams.append('query_indicator', x); url.searchParams.set('date_from', input.from); url.searchParams.set('date_to', input.to); const d = await this.request(url.pathname.slice(4) + url.search); const byDate = new Map(); for (const [key, items] of Object.entries(d.indicators ?? {}))
-        for (const item of items) {
-            const date = String(item.date).slice(0, 10);
-            const row = byDate.get(date) ?? { engine: this.id, site: input.site, account: this.account, date };
-            if (key === 'TOTAL_SHOWS')
-                row.impressions = finite(item.value);
-            if (key === 'TOTAL_CLICKS')
-                row.clicks = finite(item.value);
-            if (key === 'AVG_SHOW_POSITION')
-                row.position = finite(item.value);
-            byDate.set(date, row);
-        } return [...byDate.values()].map(metric); }
-    async getQueries(input) { const { user, host } = await this.host(input.site); const url = new URL(`https://api.webmaster.yandex.net/v4/user/${encodeURIComponent(user)}/hosts/${encodeURIComponent(host)}/search-queries/popular`); url.searchParams.set('order_by', 'TOTAL_CLICKS'); for (const x of ['TOTAL_SHOWS', 'TOTAL_CLICKS', 'AVG_SHOW_POSITION'])
-        url.searchParams.append('query_indicator', x); url.searchParams.set('date_from', input.from); url.searchParams.set('date_to', input.to); const max = Math.min(input.limit ?? 500, 3000); const rows = []; for (let offset = 0; offset < max; offset += 500) {
-        url.searchParams.set('offset', String(offset));
-        url.searchParams.set('limit', String(Math.min(500, max - offset)));
+    supports(c) {
+        return ['sites', 'performance', 'queries', 'pages', 'sitemaps', 'urlInspection', 'indexing'].includes(c);
+    }
+    authenticate() {
+        return authenticateYandex(this.store, this.account);
+    }
+    async isAuthenticated() {
+        return !!(await this.store.get('yandex', this.account));
+    }
+    async request(path, body) {
+        const credential = (await this.store.get('yandex', this.account));
+        if (!credential?.accessToken)
+            throw new WebmasterError('AUTH_FAILED', 'Yandex is not connected. Run auth yandex.');
+        return this.scheduler.run(() => jsonFetch(this.fetcher, `https://api.webmaster.yandex.net/v4/${path}`, {
+            method: body ? 'POST' : 'GET',
+            headers: {
+                Authorization: `OAuth ${credential.accessToken}`,
+                ...(body ? { 'Content-Type': 'application/json' } : {}),
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        }));
+    }
+    async userId() {
+        const d = await this.request('user');
+        return String(d.user_id);
+    }
+    async host(site) {
+        validateSite(site);
+        const user = await this.userId();
+        const d = await this.request(`user/${encodeURIComponent(user)}/hosts`);
+        const found = (d.hosts ?? []).find((h) => h.ascii_host_url === site || h.unicode_host_url === site);
+        if (!found)
+            throw new WebmasterError('PERMISSION_DENIED', 'Site is not in this Yandex account.');
+        return { user, host: found.host_id };
+    }
+    async getSites() {
+        const user = await this.userId();
+        const d = await this.request(`user/${encodeURIComponent(user)}/hosts`);
+        return (d.hosts ?? [])
+            .filter((h) => h.verified)
+            .map((h) => ({ site: h.ascii_host_url, engine: this.id, account: this.account }));
+    }
+    async getPerformance(input) {
+        const { user, host } = await this.host(input.site);
+        const url = new URL(`https://api.webmaster.yandex.net/v4/user/${encodeURIComponent(user)}/hosts/${encodeURIComponent(host)}/search-queries/all/history`);
+        for (const x of ['TOTAL_SHOWS', 'TOTAL_CLICKS', 'AVG_SHOW_POSITION'])
+            url.searchParams.append('query_indicator', x);
+        url.searchParams.set('date_from', input.from);
+        url.searchParams.set('date_to', input.to);
         const d = await this.request(url.pathname.slice(4) + url.search);
-        const batch = d.queries ?? [];
-        rows.push(...batch.map((q) => metric({ engine: this.id, site: input.site, account: this.account, query: q.query_text, clicks: q.indicators?.TOTAL_CLICKS, impressions: q.indicators?.TOTAL_SHOWS, position: q.indicators?.AVG_SHOW_POSITION })));
-        if (batch.length < Math.min(500, max - offset))
-            break;
-    } return rows; }
-    async getPages(input) { const earliest = new Date(Date.now() - 14 * 86400000).toISOString().slice(0, 10); if (input.from < earliest)
-        throw new WebmasterError('UNSUPPORTED', 'Yandex page analytics is available only for the last two weeks.'); const { user, host } = await this.host(input.site); const rows = []; const max = input.limit ?? 500; for (let offset = 0; offset < max; offset += 500) {
-        const d = await this.request(`user/${encodeURIComponent(user)}/hosts/${encodeURIComponent(host)}/query-analytics/list`, { offset, limit: Math.min(500, max - offset), text_indicator: 'URL', search_location: 'WEB_LOCATION' });
-        const items = d.text_indicator_to_statistics ?? [];
-        for (const item of items) {
-            const dates = new Map();
-            for (const stat of item.statistics ?? []) {
-                if (stat.date < input.from || stat.date > input.to)
-                    continue;
-                const row = dates.get(stat.date) ?? {};
-                row[stat.field] = stat.value;
-                dates.set(stat.date, row);
+        const byDate = new Map();
+        for (const [key, items] of Object.entries(d.indicators ?? {}))
+            for (const item of items) {
+                const date = String(item.date).slice(0, 10);
+                const row = byDate.get(date) ?? { engine: this.id, site: input.site, account: this.account, date };
+                if (key === 'TOTAL_SHOWS')
+                    row.impressions = finite(item.value);
+                if (key === 'TOTAL_CLICKS')
+                    row.clicks = finite(item.value);
+                if (key === 'AVG_SHOW_POSITION')
+                    row.position = finite(item.value);
+                byDate.set(date, row);
             }
-            for (const [date, s] of dates)
-                rows.push(metric({ engine: this.id, site: input.site, account: this.account, page: item.text_indicator?.value, date, clicks: s.CLICKS, impressions: s.IMPRESSIONS, position: s.POSITION }));
+        return [...byDate.values()].map(metric);
+    }
+    async getQueries(input) {
+        const { user, host } = await this.host(input.site);
+        const url = new URL(`https://api.webmaster.yandex.net/v4/user/${encodeURIComponent(user)}/hosts/${encodeURIComponent(host)}/search-queries/popular`);
+        url.searchParams.set('order_by', 'TOTAL_CLICKS');
+        for (const x of ['TOTAL_SHOWS', 'TOTAL_CLICKS', 'AVG_SHOW_POSITION'])
+            url.searchParams.append('query_indicator', x);
+        url.searchParams.set('date_from', input.from);
+        url.searchParams.set('date_to', input.to);
+        const max = Math.min(input.limit ?? 500, 3000);
+        const rows = [];
+        for (let offset = 0; offset < max; offset += 500) {
+            url.searchParams.set('offset', String(offset));
+            url.searchParams.set('limit', String(Math.min(500, max - offset)));
+            const d = await this.request(url.pathname.slice(4) + url.search);
+            const batch = d.queries ?? [];
+            rows.push(...batch.map((q) => metric({
+                engine: this.id,
+                site: input.site,
+                account: this.account,
+                query: q.query_text,
+                clicks: q.indicators?.TOTAL_CLICKS,
+                impressions: q.indicators?.TOTAL_SHOWS,
+                position: q.indicators?.AVG_SHOW_POSITION,
+            })));
+            if (batch.length < Math.min(500, max - offset))
+                break;
+        }
+        return rows;
+    }
+    async getPages(input) {
+        const earliest = new Date(Date.now() - 14 * 86400000).toISOString().slice(0, 10);
+        if (input.from < earliest)
+            throw new WebmasterError('UNSUPPORTED', 'Yandex page analytics is available only for the last two weeks.');
+        const { user, host } = await this.host(input.site);
+        const rows = [];
+        const max = input.limit ?? 500;
+        for (let offset = 0; offset < max; offset += 500) {
+            const d = await this.request(`user/${encodeURIComponent(user)}/hosts/${encodeURIComponent(host)}/query-analytics/list`, { offset, limit: Math.min(500, max - offset), text_indicator: 'URL', search_location: 'WEB_LOCATION' });
+            const items = d.text_indicator_to_statistics ?? [];
+            for (const item of items) {
+                const dates = new Map();
+                for (const stat of item.statistics ?? []) {
+                    if (stat.date < input.from || stat.date > input.to)
+                        continue;
+                    const row = dates.get(stat.date) ?? {};
+                    row[stat.field] = stat.value;
+                    dates.set(stat.date, row);
+                }
+                for (const [date, s] of dates)
+                    rows.push(metric({
+                        engine: this.id,
+                        site: input.site,
+                        account: this.account,
+                        page: item.text_indicator?.value,
+                        date,
+                        clicks: s.CLICKS,
+                        impressions: s.IMPRESSIONS,
+                        position: s.POSITION,
+                    }));
+            }
+            if (items.length < Math.min(500, max - offset))
+                break;
         }
-        if (items.length < Math.min(500, max - offset))
-            break;
-    } return rows; }
-    async getSitemaps(site) { const { user, host } = await this.host(site); const d = await this.request(`user/${encodeURIComponent(user)}/hosts/${encodeURIComponent(host)}/sitemaps`); return (d.sitemaps ?? []).map((s) => ({ engine: this.id, site, url: s.sitemap_url ?? s.url, status: s.status })); }
-    async inspectUrl(site, url) { validateUrl(site, url); const { user, host } = await this.host(site); const d = await this.request(`user/${encodeURIComponent(user)}/hosts/${encodeURIComponent(host)}/important-urls`); const item = (d.urls ?? []).find((x) => x.url === url); const searchable = item?.search_status?.searchable; return { engine: this.id, site, url, state: searchable === true ? 'indexed' : searchable === false ? 'not_indexed' : 'unknown', reason: item ? item.search_status?.excluded_url_status : 'URL is not in Yandex important-page monitoring.', inspectedAt: item?.update_date }; }
+        return rows;
+    }
+    async getSitemaps(site) {
+        const { user, host } = await this.host(site);
+        const d = await this.request(`user/${encodeURIComponent(user)}/hosts/${encodeURIComponent(host)}/sitemaps`);
+        return (d.sitemaps ?? []).map((s) => ({
+            engine: this.id,
+            site,
+            url: s.sitemap_url ?? s.url,
+            status: s.status,
+        }));
+    }
+    async inspectUrl(site, url) {
+        validateUrl(site, url);
+        const { user, host } = await this.host(site);
+        const d = await this.request(`user/${encodeURIComponent(user)}/hosts/${encodeURIComponent(host)}/important-urls`);
+        const item = (d.urls ?? []).find((x) => x.url === url);
+        const searchable = item?.search_status?.searchable;
+        return {
+            engine: this.id,
+            site,
+            url,
+            state: searchable === true ? 'indexed' : searchable === false ? 'not_indexed' : 'unknown',
+            reason: item ? item.search_status?.excluded_url_status : 'URL is not in Yandex important-page monitoring.',
+            inspectedAt: item?.update_date,
+        };
+    }
 }

package/dist/server/context.d.ts

@@ -1,6 +1,6 @@
-import { Cache } from '../core/cache/index.js';
-import { KeychainCredentialStore } from '../core/auth/store.js';
 import { AccountRegistry } from '../core/auth/accounts.js';
+import { KeychainCredentialStore } from '../core/auth/store.js';
+import { Cache } from '../core/cache/index.js';
 import { WebmasterService } from '../core/service.js';
 export declare function createContext(): {
     cache: Cache;

package/dist/server/context.js

@@ -1,10 +1,24 @@
-import { Cache } from '../core/cache/index.js';
-import { KeychainCredentialStore } from '../core/auth/store.js';
 import { AccountRegistry } from '../core/auth/accounts.js';
-import { GoogleProvider } from '../providers/google/index.js';
+import { KeychainCredentialStore } from '../core/auth/store.js';
+import { Cache } from '../core/cache/index.js';
+import { WebmasterService } from '../core/service.js';
 import { BingProvider } from '../providers/bing/index.js';
+import { GoogleProvider } from '../providers/google/index.js';
 import { YandexProvider } from '../providers/yandex/index.js';
-import { WebmasterService } from '../core/service.js';
-export function createContext() { const cache = new Cache(); const store = new KeychainCredentialStore(); const accounts = new AccountRegistry(cache, store); const buildProviders = () => { const providers = []; for (const engine of ['google', 'bing', 'yandex'])
-    for (const name of accounts.names(engine))
-        providers.push(engine === 'google' ? new GoogleProvider(store, name) : engine === 'bing' ? new BingProvider(store, name) : new YandexProvider(store, name)); return providers; }; return { cache, store, accounts, service: new WebmasterService(buildProviders(), cache, buildProviders) }; }
+export function createContext() {
+    const cache = new Cache();
+    const store = new KeychainCredentialStore();
+    const accounts = new AccountRegistry(cache, store);
+    const buildProviders = () => {
+        const providers = [];
+        for (const engine of ['google', 'bing', 'yandex'])
+            for (const name of accounts.names(engine))
+                providers.push(engine === 'google'
+                    ? new GoogleProvider(store, name)
+                    : engine === 'bing'
+                        ? new BingProvider(store, name)
+                        : new YandexProvider(store, name));
+        return providers;
+    };
+    return { cache, store, accounts, service: new WebmasterService(buildProviders(), cache, buildProviders) };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webmaster-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Local-first unified webmaster MCP for Google, Bing, and Yandex",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,6 +15,9 @@
     "build": "tsc -p tsconfig.json",
     "test": "node --import tsx --test test/*.test.ts",
     "postbuild": "node -e \"require('node:fs').chmodSync('dist/cli/index.js', 0o755)\"",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
     "prepack": "npm run build"
   },
   "keywords": [],
@@ -34,6 +37,7 @@
     "zod": "^4.6.5"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.5.14",
     "@types/better-sqlite3": "^9.6.0",
     "@types/node": "^26.6.2",
     "tsx": "^4.23.15",