git clone <repository>
cd mcp-webscout
python -m venv .venv

.venv\Scripts\activate

source .venv/bin/activate

pip install -e ".[dev]"

playwright install chromium

cp .env.example .env

# Required for LLM extraction
DEEPSEEK_API_KEY=sk-your-actual-key-here

# Required for mainland China users
PROXY_URL=http://127.0.0.1:7890
USE_PROXY=true

# Run tests
pytest tests/ -v

# Test the server
python -m mcp_webscout --help

mcp-webscout

python -m mcp_webscout

{
  "mcpServers": {
    "webscout": {
      "command": "mcp-webscout"
    }
  }
}

{
  "mcpServers": {
    "webscout": {
      "command": "mcp-webscout",
      "env": {
        "DEEPSEEK_API_KEY": "sk-your-key-here",
        "PROXY_URL": "http://127.0.0.1:7890",
        "USE_PROXY": "true",
        "DEFAULT_MAX_LENGTH": "5000",
        "PYTHONUTF8": "1"
      }
    }
  }
}

{
  "mcpServers": {
    "webscout": {
      "command": "python",
      "args": ["-m", "mcp_webscout"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-your-key-here",
        "PROXY_URL": "http://127.0.0.1:7890",
        "USE_PROXY": "true",
        "PYTHONUTF8": "1"
      }
    }
  }
}

{
  "query": "Python programming",
  "max_results": 3
}