pulsemcp-cms-admin-mcp-server 0.10.1 → 0.10.2

package/build/shared/src/pulsemcp-admin-client/lib/set-popularity-drop-bypass.js

@@ -0,0 +1,38 @@
+import { adminFetch } from './admin-fetch.js';
+/**
+ * Enable or disable the one-off SYSTEMIC_DROP bypass for popularity estimates.
+ *
+ * POST /api/popularity_drop_bypass with body { enabled } sets the flag and
+ * returns the resulting status. When enabled, the NEXT run of
+ * UpdatePopularityEstimatesFromBigqueryJob flushes legitimate drops held by the
+ * SYSTEMIC_DROP guardrail, then consumes (auto-resets) the flag.
+ */
+export async function setPopularityDropBypass(apiKey, baseUrl, enabled) {
+    const url = new URL('/api/popularity_drop_bypass', baseUrl);
+    const response = await adminFetch(url.toString(), {
+        method: 'POST',
+        headers: {
+            'X-API-Key': apiKey,
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ enabled }),
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new Error('Invalid API key');
+        }
+        if (response.status === 403) {
+            throw new Error('User lacks write privileges');
+        }
+        if (response.status === 404) {
+            throw new Error('Popularity drop bypass endpoint not found');
+        }
+        if (response.status === 422) {
+            const errorData = (await response.json().catch(() => ({})));
+            throw new Error(`Validation failed: ${errorData.errors?.join(', ') || 'Unknown error'}`);
+        }
+        throw new Error(`Failed to set popularity drop bypass: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}

package/build/shared/src/pulsemcp-admin-client/pulsemcp-admin-client.integration-mock.js

@@ -940,6 +940,13 @@ export function createMockPulseMCPAdminClient(mockData) {
                 deleted_count: 0,
             };
         },
+        async setPopularityDropBypass(enabled) {
+            return {
+                enabled,
+                enabled_at: enabled ? '2026-06-09T00:00:00Z' : null,
+                enabled_by: enabled ? 'mock-admin' : null,
+            };
+        },
         // Proctor methods
         async runExamForMirror() {
             return {

package/build/shared/src/server.js

@@ -60,6 +60,7 @@ import { retryGoodJob } from './pulsemcp-admin-client/lib/retry-good-job.js';
 import { discardGoodJob } from './pulsemcp-admin-client/lib/discard-good-job.js';
 import { rescheduleGoodJob } from './pulsemcp-admin-client/lib/reschedule-good-job.js';
 import { forceTriggerGoodJobCron } from './pulsemcp-admin-client/lib/force-trigger-good-job-cron.js';
+import { setPopularityDropBypass } from './pulsemcp-admin-client/lib/set-popularity-drop-bypass.js';
 import { cleanupGoodJobs } from './pulsemcp-admin-client/lib/cleanup-good-jobs.js';
 import { runExamForMirror } from './pulsemcp-admin-client/lib/run-exam-for-mirror.js';
 import { saveResultsForMirror } from './pulsemcp-admin-client/lib/save-results-for-mirror.js';
@@ -293,6 +294,9 @@ export class PulseMCPAdminClient {
     async forceTriggerGoodJobCron(cronKey) {
         return forceTriggerGoodJobCron(this.apiKey, this.baseUrl, cronKey);
     }
+    async setPopularityDropBypass(enabled) {
+        return setPopularityDropBypass(this.apiKey, this.baseUrl, enabled);
+    }
     async cleanupGoodJobs(params) {
         return cleanupGoodJobs(this.apiKey, this.baseUrl, params);
     }

package/build/shared/src/tools/set-popularity-drop-bypass.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+const PARAM_DESCRIPTIONS = {
+    enabled: 'true enables the one-off bypass; false disables it. When enabled, the NEXT run of UpdatePopularityEstimatesFromBigqueryJob flushes the legitimate downward corrections currently held by the SYSTEMIC_DROP guardrail (and clears their popularity_drop_held_since), then the flag auto-resets to false so the bypass never silently stays on.',
+};
+const SetPopularityDropBypassSchema = z.object({
+    enabled: z.boolean().describe(PARAM_DESCRIPTIONS.enabled),
+});
+export function setPopularityDropBypass(_server, clientFactory) {
+    return {
+        name: 'set_popularity_drop_bypass',
+        description: `Enable or disable a deliberate, auditable ONE-OFF bypass of the SYSTEMIC_DROP guardrail in the popularity-estimates pipeline.
+
+Background: UpdatePopularityEstimatesFromBigqueryJob holds large downward popularity corrections when more than ~10% of servers would drop at once (a possible systemic upstream event), keeping each flagged server at its stale value for ~3 days. During a known-legitimate remediation wave (e.g. correcting servers mis-linked to famous registry packages), that guardrail keeps genuinely-corrected servers visible at inflated values.
+
+Enabling this bypass tells the NEXT job run to skip the SYSTEMIC_DROP hold for that single run only: it applies the corrected (dropped) BigQuery values, clears popularity_drop_held_since for the affected servers, then CONSUMES the flag (auto-resets enabled→false). The independent impossible-RISE guardrail is unaffected.
+
+Returns the resulting bypass status (enabled / enabled_at / enabled_by).
+
+Use cases:
+- Enable the bypass before the next scheduled run to flush a known-legitimate correction wave caught in a systemic hold
+- Disable the bypass if it was enabled in error and the next run has not yet consumed it`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                enabled: { type: 'boolean', description: PARAM_DESCRIPTIONS.enabled },
+            },
+            required: ['enabled'],
+        },
+        handler: async (args) => {
+            const validatedArgs = SetPopularityDropBypassSchema.parse(args);
+            const client = clientFactory();
+            try {
+                const result = await client.setPopularityDropBypass(validatedArgs.enabled);
+                const text = `Popularity drop bypass ${result.enabled ? 'ENABLED' : 'DISABLED'}.
+- enabled: ${result.enabled}
+- enabled_at: ${result.enabled_at ?? '(none)'}
+- enabled_by: ${result.enabled_by ?? '(none)'}${result.enabled
+                    ? '\n\nThe next UpdatePopularityEstimatesFromBigqueryJob run will flush held drops and then auto-reset this flag.'
+                    : ''}`;
+                return { content: [{ type: 'text', text }] };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error setting popularity drop bypass: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        },
+    };
+}

package/build/shared/src/tools.js

@@ -65,6 +65,7 @@ import { discardGoodJob } from './tools/discard-good-job.js';
 import { rescheduleGoodJob } from './tools/reschedule-good-job.js';
 import { forceTriggerGoodJobCron } from './tools/force-trigger-good-job-cron.js';
 import { cleanupGoodJobs } from './tools/cleanup-good-jobs.js';
+import { setPopularityDropBypass } from './tools/set-popularity-drop-bypass.js';
 // Proctor tools
 import { runExamForMirror } from './tools/run-exam-for-mirror.js';
 import { getExamResult } from './tools/get-exam-result.js';
@@ -263,6 +264,10 @@ const ALL_TOOLS = [
     { factory: rescheduleGoodJob, groups: ['good_jobs'], isWriteOperation: true },
     { factory: forceTriggerGoodJobCron, groups: ['good_jobs'], isWriteOperation: true },
     { factory: cleanupGoodJobs, groups: ['good_jobs'], isWriteOperation: true },
+    // setPopularityDropBypass toggles a one-off bypass of the SYSTEMIC_DROP guardrail in
+    // UpdatePopularityEstimatesFromBigqueryJob. It lives in good_jobs because it controls the
+    // behavior of a background job and is exposed via the same write-enabled good_jobs credential.
+    { factory: setPopularityDropBypass, groups: ['good_jobs'], isWriteOperation: true },
     // Proctor tools
     { factory: runExamForMirror, groups: ['proctor'], isWriteOperation: true },
     { factory: getExamResult, groups: ['proctor'], isWriteOperation: false },

package/node_modules/@pulsemcp/mcp-elicitation/package.json

@@ -23,6 +23,6 @@
   "devDependencies": {
     "@types/node": "^24.10.12",
     "typescript": "^5.7.3",
-    "vitest": "^3.2.3"
+    "vitest": "^4.1.8"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulsemcp-cms-admin-mcp-server",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Local implementation of PulseMCP CMS Admin MCP server",
   "mcpName": "com.pulsemcp/pulsemcp-cms-admin",
   "main": "build/index.js",

package/shared/pulsemcp-admin-client/lib/set-popularity-drop-bypass.d.ts

@@ -0,0 +1,11 @@
+import type { PopularityDropBypassStatus } from '../../types.js';
+/**
+ * Enable or disable the one-off SYSTEMIC_DROP bypass for popularity estimates.
+ *
+ * POST /api/popularity_drop_bypass with body { enabled } sets the flag and
+ * returns the resulting status. When enabled, the NEXT run of
+ * UpdatePopularityEstimatesFromBigqueryJob flushes legitimate drops held by the
+ * SYSTEMIC_DROP guardrail, then consumes (auto-resets) the flag.
+ */
+export declare function setPopularityDropBypass(apiKey: string, baseUrl: string, enabled: boolean): Promise<PopularityDropBypassStatus>;
+//# sourceMappingURL=set-popularity-drop-bypass.d.ts.map

package/shared/pulsemcp-admin-client/lib/set-popularity-drop-bypass.js

@@ -0,0 +1,38 @@
+import { adminFetch } from './admin-fetch.js';
+/**
+ * Enable or disable the one-off SYSTEMIC_DROP bypass for popularity estimates.
+ *
+ * POST /api/popularity_drop_bypass with body { enabled } sets the flag and
+ * returns the resulting status. When enabled, the NEXT run of
+ * UpdatePopularityEstimatesFromBigqueryJob flushes legitimate drops held by the
+ * SYSTEMIC_DROP guardrail, then consumes (auto-resets) the flag.
+ */
+export async function setPopularityDropBypass(apiKey, baseUrl, enabled) {
+    const url = new URL('/api/popularity_drop_bypass', baseUrl);
+    const response = await adminFetch(url.toString(), {
+        method: 'POST',
+        headers: {
+            'X-API-Key': apiKey,
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ enabled }),
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new Error('Invalid API key');
+        }
+        if (response.status === 403) {
+            throw new Error('User lacks write privileges');
+        }
+        if (response.status === 404) {
+            throw new Error('Popularity drop bypass endpoint not found');
+        }
+        if (response.status === 422) {
+            const errorData = (await response.json().catch(() => ({})));
+            throw new Error(`Validation failed: ${errorData.errors?.join(', ') || 'Unknown error'}`);
+        }
+        throw new Error(`Failed to set popularity drop bypass: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}

package/shared/pulsemcp-admin-client/pulsemcp-admin-client.integration-mock.js

@@ -940,6 +940,13 @@ export function createMockPulseMCPAdminClient(mockData) {
                 deleted_count: 0,
             };
         },
