Metadata-Version: 2.1
Name: espai
Version: 0.1.0
Summary: Enumerate, Search, Parse, and Iterate - A tool for structured data extraction from search results
Author: Your Name
Author-email: your.email@example.com
Requires-Python: >=3.9,<4.0
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.13
Requires-Dist: aiohttp (>=3.11.11,<4.0.0)
Requires-Dist: beautifulsoup4 (>=4.12.3,<5.0.0)
Requires-Dist: google-api-python-client (>=2.0.0,<3.0.0)
Requires-Dist: google-generativeai (>=0.3.2,<0.4.0)
Requires-Dist: httpx (>=0.26.0,<0.27.0)
Requires-Dist: polars (>=0.20.3,<0.21.0)
Requires-Dist: pydantic (>=2.5.3,<3.0.0)
Requires-Dist: python-dotenv (>=1.0.0,<2.0.0)
Requires-Dist: rich (>=13.7.0,<14.0.0)
Requires-Dist: typer (>=0.9.0,<0.10.0)
Description-Content-Type: text/markdown

# espai (Enumerate, Search, Parse, and Iterate)

A powerful tool for structured data extraction from search results using Google Search and Gemini AI.

## Features

- Parse natural language queries into structured search parameters
- Automatically discover and enumerate search spaces
- Perform intelligent Google searches
- Extract structured data from search results using Gemini AI
- Store results in efficient Polars DataFrames
- Real-time progress tracking
- Multiple output formats (CSV, JSON, Parquet)

## Installation

```bash
pip install espai
```

## Usage

Basic usage:
```bash
espai "Athletic center names and addresses in all California zip codes"
```

With options:
```bash
espai "Athletic center names and addresses in all California zip codes" \
  --max-results=10 \
  --output-format=csv
```

## Configuration

Set your API keys as environment variables:
```bash
export GOOGLE_API_KEY="your_google_api_key"
export GOOGLE_CSE_ID="your_google_cse_id"
export GEMINI_API_KEY="your_gemini_api_key"
```

## License

MIT License

