Skip to content

Reframe FAQ 'Unsupported Websites' as bot-detection education#459

Merged
masnwilliams merged 3 commits into
mainfrom
hypeship/faq-site-bot-detection
Jul 22, 2026
Merged

Reframe FAQ 'Unsupported Websites' as bot-detection education#459
masnwilliams merged 3 commits into
mainfrom
hypeship/faq-site-bot-detection

Conversation

@masnwilliams

@masnwilliams masnwilliams commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Summary

The FAQ's Unsupported Websites section listed specific sites (LinkedIn, Facebook, Instagram, X, Amazon, Reddit) as unsupported. That was inaccurate and had caused customer-facing confusion.

This rewrites the section as education rather than a supported/unsupported verdict. It makes no claim about whether any specific site can or cannot be automated — instead it explains that bot-detection behavior is site- and configuration-specific, what drives friction, and how to reduce it.

What changed

Replaces the flat list with a "Bot detection varies by site" section that:

  • Frames detection as site- and config-dependent, not a fixed allow/deny list
  • Names the factors that increase friction — high-volume/high-concurrency scraping and aggressive detection vendors (Cloudflare, DataDome, PerimeterX, etc.)
  • Points to the right mitigation for each (proxies, Profiles, stealth, computer controls)
  • Points to Managed Auth for logged-in workflows (positively, not as a limitation)
  • Recommends manual testing of the target site before automating

Notes

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only copy and link updates with no runtime or API behavior changes.

Overview
The browsers FAQ no longer names LinkedIn, Facebook, Instagram, X, Amazon, and Reddit as unsupported. The Unsupported Websites section becomes Bot detection varies by site, explaining that friction depends on approach and scale rather than a binary supported/unsupported list.

It adds practical drivers of detection—high-volume scraping from shared exit IPs and aggressive vendors (Cloudflare, DataDome, PerimeterX, Imperva, Akamai)—with pointers to proxies, Profiles, stealth mode, computer controls, and Managed Auth for logged-in flows. An <Info> callout directs readers to test targets manually and use the bot detection guide.

Reviewed by Cursor Bugbot for commit ba58603. Bugbot is set up for automated code reviews on this repo. Configure here.

The flat "Unsupported Websites" list overstated reality: Kernel
browsers navigate these sites fine. Friction shows up on login flows,
high-volume scraping, and aggressive-vendor sites, not on page loads.
Replace the list with guidance on where resistance actually occurs and
which mitigations to use.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 22, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs Error Error Jul 22, 2026 6:22am

@masnwilliams
masnwilliams marked this pull request as ready for review July 22, 2026 06:19
@mintlify

mintlify Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Kernel 🟢 Ready View Preview Jul 22, 2026, 6:19 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Risk assessment: Very Low

This changes one FAQ MDX file (11 additions, 8 deletions) and only updates user-facing documentation copy plus links to existing documentation pages. It doesn't modify runtime logic, configuration, infrastructure, security boundaries, or model prompts. The changed surface is narrow, and the broken-links and Mintlify checks passed.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Drop login/account-creation from the "where you'll hit resistance"
list so it doesn't frame login as a limitation. Managed Auth handles
that, so point to it positively instead.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Risk assessment: Very Low

The updated diff still changes only browsers/faq.mdx: it removes one FAQ bullet and rephrases the Managed Auth guidance. The PR modifies documentation copy and links only, with no runtime logic, configuration, infrastructure, security boundary, or model-prompt changes. The latest update doesn't increase the narrow user-facing blast radius.

The PR already has an approval, so I haven't submitted another approval.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Remove any claim about whether specific sites can or cannot be
automated, and stop naming individual sites. Explain that detection is
site- and configuration-specific and what drives it.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@masnwilliams masnwilliams changed the title Reframe FAQ 'Unsupported Websites' as bot-detection guidance Reframe FAQ 'Unsupported Websites' as bot-detection education Jul 22, 2026

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Risk assessment: Very Low

The current diff changes only browsers/faq.mdx (12 additions, 8 deletions), replacing FAQ copy and adding links to existing documentation pages. It doesn't modify runtime code, configuration, infrastructure, security boundaries, or model prompts. The update since the approved commit remains limited to documentation wording, so the risk hasn't increased.

I also verified that all six newly referenced local documentation routes exist and that the diff passes git diff --check. The PR already has an approval, so I haven't submitted another approval.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@masnwilliams
masnwilliams merged commit 0e68857 into main Jul 22, 2026
6 of 7 checks passed
@masnwilliams
masnwilliams deleted the hypeship/faq-site-bot-detection branch July 22, 2026 06:24
@mintlify

mintlify Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Kernel 🟡 Building Jul 22, 2026, 6:18 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

masnwilliams added a commit that referenced this pull request Jul 22, 2026
Brings in the latest content edits from main — the FAQ 'Unsupported
Websites' → bot-detection reframing (#459) and the per-browser-type
Stripe pricing updates. Rename detection carried them onto the migrated
content/docs paths; no code overlap, build + lint green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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