Open source alternative to Semrush and Ahrefs
TypeScript backlink-analysisgoogle-search-console-mcpkeyword-researchmcpseoseo-agentseo-auditseo-automationseo-skillsseo-toolssite-audit
Pause scheduled rank tracking while checks are unreliable (#918)
Ben Senescu733ab9b69b86
diff --git a/src/client/features/rank-tracking/RankTrackingConfigModal.tsx b/src/client/features/rank-tracking/RankTrackingConfigModal.tsxindex 070b45c7..252c58b6 100644--- a/src/client/features/rank-tracking/RankTrackingConfigModal.tsx+++ b/src/client/features/rank-tracking/RankTrackingConfigModal.tsx@@ -33,6 +33,7 @@ import {type SaveConfigInput,} from "./useSaveConfigMutations";import { ScheduleField } from "./ScheduleField";+import { SCHEDULED_RANK_CHECKS_PAUSED } from "@/shared/rank-tracking-pause";import {localScheduleTimeFrom,randomScheduleDate,@@ -174,7 +175,9 @@ function RankTrackingConfigModalContent({targetingMode: existingConfig?.locationName ? "local" : "national",locationName: existingConfig?.locationName ?? undefined,devices: existingConfig?.devices ?? "mobile",- schedule: existingConfig?.scheduleInterval ?? "weekly",+ schedule:+ existingConfig?.scheduleInterval ??+ (SCHEDULED_RANK_CHECKS_PAUSED ? "manual" : "weekly"),// Shown and edited in the browser's timezone; the server converts it to UTC.scheduleTime: localScheduleTimeFrom(existingConfig?.nextCheckAt@@ -336,6 +339,7 @@ function RankTrackingConfigModalContent({form.setFieldValue("scheduleTime", time);setScheduleTimeEdited(true);}}+ scheduledChecksPaused={SCHEDULED_RANK_CHECKS_PAUSED}/><form.AppField name="serpDepth">diff --git a/src/client/features/rank-tracking/RankTrackingDomainDetail.tsx b/src/client/features/rank-tracking/RankTrackingDomainDetail.tsxindex 765f0ddb..0d5669e5 100644--- a/src/client/features/rank-tracking/RankTrackingDomainDetail.tsx+++ b/src/client/features/rank-tracking/RankTrackingDomainDetail.tsx@@ -17,6 +17,7 @@ import { Alert, AlertDescription } from "@/client/components/ui/alert";import { useHostedPlanGate } from "@/client/features/billing/HostedPlanGate";import { captureClientEvent } from "@/client/lib/posthog";import { FreePlanAlert } from "./FreePlanAlert";+import { ScheduledChecksPausedAlert } from "./ScheduledChecksPausedAlert";import { RankRunAlerts } from "./RankRunAlerts";import { RankTrackingDetailHeader } from "./RankTrackingDetailHeader";import { RankTrackingOverview } from "./RankTrackingOverview";@@ -235,6 +236,8 @@ export function RankTrackingDomainDetail({return (<div className="space-y-3">+ <ScheduledChecksPausedAlert />+{config.lastSkipReason === "insufficient_credits" && (<Alert variant="warning"><AlertTriangle />diff --git a/src/client/features/rank-tracking/ScheduleField.tsx b/src/client/features/rank-tracking/ScheduleField.tsxindex c6b26141..10ae1437 100644--- a/src/client/features/rank-tracking/ScheduleField.tsx+++ b/src/client/features/rank-tracking/ScheduleField.tsx@@ -43,6 +43,8 @@ type Props = {onScheduleTimeChange: (scheduleTime: LocalScheduleTime) => void;/** AI visibility pauses tracking instead of offering a manual schedule. */allowManual?: boolean;+ /** Only manual, or the schedule already saved, can be picked. */+ scheduledChecksPaused?: boolean;};export function ScheduleField({@@ -51,11 +53,19 @@ export function ScheduleField({scheduleTime,onScheduleTimeChange,allowManual = true,+ scheduledChecksPaused = false,}: Props) {const id = useId();- const items = allowManual- ? SCHEDULE_ITEMS- : SCHEDULE_ITEMS.filter((item) => item.value !== "manual");+ // Paused: offer manual plus whatever the config already uses, so an edit+ // never silently drops a saved schedule.+ const [pausedSchedule] = useState(schedule);+ const items = scheduledChecksPaused+ ? SCHEDULE_ITEMS.filter(+ (item) => item.value === "manual" || item.value === pausedSchedule,+ )+ : allowManual+ ? SCHEDULE_ITEMS+ : SCHEDULE_ITEMS.filter((item) => item.value !== "manual");const [showScheduleTime, setShowScheduleTime] = useState(false);return (diff --git a/src/client/features/rank-tracking/ScheduledChecksPausedAlert.tsx b/src/client/features/rank-tracking/ScheduledChecksPausedAlert.tsxnew file mode 100644index 00000000..baa7d2be--- /dev/null+++ b/src/client/features/rank-tracking/ScheduledChecksPausedAlert.tsx@@ -0,0 +1,24 @@+import { AlertTriangle } from "lucide-react";+import { Alert, AlertDescription } from "@/client/components/ui/alert";+import { SCHEDULED_RANK_CHECKS_PAUSED } from "@/shared/rank-tracking-pause";++export function ScheduledChecksPausedAlert() {+ if (!SCHEDULED_RANK_CHECKS_PAUSED) return null;++ return (+ <Alert variant="warning">+ <AlertTriangle />+ <AlertDescription className="text-foreground">+ <p>+ <span className="font-medium">+ Scheduled rank tracking has been temporarily disabled.+ </span>{" "}+ Scraping Google Search Results has been unreliable industry wide due+ to change Google has made. Due to this, we've disabled it until+ we have a better solution. We should have an update within the next+ week. Sorry for the inconvenience.+ </p>+ </AlertDescription>+ </Alert>+ );+}diff --git a/src/routes/_app/p/$projectId/rank-tracking/index.tsx b/src/routes/_app/p/$projectId/rank-tracking/index.tsxindex 514825f9..08c8cf04 100644--- a/src/routes/_app/p/$projectId/rank-tracking/index.tsx+++ b/src/routes/_app/p/$projectId/rank-tracking/index.tsx@@ -7,6 +7,7 @@ import {import { useQueryClient } from "@tanstack/react-query";import { RankTrackingDomainList } from "@/client/features/rank-tracking/RankTrackingDomainList";import { RankTrackingConfigModal } from "@/client/features/rank-tracking/RankTrackingConfigModal";+import { ScheduledChecksPausedAlert } from "@/client/features/rank-tracking/ScheduledChecksPausedAlert";import { rankTrackingListSearchSchema } from "@/types/schemas/rank-tracking-search";export const Route = createFileRoute("/_app/p/$projectId/rank-tracking/")({@@ -36,7 +37,8 @@ function RankTrackingIndex() {};return (- <>+ <div className="space-y-3">+ <ScheduledChecksPausedAlert /><RankTrackingDomainListprojectId={projectId}search={search}@@ -68,6 +70,6 @@ function RankTrackingIndex() {}}/>)}- </>+ </div>);}diff --git a/src/server.ts b/src/server.tsindex 8184756c..7b3b2c73 100644--- a/src/server.ts+++ b/src/server.ts@@ -7,6 +7,7 @@ import { resolveUserContextFromHeaders } from "@/middleware/ensure-user/resolve"import { ProjectRepository } from "@/server/features/projects/repositories/ProjectRepository";import { SamSessionRepository } from "@/server/features/sam/SamSessionRepository";import { runScheduledRankChecks } from "@/server/features/rank-tracking/services/scheduledRankChecks";+import { SCHEDULED_RANK_CHECKS_PAUSED } from "@/shared/rank-tracking-pause";import { reconcileStaleAudits } from "@/server/features/audit/services/auditReconciler";import { getOrCreateOrganizationCustomer } from "@/server/billing/subscription";import { isHostedServerAuthMode } from "@/server/lib/runtime-env";@@ -240,7 +241,9 @@ export default {}// Scope a per-request Postgres client for the cron run (no-op in D1 mode).const checks = await Promise.allSettled([- withPgClient(() => runScheduledRankChecks(env)),+ SCHEDULED_RANK_CHECKS_PAUSED+ ? Promise.resolve()+ : withPgClient(() => runScheduledRankChecks(env)),withPgClient(async () => {const { runScheduledAiVisibility } =await import("@/server/features/ai-visibility/services/scheduledAiVisibility");diff --git a/src/server/features/rank-tracking/services/RankTrackingService.management.test.ts b/src/server/features/rank-tracking/services/RankTrackingService.management.test.tsindex 382eea4b..04ec00d7 100644--- a/src/server/features/rank-tracking/services/RankTrackingService.management.test.ts+++ b/src/server/features/rank-tracking/services/RankTrackingService.management.test.ts@@ -14,6 +14,10 @@ const mocks = vi.hoisted(() => ({fetchKeywordMetricsForList: vi.fn(),}));+// These tests cover normal scheduling, not the temporary pause.+vi.mock("@/shared/rank-tracking-pause", () => ({+ SCHEDULED_RANK_CHECKS_PAUSED: false,+}));vi.mock("cloudflare:workers", () => ({ env: { RANK_CHECK_WORKFLOW: {} } }));vi.mock("@/server/features/rank-tracking/repositories/RankTrackingRepository",diff --git a/src/server/features/rank-tracking/services/RankTrackingService.test.ts b/src/server/features/rank-tracking/services/RankTrackingService.test.tsindex 2cb54944..e90ea966 100644--- a/src/server/features/rank-tracking/services/RankTrackingService.test.ts+++ b/src/server/features/rank-tracking/services/RankTrackingService.test.ts@@ -16,6 +16,10 @@ const mocks = vi.hoisted(() => ({customerHasPaidPlan: vi.fn(),}));+// These tests cover normal scheduling, not the temporary pause.+vi.mock("@/shared/rank-tracking-pause", () => ({+ SCHEDULED_RANK_CHECKS_PAUSED: false,+}));vi.mock("cloudflare:workers", () => ({env: { RANK_CHECK_WORKFLOW: { create: mocks.startWorkflow } },}));diff --git a/src/server/features/rank-tracking/services/RankTrackingService.ts b/src/server/features/rank-tracking/services/RankTrackingService.tsindex e77e81cd..24f8b1ad 100644--- a/src/server/features/rank-tracking/services/RankTrackingService.ts+++ b/src/server/features/rank-tracking/services/RankTrackingService.ts@@ -22,11 +22,10 @@ import {} from "./rankCheckRunGuards";import {estimateRankCheckCredits,- computeNextCheckAt,- isScheduledRankTrackingInterval,MAX_CONFIGS_PER_PROJECT,rankCheckCostApprovalError,} from "@/shared/rank-tracking";+import { resolveNextCheckAt } from "./configSchedule";import {getIsoCountryCode,resolveKeywordDataLanguage,@@ -213,33 +212,6 @@ async function updateConfig(await RankTrackingRepository.updateConfig(configId, projectId, updates);}-function resolveNextCheckAt(- scheduleInterval: RankTrackingConfig["scheduleInterval"],- scheduleTime: RankCheckScheduleTime | undefined,-): string | null {- if (isScheduledRankTrackingInterval(scheduleInterval)) {- // Without one the check would quietly repeat on whatever day today is.- if (- scheduleInterval === "weekly" &&- scheduleTime &&- scheduleTime.weekday === undefined- ) {- throw new AppError(- "VALIDATION_ERROR",- "A weekly schedule time needs a weekday",- );- }- return computeNextCheckAt(scheduleInterval, null, scheduleTime);- }- if (scheduleTime) {- throw new AppError(- "VALIDATION_ERROR",- "A schedule time needs a daily, weekly, or monthly schedule",- );- }- return null;-}-// ---------------------------------------------------------------------------// Trigger a manual check// ---------------------------------------------------------------------------diff --git a/src/server/features/rank-tracking/services/configSchedule.ts b/src/server/features/rank-tracking/services/configSchedule.tsnew file mode 100644index 00000000..d7da5dfa--- /dev/null+++ b/src/server/features/rank-tracking/services/configSchedule.ts@@ -0,0 +1,45 @@+import { AppError } from "@/server/lib/errors";+import { SCHEDULED_RANK_CHECKS_PAUSED } from "@/shared/rank-tracking-pause";+import {+ computeNextCheckAt,+ isScheduledRankTrackingInterval,+} from "@/shared/rank-tracking";+import type {+ RankCheckScheduleTime,+ RankTrackingConfig,+} from "@/types/schemas/rank-tracking";++export function resolveNextCheckAt(+ scheduleInterval: RankTrackingConfig["scheduleInterval"],+ scheduleTime: RankCheckScheduleTime | undefined,+): string | null {+ if (isScheduledRankTrackingInterval(scheduleInterval)) {+ // Reached only when a schedule is created or changed, so configs keep the+ // schedule they already have (and resume when the pause lifts).+ if (SCHEDULED_RANK_CHECKS_PAUSED) {+ throw new AppError(+ "VALIDATION_ERROR",+ "Scheduled rank checks are temporarily paused. Use a manual schedule and run checks on demand.",+ );+ }+ // Without one the check would quietly repeat on whatever day today is.+ if (+ scheduleInterval === "weekly" &&+ scheduleTime &&+ scheduleTime.weekday === undefined+ ) {+ throw new AppError(+ "VALIDATION_ERROR",+ "A weekly schedule time needs a weekday",+ );+ }+ return computeNextCheckAt(scheduleInterval, null, scheduleTime);+ }+ if (scheduleTime) {+ throw new AppError(+ "VALIDATION_ERROR",+ "A schedule time needs a daily, weekly, or monthly schedule",+ );+ }+ return null;+}diff --git a/src/shared/rank-tracking-pause.ts b/src/shared/rank-tracking-pause.tsnew file mode 100644index 00000000..e3e954ec--- /dev/null+++ b/src/shared/rank-tracking-pause.ts@@ -0,0 +1,6 @@+// Temporary kill switch for scheduled rank checks while they are unreliable.+// While true the cron starts no scheduled runs and no config can switch onto a+// schedule. Existing configs keep their stored schedule, so flipping this back+// resumes them (overdue ones drain through the scheduler's per-tick budget).+// Manual checks are unaffected.+export const SCHEDULED_RANK_CHECKS_PAUSED = true;