Mcp Tools

# Bright Data MCP Tools Reference Complete reference for all Bright Data MCP server tools, organized by mode and category. ## Rapid (Free) Tools Available by default, no special configuration needed. ### search_engine Scrape search results from Google, Bing, or Yandex. Returns SERP results in JSON for Google and Markdown for Bing/Yandex. Supports pagination with the `cursor` parameter. ### scrape_as_markdown Scrape a single webpage with advanced extraction and return Markdown. Uses Bright Data's unlocker to handle bot protection and CAPTCHA. ### search_engine_batch Run up to 10 search queries in parallel. Returns JSON for Google results and Markdown for Bing/Yandex. Requires `advanced_scraping` group or Pro mode. ### scrape_batch Scrape up to 10 webpages in one request and return an array of URL/content pairs in Markdown format. Requires `advanced_scraping` group or Pro mode. --- ## Pro Tools by Group ### Advanced Scraping Group (`advanced_scraping`) | Tool | Description | |------|-------------| | `scrape_as_html` | Scrape a webpage and return raw HTML. Handles bot detection and CAPTCHA. | | `extract` | Scrape a webpage as Markdown, then convert to structured JSON using AI. Accepts optional custom extraction prompt. | | `session_stats` | Report how many times each tool has been called during the current MCP session. | | `search_engine_batch` | Run up to 10 search queries in parallel. | | `scrape_batch` | Scrape up to 10 webpages in one request. | ### E-Commerce Group (`ecommerce`) | Tool | URL Requirement | Description | |------|-----------------|-------------| | `web_data_amazon_product` | Must contain `/dp/` | Structured Amazon product data (title, price, rating, images, etc.) | | `web_data_amazon_product_reviews` | Must contain `/dp/` | Structured Amazon review data | | `web_data_amazon_product_search` | Requires keyword + Amazon domain URL | Structured search results (first page only) | | `web_data_walmart_product` | Must contain `/ip/` | Structured Walmart product data | | `web_data_walmart_seller` | Valid Walmart seller URL | Structured seller data | | `web_data_ebay_product` | Valid eBay product URL | Structured eBay listing data | | `web_data_homedepot_products` | Valid homedepot.com URL | Structured Home Depot data | | `web_data_zara_products` | Valid Zara product URL | Structured Zara data | | `web_data_etsy_products` | Valid Etsy product URL | Structured Etsy data | | `web_data_bestbuy_products` | Valid Best Buy product URL | Structured Best Buy data | | `web_data_google_shopping` | Valid Google Shopping URL | Structured Google Shopping data | ### Social Media Group (`social`) | Tool | URL Requirement | Description | |------|-----------------|-------------| | `web_data_linkedin_person_profile` | Valid LinkedIn profile URL | Profile data (experience, skills, education) | | `web_data_linkedin_company_profile` | Valid LinkedIn company URL | Company profile data | | `web_data_linkedin_job_listings` | Valid LinkedIn jobs URL | Job listing details | | `web_data_linkedin_posts` | Valid LinkedIn post URL | Post content and engagement | | `web_data_linkedin_people_search` | LinkedIn people search URL | People search results | | `web_data_instagram_profiles` | Valid Instagram profile URL | Bio, followers, following | | `web_data_instagram_posts` | Valid Instagram post URL | Post details, likes, captions | | `web_data_instagram_reels` | Valid Instagram reel URL | Reel data and metrics | | `web_data_instagram_comments` | Valid Instagram URL | Post comments | | `web_data_facebook_posts` | Valid Facebook post URL | Post content and reactions | | `web_data_facebook_marketplace_listings` | Valid Marketplace listing URL | Listing details | | `web_data_facebook_company_reviews` | Valid Facebook company URL (+ optional review count) | Company reviews | | `web_data_facebook_events` | Valid Facebook event URL | Event details | | `web_data_tiktok_profiles` | Valid TikTok profile URL | Creator profile data | | `web_data_tiktok_posts` | Valid TikTok post URL | Video details and metrics | | `web_data_tiktok_shop` | Valid TikTok Shop product URL | Product data | | `web_data_tiktok_comments` | Valid TikTok video URL | Video comments | | `web_data_x_posts` | Valid X (Twitter) post URL | Tweet data | | `web_data_youtube_videos` | Valid YouTube video URL | Video metadata | | `web_data_youtube_profiles` | Valid YouTube channel URL | Channel profile data | | `web_data_youtube_comments` | Valid YouTube video URL (+ optional num_of_comments, default 10) | Video comments | | `web_data_reddit_posts` | Valid Reddit post URL | Post and comment data | ### Business Intelligence Group (`business`) | Tool | URL Requirement | Description | |------|-----------------|-------------| | `web_data_crunchbase_company` | Valid Crunchbase company URL | Company funding, employees, rounds | | `web_data_zoominfo_company_profile` | Valid ZoomInfo company URL | Company profile data | | `web_data_google_maps_reviews` | Valid Google Maps URL (+ optional days_limit, default 3) | Business reviews | | `web_data_zillow_properties_listing` | Valid Zillow listing URL | Property listing data | ### Finance Group (`finance`) | Tool | URL Requirement | Description | |------|-----------------|-------------| | `web_data_yahoo_finance_business` | Valid Yahoo Finance business URL | Company profile and stock data | ### Research Group (`research`) | Tool | URL Requirement | Description | |------|-----------------|-------------| | `web_data_reuter_news` | Valid Reuters news article URL | Structured news data | | `web_data_github_repository_file` | Valid GitHub file URL | Repository file data | ### App Stores Group (`app_stores`) | Tool | URL Requirement | Description | |------|-----------------|-------------| | `web_data_google_play_store` | Valid Play Store app URL | App data and reviews | | `web_data_apple_app_store` | Valid App Store app URL | App data and reviews | ### Travel Group (`travel`) | Tool | URL Requirement | Description | |------|-----------------|-------------| | `web_data_booking_hotel_listings` | Valid Booking.com listing URL | Hotel listing data | ### Browser Automation Group (`browser`) Use these tools in sequence for interactive web automation. | Tool | Description | |------|-------------| | `scraping_browser_navigate` | Open or reuse a session, navigate to URL. Resets tracked network requests. | | `scraping_browser_go_back` | Navigate back to the previous page. | | `scraping_browser_go_forward` | Navigate forward to the next page. | | `scraping_browser_snapshot` | Capture ARIA snapshot listing interactive elements with refs. | | `scraping_browser_click_ref` | Click an element by its ref from the ARIA snapshot. Requires ref + human-readable description. | | `scraping_browser_type_ref` | Fill an input element by ref. Optionally press Enter after typing. | | `scraping_browser_screenshot` | Capture screenshot. Supports optional `full_page` mode. | | `scraping_browser_network_requests` | List network requests since page load (method, URL, status). | | `scraping_browser_wait_for_ref` | Wait until an element becomes visible (optional timeout in ms). | | `scraping_browser_get_text` | Return the text content of the page body. | | `scraping_browser_get_html` | Return page HTML. Avoid `full_page` unless head/script tags are needed. | | `scraping_browser_scroll` | Scroll to the bottom of the page. | | `scraping_browser_scroll_to_ref` | Scroll until a specific element (by ARIA ref) is in view. | #### Browser Automation Best Practices 1. Always start with `scraping_browser_navigate` to open the target URL 2. Use `scraping_browser_snapshot` to discover interactive elements before clicking/typing 3. Use refs from the snapshot (not selectors) for all interactions 4. After interactions, take a new `scraping_browser_snapshot` to see updated state 5. Use `scraping_browser_screenshot` to visually verify state when debugging 6. Use `scraping_browser_wait_for_ref` before interacting with elements that load dynamically 7. Extract final content with `scraping_browser_get_text` or `scraping_browser_get_html` --- ## Available Groups Summary | Group | Description | Key Tools | |-------|-------------|-----------| | `ecommerce` | E-commerce platforms | Amazon, Walmart, eBay, Best Buy, Etsy, etc. | | `social` | Social media & professional | LinkedIn, Instagram, Facebook, TikTok, YouTube, X, Reddit | | `business` | Business intelligence | Crunchbase, ZoomInfo, Google Maps, Zillow | | `finance` | Financial data | Yahoo Finance | | `research` | Research & news | Reuters, GitHub | | `app_stores` | App stores | Google Play, Apple App Store | | `travel` | Travel platforms | Booking.com | | `browser` | Browser automation | Navigate, click, type, screenshot, extract | | `advanced_scraping` | Advanced extraction | HTML scraping, AI extraction, batch operations |