Skip to content

feat: gem v0.26.0 updates (drop browserless, capture, mcp, botasaurus improvements) - #1232

Merged
gildesmarais merged 15 commits into
mainfrom
feat/drop-browserless
Aug 16, 2026
Merged

feat: gem v0.26.0 updates (drop browserless, capture, mcp, botasaurus improvements)#1232
gildesmarais merged 15 commits into
mainfrom
feat/drop-browserless

Conversation

@gildesmarais

@gildesmarais gildesmarais commented Aug 15, 2026

Copy link
Copy Markdown
Member

This pull request updates documentation and configuration to reflect the migration from the deprecated Browserless strategy to Botasaurus for browser-based scraping, improves guidance for creating and sharing custom feed configs, and introduces new documentation for advanced workflows and config capture. It also updates dependencies and simplifies Docker Compose usage by removing Watchtower snippets.

Migration to Botasaurus and Strategy Updates:

  • Updated all references and guidance from the deprecated browserless strategy to botasaurus for browser-based scraping, including configuration examples, migration instructions, and option keys. This clarifies that Botasaurus is now the standard for JavaScript-rendered and anti-bot sites, and removes Browserless-specific documentation. [1] [2] [3] [4] [5] [6]

Feed Config Authoring and Contribution Guidance:

  • Enhanced the recommended workflow for creating custom feeds by adding a step for capturing draft configs with html2rss capture, and clarified when and how to escalate to Botasaurus.
  • Updated instructions for sharing configs with the community: configs should now be added under lib/html2rss/configs/domain.com/name.yml and must include directory.topics metadata from a controlled vocabulary. Provided example metadata and topic list. [1] [2]

New and Expanded Documentation:

  • Added a new guide on capturing feed configs (capture) with CLI and Ruby API usage, best practices, and follow-up steps.
  • Introduced a new guide for integrating html2rss with AI agents via the Model Context Protocol (MCP), including setup for Cursor and Claude Desktop, and workflow patterns for autonomous feed generation and validation.

Dependency and Docker Compose Updates:

  • Changed the html2rss gem dependency from a Git reference to a versioned release (~> 0.26) in the Gemfile, ensuring stability and compatibility.
  • Removed Watchtower-related code and variants from Docker Compose snippets and component props, simplifying deployment documentation. [1] [2]

Feed Directory and Navigation Improvements:

  • Updated the Feed Directory onboarding text to clarify its purpose as a fallback/catalog and highlighted the use of topic/language filters and OPML export.
  • Adjusted navigation redirects for deployment and automatic updates documentation to improve user experience.

@gildesmarais
gildesmarais force-pushed the feat/drop-browserless branch from 2afb822 to 267266d Compare August 15, 2026 15:22
@gildesmarais gildesmarais changed the title feat: drop browserless feat: gem v0.26.0 updates (drop browserless, botasaurus improvements) Aug 16, 2026
…warding

Add execution_mode, organic_get, scroll, scroll_to_bottom, block_trackers,
headers, and cookies to the botasaurus options table in strategy reference.
Update the custom HTTP requests guide to mention header/cookie forwarding.

These options were added in commits 9ca09a0 and a41ab3f of the core repo.
Document html2rss capture as a draft-config workflow and note that
Botasaurus browser-tier XHR JSON feeds AutoSource xhr_articles.
Describe always-on Botasaurus XHR captures as a first-class AutoSource
strategy alongside json_state, with enable toggle and limitations.
Document the controlled topics vocabulary, capture-first authoring
workflow, and topic/language filters on the Feed Directory page.
Explain xhr_responses forwarding into captured_responses and add
DataDome blocked-surface recovery steps in troubleshooting.
@gildesmarais
gildesmarais force-pushed the feat/drop-browserless branch from ce1515d to d31f69c Compare August 16, 2026 14:18
@gildesmarais
gildesmarais marked this pull request as ready for review August 16, 2026 15:34
@gildesmarais gildesmarais changed the title feat: gem v0.26.0 updates (drop browserless, botasaurus improvements) feat: gem v0.26.0 updates (drop browserless, capture, mcp, botasaurus improvements) Aug 16, 2026
Comment thread src/content/docs/ruby-gem/guides/capturing-feed-configs.mdx Outdated
Comment thread src/content/docs/ruby-gem/guides/capturing-feed-configs.mdx Outdated
Comment thread src/content/docs/ruby-gem/guides/capturing-feed-configs.mdx Outdated
Co-authored-by: Gil Desmarais <gildesmarais@users.noreply.github.com>
@gildesmarais
gildesmarais merged commit 1897194 into main Aug 16, 2026
5 checks passed
@gildesmarais
gildesmarais deleted the feat/drop-browserless branch August 16, 2026 15:47
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