+        async setPopularityDropBypass(enabled) {
+            return {
+                enabled,
+                enabled_at: enabled ? '2026-06-09T00:00:00Z' : null,
+                enabled_by: enabled ? 'mock-admin' : null,
+            };
+        },
         // Proctor methods
         async runExamForMirror() {
             return {

package/shared/server.d.ts

@@ -1,5 +1,5 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import type { Post, PostsResponse, CreatePostParams, UpdatePostParams, ImageUploadResponse, Author, AuthorsResponse, MCPServer, MCPClient, MCPImplementation, MCPImplementationsResponse, SaveMCPImplementationParams, CreateMCPImplementationParams, Provider, ProvidersResponse, OfficialMirrorQueueStatus, OfficialMirrorQueueResponse, OfficialMirrorQueueItemDetail, OfficialMirrorQueueActionResponse, UnofficialMirror, UnofficialMirrorsResponse, CreateUnofficialMirrorParams, UpdateUnofficialMirrorParams, OfficialMirrorRest, OfficialMirrorsResponse, Tenant, TenantsResponse, ListTenantServersResponse, BulkUpdateTenantServersParams, BulkUpdateTenantServersResponse, McpJson, McpJsonsResponse, CreateMcpJsonParams, UpdateMcpJsonParams, UnifiedMCPServer, UnifiedMCPServersResponse, UpdateUnifiedMCPServerParams, Redirect, RedirectsResponse, RedirectStatus, CreateRedirectParams, UpdateRedirectParams, GoodJob, GoodJobsResponse, GoodJobStatus, GoodJobCronSchedule, GoodJobProcess, GoodJobStatistics, GoodJobActionResponse, GoodJobCleanupResponse, ProctorRunExamParams, ProctorRunExamResponse, ProctorSaveResultsParams, ProctorSaveResultsResponse, ProctorRunsResponse, GetProctorRunsParams, ProctorMetadataResponse, DiscoveredUrlsResponse, MarkDiscoveredUrlProcessedParams, MarkDiscoveredUrlProcessedResponse, DiscoveredUrlStats, MozMetricsResponse, MozBacklinksResponse, MozStoredMetricsResponse, CreateTenantParams, ApiKey, CreateApiKeyParams, DeleteTenantParams, DeleteTenantResponse, DeleteApiKeyResponse, RecacheMCPServerResponse, SetKnownMissingInitToolsListResponse } from './types.js';
+import type { Post, PostsResponse, CreatePostParams, UpdatePostParams, ImageUploadResponse, Author, AuthorsResponse, MCPServer, MCPClient, MCPImplementation, MCPImplementationsResponse, SaveMCPImplementationParams, CreateMCPImplementationParams, Provider, ProvidersResponse, OfficialMirrorQueueStatus, OfficialMirrorQueueResponse, OfficialMirrorQueueItemDetail, OfficialMirrorQueueActionResponse, UnofficialMirror, UnofficialMirrorsResponse, CreateUnofficialMirrorParams, UpdateUnofficialMirrorParams, OfficialMirrorRest, OfficialMirrorsResponse, Tenant, TenantsResponse, ListTenantServersResponse, BulkUpdateTenantServersParams, BulkUpdateTenantServersResponse, McpJson, McpJsonsResponse, CreateMcpJsonParams, UpdateMcpJsonParams, UnifiedMCPServer, UnifiedMCPServersResponse, UpdateUnifiedMCPServerParams, Redirect, RedirectsResponse, RedirectStatus, CreateRedirectParams, UpdateRedirectParams, GoodJob, GoodJobsResponse, GoodJobStatus, GoodJobCronSchedule, GoodJobProcess, GoodJobStatistics, GoodJobActionResponse, GoodJobCleanupResponse, PopularityDropBypassStatus, ProctorRunExamParams, ProctorRunExamResponse, ProctorSaveResultsParams, ProctorSaveResultsResponse, ProctorRunsResponse, GetProctorRunsParams, ProctorMetadataResponse, DiscoveredUrlsResponse, MarkDiscoveredUrlProcessedParams, MarkDiscoveredUrlProcessedResponse, DiscoveredUrlStats, MozMetricsResponse, MozBacklinksResponse, MozStoredMetricsResponse, CreateTenantParams, ApiKey, CreateApiKeyParams, DeleteTenantParams, DeleteTenantResponse, DeleteApiKeyResponse, RecacheMCPServerResponse, SetKnownMissingInitToolsListResponse } from './types.js';
 export interface IPulseMCPAdminClient {
     getPosts(params?: {
         search?: string;
@@ -166,6 +166,7 @@ export interface IPulseMCPAdminClient {
     discardGoodJob(id: string): Promise<GoodJobActionResponse>;
     rescheduleGoodJob(id: string, scheduledAt: string): Promise<GoodJobActionResponse>;
     forceTriggerGoodJobCron(cronKey: string): Promise<GoodJobActionResponse>;
+    setPopularityDropBypass(enabled: boolean): Promise<PopularityDropBypassStatus>;
     cleanupGoodJobs(params?: {
         older_than_days?: number;
         status?: GoodJobStatus;
@@ -366,6 +367,7 @@ export declare class PulseMCPAdminClient implements IPulseMCPAdminClient {
     discardGoodJob(id: string): Promise<GoodJobActionResponse>;
     rescheduleGoodJob(id: string, scheduledAt: string): Promise<GoodJobActionResponse>;
     forceTriggerGoodJobCron(cronKey: string): Promise<GoodJobActionResponse>;
+    setPopularityDropBypass(enabled: boolean): Promise<PopularityDropBypassStatus>;
     cleanupGoodJobs(params?: {
         older_than_days?: number;
         status?: GoodJobStatus;

package/shared/server.js

@@ -60,6 +60,7 @@ import { retryGoodJob } from './pulsemcp-admin-client/lib/retry-good-job.js';
 import { discardGoodJob } from './pulsemcp-admin-client/lib/discard-good-job.js';
 import { rescheduleGoodJob } from './pulsemcp-admin-client/lib/reschedule-good-job.js';
 import { forceTriggerGoodJobCron } from './pulsemcp-admin-client/lib/force-trigger-good-job-cron.js';
+import { setPopularityDropBypass } from './pulsemcp-admin-client/lib/set-popularity-drop-bypass.js';
 import { cleanupGoodJobs } from './pulsemcp-admin-client/lib/cleanup-good-jobs.js';
 import { runExamForMirror } from './pulsemcp-admin-client/lib/run-exam-for-mirror.js';
 import { saveResultsForMirror } from './pulsemcp-admin-client/lib/save-results-for-mirror.js';
@@ -293,6 +294,9 @@ export class PulseMCPAdminClient {
     async forceTriggerGoodJobCron(cronKey) {
         return forceTriggerGoodJobCron(this.apiKey, this.baseUrl, cronKey);
     }
+    async setPopularityDropBypass(enabled) {
+        return setPopularityDropBypass(this.apiKey, this.baseUrl, enabled);
+    }
     async cleanupGoodJobs(params) {
         return cleanupGoodJobs(this.apiKey, this.baseUrl, params);
     }

package/shared/tools/set-popularity-drop-bypass.d.ts

@@ -0,0 +1,30 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { ClientFactory } from '../server.js';
+export declare function setPopularityDropBypass(_server: Server, clientFactory: ClientFactory): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            enabled: {
+                type: string;
+                description: "true enables the one-off bypass; false disables it. When enabled, the NEXT run of UpdatePopularityEstimatesFromBigqueryJob flushes the legitimate downward corrections currently held by the SYSTEMIC_DROP guardrail (and clears their popularity_drop_held_since), then the flag auto-resets to false so the bypass never silently stays on.";
+            };
+        };
+        required: string[];
+    };
+    handler: (args: unknown) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};
+//# sourceMappingURL=set-popularity-drop-bypass.d.ts.map

package/shared/tools/set-popularity-drop-bypass.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+const PARAM_DESCRIPTIONS = {
+    enabled: 'true enables the one-off bypass; false disables it. When enabled, the NEXT run of UpdatePopularityEstimatesFromBigqueryJob flushes the legitimate downward corrections currently held by the SYSTEMIC_DROP guardrail (and clears their popularity_drop_held_since), then the flag auto-resets to false so the bypass never silently stays on.',
+};
+const SetPopularityDropBypassSchema = z.object({
+    enabled: z.boolean().describe(PARAM_DESCRIPTIONS.enabled),
+});
+export function setPopularityDropBypass(_server, clientFactory) {
+    return {
+        name: 'set_popularity_drop_bypass',
+        description: `Enable or disable a deliberate, auditable ONE-OFF bypass of the SYSTEMIC_DROP guardrail in the popularity-estimates pipeline.
+
+Background: UpdatePopularityEstimatesFromBigqueryJob holds large downward popularity corrections when more than ~10% of servers would drop at once (a possible systemic upstream event), keeping each flagged server at its stale value for ~3 days. During a known-legitimate remediation wave (e.g. correcting servers mis-linked to famous registry packages), that guardrail keeps genuinely-corrected servers visible at inflated values.
+
+Enabling this bypass tells the NEXT job run to skip the SYSTEMIC_DROP hold for that single run only: it applies the corrected (dropped) BigQuery values, clears popularity_drop_held_since for the affected servers, then CONSUMES the flag (auto-resets enabled→false). The independent impossible-RISE guardrail is unaffected.
+
+Returns the resulting bypass status (enabled / enabled_at / enabled_by).
+
+Use cases:
+- Enable the bypass before the next scheduled run to flush a known-legitimate correction wave caught in a systemic hold
+- Disable the bypass if it was enabled in error and the next run has not yet consumed it`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                enabled: { type: 'boolean', description: PARAM_DESCRIPTIONS.enabled },
+            },
+            required: ['enabled'],
+        },
+        handler: async (args) => {
+            const validatedArgs = SetPopularityDropBypassSchema.parse(args);
+            const client = clientFactory();
+            try {
+                const result = await client.setPopularityDropBypass(validatedArgs.enabled);
+                const text = `Popularity drop bypass ${result.enabled ? 'ENABLED' : 'DISABLED'}.
+- enabled: ${result.enabled}
+- enabled_at: ${result.enabled_at ?? '(none)'}
+- enabled_by: ${result.enabled_by ?? '(none)'}${result.enabled
+                    ? '\n\nThe next UpdatePopularityEstimatesFromBigqueryJob run will flush held drops and then auto-reset this flag.'
+                    : ''}`;
+                return { content: [{ type: 'text', text }] };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error setting popularity drop bypass: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        },
+    };
+}

package/shared/tools.js

@@ -65,6 +65,7 @@ import { discardGoodJob } from './tools/discard-good-job.js';
 import { rescheduleGoodJob } from './tools/reschedule-good-job.js';
 import { forceTriggerGoodJobCron } from './tools/force-trigger-good-job-cron.js';
 import { cleanupGoodJobs } from './tools/cleanup-good-jobs.js';
+import { setPopularityDropBypass } from './tools/set-popularity-drop-bypass.js';
 // Proctor tools
 import { runExamForMirror } from './tools/run-exam-for-mirror.js';
 import { getExamResult } from './tools/get-exam-result.js';
@@ -263,6 +264,10 @@ const ALL_TOOLS = [
     { factory: rescheduleGoodJob, groups: ['good_jobs'], isWriteOperation: true },
     { factory: forceTriggerGoodJobCron, groups: ['good_jobs'], isWriteOperation: true },
     { factory: cleanupGoodJobs, groups: ['good_jobs'], isWriteOperation: true },
+    // setPopularityDropBypass toggles a one-off bypass of the SYSTEMIC_DROP guardrail in
+    // UpdatePopularityEstimatesFromBigqueryJob. It lives in good_jobs because it controls the
+    // behavior of a background job and is exposed via the same write-enabled good_jobs credential.
+    { factory: setPopularityDropBypass, groups: ['good_jobs'], isWriteOperation: true },
     // Proctor tools
     { factory: runExamForMirror, groups: ['proctor'], isWriteOperation: true },
     { factory: getExamResult, groups: ['proctor'], isWriteOperation: false },

package/shared/types.d.ts

@@ -897,6 +897,11 @@ export interface SetKnownMissingInitToolsListResponse {
     known_missing_init_tools_list: boolean;
     known_missing_init_tools_list_filter_to: string | null;
 }
+export interface PopularityDropBypassStatus {
+    enabled: boolean;
+    enabled_at: string | null;
+    enabled_by: string | null;
+}
 export interface MozMetrics {
     page_authority?: number;
     domain_authority?: number;