metalift-sdk 1.0.0__tar.gz

metalift_sdk-1.0.0/LICENSE

@@ -0,0 +1,74 @@
+Proprietary License — Maximum restriction
+
+Copyright (c) 2026 Metalift. All rights reserved.
+
+NOTICE: This software and all associated materials (source code, object code,
+documentation, configuration, designs, and data) are proprietary and confidential.
+No license or right is granted except as expressly set forth below.
+
+1. NO GRANT OF RIGHTS
+
+   Except as expressly authorized in a separate written agreement signed by
+   Metalift, you are granted NO rights to use, copy, modify, merge, publish,
+   distribute, sublicense, sell, rent, lease, lend, disclose, or otherwise
+   transfer this software or any part thereof.
+
+2. RESTRICTED ACTIVITIES
+
+   Without prior written consent from Metalift, you may NOT:
+
+   (a) access, use, or run the software in any environment;
+   (b) copy, reproduce, or duplicate the software or documentation;
+   (c) modify, adapt, translate, or create derivative works;
+   (d) reverse engineer, decompile, disassemble, or attempt to derive source
+       code, algorithms, or trade secrets;
+   (e) remove, alter, or obscure proprietary notices or labels;
+   (f) distribute, publish, or make the software available to any third party;
+   (g) use the software to develop, train, or improve competing products or
+       services;
+   (h) benchmark, scrape, or systematically extract outputs for redistribution;
+   (i) sublicense, assign, or transfer any rights under this notice.
+
+3. CONFIDENTIALITY
+
+   The software constitutes confidential information of Metalift. You must
+   protect it using at least the same degree of care you use for your own
+   confidential information, and in no event less than reasonable care.
+
+4. THIRD-PARTY COMPONENTS
+
+   Third-party open-source components, if any, remain subject to their
+   respective licenses. This notice does not restrict use of those components
+   as permitted by their licenses, but does not grant additional rights to
+   Metalift proprietary code.
+
+5. TERMINATION
+
+   Any unauthorized use automatically terminates any permission that may have
+   been granted. Upon termination, you must destroy all copies of the software
+   and certify destruction if requested.
+
+6. DISCLAIMER OF WARRANTY
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS
+   FOR A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT.
+
+7. LIMITATION OF LIABILITY
+
+   IN NO EVENT SHALL METALIFT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
+   CONSEQUENTIAL, OR PUNITIVE DAMAGES, OR ANY LOSS OF PROFITS, DATA, GOODWILL,
+   OR BUSINESS INTERRUPTION, ARISING FROM OR RELATED TO THE SOFTWARE, WHETHER
+   IN CONTRACT, TORT, OR OTHERWISE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+   DAMAGES. METALIFT'S TOTAL LIABILITY SHALL NOT EXCEED THE AMOUNT PAID BY YOU
+   TO METALIFT FOR AUTHORIZED ACCESS IN THE TWELVE (12) MONTHS PRECEDING THE
+   CLAIM, OR ONE HUNDRED U.S. DOLLARS (USD $100) IF NO SUCH PAYMENT WAS MADE.
+
+8. GOVERNING LAW
+
+   This notice is governed by the laws applicable where Metalift is organized,
+   without regard to conflict-of-law principles.
+
+9. CONTACT
+
+   For licensing inquiries: legal@metalift.ai

