Repository files navigation

This demo suite showcases autonomous AI agents using Strands framework with Bright Data MCP tools for competitive intelligence and market analysis.

The demo demonstrates how Strands agents can autonomously decide which web data tools to use based on natural language prompts, showcasing true agentic behavior with real Bright Data MCP integration.

1. Environment Setup:

   • Python 3.8+
   • Virtual environment with required packages
   • .env file with API keys

2. Required API Keys:

   ANTHROPIC_API_KEY=your_anthropic_key_hereBRIGHT_DATA_API_KEY=your_bright_data_token_hereANTHROPIC_MODEL=claude-3-opus-20240229

3. Claude Desktop MCP Configuration (if using hosted MCP):

   • Bright Data MCP configured in Claude Desktop
   • Usesmcp-remote for hosted MCP connection

# Create virtual environmentpython -m venv venvsource venv/bin/activate# On Windows: venv\Scripts\activate# Install requirementspip install -r requirements.txt# Set up environmentcp .env.example .env# Edit .env with your API keys

Purpose: Demonstrates autonomous market research and analysis

What it shows:

• Agent autonomously selects tools for market discovery
• Uses search_engine for market research
• Scrapes competitor websites for detailed analysis
• Provides comprehensive market intelligence

Usage:

python demo1_market_analysis.py

Key Features:

• Market size and growth analysis
• Competitive landscape mapping
• Strategic opportunity identification
• Quantitative market insights

Purpose: Shows deep competitor analysis with website scraping

What it shows:

• Agent autonomously gathers competitor intelligence
• Uses scrape_as_markdown for detailed website analysis
• Extracts pricing, product details, and strategy
• Identifies competitive advantages and vulnerabilities

Usage:

python demo2_competitor_analysis.py

Key Features:

• Deep competitor website analysis
• Product and pricing strategy extraction
• Competitive positioning assessment
• Strategic vulnerability identification

Purpose: Demonstrates coordinated multi-phase analysis

What it shows:

• Agent orchestrates complex multi-step workflows
• Coordinates market discovery and competitor analysis
• Synthesizes insights across multiple analysis phases
• Provides executive-level strategic recommendations

Usage:

python demo3_multi_step_workflow.py

Key Features:

• Multi-phase workflow coordination
• Strategic synthesis of complex intelligence
• Executive-level recommendations
• Comprehensive competitive landscape analysis

The demos use these Bright Data MCP tools:

1. search_engine: Scrape search results from Google, Bing, or Yandex
2. scrape_as_markdown: Scrape single webpage with advanced content extraction
3. search_engine_batch: Run multiple search queries simultaneously
4. scrape_batch: Scrape multiple webpages with batch processing

• base_agent.py: Shared base class with MCP connection logic
• demo1_market_analysis.py: Market research focused agent
• demo2_competitor_analysis.py: Competitive intelligence focused agent
• demo3_multi_step_workflow.py: Multi-phase workflow coordination

✅Autonomous Tool Selection: Agents decide which tools to use based on prompts✅Real Web Data: Uses actual Bright Data MCP for web scraping✅Agentic Behavior: No hardcoded tool sequences - true AI decision making✅Production Ready: Real API integration with error handling✅Modular Design: Separate demos for different use cases

MCP Connection Issues:

• Ensure Bright Data MCP is configured in Claude Desktop
• Check that BRIGHT_DATA_API_KEY is set correctly
• Verifymcp-remote is available via npx

Anthropic API Issues:

• Ensure ANTHROPIC_API_KEY is valid and has sufficient credits
• Check API key permissions and rate limits

Import Issues:

• Ensure all required packages are installed
• Check Python version compatibility (3.8+)

When running successfully, you'll see:

• MCP connection establishment
• Tool discovery (4 Bright Data tools)
• Agent autonomous tool selection
• Real-time web data extraction
• Comprehensive analysis results

The agent will autonomously decide to use multiple tools in sequence, demonstrating true agentic workflow behavior.