Skip to content

Seed SERP-rivals from rank-tracked keywords - #55

Merged
ThinkingSpade merged 1 commit into
mainfrom
feat/serp-rivals-keyword-seed
Aug 20, 2026
Merged

ThinkingSpade merged 1 commit into
mainfrom
feat/serp-rivals-keyword-seed

Conversation

@ThinkingSpade

Copy link
Copy Markdown
Owner

Wires the third candidate source in the expired-domain finder. It was built and tested in #52 but returned nothing without a keyword seed.

Why rank-tracked keywords

They are the queries you have explicitly said you care about. Saved keywords are a research bucket (plenty get saved and never pursued), and GSC queries include everything you happen to rank for rather than what you target. A caller can still override via the keywords input.

The cost correction that came with it

The SERP endpoint is priced per keyword, so this adds real DataForSEO spend to a run. The panel previously said "Also runs one DataForSEO link-gap lookup" — that now understates the bill. It reads "two DataForSEO lookups: one link-gap call, and one SERP call priced per rank-tracked keyword", and the e2e spec asserts that wording so the quote cannot silently drift from what the code actually spends.

Keywords are gathered across the project's tracking configs and deduped — the same keyword tracked under two configs must not be billed twice. A rank-tracking read that fails degrades to no seed rather than taking down a run whose other two sources are fine.

Verification

  • pnpm ci:check clean; pnpm test green — 306 files, 3092 tests.
  • e2e/expired-domains.spec.ts passes, including the new cost-copy assertion. Still needs no API key and no guard, so it runs on every CI run.

Not verified

A run that actually uses the seed is not browser-verified — that bills DataForSEO per keyword plus APIVerve per candidate.

Deploy notes

No D1 migration.

🤖 Generated with Claude Code

Those are the queries the user has explicitly said they care about, which makes
them the most defensible answer to "who else competes here" -- saved keywords
are a research bucket and GSC queries include plenty the project never targeted.
Keywords live per tracking config, so they are gathered across the project's
configs and deduped: the SERP endpoint bills PER KEYWORD, so the same keyword
tracked under two configs must not be paid for twice. A rank-tracking read that
fails degrades to no seed rather than taking down a run whose other two sources
are fine.

Also corrects the panel's cost line, which now understated the bill. It claimed
"one DataForSEO link-gap lookup"; a run makes two DataForSEO calls, and the
second is priced per keyword. The e2e spec asserts the corrected wording, so the
quote cannot silently drift from what the code actually spends again.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 20, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
flyrocketseo 251e3e6 Aug 20 2026, 02:31 PM

@ThinkingSpade
ThinkingSpade merged commit b05ad30 into main Aug 20, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant