Metadata-Version: 2.4
Name: crewai-snaprender
Version: 0.1.0
Summary: CrewAI tools for SnapRender Screenshot API — capture websites as PNG, JPEG, WebP, or PDF
Author-email: SnapRender <support@snap-render.com>
License: MIT
Project-URL: Homepage, https://snap-render.com
Project-URL: Repository, https://github.com/User0856/snaprender-integrations/tree/main/crewai
Project-URL: Documentation, https://snap-render.com
Project-URL: Bug Tracker, https://github.com/User0856/snaprender-integrations/issues
Keywords: crewai,crewai-tool,screenshot,web-capture,snaprender,ai-agent
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: crewai>=0.80.0
Requires-Dist: snaprender>=0.2.0

# crewai-snaprender

[![PyPI](https://img.shields.io/pypi/v/crewai-snaprender)](https://pypi.org/project/crewai-snaprender/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../LICENSE)

CrewAI tools for [SnapRender Screenshot API](https://snap-render.com). Lets your CrewAI agents capture website screenshots as PNG, JPEG, WebP, or PDF.

## Install

```bash
pip install crewai-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 crewai import Agent, Task, Crew
from crewai_snaprender import SnapRenderScreenshotTool, SnapRenderCacheTool, SnapRenderUsageTool

researcher = Agent(
    role="Web Researcher",
    goal="Capture and analyze website screenshots",
    backstory="You are a visual web analyst.",
    tools=[SnapRenderScreenshotTool(), SnapRenderCacheTool(), SnapRenderUsageTool()],
)

task = Task(
    description="Take a screenshot of stripe.com in dark mode on iPhone",
    expected_output="Screenshot file path and metadata",
    agent=researcher,
)

crew = Crew(agents=[researcher], tasks=[task])
result = crew.kickoff()
```

## Tools

### `SnapRenderScreenshotTool`

Capture any website as PNG, JPEG, WebP, or PDF with device emulation, dark mode, ad blocking, and more.

### `SnapRenderCacheTool`

Check if a screenshot is cached (free, doesn't count against quota).

### `SnapRenderUsageTool`

Get current month's usage stats.

## License

MIT
