Skip to content

CHANGELOG.md

Latest commit

 

History

History
236 lines (176 loc) · 8.63 KB

CHANGELOG.md

File metadata and controls

236 lines (176 loc) · 8.63 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

[4.0.0] - 2026-10-18

Added

  • ask_brightdata_assistant: ask Sophie, Bright Data's support assistant, about products, zones, errors or setup. Pass the returned dialog_id to ask a follow-up. On by default and in every group, as on the hosted server.

Changed

  • Playwright is pinned to 1.64.1, the same version as the hosted server.

Removed

  • BREAKING: The discover tool and its Discover API integration. It was in every tool group and on by default, so it is no longer served in any config. Use search_engine or search_engine_batch to find sources and scrape_as_markdown or scrape_batch to read them.
  • POLLING_TIMEOUT. The AI insights tools wait up to 600 seconds, as before. Configs that set it keep working; it is ignored.

[3.1.0] - 2026-10-15

Changed

  • All tools are on by default, including the browser tools, scrape_as_html, search_dataset and session_stats. Set GROUPS or TOOLS to limit the server to those tools only.
  • Results from search, scrape, scraper, dataset and browser tools are marked as untrusted web content, so the model treats text inside them as data, not instructions. Error bodies from scraped sites are marked too.
  • The web_scraping_strategy and diagnose_scraping_approach prompts are reformatted, and no longer describe tools by cost.
  • The Docker image runs on Node.js 24.

Removed

  • PRO_MODE. Existing configs that set it keep working; it is ignored.

[3.0.0] - 2026-10-11

Removed

  • 46 web_data_* tools (Amazon, LinkedIn, Instagram, TikTok, YouTube, npm, PyPI and others). The scraper tools cover the same scrapers and 1,200+ more: search_scrapers → get_scraper_details → run_scraper.
  • web_data_grok_ai_insights and web_data_reuter_news. Their scrapers no longer exist, so these tools always failed.

Changed

  • web_data_chatgpt_ai_insights and web_data_perplexity_ai_insights are renamed to chatgpt_ai_insights and perplexity_ai_insights.
  • Existing configs keep working. Old group IDs (ecommerce, social, business, finance, research, app_stores, travel, code) now enable the scraper tools, and old web_data_* names in TOOLS enable the scraper tools or the renamed AI tools.
  • Scraper tool requests send the scraper's dataset ID and method in x-mcp-dataset-id and x-mcp-method headers, so failed runs can be traced to a scraper.
  • If you installed the bright-data-mcp, competitive-intel or price-comparison skills, update them: older versions tell the agent to use the removed tools.

[2.12.0] - 2026-10-08

