tapac-sdk 1.0.0__tar.gz

tapac_sdk-1.0.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+dist/
+build/
+.DS_Store
+uv.lock

tapac_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.5
+Name: tapac-sdk
+Version: 1.0.0
+Summary: Official Python SDK for TAPAC — find and verify B2B contacts programmatically.
+Project-URL: Homepage, https://tapacapi.com
+Project-URL: Repository, https://github.com/axelfreeman/tapac-mcp
+Author: Axel Freeman
+License: MIT
+Keywords: b2b,contacts,email-verification,lead-generation,mcp,tapac
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.24
+Description-Content-Type: text/markdown
+
+# tapac-sdk
+
+Official Python SDK for [TAPAC](https://tapacapi.com) — find and verify B2B contacts programmatically.
+
+TAPAC scrapes business contacts from company websites, Discord communities, and Telegram channels, then validates emails in real time via SMTP (2–5% bounce rate vs. the 25–35% industry average). This SDK wraps the TAPAC REST API.
+
+## Install
+
+```bash
+pip install tapac-sdk
+```
+
+## Quick start
+
+```python
+from tapac_sdk import TapacClient
+
+client = TapacClient(api_key="your-api-key")
+
+# Service status
+print(client.status())
+
+# Find contacts
+result = client.find_contacts(
+    industry="fintech",
+    job_titles=["CEO", "CTO"],
+    location="Singapore",
+    source="website",
+    limit=10,
+)
+
+# Verify emails in real time
+verified = client.verify_emails(["alex@example.com", "sam@example.com"])
+```
+
+## Sandbox mode
+
+Pass `sandbox=True` to exercise the API without real lookups:
+
+```python
+client = TapacClient(sandbox=True)
+```
+
+## Authentication
+
+Pass your API key to `TapacClient(api_key=...)`. The client sends it as a `Bearer` token. Keys are issued from the TAPAC developer portal at [tapacapi.com/developers](https://tapacapi.com/developers).
+
+## Requirements
+
+- Python 3.9+
+- [`httpx`](https://www.python-httpx.dev/) (installed automatically)
+
+## License
+
+MIT

tapac_sdk-1.0.0/README.md

@@ -0,0 +1,55 @@
+# tapac-sdk
+
+Official Python SDK for [TAPAC](https://tapacapi.com) — find and verify B2B contacts programmatically.
+
+TAPAC scrapes business contacts from company websites, Discord communities, and Telegram channels, then validates emails in real time via SMTP (2–5% bounce rate vs. the 25–35% industry average). This SDK wraps the TAPAC REST API.
+
+## Install
+
+```bash
+pip install tapac-sdk
+```
+
+## Quick start
+
+```python
+from tapac_sdk import TapacClient
+
+client = TapacClient(api_key="your-api-key")
+
+# Service status
+print(client.status())
+
+# Find contacts
+result = client.find_contacts(
+    industry="fintech",
+    job_titles=["CEO", "CTO"],
+    location="Singapore",
+    source="website",
+    limit=10,
+)
+
+# Verify emails in real time
+verified = client.verify_emails(["alex@example.com", "sam@example.com"])
+```
+
+## Sandbox mode
+
+Pass `sandbox=True` to exercise the API without real lookups:
+
+```python
+client = TapacClient(sandbox=True)
+```
+
+## Authentication
+
+Pass your API key to `TapacClient(api_key=...)`. The client sends it as a `Bearer` token. Keys are issued from the TAPAC developer portal at [tapacapi.com/developers](https://tapacapi.com/developers).
+
+## Requirements
+
+- Python 3.9+
+- [`httpx`](https://www.python-httpx.dev/) (installed automatically)
+
+## License
+
+MIT

tapac_sdk-1.0.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tapac-sdk"
+version = "1.0.0"
+description = "Official Python SDK for TAPAC — find and verify B2B contacts programmatically."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Axel Freeman" }]
+requires-python = ">=3.9"
+keywords = ["tapac", "b2b", "contacts", "lead-generation", "email-verification", "mcp"]
+dependencies = ["httpx>=0.24"]
+
+[project.urls]
+Homepage = "https://tapacapi.com"
+Repository = "https://github.com/axelfreeman/tapac-mcp"
+
+[tool.hatch.build.targets.wheel]
+packages = ["tapac_sdk"]

tapac_sdk-1.0.0/tapac_sdk/__init__.py

@@ -0,0 +1,42 @@
+"""TAPAC SDK — official Python client for the TAPAC REST API."""
+from __future__ import annotations
+
+import httpx
+
+DEFAULT_BASE = "https://tapacapi.com"
+
+
+class TapacClient:
+    def __init__(self, api_key: str | None = None, base_url: str = DEFAULT_BASE, sandbox: bool = False):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.sandbox = sandbox
+
+    def _headers(self) -> dict:
+        h = {"Content-Type": "application/json"}
+        if self.api_key:
+            h["Authorization"] = f"Bearer {self.api_key}"
+        if self.sandbox:
+            h["X-Sandbox"] = "true"
+        return h
+
+    def _request(self, method: str, path: str, **kwargs):
+        r = httpx.request(method, f"{self.base_url}{path}", headers=self._headers(), **kwargs)
+        r.raise_for_status()
+        return r.json()
+
+    def status(self) -> dict:
+        return self._request("GET", "/v1/status")
+
+    def find_contacts(self, industry="", job_titles=None, company_size="", location="", source="website", limit=10) -> dict:
+        return self._request("POST", "/v1/contacts/search", json={
+            "industry": industry,
+            "job_titles": job_titles or [],
+            "company_size": company_size,
+            "location": location,
+            "source": source,
+            "limit": limit,
+        })
+
+    def verify_emails(self, emails: list[str]) -> dict:
+        return self._request("POST", "/v1/contacts/verify", json={"emails": emails})