Metadata-Version: 2.4
Name: agentweb-mcp
Version: 0.1.0
Summary: Python SDK for AgentWeb.live — the global business directory for AI agents
Project-URL: Homepage, https://agentweb.live
Project-URL: Repository, https://github.com/zerabic/agentweb-python
Author-email: AgentWeb <hello@agentweb.live>
License-Expression: MIT
License-File: LICENSE
Keywords: agentweb,ai-agents,api,business,directory
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Requires-Dist: requests>=2.20
Description-Content-Type: text/markdown

# agentweb

Python SDK for [AgentWeb.live](https://agentweb.live) — the global business directory for AI agents.

Search 11M+ businesses across 195 countries via a simple API.

## Installation

```bash
pip install agentweb
```

## Quick Start

```python
from agentweb import AgentWebClient

client = AgentWebClient(api_key="your-api-key")

# Search for businesses
results = client.search("coffee shop", country="US", limit=5)
print(results)

# Geo search
results = client.search("restaurant", lat=40.7128, lng=-74.0060, radius_km=2)

# Get a single business
biz = client.get_business("some-business-id")

# Health check
status = client.health()
```

## API Reference

### `AgentWebClient(api_key, base_url=..., timeout=30)`

Create a client. Get your API key at [agentweb.live](https://agentweb.live).

### `client.search(q, *, lat, lng, radius_km, country, limit)`

Search for businesses. All parameters except `q` are optional.

### `client.get_business(business_id)`

Fetch a single business by its AgentWeb ID.

### `client.health()`

Check API health and stats.

## License

MIT
