seo 0.12.0 → 0.13.0

package/dist/provider-sdk.d.ts

@@ -1,10 +1,10 @@
 
 //#region packages/core/src/provider-extensions/sdk.d.ts
-declare const SEO_PROVIDER_API_VERSION: 1;
-type SeoProviderApiVersion = typeof SEO_PROVIDER_API_VERSION;
-type SeoProviderKind = 'traffic-analytics' | 'search-results' | 'keyword-data' | 'domain-data' | 'link-data' | 'local-search' | 'ai-data' | 'other';
-type SeoProviderCapabilityId = 'landing-page-visits' | 'keyword-metrics' | 'keyword-discovery' | 'serp-snapshot' | 'domain-overview' | 'ranked-keywords' | 'relevant-pages' | 'serp-competitors' | 'link-summary' | 'referring-domains' | 'backlinks' | 'domain-rating' | 'local-search' | 'ai-mentions' | 'ai-prompt-observation';
-type SeoProviderConnectionField = {
+export declare const SEO_PROVIDER_API_VERSION: 1;
+export type SeoProviderApiVersion = typeof SEO_PROVIDER_API_VERSION;
+export type SeoProviderKind = 'traffic-analytics' | 'search-results' | 'keyword-data' | 'domain-data' | 'link-data' | 'local-search' | 'ai-data' | 'other';
+export type SeoProviderCapabilityId = 'landing-page-visits' | 'keyword-metrics' | 'keyword-discovery' | 'serp-snapshot' | 'domain-overview' | 'ranked-keywords' | 'relevant-pages' | 'serp-competitors' | 'link-summary' | 'referring-domains' | 'backlinks' | 'domain-rating' | 'local-search' | 'ai-mentions' | 'ai-prompt-observation';
+export type SeoProviderConnectionField = {
   id: string;
   label: string;
   description?: string;
@@ -12,32 +12,32 @@ type SeoProviderConnectionField = {
   required?: boolean;
   envVar?: string;
 };
-type SeoProviderRequest = {
+export type SeoProviderRequest = {
   operation: string;
   url: string;
   method?: 'GET' | 'POST';
   headers?: Readonly<Record<string, string>>;
   body?: string;
 };
-interface SeoProviderRuntime {
+export interface SeoProviderRuntime {
   requestJson(input: SeoProviderRequest): Promise<unknown>;
   now(): string;
 }
-type SeoProviderConnection = {
+export type SeoProviderConnection = {
   account: Readonly<Record<string, string>>;
   credentials: Readonly<Record<string, string>>;
 };
-type SeoProviderConnectionAdapter = {
+export type SeoProviderConnectionAdapter = {
   fields: readonly SeoProviderConnectionField[];
   normalizeAccount?(account: Readonly<Record<string, string>>): Record<string, string>;
   verify(connection: SeoProviderConnection, runtime: SeoProviderRuntime): Promise<void>;
   verificationNotice?: string;
 };
-type SeoLandingPageVisitRow = {
+export type SeoLandingPageVisitRow = {
   path: string;
   visits: number;
 };
-type SeoLandingPageVisitsResult = {
+export type SeoLandingPageVisitsResult = {
   metric: 'landing-page-visits';
   rows: readonly SeoLandingPageVisitRow[];
   returnedRows: number;
@@ -47,7 +47,7 @@ type SeoLandingPageVisitsResult = {
   dataStatus: 'complete' | 'partial';
   qualityWarnings: readonly string[];
 };
-type SeoLandingPageVisitsCapability = {
+export type SeoLandingPageVisitsCapability = {
   id: 'landing-page-visits';
   run(input: SeoProviderConnection & {
     startDate: string;
@@ -55,7 +55,7 @@ type SeoLandingPageVisitsCapability = {
     limit: number;
   }, runtime: SeoProviderRuntime): Promise<SeoLandingPageVisitsResult>;
 };
-type SeoSearchMarket = {
+export type SeoSearchMarket = {
   searchEngine: 'google' | 'bing';
   countryCode: string;
   languageCode: string;
@@ -65,7 +65,7 @@ type SeoSearchMarket = {
     name?: string;
   };
 };
-type SeoSerpOrganicResult = {
+export type SeoSerpOrganicResult = {
   rankGroup: number;
   rankAbsolute: number;
   page: number;
@@ -75,7 +75,7 @@ type SeoSerpOrganicResult = {
   description: string | null;
   isFeaturedSnippet: boolean | null;
 };
-type SeoSerpLocalPackResult = {
+export type SeoSerpLocalPackResult = {
   rankGroup: number;
   rankAbsolute: number;
   page: number | null;
@@ -93,7 +93,7 @@ type SeoSerpLocalPackResult = {
     maximum: number | null;
   } | null;
 };
-type SeoSerpSnapshotResult = {
+export type SeoSerpSnapshotResult = {
   observedAt: string;
   effectiveKeyword: string;
   searchEngineDomain: string | null;
@@ -140,7 +140,7 @@ type SeoSerpSnapshotResult = {
     row?: number;
   }[];
 };
-type SeoSerpSnapshotCapability = {
+export type SeoSerpSnapshotCapability = {
   id: 'serp-snapshot';
   defaultDepth: number;
   maxDepth: number;
@@ -168,12 +168,12 @@ type SeoSerpSnapshotCapability = {
     depth: number;
   }, runtime: SeoProviderRuntime): Promise<SeoSerpSnapshotResult>;
 };
-type SeoProviderCapabilityAdapter = SeoLandingPageVisitsCapability | SeoSerpSnapshotCapability;
-type SeoProviderJson = string | number | boolean | null | readonly SeoProviderJson[] | {
+export type SeoProviderCapabilityAdapter = SeoLandingPageVisitsCapability | SeoSerpSnapshotCapability;
+export type SeoProviderJson = string | number | boolean | null | readonly SeoProviderJson[] | {
   readonly [key: string]: SeoProviderJson;
 };
-type SeoProviderJsonSchema = Readonly<Record<string, SeoProviderJson>>;
-type SeoProviderActionAdapter = {
+export type SeoProviderJsonSchema = Readonly<Record<string, SeoProviderJson>>;
+export type SeoProviderActionAdapter = {
   id: string;
   description: string;
   inputSchema: SeoProviderJsonSchema;
@@ -183,7 +183,7 @@ type SeoProviderActionAdapter = {
     params: Readonly<Record<string, SeoProviderJson>>;
   }, runtime: SeoProviderRuntime): Promise<unknown>;
 };
-type SeoProviderRegistration = {
+export type SeoProviderRegistration = {
   id: string;
   displayName: string;
   description: string;
@@ -192,13 +192,12 @@ type SeoProviderRegistration = {
   capabilities: readonly SeoProviderCapabilityAdapter[];
   actions?: readonly SeoProviderActionAdapter[];
 };
-interface SeoProviderHost {
+export interface SeoProviderHost {
   readonly apiVersion: SeoProviderApiVersion;
   registerProvider(provider: SeoProviderRegistration): void;
 }
-type SeoProviderActivate = (host: SeoProviderHost) => void | Promise<void>;
-type SeoAnalyticsConnection = SeoProviderConnection;
-type SeoAnalyticsLandingPageResult = SeoLandingPageVisitsResult;
+export type SeoProviderActivate = (host: SeoProviderHost) => void | Promise<void>;
+export type SeoAnalyticsConnection = SeoProviderConnection;
+export type SeoAnalyticsLandingPageResult = SeoLandingPageVisitsResult;
 //#endregion
-export { SEO_PROVIDER_API_VERSION, SeoAnalyticsConnection, SeoAnalyticsLandingPageResult, SeoLandingPageVisitRow, SeoLandingPageVisitsCapability, SeoLandingPageVisitsResult, SeoProviderActionAdapter, SeoProviderActivate, SeoProviderApiVersion, SeoProviderCapabilityAdapter, SeoProviderCapabilityId, SeoProviderConnection, SeoProviderConnectionAdapter, SeoProviderConnectionField, SeoProviderHost, SeoProviderJson, SeoProviderJsonSchema, SeoProviderKind, SeoProviderRegistration, SeoProviderRequest, SeoProviderRuntime, SeoSearchMarket, SeoSerpLocalPackResult, SeoSerpOrganicResult, SeoSerpSnapshotCapability, SeoSerpSnapshotResult };
 //# sourceMappingURL=provider-sdk.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seo",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "mcpName": "dev.seoskill/seo",
   "description": "The SEO command for AI agents: a free Google Search Console MCP server and CLI. Reads your real Search Console, Google Analytics and Bing data for traffic drops, quick wins, content decay, cannibalization and indexing, plus DataForSEO and Ahrefs keyword research.",
   "type": "module",
@@ -69,7 +69,7 @@
   },
   "packageManager": "pnpm@11.11.0",
   "engines": {
-    "node": ">=22.19.0"
+    "node": "^22.23.4 || ^24.22.1 || >=26.12.1"
   },
   "scripts": {
     "auth:inject-shared-client": "node scripts/inject-shared-oauth-client.mjs",
@@ -106,38 +106,38 @@
     "typecheck": "turbo run typecheck"
   },
   "dependencies": {
-    "@clack/prompts": "^1.7.0",
+    "@clack/prompts": "^1.8.1",
     "@mozilla/readability": "^0.6.0",
     "@napi-rs/keyring": "^1.3.0",
-    "@types/node": "^22.20.1",
+    "@types/node": "^22.20.5",
     "citty": "^0.2.2",
     "cli-table3": "^0.6.5",
-    "defuddle": "^0.19.1",
+    "defuddle": "^0.19.5",
     "htmlparser2": "10.1.0",
     "jsonc-parser": "^3.3.1",
     "libsql": "^0.5.29",
-    "lighthouse": "13.4.1",
+    "lighthouse": "13.5.0",
     "linkedom": "^0.18.13",
-    "open": "^11.0.0",
-    "p-queue": "^9.3.1",
-    "p-retry": "^8.0.0",
+    "open": "^11.0.4",
+    "p-queue": "^9.3.5",
+    "p-retry": "^8.0.1",
     "picocolors": "^1.1.1",
-    "pino": "^10.3.1",
-    "pino-pretty": "^13.1.3",
-    "playwright-core": "1.61.1",
+    "pino": "^10.4.0",
+    "pino-pretty": "^13.2.0",
+    "playwright-core": "1.64.1",
     "proper-lockfile": "^4.1.2",
     "robots-parser": "^3.0.1",
-    "string-width": "^8.2.2",
+    "string-width": "^8.3.0",
     "turndown": "^7.2.4",
-    "undici": "^8.10.2",
+    "undici": "^8.12.2",
     "update-notifier": "^7.3.1",
-    "zod": "^4.4.3"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.4",
-    "@modelcontextprotocol/sdk": "^1.31.0",
-    "tsdown": "^0.22.12",
-    "turbo": "^2.10.5",
+    "@biomejs/biome": "^2.5.15",
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "tsdown": "^0.23.1",
+    "turbo": "^2.11.8",
     "typescript": "^6.0.3"
   }
 }

package/skills/seo/SKILL.md

@@ -19,7 +19,7 @@ link for them to approve, then run it again.
 
 | CLI | MCP tool | Returns |
 |---|---|---|
-| `seo report --site <site>` | `seo_report` | Search Console overview and sections |
+| `seo report --site <site>` | `seo_report` | Search Console overview and sections; with no site, last week across the sites in the weekly site audit beta |
 | `seo page --url <url>` | `seo_page` | One URL: live page, index status, queries |
 | `seo compare --site <site> --date <date>` | `seo_compare` | Before and after a date, with Google updates |
 | `seo index --site <site>` | `seo_index` | Google's indexing reasons, labelled, and pages that lost their clicks |
@@ -29,8 +29,9 @@ link for them to approve, then run it again.
 | `seo internal-links --site <site>` or `--url <url>` | `seo_internal_links` | Links to add across a site, or to one page |
 | `seo sites` | `seo_sites` | The properties the person can read |
 
-Each result ends with the command to run next. `seo <command> --help` shows
-the options.
+Each result ends with the command to run next. Start small and ask for more:
+a site, then a `--section` (`section`), then `--detail rows` or `full`.
+`seo <command> --help` shows the options.
 
 ## Indexing reasons each week