Skip to content

docs(seo): SEO research, tooling, and P0 title/meta rewrites - #72

Merged
nibzard merged 5 commits into
mainfrom
niko/seo
Jul 23, 2026
Merged

docs(seo): SEO research, tooling, and P0 title/meta rewrites#72
nibzard merged 5 commits into
mainfrom
niko/seo

Conversation

@nibzard

@nibzard nibzard commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

What

Ships the SEO workstream from the niko/seo branch:

  1. SEO opportunity research (SEO-OPPORTUNITIES.md) — DataForSEO volume/CPC data for 153 keywords + live SERP research, distilled into a prioritized 90-day roadmap
  2. Recurring SEO pulse tooling — in-repo seo skill + scripts, first baseline report (2026-07)
  3. P0 quick win: title/H1/meta rewrites on 15 pages — the highest-ROI action from the research

The P0 rewrites

These pages sit behind the highest-volume terms in the space (selenium 110k/mo, playwright 74k, langgraph 33k, puppeteer 27k, ...) but had generic titles (Browser Use | Steel Docs) that don't phrase-match demand.

  • 11 integration pages: intent-phrased titles + 140–160 char meta descriptions (the old ones were 66–106 chars)
  • Agent Traces: Agent Traces: Observability for Browser Agents (feature name preserved)
  • Captcha Solving → CAPTCHA Solving API for Browser Automation
  • Proxies → Proxies & Proxy Rotation for Browser Automation
  • cookbook/scrape → Scrape JavaScript-Rendered Pages to Markdown + short sidebarTitle, RecipeJsonLd kept in sync

Constraints honored

  • No third-party protection-brand names (reCAPTCHA/Turnstile/etc.) in titles or meta — legal
  • Feature names preserved in titles
  • Sidebar labels unchanged everywhere (sidebarTitle takes precedence; verified in lib/source.ts)
  • No em dashes

After merge

Submit the 15 URLs to IndexNow/GSC for recrawl. Next roadmap items: BreadcrumbList/TechArticle JSON-LD, internal-linking pass.

nibzard and others added 4 commits July 20, 2026 11:29
Prioritized SEO research (real DataForSEO volumes + SERP findings + codebase/live audit).

- SEO-OPPORTUNITIES.md: findings, prioritized P0/P1/P2 actions, technical fixes, 90-day roadmap
- scripts/seo/dfs-keywords.mjs: reusable DataForSEO volume/CPC puller (reads .env)
- scripts/seo/keyword-volume-table.md + dfs-keywords-*.json: 153-keyword volume/CPC data
- scripts/seo/keywords-*.txt: keyword seed lists
- scripts/seo/recon-salvage.json: 52 SERP-grounded research findings

Co-Authored-By: Claude <noreply@anthropic.com>
Un-ignore `.claude/skills/` so the recurring monthly SEO skill
(SKILL.md + Steel-baked config.json + dfs-volumes/dfs-rank/tech-audit
scripts + evals) is version-controlled and travels with this branch.
`.env` (DataForSEO creds) and the rest of `.claude/` stay ignored.

Co-Authored-By: Claude <noreply@anthropic.com>
Output of the first monthly pulse run: the baseline delta report
(no prior month to diff against) and the movers summary. Establishes
the "previous" snapshot next month's run will diff against.

Co-Authored-By: Claude <noreply@anthropic.com>
…arch demand

Ship the P0 quick-win from SEO-OPPORTUNITIES.md: 15 pages sitting behind
the highest-volume terms (selenium 110k/mo, playwright 74k, langgraph 33k)
had generic titles that didn't phrase-match intent.

- 11 integration pages: intent-phrased titles + 140-160 char descriptions
- Agent Traces: adds observability qualifier, feature name preserved
- Captcha Solving / Proxies: keyword-targeted titles, tighter descriptions
- cookbook/scrape: JS-rendered-pages title, new short sidebarTitle,
  RecipeJsonLd kept in sync

No third-party protection-brand names in titles/meta (legal constraint).
Sidebar labels unchanged (sidebarTitle preserved everywhere).
@vercel

vercel Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 23, 2026 3:58pm

Request Review

@nibzard
nibzard merged commit 8ff87c6 into main Jul 23, 2026
3 checks passed
@nibzard
nibzard deleted the niko/seo branch July 23, 2026 15:59
nibzard added a commit that referenced this pull request Jul 30, 2026
The page earned 36,672 GSC impressions at 0.05% CTR because Google matched
it for Railway-the-platform queries (railway healthcheckpath, railway
autoscaling documentation, railway public domain, railway dev, railway web)
that Steel can never win.

Retarget title and description to self-hosting Steel Browser on Railway,
following the intent-phrased convention from #72, and rescope the headings
that read as generic Railway platform docs (health check endpoint, public
domain access, security considerations). sidebarTitle stays "Railway".
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