browser7 0.1.0a1__tar.gz

browser7-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Browser7 Data Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

browser7-0.1.0a1/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: browser7
+Version: 0.1.0a1
+Summary: Official Python SDK for Browser7 - Geo-targeted web scraping with automatic CAPTCHA solving and wait actions [ALPHA - API launching Q2 2026]
+Author-email: Browser7 <support@browser7.com>
+License: MIT
+Project-URL: Homepage, https://browser7.com
+Project-URL: Documentation, https://docs.browser7.com
+Project-URL: Repository, https://github.com/browser7data/browser7-python
+Project-URL: Bug Tracker, https://github.com/browser7data/browser7-python/issues
+Keywords: browser7,web-scraping,scraping,rendering,headless-browser,captcha,captcha-solver,geo-targeting,proxy,api-client,screenshot,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Browser7 Python SDK
+
+> ⚠️ **ALPHA RELEASE** - The Browser7 API is not yet publicly available. This package is published to reserve the package name. The API is expected to launch in **Q2 2026**.
+>
+> **Do not install this package yet** - it will not work until the Browser7 API is live. Follow [@browser7data](https://x.com/browser7data) or visit [browser7.com](https://browser7.com) for launch announcements.
+
+---
+
+Official Python client for the [Browser7](https://browser7.com) web scraping and rendering API.
+
+Browser7 provides geo-targeted web scraping with automatic proxy management, CAPTCHA solving, and powerful wait actions for dynamic content.
+
+## Features
+
+- 🌍 **Geo-Targeting** - Render pages from specific countries and cities
+- 🤖 **CAPTCHA Solving** - Automatic detection and solving of reCAPTCHA and Cloudflare Turnstile
+- ⏱️ **Wait Actions** - Click elements, wait for selectors, text, or delays
+- 📸 **Screenshots** - Get JPEG screenshots of rendered pages
+- 🚀 **Performance** - Block images, track bandwidth, view timing metrics
+- 🔄 **Automatic Polling** - Built-in polling with progress callbacks
+- 💪 **Type Hints** - Full type annotations for IDE support
+
+## Installation
+
+```bash
+pip install browser7
+```
+
+**Requirements:** Python 3.8+
+
+## Quick Start
+
+```python
+from browser7 import Browser7
+
+client = Browser7(api_key='your-api-key')
+
+# Simple render
+result = client.render('https://example.com')
+print(result.html)
+```
+
+## Authentication
+
+Get your API key from the [Browser7 Dashboard](https://dashboard.browser7.com).
+
+```python
+client = Browser7(api_key='b7_your_api_key_here')
+```
+
+## Usage Examples
+
+### Basic Rendering
+
+```python
+result = client.render('https://example.com', country_code='US')
+
+print(result.html)              # Rendered HTML
+print(result.screenshot)        # JPEG screenshot (bytes)
+print(result.selected_city)     # City used for rendering
+```
+
+### With Wait Actions
+
+```python
+from browser7 import wait_for_click, wait_for_selector, wait_for_delay
+
+result = client.render(
+    'https://example.com',
+    country_code='GB',
+    city='london',
+    wait_for=[
+        wait_for_click('.cookie-accept'),           # Click element
+        wait_for_selector('.main-content'),          # Wait for element
+        wait_for_delay(2000)                         # Wait 2 seconds
+    ]
+)
+```
+
+### With CAPTCHA Solving
+
+```python
+result = client.render(
+    'https://protected-site.com',
+    country_code='US',
+    captcha='auto'  # Auto-detect and solve CAPTCHAs
+)
+
+print(result.captcha)  # CAPTCHA detection info
+```
+
+## API Reference
+
+### `Browser7(api_key, base_url=None)`
+
+Create a new Browser7 client.
+
+**Parameters:**
+- `api_key` (str, required): Your Browser7 API key
+- `base_url` (str, optional): Full API base URL. Defaults to production API.
+
+**Example:**
+```python
+# Production (default)
+client = Browser7(api_key='your-api-key')
+
+# Canadian endpoint
+client = Browser7(
+    api_key='your-api-key',
+    base_url='https://ca-api.browser7.com/v1'
+)
+```
+
+### `client.render(url, **options)`
+
+Render a URL and poll for the result.
+
+**Parameters:**
+- `url` (str): The URL to render
+- `country_code` (str, optional): Country code (e.g., 'US', 'GB', 'DE')
+- `city` (str, optional): City name (e.g., 'new.york', 'london')
+- `wait_for` (list, optional): List of wait actions (max 10)
+- `captcha` (str, optional): CAPTCHA mode: 'disabled', 'auto', 'recaptcha_v2', 'recaptcha_v3', 'turnstile'
+- `block_images` (bool, optional): Block images for faster rendering (default: True)
+- `fetch_urls` (list, optional): Additional URLs to fetch (max 10)
+
+**Returns:** `RenderResult` object
+
+## Helper Functions
+
+### `wait_for_delay(duration)`
+
+Create a delay wait action.
+
+```python
+wait_for_delay(3000)  # Wait 3 seconds
+```
+
+### `wait_for_selector(selector, state='visible', timeout=30000)`
+
+Create a selector wait action.
+
+```python
+wait_for_selector('.main-content', state='visible', timeout=10000)
+```
+
+### `wait_for_text(text, selector=None, timeout=30000)`
+
+Create a text wait action.
+
+```python
+wait_for_text('In Stock', selector='.availability', timeout=10000)
+```
+
+### `wait_for_click(selector, timeout=30000)`
+
+Create a click wait action.
+
+```python
+wait_for_click('.cookie-accept', timeout=5000)
+```
+
+## Supported Countries
+
+AT, BE, CA, CH, CZ, DE, FR, GB, HR, HU, IT, NL, PL, SK, US
+
+See [Browser7 Documentation](https://docs.browser7.com) for available cities per country.
+
+## CAPTCHA Support
+
+Browser7 supports automatic CAPTCHA detection and solving for:
+
+- **reCAPTCHA v2** - Google's image-based CAPTCHA
+- **reCAPTCHA v3** - Google's score-based CAPTCHA
+- **Cloudflare Turnstile** - Cloudflare's CAPTCHA alternative
+
+**Modes:**
+- `'disabled'` (default) - Skip CAPTCHA detection (fastest)
+- `'auto'` - Auto-detect and solve any CAPTCHA type
+- `'recaptcha_v2'`, `'recaptcha_v3'`, `'turnstile'` - Solve specific type
+
+## Contributing
+
+Issues and pull requests are welcome! Please visit our [GitHub repository](https://github.com/browser7data/browser7-python).
+
+## License
+
+MIT
+
+## Support
+
+- 📧 Email: support@browser7.com
+- 📚 Documentation: https://docs.browser7.com
+- 🐛 Issues: https://github.com/browser7data/browser7-python/issues
+- 💬 Discord: https://discord.gg/browser7
+
+## Links
+
+- [Browser7 Website](https://browser7.com)
+- [API Documentation](https://docs.browser7.com/api)
+- [Dashboard](https://dashboard.browser7.com)
+- [Pricing](https://browser7.com/pricing)

browser7-0.1.0a1/README.md

@@ -0,0 +1,202 @@
+# Browser7 Python SDK
+
+> ⚠️ **ALPHA RELEASE** - The Browser7 API is not yet publicly available. This package is published to reserve the package name. The API is expected to launch in **Q2 2026**.
+>
+> **Do not install this package yet** - it will not work until the Browser7 API is live. Follow [@browser7data](https://x.com/browser7data) or visit [browser7.com](https://browser7.com) for launch announcements.
+
+---
+
+Official Python client for the [Browser7](https://browser7.com) web scraping and rendering API.
+
+Browser7 provides geo-targeted web scraping with automatic proxy management, CAPTCHA solving, and powerful wait actions for dynamic content.
+
+## Features
+
+- 🌍 **Geo-Targeting** - Render pages from specific countries and cities
+- 🤖 **CAPTCHA Solving** - Automatic detection and solving of reCAPTCHA and Cloudflare Turnstile
+- ⏱️ **Wait Actions** - Click elements, wait for selectors, text, or delays
+- 📸 **Screenshots** - Get JPEG screenshots of rendered pages
+- 🚀 **Performance** - Block images, track bandwidth, view timing metrics
+- 🔄 **Automatic Polling** - Built-in polling with progress callbacks
+- 💪 **Type Hints** - Full type annotations for IDE support
+
+## Installation
+
+```bash
+pip install browser7
+```
+
+**Requirements:** Python 3.8+
+
+## Quick Start
+
+```python
+from browser7 import Browser7
+
+client = Browser7(api_key='your-api-key')
+
+# Simple render
+result = client.render('https://example.com')
+print(result.html)
+```
+
+## Authentication
+
+Get your API key from the [Browser7 Dashboard](https://dashboard.browser7.com).
+
+```python
+client = Browser7(api_key='b7_your_api_key_here')
+```
+
+## Usage Examples
+
+### Basic Rendering
+
+```python
+result = client.render('https://example.com', country_code='US')
+
+print(result.html)              # Rendered HTML
+print(result.screenshot)        # JPEG screenshot (bytes)
+print(result.selected_city)     # City used for rendering
+```
+
+### With Wait Actions
+
+```python
+from browser7 import wait_for_click, wait_for_selector, wait_for_delay
+
+result = client.render(
+    'https://example.com',
+    country_code='GB',
+    city='london',
+    wait_for=[
+        wait_for_click('.cookie-accept'),           # Click element
+        wait_for_selector('.main-content'),          # Wait for element
+        wait_for_delay(2000)                         # Wait 2 seconds
+    ]
+)
+```
+
+### With CAPTCHA Solving
+
+```python
+result = client.render(
+    'https://protected-site.com',
+    country_code='US',
+    captcha='auto'  # Auto-detect and solve CAPTCHAs
+)
+
+print(result.captcha)  # CAPTCHA detection info
+```
+
+## API Reference
+
+### `Browser7(api_key, base_url=None)`
+
+Create a new Browser7 client.
+
+**Parameters:**
+- `api_key` (str, required): Your Browser7 API key
+- `base_url` (str, optional): Full API base URL. Defaults to production API.
+
+**Example:**
+```python
+# Production (default)
+client = Browser7(api_key='your-api-key')
+
+# Canadian endpoint
+client = Browser7(
+    api_key='your-api-key',
+    base_url='https://ca-api.browser7.com/v1'
+)
+```
+
+### `client.render(url, **options)`
+
+Render a URL and poll for the result.
+
+**Parameters:**
+- `url` (str): The URL to render
+- `country_code` (str, optional): Country code (e.g., 'US', 'GB', 'DE')
+- `city` (str, optional): City name (e.g., 'new.york', 'london')
+- `wait_for` (list, optional): List of wait actions (max 10)
+- `captcha` (str, optional): CAPTCHA mode: 'disabled', 'auto', 'recaptcha_v2', 'recaptcha_v3', 'turnstile'
+- `block_images` (bool, optional): Block images for faster rendering (default: True)
+- `fetch_urls` (list, optional): Additional URLs to fetch (max 10)
+
+**Returns:** `RenderResult` object
+
+## Helper Functions
+
+### `wait_for_delay(duration)`
+
+Create a delay wait action.
+
+```python
+wait_for_delay(3000)  # Wait 3 seconds
+```
+
+### `wait_for_selector(selector, state='visible', timeout=30000)`
+
+Create a selector wait action.
+
+```python
+wait_for_selector('.main-content', state='visible', timeout=10000)
+```
+
+### `wait_for_text(text, selector=None, timeout=30000)`
+
+Create a text wait action.
+
+```python
+wait_for_text('In Stock', selector='.availability', timeout=10000)
+```
+
+### `wait_for_click(selector, timeout=30000)`
+
+Create a click wait action.
+
+```python
+wait_for_click('.cookie-accept', timeout=5000)
+```
+
+## Supported Countries
+
+AT, BE, CA, CH, CZ, DE, FR, GB, HR, HU, IT, NL, PL, SK, US
+
+See [Browser7 Documentation](https://docs.browser7.com) for available cities per country.
+
+## CAPTCHA Support
+
+Browser7 supports automatic CAPTCHA detection and solving for:
+
+- **reCAPTCHA v2** - Google's image-based CAPTCHA
+- **reCAPTCHA v3** - Google's score-based CAPTCHA
+- **Cloudflare Turnstile** - Cloudflare's CAPTCHA alternative
+
+**Modes:**
+- `'disabled'` (default) - Skip CAPTCHA detection (fastest)
+- `'auto'` - Auto-detect and solve any CAPTCHA type
+- `'recaptcha_v2'`, `'recaptcha_v3'`, `'turnstile'` - Solve specific type
+
+## Contributing
+
+Issues and pull requests are welcome! Please visit our [GitHub repository](https://github.com/browser7data/browser7-python).
+
+## License
+
+MIT
+
+## Support
+
+- 📧 Email: support@browser7.com
+- 📚 Documentation: https://docs.browser7.com
+- 🐛 Issues: https://github.com/browser7data/browser7-python/issues
+- 💬 Discord: https://discord.gg/browser7
+
+## Links
+
+- [Browser7 Website](https://browser7.com)
+- [API Documentation](https://docs.browser7.com/api)
+- [Dashboard](https://dashboard.browser7.com)
+- [Pricing](https://browser7.com/pricing)

browser7-0.1.0a1/browser7/__init__.py

@@ -0,0 +1,271 @@
+"""
+Browser7 Python SDK
+
+Official Python client for the Browser7 web scraping and rendering API.
+
+⚠️ ALPHA RELEASE - This is a pre-release version published to reserve the package name.
+The Browser7 API is not yet publicly available. Expected launch: Q2 2026.
+
+Visit https://browser7.com for launch announcements.
+"""
+
+__version__ = "0.1.0a1"
+__author__ = "Browser7"
+__email__ = "support@browser7.com"
+__url__ = "https://browser7.com"
+
+from typing import Optional, List, Dict, Any, Callable
+
+
+class Browser7:
+    """
+    Browser7 API client.
+
+    ⚠️ ALPHA: The Browser7 API is not yet live. This is a placeholder implementation.
+
+    Args:
+        api_key: Your Browser7 API key
+        base_url: Optional custom API base URL
+
+    Example:
+        >>> client = Browser7(api_key='your-api-key')
+        >>> result = client.render('https://example.com')
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: Optional[str] = None
+    ):
+        """Initialize Browser7 client."""
+        if not api_key:
+            raise ValueError("API key is required")
+
+        self.api_key = api_key
+        self.base_url = base_url or "https://api.browser7.com/v1"
+
+    def render(
+        self,
+        url: str,
+        country_code: Optional[str] = None,
+        city: Optional[str] = None,
+        wait_for: Optional[List[Dict[str, Any]]] = None,
+        captcha: Optional[str] = None,
+        block_images: Optional[bool] = None,
+        fetch_urls: Optional[List[str]] = None,
+        on_progress: Optional[Callable] = None
+    ) -> "RenderResult":
+        """
+        Render a URL and poll for the result.
+
+        ⚠️ ALPHA: This method is not yet functional. The Browser7 API is not live.
+
+        Args:
+            url: The URL to render
+            country_code: Country code (e.g., 'US', 'GB', 'DE')
+            city: City name (e.g., 'new.york', 'london')
+            wait_for: List of wait actions (max 10)
+            captcha: CAPTCHA mode ('disabled', 'auto', 'recaptcha_v2', 'recaptcha_v3', 'turnstile')
+            block_images: Whether to block images (default: True)
+            fetch_urls: Additional URLs to fetch (max 10)
+            on_progress: Optional progress callback function
+
+        Returns:
+            RenderResult object with HTML, screenshot, and metadata
+
+        Raises:
+            NotImplementedError: API is not yet available
+        """
+        raise NotImplementedError(
+            "Browser7 API is not yet publicly available. "
+            "Expected launch: Q2 2026. Visit https://browser7.com for updates."
+        )
+
+    def create_render(
+        self,
+        url: str,
+        **options
+    ) -> Dict[str, str]:
+        """
+        Create a render job (low-level API).
+
+        ⚠️ ALPHA: This method is not yet functional. The Browser7 API is not live.
+
+        Args:
+            url: The URL to render
+            **options: Render options
+
+        Returns:
+            Dictionary with renderId
+
+        Raises:
+            NotImplementedError: API is not yet available
+        """
+        raise NotImplementedError(
+            "Browser7 API is not yet publicly available. "
+            "Expected launch: Q2 2026. Visit https://browser7.com for updates."
+        )
+
+    def get_render(
+        self,
+        render_id: str
+    ) -> "RenderResult":
+        """
+        Get the status and result of a render job (low-level API).
+
+        ⚠️ ALPHA: This method is not yet functional. The Browser7 API is not live.
+
+        Args:
+            render_id: The render ID to retrieve
+
+        Returns:
+            RenderResult object
+
+        Raises:
+            NotImplementedError: API is not yet available
+        """
+        raise NotImplementedError(
+            "Browser7 API is not yet publicly available. "
+            "Expected launch: Q2 2026. Visit https://browser7.com for updates."
+        )
+
+
+class RenderResult:
+    """
+    Result from a render operation.
+
+    ⚠️ ALPHA: Placeholder class. Full implementation coming with API launch.
+
+    Attributes:
+        status: Render status ('completed', 'processing', 'failed')
+        html: Rendered HTML content
+        screenshot: JPEG screenshot as bytes
+        selected_city: City information
+        bandwidth_metrics: Network bandwidth statistics
+        captcha: CAPTCHA detection info
+        timing_breakdown: Performance metrics
+        fetch_responses: Additional fetch responses
+    """
+
+    def __init__(self, data: Dict[str, Any]):
+        """Initialize from API response data."""
+        self.status = data.get('status')
+        self.html = data.get('html')
+        self.screenshot = data.get('screenshot')
+        self.selected_city = data.get('selectedCity')
+        self.bandwidth_metrics = data.get('bandwidthMetrics')
+        self.captcha = data.get('captcha')
+        self.timing_breakdown = data.get('timingBreakdown')
+        self.fetch_responses = data.get('fetchResponses')
+
+
+# Helper functions for creating wait actions
+
+def wait_for_delay(duration: int) -> Dict[str, Any]:
+    """
+    Create a delay wait action.
+
+    Args:
+        duration: Duration in milliseconds (100-60000)
+
+    Returns:
+        Wait action dictionary
+
+    Example:
+        >>> wait_for_delay(3000)  # Wait 3 seconds
+    """
+    return {
+        'type': 'delay',
+        'duration': duration
+    }
+
+
+def wait_for_selector(
+    selector: str,
+    state: str = 'visible',
+    timeout: int = 30000
+) -> Dict[str, Any]:
+    """
+    Create a selector wait action.
+
+    Args:
+        selector: CSS selector to wait for
+        state: Element state ('visible', 'hidden', 'attached')
+        timeout: Timeout in milliseconds (1000-60000)
+
+    Returns:
+        Wait action dictionary
+
+    Example:
+        >>> wait_for_selector('.main-content', state='visible', timeout=10000)
+    """
+    return {
+        'type': 'selector',
+        'selector': selector,
+        'state': state,
+        'timeout': timeout
+    }
+
+
+def wait_for_text(
+    text: str,
+    selector: Optional[str] = None,
+    timeout: int = 30000
+) -> Dict[str, Any]:
+    """
+    Create a text wait action.
+
+    Args:
+        text: Text to wait for
+        selector: Optional CSS selector to limit search scope
+        timeout: Timeout in milliseconds (1000-60000)
+
+    Returns:
+        Wait action dictionary
+
+    Example:
+        >>> wait_for_text('In Stock', selector='.availability', timeout=10000)
+    """
+    action = {
+        'type': 'text',
+        'text': text,
+        'timeout': timeout
+    }
+    if selector:
+        action['selector'] = selector
+    return action
+
+
+def wait_for_click(
+    selector: str,
+    timeout: int = 30000
+) -> Dict[str, Any]:
+    """
+    Create a click wait action.
+
+    Args:
+        selector: CSS selector of element to click
+        timeout: Timeout in milliseconds (1000-60000)
+
+    Returns:
+        Wait action dictionary
+
+    Example:
+        >>> wait_for_click('.cookie-accept', timeout=5000)
+    """
+    return {
+        'type': 'click',
+        'selector': selector,
+        'timeout': timeout
+    }
+
+
+# Export public API
+__all__ = [
+    'Browser7',
+    'RenderResult',
+    'wait_for_delay',
+    'wait_for_selector',
+    'wait_for_text',
+    'wait_for_click',
+]

browser7-0.1.0a1/browser7/py.typed

@@ -0,0 +1,2 @@
+# Marker file for PEP 561.
+# This package supports type hints.

browser7-0.1.0a1/browser7.egg-info/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: browser7
+Version: 0.1.0a1
+Summary: Official Python SDK for Browser7 - Geo-targeted web scraping with automatic CAPTCHA solving and wait actions [ALPHA - API launching Q2 2026]
+Author-email: Browser7 <support@browser7.com>
+License: MIT
+Project-URL: Homepage, https://browser7.com
+Project-URL: Documentation, https://docs.browser7.com
+Project-URL: Repository, https://github.com/browser7data/browser7-python
+Project-URL: Bug Tracker, https://github.com/browser7data/browser7-python/issues
+Keywords: browser7,web-scraping,scraping,rendering,headless-browser,captcha,captcha-solver,geo-targeting,proxy,api-client,screenshot,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Browser7 Python SDK
+
+> ⚠️ **ALPHA RELEASE** - The Browser7 API is not yet publicly available. This package is published to reserve the package name. The API is expected to launch in **Q2 2026**.
+>
+> **Do not install this package yet** - it will not work until the Browser7 API is live. Follow [@browser7data](https://x.com/browser7data) or visit [browser7.com](https://browser7.com) for launch announcements.
+
+---
+
+Official Python client for the [Browser7](https://browser7.com) web scraping and rendering API.
+
+Browser7 provides geo-targeted web scraping with automatic proxy management, CAPTCHA solving, and powerful wait actions for dynamic content.
+
+## Features
+
+- 🌍 **Geo-Targeting** - Render pages from specific countries and cities
+- 🤖 **CAPTCHA Solving** - Automatic detection and solving of reCAPTCHA and Cloudflare Turnstile
+- ⏱️ **Wait Actions** - Click elements, wait for selectors, text, or delays
+- 📸 **Screenshots** - Get JPEG screenshots of rendered pages
+- 🚀 **Performance** - Block images, track bandwidth, view timing metrics
+- 🔄 **Automatic Polling** - Built-in polling with progress callbacks
+- 💪 **Type Hints** - Full type annotations for IDE support
+
+## Installation
+
+```bash
+pip install browser7
+```
+
+**Requirements:** Python 3.8+
+
+## Quick Start
+
+```python
+from browser7 import Browser7
+
+client = Browser7(api_key='your-api-key')
+
+# Simple render
+result = client.render('https://example.com')
+print(result.html)
+```
+
+## Authentication
+
+Get your API key from the [Browser7 Dashboard](https://dashboard.browser7.com).
+
+```python
+client = Browser7(api_key='b7_your_api_key_here')
+```
+
+## Usage Examples
+
+### Basic Rendering
+
+```python
+result = client.render('https://example.com', country_code='US')
+
+print(result.html)              # Rendered HTML
+print(result.screenshot)        # JPEG screenshot (bytes)
+print(result.selected_city)     # City used for rendering
+```
+
+### With Wait Actions
+
+```python
+from browser7 import wait_for_click, wait_for_selector, wait_for_delay
+
+result = client.render(
+    'https://example.com',
+    country_code='GB',
+    city='london',
+    wait_for=[
+        wait_for_click('.cookie-accept'),           # Click element
+        wait_for_selector('.main-content'),          # Wait for element
+        wait_for_delay(2000)                         # Wait 2 seconds
+    ]
+)
+```
+
+### With CAPTCHA Solving
+
+```python
+result = client.render(
+    'https://protected-site.com',
+    country_code='US',
+    captcha='auto'  # Auto-detect and solve CAPTCHAs
+)
+
+print(result.captcha)  # CAPTCHA detection info
+```
+
+## API Reference
+
+### `Browser7(api_key, base_url=None)`
+
+Create a new Browser7 client.
+
+**Parameters:**
+- `api_key` (str, required): Your Browser7 API key
+- `base_url` (str, optional): Full API base URL. Defaults to production API.
+
+**Example:**
+```python
+# Production (default)
+client = Browser7(api_key='your-api-key')
+
+# Canadian endpoint
+client = Browser7(
+    api_key='your-api-key',
+    base_url='https://ca-api.browser7.com/v1'
+)
+```
+
+### `client.render(url, **options)`
+
+Render a URL and poll for the result.
+
+**Parameters:**
+- `url` (str): The URL to render
+- `country_code` (str, optional): Country code (e.g., 'US', 'GB', 'DE')
+- `city` (str, optional): City name (e.g., 'new.york', 'london')
+- `wait_for` (list, optional): List of wait actions (max 10)
+- `captcha` (str, optional): CAPTCHA mode: 'disabled', 'auto', 'recaptcha_v2', 'recaptcha_v3', 'turnstile'
+- `block_images` (bool, optional): Block images for faster rendering (default: True)
+- `fetch_urls` (list, optional): Additional URLs to fetch (max 10)
+
+**Returns:** `RenderResult` object
+
+## Helper Functions
+
+### `wait_for_delay(duration)`
+
+Create a delay wait action.
+
+```python
+wait_for_delay(3000)  # Wait 3 seconds
+```
+
+### `wait_for_selector(selector, state='visible', timeout=30000)`
+
+Create a selector wait action.
+
+```python
+wait_for_selector('.main-content', state='visible', timeout=10000)
+```
+
+### `wait_for_text(text, selector=None, timeout=30000)`
+
+Create a text wait action.
+
+```python
+wait_for_text('In Stock', selector='.availability', timeout=10000)
+```
+
+### `wait_for_click(selector, timeout=30000)`
+
+Create a click wait action.
+
+```python
+wait_for_click('.cookie-accept', timeout=5000)
+```
+
+## Supported Countries
+
+AT, BE, CA, CH, CZ, DE, FR, GB, HR, HU, IT, NL, PL, SK, US
+
+See [Browser7 Documentation](https://docs.browser7.com) for available cities per country.
+
+## CAPTCHA Support
+
+Browser7 supports automatic CAPTCHA detection and solving for:
+
+- **reCAPTCHA v2** - Google's image-based CAPTCHA
+- **reCAPTCHA v3** - Google's score-based CAPTCHA
+- **Cloudflare Turnstile** - Cloudflare's CAPTCHA alternative
+
+**Modes:**
+- `'disabled'` (default) - Skip CAPTCHA detection (fastest)
+- `'auto'` - Auto-detect and solve any CAPTCHA type
+- `'recaptcha_v2'`, `'recaptcha_v3'`, `'turnstile'` - Solve specific type
+
+## Contributing
+
+Issues and pull requests are welcome! Please visit our [GitHub repository](https://github.com/browser7data/browser7-python).
+
+## License
+
+MIT
+
+## Support
+
+- 📧 Email: support@browser7.com
+- 📚 Documentation: https://docs.browser7.com
+- 🐛 Issues: https://github.com/browser7data/browser7-python/issues
+- 💬 Discord: https://discord.gg/browser7
+
+## Links
+
+- [Browser7 Website](https://browser7.com)
+- [API Documentation](https://docs.browser7.com/api)
+- [Dashboard](https://dashboard.browser7.com)
+- [Pricing](https://browser7.com/pricing)

browser7-0.1.0a1/browser7.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+browser7/__init__.py
+browser7/py.typed
+browser7.egg-info/PKG-INFO
+browser7.egg-info/SOURCES.txt
+browser7.egg-info/dependency_links.txt
+browser7.egg-info/top_level.txt

browser7-0.1.0a1/browser7.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

browser7-0.1.0a1/browser7.egg-info/top_level.txt

@@ -0,0 +1 @@
+browser7

browser7-0.1.0a1/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "browser7"
+version = "0.1.0a1"
+description = "Official Python SDK for Browser7 - Geo-targeted web scraping with automatic CAPTCHA solving and wait actions [ALPHA - API launching Q2 2026]"
+readme = "README.md"
+authors = [
+    {name = "Browser7", email = "support@browser7.com"}
+]
+license = {text = "MIT"}
+requires-python = ">=3.8"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+keywords = [
+    "browser7",
+    "web-scraping",
+    "scraping",
+    "rendering",
+    "headless-browser",
+    "captcha",
+    "captcha-solver",
+    "geo-targeting",
+    "proxy",
+    "api-client",
+    "screenshot",
+    "automation"
+]
+
+[project.urls]
+Homepage = "https://browser7.com"
+Documentation = "https://docs.browser7.com"
+Repository = "https://github.com/browser7data/browser7-python"
+"Bug Tracker" = "https://github.com/browser7data/browser7-python/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["browser7*"]
+exclude = ["tests*"]

browser7-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+