Bright Data Web MCP for Claude Code: Setup & Config

What you can do with Bright Data Web in Claude Code

Choose configurable live-web access spanning search, extraction, datasets, and package intelligence.

• Research current web information and extract readable page content.
• Compare AI-generated brand mentions across supported LLM services.

Before you start: Bright Data Web in Claude Code

• Node.js with npx for local execution
• A Bright Data account and API token
• An MCP-compatible client

This configuration uses the local process. A hosted endpoint is also documented. Rapid mode is the default; optional groups and Pro tools can change usage costs.

Bright Data Web Claude Code configuration

1. Choose Claude Code configuration scope

   For Bright Data Web MCP, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

2. Add Bright Data Web MCP to Claude Code

   Use the brightdata-mcp entry below in mcpServers. Keep Bright Data Web MCP's documented stdio connection fields and your other Claude Code entries.

3. Check Bright Data Web MCP in Claude Code

   Bright Data Web MCP: Inspect claude mcp list and /mcp status.

{
  "mcpServers": {
    "brightdata-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@brightdata/mcp"
      ],
      "env": {
        "API_TOKEN": "<your Bright Data API token>"
      }
    }
  }
}

claude mcp add-json --scope project 'brightdata-mcp' '{"type":"stdio","command":"npx","args":["@brightdata/mcp"],"env":{"API_TOKEN":"<your Bright Data API token>"}}'

Bright Data Web tools available to Claude Code

Bright Data Web's stored tool list documents 30 tools; compare it with Claude Code's connected tool list, because the stored list is not a live check.

search_engine

For Bright Data Web's search_engine, review the permission request and arguments in Claude Code before approval.

Search the live web for results suitable for an assistant's research workflow.

search_engine_batch

For Bright Data Web's search_engine_batch, review the permission request and arguments in Claude Code before approval.

Run multiple web searches as a batch.

scrape_as_markdown

For Bright Data Web's scrape_as_markdown, review the permission request and arguments in Claude Code before approval.

Extract a web page into Markdown content.

scrape_batch

For Bright Data Web's scrape_batch, review the permission request and arguments in Claude Code before approval.

Retrieve content from multiple pages in one batch workflow.

discover

For Bright Data Web's discover, review the permission request and arguments in Claude Code before approval.

Find web results ranked against the intent of a research query.

scrape_as_html

For Bright Data Web's scrape_as_html, review the permission request and arguments in Claude Code before approval.

Retrieve HTML through an explicitly selected scraping tool.

extract

For Bright Data Web's extract, review the permission request and arguments in Claude Code before approval.

Use the advanced scraping group for AI-assisted extraction.

scraping_browser_snapshot

For Bright Data Web's scraping_browser_snapshot, review the permission request and arguments in Claude Code before approval.

Inspect the state of a remotely controlled browser.

scraping_browser_click_ref

For Bright Data Web's scraping_browser_click_ref, review the permission request and arguments in Claude Code before approval.

scraping_browser_screenshot

For Bright Data Web's scraping_browser_screenshot, review the permission request and arguments in Claude Code before approval.

web_data_amazon_product

For Bright Data Web's web_data_amazon_product, review the permission request and arguments in Claude Code before approval.

web_data_walmart_product

For Bright Data Web's web_data_walmart_product, review the permission request and arguments in Claude Code before approval.

web_data_google_shopping

For Bright Data Web's web_data_google_shopping, review the permission request and arguments in Claude Code before approval.

web_data_linkedin_posts

For Bright Data Web's web_data_linkedin_posts, review the permission request and arguments in Claude Code before approval.

web_data_tiktok_posts

For Bright Data Web's web_data_tiktok_posts, review the permission request and arguments in Claude Code before approval.

web_data_youtube_videos

For Bright Data Web's web_data_youtube_videos, review the permission request and arguments in Claude Code before approval.

web_data_yahoo_finance_business

For Bright Data Web's web_data_yahoo_finance_business, review the permission request and arguments in Claude Code before approval.

web_data_crunchbase_company

For Bright Data Web's web_data_crunchbase_company, review the permission request and arguments in Claude Code before approval.

web_data_zoominfo_company_profile

For Bright Data Web's web_data_zoominfo_company_profile, review the permission request and arguments in Claude Code before approval.

web_data_zillow_properties_listing

For Bright Data Web's web_data_zillow_properties_listing, review the permission request and arguments in Claude Code before approval.

web_data_github_repository_file

For Bright Data Web's web_data_github_repository_file, review the permission request and arguments in Claude Code before approval.

web_data_reuter_news

For Bright Data Web's web_data_reuter_news, review the permission request and arguments in Claude Code before approval.

web_data_google_play_store

For Bright Data Web's web_data_google_play_store, review the permission request and arguments in Claude Code before approval.

Retrieve Google Play store data.

web_data_apple_app_store

For Bright Data Web's web_data_apple_app_store, review the permission request and arguments in Claude Code before approval.

Retrieve Apple App Store data.

web_data_booking_hotel_listings

For Bright Data Web's web_data_booking_hotel_listings, review the permission request and arguments in Claude Code before approval.

Access Booking hotel listing information.

web_data_chatgpt_ai_insights

For Bright Data Web's web_data_chatgpt_ai_insights, review the permission request and arguments in Claude Code before approval.

Query ChatGPT for structured AI insights and brand visibility research.

web_data_grok_ai_insights

For Bright Data Web's web_data_grok_ai_insights, review the permission request and arguments in Claude Code before approval.

Query Grok for AI insights useful in brand visibility research.

web_data_perplexity_ai_insights

For Bright Data Web's web_data_perplexity_ai_insights, review the permission request and arguments in Claude Code before approval.

Query Perplexity for sourced AI answers and brand visibility research.

web_data_npm_package

For Bright Data Web's web_data_npm_package, review the permission request and arguments in Claude Code before approval.

Look up npm package versions, documentation, and dependency metadata.

web_data_pypi_package

For Bright Data Web's web_data_pypi_package, review the permission request and arguments in Claude Code before approval.

Bright Data Web: full stored tool descriptions

Troubleshooting Bright Data Web in Claude Code

• If Bright Data Web MCP fails to start, check npx @brightdata/mcp (Node.js/npm), the working directory, and Claude Code's selected scope; inspect claude mcp list and /mcp.
• Bright Data Web MCP: check API_TOKEN; keep credentials out of shared .mcp.json.
• Bright Data Web MCP uses stdio here: Claude Code must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Requires a Bright Data API token.
• Known limitation: Browser automation and Pro capabilities incur usage charges.
• Known limitation: Requests stop after the free credit pool is exhausted unless funds are available.
• General Claude Code troubleshooting lives in the /clients/claude-code guide.

Frequently asked questions