langchain-snaprender 0.1.0__tar.gz

langchain_snaprender-0.1.0/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: langchain-snaprender
+Version: 0.1.0
+Summary: LangChain tools for SnapRender Screenshot API — capture websites as PNG, JPEG, WebP, or PDF
+Author-email: SnapRender <support@snap-render.com>
+License-Expression: MIT
+Project-URL: Homepage, https://snap-render.com
+Project-URL: Repository, https://github.com/User0856/snaprender-integrations/tree/main/langchain
+Project-URL: Documentation, https://snap-render.com
+Project-URL: Bug Tracker, https://github.com/User0856/snaprender-integrations/issues
+Keywords: langchain,langchain-tool,screenshot,web-capture,snaprender,ai-agent,llm-tool
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+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
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: langchain-core>=0.2.0
+Requires-Dist: snaprender>=0.2.0
+
+# langchain-snaprender
+
+[![PyPI](https://img.shields.io/pypi/v/langchain-snaprender)](https://pypi.org/project/langchain-snaprender/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../LICENSE)
+
+LangChain / LangGraph tools for [SnapRender Screenshot API](https://snap-render.com). Lets your LangChain agents capture website screenshots as PNG, JPEG, WebP, or PDF.
+
+## Install
+
+```bash
+pip install langchain-snaprender
+```
+
+## Setup
+
+```bash
+export SNAPRENDER_API_KEY="sk_live_your_key_here"
+```
+
+Get a free key at [app.snap-render.com](https://app.snap-render.com/auth/signup) — 50 screenshots/month, no credit card.
+
+## Usage
+
+```python
+from langchain_snaprender import take_screenshot, check_cache, get_usage
+
+# Use as standalone tools
+result = take_screenshot.invoke({"url": "https://example.com"})
+print(result)
+
+# Or bind to a LangChain agent
+from langchain_openai import ChatOpenAI
+from langgraph.prebuilt import create_react_agent
+
+llm = ChatOpenAI(model="gpt-4o")
+tools = [take_screenshot, check_cache, get_usage]
+agent = create_react_agent(llm, tools)
+
+response = agent.invoke({"messages": [("user", "Take a screenshot of stripe.com")]})
+```
+
+## Tools
+
+### `take_screenshot`
+
+Capture any website as PNG, JPEG, WebP, or PDF.
+
+Parameters: `url`, `format`, `full_page`, `dark_mode`, `block_ads`, `block_cookie_banners`, `device`, `width`, `height`
+
+### `check_cache`
+
+Check if a screenshot is cached (free, doesn't count against quota).
+
+Parameters: `url`, `format`
+
+### `get_usage`
+
+Get current month's usage stats.
+
+## License
+
+MIT

langchain_snaprender-0.1.0/README.md

@@ -0,0 +1,62 @@
+# langchain-snaprender
+
+[![PyPI](https://img.shields.io/pypi/v/langchain-snaprender)](https://pypi.org/project/langchain-snaprender/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../LICENSE)
+
+LangChain / LangGraph tools for [SnapRender Screenshot API](https://snap-render.com). Lets your LangChain agents capture website screenshots as PNG, JPEG, WebP, or PDF.
+
+## Install
+
+```bash
+pip install langchain-snaprender
+```
+
+## Setup
+
+```bash
+export SNAPRENDER_API_KEY="sk_live_your_key_here"
+```
+
+Get a free key at [app.snap-render.com](https://app.snap-render.com/auth/signup) — 50 screenshots/month, no credit card.
+
+## Usage
+
+```python
+from langchain_snaprender import take_screenshot, check_cache, get_usage
+
+# Use as standalone tools
+result = take_screenshot.invoke({"url": "https://example.com"})
+print(result)
+
+# Or bind to a LangChain agent
+from langchain_openai import ChatOpenAI
+from langgraph.prebuilt import create_react_agent
+
+llm = ChatOpenAI(model="gpt-4o")
+tools = [take_screenshot, check_cache, get_usage]
+agent = create_react_agent(llm, tools)
+
+response = agent.invoke({"messages": [("user", "Take a screenshot of stripe.com")]})
+```
+
+## Tools
+
+### `take_screenshot`
+
+Capture any website as PNG, JPEG, WebP, or PDF.
+
+Parameters: `url`, `format`, `full_page`, `dark_mode`, `block_ads`, `block_cookie_banners`, `device`, `width`, `height`
+
+### `check_cache`
+
+Check if a screenshot is cached (free, doesn't count against quota).
+
+Parameters: `url`, `format`
+
+### `get_usage`
+
+Get current month's usage stats.
+
+## License
+
+MIT

langchain_snaprender-0.1.0/langchain_snaprender/__init__.py

@@ -0,0 +1,137 @@
+"""LangChain tools for SnapRender Screenshot API.
+
+Usage:
+    from langchain_snaprender import take_screenshot, check_cache, get_usage
+
+    tools = [take_screenshot, check_cache, get_usage]
+"""
+
+from __future__ import annotations
+
+import base64
+import os
+import tempfile
+from typing import Optional
+
+from langchain_core.tools import tool
+from snaprender import SnapRender
+
+
+def _client() -> SnapRender:
+    key = os.environ.get("SNAPRENDER_API_KEY")
+    if not key:
+        raise RuntimeError(
+            "SNAPRENDER_API_KEY environment variable is required. "
+            "Get a free key at https://app.snap-render.com/auth/signup"
+        )
+    return SnapRender(api_key=key)
+
+
+@tool
+def take_screenshot(
+    url: str,
+    format: str = "png",
+    full_page: bool = False,
+    dark_mode: bool = False,
+    block_ads: bool = True,
+    block_cookie_banners: bool = True,
+    device: Optional[str] = None,
+    width: Optional[int] = None,
+    height: Optional[int] = None,
+) -> str:
+    """Take a screenshot of a website. Returns the file path and metadata.
+
+    Args:
+        url: URL to capture (must start with http:// or https://)
+        format: Output format - png, jpeg, webp, or pdf (default: png)
+        full_page: Capture entire scrollable page (default: False)
+        dark_mode: Enable dark mode CSS emulation (default: False)
+        block_ads: Block advertisements (default: True)
+        block_cookie_banners: Remove cookie consent banners (default: True)
+        device: Device preset - iphone_14, iphone_15_pro, pixel_7, ipad_pro, macbook_pro
+        width: Viewport width in pixels, 320-3840
+        height: Viewport height in pixels, 200-10000
+    """
+    snap = _client()
+    try:
+        result = snap.capture(
+            url,
+            format=format,
+            full_page=full_page,
+            dark_mode=dark_mode,
+            block_ads=block_ads,
+            block_cookie_banners=block_cookie_banners,
+            device=device,
+            width=width,
+            height=height,
+            response_type="json",
+        )
+    finally:
+        snap.close()
+
+    ext = format if format != "jpeg" else "jpg"
+    fd, path = tempfile.mkstemp(suffix=f".{ext}", prefix="snaprender_")
+    os.close(fd)
+
+    image_data = result["image"]
+    if "," in image_data:
+        image_data = image_data.split(",", 1)[1]
+
+    with open(path, "wb") as f:
+        f.write(base64.b64decode(image_data))
+
+    file_size = os.path.getsize(path)
+    return (
+        f"Screenshot saved to {path} ({file_size:,} bytes)\n"
+        f"URL: {result.get('url', url)}\n"
+        f"Format: {result.get('format', format)}\n"
+        f"Cache: {result.get('cache', 'unknown')}\n"
+        f"Response time: {result.get('responseTime', 'unknown')}\n"
+        f"Remaining credits: {result.get('remainingCredits', 'unknown')}"
+    )
+
+
+@tool
+def check_cache(url: str, format: str = "png") -> str:
+    """Check if a screenshot is already cached without capturing a new one. Does not count against quota.
+
+    Args:
+        url: URL to check
+        format: Output format - png, jpeg, webp, or pdf (default: png)
+    """
+    snap = _client()
+    try:
+        info = snap.info(url, format=format)
+    finally:
+        snap.close()
+
+    if info["cached"]:
+        return (
+            f"Cached: YES\n"
+            f"URL: {info['url']}\n"
+            f"Cached at: {info.get('cached_at', 'unknown')}\n"
+            f"Expires at: {info.get('expires_at', 'unknown')}\n"
+            f"Content type: {info.get('content_type', 'unknown')}"
+        )
+    return f"Cached: NO\nURL: {info['url']}"
+
+
+@tool
+def get_usage() -> str:
+    """Get current month's screenshot usage statistics including plan, used, limit, and remaining credits."""
+    snap = _client()
+    try:
+        usage = snap.usage()
+    finally:
+        snap.close()
+
+    return (
+        f"Plan: {usage['plan']}\n"
+        f"Used: {usage['used']}\n"
+        f"Limit: {usage['limit']}\n"
+        f"Remaining: {usage['remaining']}\n"
+        f"Period: {usage['period']}"
+    )
+
+
+__all__ = ["take_screenshot", "check_cache", "get_usage"]

langchain_snaprender-0.1.0/langchain_snaprender.egg-info/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: langchain-snaprender
+Version: 0.1.0
+Summary: LangChain tools for SnapRender Screenshot API — capture websites as PNG, JPEG, WebP, or PDF
+Author-email: SnapRender <support@snap-render.com>
+License-Expression: MIT
+Project-URL: Homepage, https://snap-render.com
+Project-URL: Repository, https://github.com/User0856/snaprender-integrations/tree/main/langchain
+Project-URL: Documentation, https://snap-render.com
+Project-URL: Bug Tracker, https://github.com/User0856/snaprender-integrations/issues
+Keywords: langchain,langchain-tool,screenshot,web-capture,snaprender,ai-agent,llm-tool
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+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
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: langchain-core>=0.2.0
+Requires-Dist: snaprender>=0.2.0
+
+# langchain-snaprender
+
+[![PyPI](https://img.shields.io/pypi/v/langchain-snaprender)](https://pypi.org/project/langchain-snaprender/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../LICENSE)
+
+LangChain / LangGraph tools for [SnapRender Screenshot API](https://snap-render.com). Lets your LangChain agents capture website screenshots as PNG, JPEG, WebP, or PDF.
+
+## Install
+
+```bash
+pip install langchain-snaprender
+```
+
+## Setup
+
+```bash
+export SNAPRENDER_API_KEY="sk_live_your_key_here"
+```
+
+Get a free key at [app.snap-render.com](https://app.snap-render.com/auth/signup) — 50 screenshots/month, no credit card.
+
+## Usage
+
+```python
+from langchain_snaprender import take_screenshot, check_cache, get_usage
+
+# Use as standalone tools
+result = take_screenshot.invoke({"url": "https://example.com"})
+print(result)
+
+# Or bind to a LangChain agent
+from langchain_openai import ChatOpenAI
+from langgraph.prebuilt import create_react_agent
+
+llm = ChatOpenAI(model="gpt-4o")
+tools = [take_screenshot, check_cache, get_usage]
+agent = create_react_agent(llm, tools)
+
+response = agent.invoke({"messages": [("user", "Take a screenshot of stripe.com")]})
+```
+
+## Tools
+
+### `take_screenshot`
+
+Capture any website as PNG, JPEG, WebP, or PDF.
+
+Parameters: `url`, `format`, `full_page`, `dark_mode`, `block_ads`, `block_cookie_banners`, `device`, `width`, `height`
+
+### `check_cache`
+
+Check if a screenshot is cached (free, doesn't count against quota).
+
+Parameters: `url`, `format`
+
+### `get_usage`
+
+Get current month's usage stats.
+
+## License
+
+MIT

langchain_snaprender-0.1.0/langchain_snaprender.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+langchain_snaprender/__init__.py
+langchain_snaprender.egg-info/PKG-INFO
+langchain_snaprender.egg-info/SOURCES.txt
+langchain_snaprender.egg-info/dependency_links.txt
+langchain_snaprender.egg-info/requires.txt
+langchain_snaprender.egg-info/top_level.txt

langchain_snaprender-0.1.0/langchain_snaprender.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

langchain_snaprender-0.1.0/langchain_snaprender.egg-info/requires.txt

@@ -0,0 +1,2 @@
+langchain-core>=0.2.0
+snaprender>=0.2.0

langchain_snaprender-0.1.0/langchain_snaprender.egg-info/top_level.txt

@@ -0,0 +1 @@
+langchain_snaprender

langchain_snaprender-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "langchain-snaprender"
+version = "0.1.0"
+description = "LangChain tools for SnapRender Screenshot API — capture websites as PNG, JPEG, WebP, or PDF"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "SnapRender", email = "support@snap-render.com" },
+]
+keywords = [
+    "langchain",
+    "langchain-tool",
+    "screenshot",
+    "web-capture",
+    "snaprender",
+    "ai-agent",
+    "llm-tool",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Internet :: WWW/HTTP",
+]
+dependencies = [
+    "langchain-core>=0.2.0",
+    "snaprender>=0.2.0",
+]
+
+[project.urls]
+Homepage = "https://snap-render.com"
+Repository = "https://github.com/User0856/snaprender-integrations/tree/main/langchain"
+Documentation = "https://snap-render.com"
+"Bug Tracker" = "https://github.com/User0856/snaprender-integrations/issues"
+
+[tool.setuptools.packages.find]
+include = ["langchain_snaprender*"]

langchain_snaprender-0.1.0/setup.cfg

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