metalift_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: metalift-sdk
+Version: 1.0.0
+Summary: Official Python SDK for the Metalift web context API
+Author-email: Metalift <support@metalift.ai>
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://metalift.ai
+Project-URL: Documentation, https://metalift.ai/docs
+Project-URL: Repository, https://github.com/Endacoder/scraper-mcp
+Project-URL: Issues, https://github.com/Endacoder/scraper-mcp/issues
+Project-URL: Changelog, https://github.com/Endacoder/scraper-mcp/releases
+Keywords: metalift,scraping,web-scraping,crawl,llm,agents,markdown
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Dynamic: license-file
+
+# metalift-sdk
+
+Official Python SDK for [Metalift](https://app.metalift.ai) — turn any URL into agent-ready markdown, HTML, or structured data.
+
+## Install
+
+```bash
+pip install metalift-sdk
+```
+
+Requires Python 3.11+.
+
+## Quick start
+
+```python
+from metalift_sdk import Metalift
+
+client = Metalift(api_key="YOUR_API_KEY")
+
+result = client.scrape(
+    "https://example.com",
+    formats=["markdown"],
+)
+print(result["data"]["markdown"])
+```
+
+Get an API key from the [Metalift dashboard](https://app.metalift.ai/dashboard/keys). New accounts receive **1,000 free credits/month**.
+
+## Configuration
+
+```python
+from metalift_sdk import Metalift
+
+client = Metalift(
+    api_url="https://api.metalift.ai",  # default
+    api_key="YOUR_API_KEY",
+    timeout=60.0,
+)
+```
+
+Environment variables are also supported:
+
+| Variable | Description |
+|----------|-------------|
+| `METALIFT_API_URL` | API base URL (default: `https://api.metalift.ai`) |
+| `METALIFT_API_KEY` | Bearer token for authenticated requests |
+
+## API
+
+### Scrape
+
+```python
+client.scrape(
+    "https://example.com",
+    formats=["markdown"],
+    render="auto",
+    only_main_content=True,
+    strategy="default",
+)
+```
+
+### Batch scrape
+
+```python
+client.batch(
+    ["https://example.com", "https://example.org"],
+    async_=True,
+    scrape_options={"formats": ["markdown"]},
+)
+```
+
+### Crawl and map
+
+```python
+crawl_job = client.crawl("https://example.com", limit=50)
+map_result = client.map("https://example.com", limit=100)
+```
+
+### Async jobs
+
+```python
+job = client.crawl("https://example.com", limit=20)
+completed = client.wait_for_job(job["job_id"])
+print(completed["status"], completed.get("data"))
+```
+
+### Strategies and protected sites
+
+```python
+strategies = client.list_strategies()
+protection = client.list_protection_types()
+
+client.scrape(
+    "https://www.walmart.com/ip/EXAMPLE",
+    strategy="retail",
+    formats=["markdown"],
+)
+
+client.fetch_session(url="https://www.walmart.com/", domain="www.walmart.com")
+```
+
+### Session cookies
+
+```python
+client.seed_session(
+    domain="example.com",
+    cookies=[{"name": "session", "value": "...", "domain": "example.com", "path": "/"}],
+)
+```
+
+## Errors
+
+API failures raise `MetaliftError`:
+
+```python
+from metalift_sdk import Metalift, MetaliftError
+
+try:
+    client.scrape("https://example.com")
+except MetaliftError as exc:
+    print(exc.status_code, exc.detail)
+```
+
+## Links
+
+- [Documentation](https://app.metalift.ai/docs)
+- [API reference](https://app.metalift.ai/openapi/metalift.v1.yaml)
+- [Support](mailto:support@metalift.ai)
+
+## License & distribution
+
+`metalift-sdk` is **proprietary software** licensed under the terms in [LICENSE](./LICENSE). Use, copying, modification, and redistribution are not permitted except as expressly authorized by Metalift.
+
+The package is published on the public [Python Package Index (PyPI)](https://pypi.org/project/metalift-sdk/) so customers can install it with `pip install metalift-sdk`. Publishing on PyPI does **not** make the software open source: the wheel and source archive are publicly downloadable, but legal use remains governed by the proprietary license.
+
+Do not commit API keys or other credentials into your application code. Pass them at runtime via the `api_key` argument or the `METALIFT_API_KEY` environment variable.

metalift_sdk-1.0.0/README.md

@@ -0,0 +1,136 @@
+# metalift-sdk
+
+Official Python SDK for [Metalift](https://app.metalift.ai) — turn any URL into agent-ready markdown, HTML, or structured data.
+
+## Install
+
+```bash
+pip install metalift-sdk
+```
+
+Requires Python 3.11+.
+
+## Quick start
+
+```python
+from metalift_sdk import Metalift
+
+client = Metalift(api_key="YOUR_API_KEY")
+
+result = client.scrape(
+    "https://example.com",
+    formats=["markdown"],
+)
+print(result["data"]["markdown"])
+```
+
+Get an API key from the [Metalift dashboard](https://app.metalift.ai/dashboard/keys). New accounts receive **1,000 free credits/month**.
+
+## Configuration
+
+```python
+from metalift_sdk import Metalift
+
+client = Metalift(
+    api_url="https://api.metalift.ai",  # default
+    api_key="YOUR_API_KEY",
+    timeout=60.0,
+)
+```
+
+Environment variables are also supported:
+
+| Variable | Description |
+|----------|-------------|
+| `METALIFT_API_URL` | API base URL (default: `https://api.metalift.ai`) |
+| `METALIFT_API_KEY` | Bearer token for authenticated requests |
+
+## API
+
+### Scrape
+
+```python
+client.scrape(
+    "https://example.com",
+    formats=["markdown"],
+    render="auto",
+    only_main_content=True,
+    strategy="default",
+)
+```
+
+### Batch scrape
+
+```python
+client.batch(
+    ["https://example.com", "https://example.org"],
+    async_=True,
+    scrape_options={"formats": ["markdown"]},
+)
+```
+
+### Crawl and map
+
+```python
+crawl_job = client.crawl("https://example.com", limit=50)
+map_result = client.map("https://example.com", limit=100)
+```
+
+### Async jobs
+
+```python
+job = client.crawl("https://example.com", limit=20)
+completed = client.wait_for_job(job["job_id"])
+print(completed["status"], completed.get("data"))
+```
+
+### Strategies and protected sites
+
+```python
+strategies = client.list_strategies()
+protection = client.list_protection_types()
+
+client.scrape(
+    "https://www.walmart.com/ip/EXAMPLE",
+    strategy="retail",
+    formats=["markdown"],
+)
+
+client.fetch_session(url="https://www.walmart.com/", domain="www.walmart.com")
+```
+
+### Session cookies
+
+```python
+client.seed_session(
+    domain="example.com",
+    cookies=[{"name": "session", "value": "...", "domain": "example.com", "path": "/"}],
+)
+```
+
+## Errors
+
+API failures raise `MetaliftError`:
+
+```python
+from metalift_sdk import Metalift, MetaliftError
+
+try:
+    client.scrape("https://example.com")
+except MetaliftError as exc:
+    print(exc.status_code, exc.detail)
+```
+
+## Links
+
+- [Documentation](https://app.metalift.ai/docs)
+- [API reference](https://app.metalift.ai/openapi/metalift.v1.yaml)
+- [Support](mailto:support@metalift.ai)
+
+## License & distribution
+
+`metalift-sdk` is **proprietary software** licensed under the terms in [LICENSE](./LICENSE). Use, copying, modification, and redistribution are not permitted except as expressly authorized by Metalift.
+
+The package is published on the public [Python Package Index (PyPI)](https://pypi.org/project/metalift-sdk/) so customers can install it with `pip install metalift-sdk`. Publishing on PyPI does **not** make the software open source: the wheel and source archive are publicly downloadable, but legal use remains governed by the proprietary license.
+
+Do not commit API keys or other credentials into your application code. Pass them at runtime via the `api_key` argument or the `METALIFT_API_KEY` environment variable.

metalift_sdk-1.0.0/metalift_sdk/__init__.py

@@ -0,0 +1,12 @@
+"""Metalift Python SDK."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from metalift_sdk.client import DEFAULT_API_URL, Metalift, MetaliftError
+
+try:
+    __version__ = version("metalift-sdk")
+except PackageNotFoundError:
+    __version__ = "1.0.0"
+
+__all__ = ["DEFAULT_API_URL", "Metalift", "MetaliftError", "__version__"]

metalift_sdk-1.0.0/metalift_sdk/client.py

@@ -0,0 +1,108 @@
+from __future__ import annotations
+
+import os
+import time
+from typing import Any
+
+import httpx
+
+DEFAULT_API_URL = "https://api.metalift.ai"
+
+
+class MetaliftError(RuntimeError):
+    """Raised when the Metalift API returns an error response."""
+
+    def __init__(
+        self,
+        detail: str,
+        *,
+        status_code: int | None = None,
+        body: dict[str, Any] | None = None,
+    ) -> None:
+        super().__init__(detail)
+        self.detail = detail
+        self.status_code = status_code
+        self.body = body or {}
+
+
+class Metalift:
+    def __init__(
+        self,
+        api_url: str | None = None,
+        api_key: str | None = None,
+        timeout: float = 60.0,
+    ) -> None:
+        self.api_url = (api_url or os.getenv("METALIFT_API_URL") or DEFAULT_API_URL).rstrip("/")
+        self.api_key = api_key or os.getenv("METALIFT_API_KEY")
+        self.timeout = timeout
+
+    def _headers(self) -> dict[str, str]:
+        headers = {"Content-Type": "application/json", "Accept": "application/json"}
+        if self.api_key:
+            headers["Authorization"] = f"Bearer {self.api_key}"
+        return headers
+
+    def _parse_body(self, response: httpx.Response) -> dict[str, Any]:
+        try:
+            body = response.json()
+            if isinstance(body, dict):
+                return body
+        except ValueError:
+            pass
+        return {"detail": response.text or response.reason_phrase}
+
+    def _request(self, method: str, path: str, json: dict[str, Any] | None = None) -> dict[str, Any]:
+        with httpx.Client(timeout=self.timeout) as client:
+            response = client.request(method, f"{self.api_url}{path}", headers=self._headers(), json=json)
+            body = self._parse_body(response)
+            if response.is_error:
+                detail = body.get("detail") or body.get("error") or response.text or response.reason_phrase
+                raise MetaliftError(str(detail), status_code=response.status_code, body=body)
+            return body
+
+    def scrape(self, url: str, **kwargs: Any) -> dict[str, Any]:
+        payload = {"url": url, **kwargs}
+        return self._request("POST", "/v1/scrape", payload)
+
+    def batch(self, urls: list[str], **kwargs: Any) -> dict[str, Any]:
+        if "async_" in kwargs:
+            kwargs["async"] = kwargs.pop("async_")
+        payload = {"urls": urls, **kwargs}
+        return self._request("POST", "/v1/batch", payload)
+
+    def crawl(self, url: str, **kwargs: Any) -> dict[str, Any]:
+        payload = {"url": url, **kwargs}
+        return self._request("POST", "/v1/crawl", payload)
+
+    def map(self, url: str, **kwargs: Any) -> dict[str, Any]:
+        payload = {"url": url, **kwargs}
+        return self._request("POST", "/v1/map", payload)
+
+    def list_strategies(self) -> dict[str, Any]:
+        return self._request("GET", "/v1/strategies")
+
+    def list_protection_types(self) -> dict[str, Any]:
+        return self._request("GET", "/v1/protection-types")
+
+    def seed_session(self, **kwargs: Any) -> dict[str, Any]:
+        return self._request("PUT", "/v1/sessions", kwargs)
+
+    def fetch_session(self, **kwargs: Any) -> dict[str, Any]:
+        return self._request("POST", "/v1/sessions/fetch", kwargs)
+
+    def get_job(self, job_id: str) -> dict[str, Any]:
+        return self._request("GET", f"/v1/jobs/{job_id}")
+
+    def wait_for_job(
+        self,
+        job_id: str,
+        interval_seconds: float = 2.0,
+        timeout_seconds: float = 300.0,
+    ) -> dict[str, Any]:
+        start = time.time()
+        while time.time() - start < timeout_seconds:
+            job = self.get_job(job_id)
+            if job.get("status") in {"completed", "failed"}:
+                return job
+            time.sleep(interval_seconds)
+        raise TimeoutError(f"Job {job_id} timed out after {timeout_seconds}s")

metalift_sdk-1.0.0/metalift_sdk.egg-info/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: metalift-sdk
+Version: 1.0.0
+Summary: Official Python SDK for the Metalift web context API
+Author-email: Metalift <support@metalift.ai>
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://metalift.ai
+Project-URL: Documentation, https://metalift.ai/docs
+Project-URL: Repository, https://github.com/Endacoder/scraper-mcp
+Project-URL: Issues, https://github.com/Endacoder/scraper-mcp/issues
+Project-URL: Changelog, https://github.com/Endacoder/scraper-mcp/releases
+Keywords: metalift,scraping,web-scraping,crawl,llm,agents,markdown
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Dynamic: license-file
+
+# metalift-sdk
+
+Official Python SDK for [Metalift](https://app.metalift.ai) — turn any URL into agent-ready markdown, HTML, or structured data.
+
+## Install
+
+```bash
+pip install metalift-sdk
+```
+
+Requires Python 3.11+.
+
+## Quick start
+
+```python
+from metalift_sdk import Metalift
+
+client = Metalift(api_key="YOUR_API_KEY")
+
+result = client.scrape(
+    "https://example.com",
+    formats=["markdown"],
+)
+print(result["data"]["markdown"])
+```
+
+Get an API key from the [Metalift dashboard](https://app.metalift.ai/dashboard/keys). New accounts receive **1,000 free credits/month**.
+
+## Configuration
+
+```python
+from metalift_sdk import Metalift
+
+client = Metalift(
+    api_url="https://api.metalift.ai",  # default
+    api_key="YOUR_API_KEY",
+    timeout=60.0,
+)
+```
+
+Environment variables are also supported:
+
+| Variable | Description |
+|----------|-------------|
+| `METALIFT_API_URL` | API base URL (default: `https://api.metalift.ai`) |
+| `METALIFT_API_KEY` | Bearer token for authenticated requests |
+
+## API
+
+### Scrape
+
+```python
+client.scrape(
+    "https://example.com",
+    formats=["markdown"],
+    render="auto",
+    only_main_content=True,
+    strategy="default",
+)
+```
+
+### Batch scrape
+
+```python
+client.batch(
+    ["https://example.com", "https://example.org"],
+    async_=True,
+    scrape_options={"formats": ["markdown"]},
+)
+```
+
+### Crawl and map
+
+```python
+crawl_job = client.crawl("https://example.com", limit=50)
+map_result = client.map("https://example.com", limit=100)
+```
+
+### Async jobs
+
+```python
+job = client.crawl("https://example.com", limit=20)
+completed = client.wait_for_job(job["job_id"])
+print(completed["status"], completed.get("data"))
+```
+
+### Strategies and protected sites
+
+```python
+strategies = client.list_strategies()
+protection = client.list_protection_types()
+
+client.scrape(
+    "https://www.walmart.com/ip/EXAMPLE",
+    strategy="retail",
+    formats=["markdown"],
+)
+
+client.fetch_session(url="https://www.walmart.com/", domain="www.walmart.com")
+```
+
+### Session cookies
+
+```python
+client.seed_session(
+    domain="example.com",
+    cookies=[{"name": "session", "value": "...", "domain": "example.com", "path": "/"}],
+)
+```
+
+## Errors
+
+API failures raise `MetaliftError`:
+
+```python
+from metalift_sdk import Metalift, MetaliftError
+
+try:
+    client.scrape("https://example.com")
+except MetaliftError as exc:
+    print(exc.status_code, exc.detail)
+```
+
+## Links
+
+- [Documentation](https://app.metalift.ai/docs)
+- [API reference](https://app.metalift.ai/openapi/metalift.v1.yaml)
+- [Support](mailto:support@metalift.ai)
+
+## License & distribution
+
+`metalift-sdk` is **proprietary software** licensed under the terms in [LICENSE](./LICENSE). Use, copying, modification, and redistribution are not permitted except as expressly authorized by Metalift.
+
+The package is published on the public [Python Package Index (PyPI)](https://pypi.org/project/metalift-sdk/) so customers can install it with `pip install metalift-sdk`. Publishing on PyPI does **not** make the software open source: the wheel and source archive are publicly downloadable, but legal use remains governed by the proprietary license.
+
+Do not commit API keys or other credentials into your application code. Pass them at runtime via the `api_key` argument or the `METALIFT_API_KEY` environment variable.

metalift_sdk-1.0.0/metalift_sdk.egg-info/SOURCES.txt

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

metalift_sdk-1.0.0/metalift_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

metalift_sdk-1.0.0/metalift_sdk.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.27.0

metalift_sdk-1.0.0/metalift_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+metalift_sdk

metalift_sdk-1.0.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "metalift-sdk"
+version = "1.0.0"
+description = "Official Python SDK for the Metalift web context API"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
+authors = [{ name = "Metalift", email = "support@metalift.ai" }]
+keywords = ["metalift", "scraping", "web-scraping", "crawl", "llm", "agents", "markdown"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://metalift.ai"
+Documentation = "https://metalift.ai/docs"
+Repository = "https://github.com/Endacoder/scraper-mcp"
+Issues = "https://github.com/Endacoder/scraper-mcp/issues"
+Changelog = "https://github.com/Endacoder/scraper-mcp/releases"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["metalift_sdk*"]

metalift_sdk-1.0.0/setup.cfg

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