agentweb-mcp 0.1.0__tar.gz

agentweb_mcp-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+dist/
+*.egg-info/
+__pycache__/
+*.pyc
+.venv/

agentweb_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgentWeb
+
+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.

agentweb_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+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

agentweb_mcp-0.1.0/README.md

@@ -0,0 +1,54 @@
+# 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

agentweb_mcp-0.1.0/agentweb/__init__.py

@@ -0,0 +1,6 @@
+"""AgentWeb.live Python SDK — search the global business directory."""
+
+from .client import AgentWebClient
+
+__all__ = ["AgentWebClient"]
+__version__ = "0.1.0"

agentweb_mcp-0.1.0/agentweb/client.py

@@ -0,0 +1,107 @@
+"""AgentWeb API client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import requests
+
+
+class AgentWebError(Exception):
+    """Raised when the API returns a non-2xx response."""
+
+    def __init__(self, status_code: int, detail: Any = None):
+        self.status_code = status_code
+        self.detail = detail
+        super().__init__(f"HTTP {status_code}: {detail}")
+
+
+class AgentWebClient:
+    """Client for the AgentWeb.live business directory API.
+
+    Args:
+        api_key: Your AgentWeb API key.
+        base_url: API base URL (default: https://api.agentweb.live/v1).
+        timeout: Request timeout in seconds.
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://api.agentweb.live/v1",
+        timeout: float = 30,
+    ):
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self._session = requests.Session()
+        self._session.headers.update({"X-API-Key": api_key})
+
+    # ------------------------------------------------------------------
+    # Public helpers
+    # ------------------------------------------------------------------
+
+    def _get(self, path: str, params: Optional[dict] = None) -> Any:
+        url = f"{self.base_url}{path}"
+        resp = self._session.get(url, params=params, timeout=self.timeout)
+        if not resp.ok:
+            raise AgentWebError(resp.status_code, resp.text)
+        return resp.json()
+
+    # ------------------------------------------------------------------
+    # Endpoints
+    # ------------------------------------------------------------------
+
+    def search(
+        self,
+        q: str,
+        *,
+        lat: Optional[float] = None,
+        lng: Optional[float] = None,
+        radius_km: Optional[float] = None,
+        country: Optional[str] = None,
+        limit: Optional[int] = None,
+    ) -> dict[str, Any]:
+        """Search for businesses.
+
+        Args:
+            q: Search query (e.g. "coffee shop").
+            lat: Latitude for geo search.
+            lng: Longitude for geo search.
+            radius_km: Radius in km for geo search.
+            country: ISO 3166-1 alpha-2 country code filter.
+            limit: Maximum number of results.
+
+        Returns:
+            API response as a dict.
+        """
+        params: dict[str, Any] = {"q": q}
+        if lat is not None:
+            params["lat"] = lat
+        if lng is not None:
+            params["lng"] = lng
+        if radius_km is not None:
+            params["radius_km"] = radius_km
+        if country is not None:
+            params["country"] = country
+        if limit is not None:
+            params["limit"] = limit
+        return self._get("/search", params)
+
+    def get_business(self, business_id: str) -> dict[str, Any]:
+        """Get a single business by ID.
+
+        Args:
+            business_id: The AgentWeb business ID.
+
+        Returns:
+            Business data as a dict.
+        """
+        return self._get(f"/business/{business_id}")
+
+    def health(self) -> dict[str, Any]:
+        """Check API health and stats.
+
+        Returns:
+            Health/status info as a dict.
+        """
+        return self._get("/health")

agentweb_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentweb-mcp"
+version = "0.1.0"
+description = "Python SDK for AgentWeb.live — the global business directory for AI agents"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [{ name = "AgentWeb", email = "hello@agentweb.live" }]
+keywords = ["agentweb", "business", "directory", "api", "ai-agents"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+dependencies = ["requests>=2.20"]
+
+[project.urls]
+Homepage = "https://agentweb.live"
+Repository = "https://github.com/zerabic/agentweb-python"
+
+[tool.hatch.build.targets.wheel]
+packages = ["agentweb"]