arcade-mcp/toolkits
meirk-brd 274fb1c025
add Bright Data toolkit (#542)
# Add Bright Data Web Scraping and Data Extraction Toolkit

## Overview
This PR introduces a comprehensive Bright Data toolkit that provides web
scraping, search, and structured data extraction capabilities through
the Bright Data API.

## Features Added

### Core Tools
1. **`scrape_as_markdown`** - Scrapes any webpage and returns clean
Markdown content
2. **`get_screenshot`** - Captures screenshots of webpages and saves
them locally
3. **`search_engine`** - Advanced search functionality across Google,
Bing, and Yandex with customizable parameters
4. **`web_data_feed`** - Extracts structured data from major platforms
(LinkedIn, Amazon, Instagram, Facebook, X, YouTube, Zillow, Booking.com,
etc.)

### Supporting Infrastructure
- **`BrightDataClient`** 
- Error handling
- URL encoding utilities and request optimization

## Technical Details

### Search Engine Capabilities
- Multi-engine support (Google, Bing, Yandex)
- Advanced parameters: language, country, search type (images, shopping,
news)
- Device targeting (mobile, iOS, Android, iPad)
- Pagination and result count control
- Location-based searches

### Structured Data Sources
Supports 13+ data sources including:
- **E-commerce**: Amazon products and reviews
- **Professional**: LinkedIn profiles and companies, ZoomInfo
- **Social Media**: Instagram, Facebook, X (Twitter) content
- **Real Estate**: Zillow property listings
- **Travel**: Booking.com hotel listings
- **Video**: YouTube videos and metadata


## Testing & Validation
- [x] Deployed and tested on personal account
- [x] Tested via ngrok as well 
- [x] Verified all tool functions work as expected
- [x] Validated against multiple data sources and search engines
- [x] Confirmed error handling and edge cases


## Security & Best Practices
- Requires proper API key and zone configuration via secrets

## Dependencies
- `requests` - HTTP client
- `arcade_tdk` - Arcade toolkit framework
- Standard library modules: `json`, `time`, `typing`, `urllib.parse`

## Notes
- All tools require `BRIGHTDATA_API_KEY` secret
- Search and scraping tools also require `BRIGHTDATA_ZONE` secret
- Follows Arcade AI toolkit patterns and conventions
- Comprehensive docstrings with examples provided

This toolkit significantly expands Arcade AI's web data capabilities,
enabling users to scrape, search, and extract structured data from
across the web through a single, unified interface.

---------
Authored-by: meirk-brd
2025-10-15 16:47:45 -04:00
..
airtable_api [MOAR][AIRTABLE] Adding AirTable starter tools (+49) (#615) 2025-10-13 15:13:39 -03:00
box_api Box.com Starter MCP Server (#584) 2025-10-01 23:05:16 -03:00
brightdata add Bright Data toolkit (#542) 2025-10-15 16:47:45 -04:00
calendly_api [MOAR][Calendly] Adding Calendly starter toolkit (#605) 2025-10-10 17:23:09 -03:00
clickhouse Local MCP Fixes and Address General Feedback (#586) 2025-09-29 16:00:47 -07:00
cursor_agents_api Cursor Agents Starter MCP Server tools (#625) 2025-10-15 10:41:35 -03:00
freshservice_api Freshservice Starter MCP Server tools (#623) 2025-10-14 22:27:58 -03:00
linkedin Local MCP Fixes and Address General Feedback (#586) 2025-09-29 16:00:47 -07:00
math Local MCP Fixes and Address General Feedback (#586) 2025-09-29 16:00:47 -07:00
miro_api [Moar][Miro] Miro tools added (#602) 2025-10-13 15:11:56 -03:00
mongodb Local MCP Fixes and Address General Feedback (#586) 2025-09-29 16:00:47 -07:00
pagerduty_api [MOAR][PAGERDUTY] Adding PagerDuty Tools (#609) 2025-10-13 15:10:26 -03:00
postgres Local MCP Fixes and Address General Feedback (#586) 2025-09-29 16:00:47 -07:00
slack_api Local MCP Fixes and Address General Feedback (#586) 2025-09-29 16:00:47 -07:00
squareup_api [MOAR][SquareUP] Adding square up toolkit (#596) 2025-10-10 17:03:56 -03:00
stripe_api Stripe Starter toolkit (#590) 2025-10-01 21:42:38 -03:00
trello_api [MOAR][TRELLO] Adding trello tools (#591) 2025-10-06 13:09:49 -03:00
xero_api Xero API Starter MCP server (#603) 2025-10-10 16:35:55 -03:00
zendesk Local MCP Fixes and Address General Feedback (#586) 2025-09-29 16:00:47 -07:00