Skip to content

Open source alternative to Semrush and Ahrefs

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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
new file mode 100644
index 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&apos;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.tsx
index 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 />
<RankTrackingDomainList
projectId={projectId}
search={search}
@@ -68,6 +70,6 @@ function RankTrackingIndex() {
}}
/>
)}
- </>
+ </div>
);
}
diff --git a/src/server.ts b/src/server.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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;