Added

  • Web Scraper API tools: search_scrapers, get_scraper_details, run_scraper, get_scraper_progress, get_scraper_results and refresh_scrapers. They give access to all 1,200+ pre-built scrapers from a catalog that updates itself, with no hardcoded list. On by default, or select them with the new scrapers group.
  • run_scraper waits up to 45 seconds. If the data is not ready by then, it returns a snapshot ID for get_scraper_progress and get_scraper_results.
  • Content gate: when page content from scrape_as_markdown, search_engine, extract or their batch variants looks like instructions to change the MCP configuration, the server asks the user (via MCP elicitation) before returning it. Configure it with CONTENT_GATE and CONTENT_GATE_TIMEOUT (PR #190).

[2.11.3] - 2026-09-15

Security

  • Credentials embedded in URLs (scheme://user:pass@host) are now redacted from error output.

[2.11.2] - 2026-09-10

Security

  • Hardened scrape_batch error handling to always report failed requests as sanitized error strings instead of raw error objects.

Changed

  • Errors thrown from tools are now re-thrown as sanitized Error instances. Messages for HTTP and network failures are unchanged; non-Error throws are now reported as Tool execution failed.

Fixed

  • Fixed a broken string concatenation in the usage-limit error message that caused a TypeError instead of the intended error.

[2.11.1] - 2026-07-27

Fixed

  • Fixed compatibility with updated Playwright API: replaced deprecated page._snapshotForAI() with page.ariaSnapshot({ mode: 'ai' }), restoring correct functionality of scraping_browser_snapshot and all ref-based browser automation tools

[2.11.0] - 2026-07-26

Added

  • Added reddit_comments tool to collect Reddit post comments

[2.10.0] - 2026-06-04

Added

  • search_dataset tool to search supported datasets by a filter and get matching records back directly via the fast search API (PR #142)
  • list_dataset_fields tool to discover a dataset's filterable fields (name, type, description) before building a filter (PR #142)

[2.6.0] - 2025-10-27

Added

  • Client name logging and header passthrough for improved observability (PR #75)
  • ARIA ref-based browser automation for more reliable element interactions (PR #65)
  • ARIA snapshot filtering for better element targeting
  • Network request tracking in browser sessions
  • MCP Registry support (PR #71)
  • scraping_browser_snapshot tool to capture ARIA snapshots
  • scraping_browser_click_ref, scraping_browser_type_ref, scraping_browser_wait_for_ref tools using ref-based selectors
  • scraping_browser_network_requests tool to track HTTP requests

Changed

  • Enhanced search engine tool to return JSON with only relevant fields (PR #57)
  • Added fixed_values parameter to reduce token usage (PR #60)
  • Browser tools now use ARIA refs instead of CSS selectors for better reliability

Fixed

  • Stop polling on HTTP 400 errors in web data tools (PR #64)

Deprecated

  • Legacy selector-based tools (scraping_browser_click, scraping_browser_type, scraping_browser_wait_for) replaced by ref-based equivalents
  • scraping_browser_links tool deprecated in favor of snapshot-based approach

[2.0.0] - 2025-05-26

Changed

  • Updated browser authentication to use API_TOKEN instead of previous authentication method
  • BROWSER_ZONE is now an optional parameter, the deafult zone is mcp_browser
  • Removed duplicate web_data_ tools

[1.9.2] - 2025-05-23

Fixed

  • Fixed GitHub references and repository settings

[1.9.1] - 2025-05-21

Fixed

  • Fixed spelling errors and improved coding conventions
  • Converted files back to Unix line endings for consistency

[1.9.0] - 2025-05-21

Added

  • Added 23 new web data tools for enhanced data collection capabilities
  • Added progress reporting functionality for better user feedback
  • Added default parameter handling for improved tool usability

Changed

  • Improved coding conventions and file formatting
  • Enhanced web data API endpoints integration

[1.8.3] - 2025-05-21

Added

  • Added Bright Data MCP with Claude demo video to README.md

Changed

  • Updated documentation with video demonstrations

[1.8.2] - 2025-05-13

Changed

  • Bumped FastMCP version for improved performance
  • Updated README.md with additional documentation

[1.8.1] - 2025-05-05

Added

  • Added 12 new WSAPI endpoints for enhanced functionality
  • Changed to polling mechanism for better reliability

Changed

  • Applied dos2unix formatting for consistency
  • Updated Docker configuration
  • Updated smithery.yaml configuration

[1.8.0] - 2025-05-03

Added

  • Added domain-based browser sessions to avoid navigation limit issues
  • Added automatic creation of required unlocker zone when not present

Fixed

  • Fixed browser context maintenance across tool calls with current domain tracking
  • Minor lint fixes

[1.0.0] - 2025-04-29

Added

  • Initial release of Bright Data MCP server
  • Browser automation capabilities with Bright Data integration
  • Core web scraping and data collection tools
  • Smithery.yaml configuration for deployment in Smithery.ai
  • MIT License
  • Demo materials and documentation

Documentation

  • Created comprehensive README.md
  • Added demo.md with usage examples
  • Created examples/README.md for sample implementations
  • Added Tools.md documentation for available tools

Release Notes

Version 1.9.x Series

The 1.9.x series focuses on expanding web data collection capabilities and improving authentication mechanisms. Key highlights include the addition of 23 new web data tools.

Version 1.8.x Series

The 1.8.x series introduced significant improvements to browser session management, WSAPI endpoints, and overall system reliability. Notable features include domain-based sessions and automatic zone creation.

Version 1.0.0

Initial stable release providing core MCP server functionality for Bright Data integration with comprehensive browser automation and web scraping capabilities.