propzapi-skills
Agent skills for template-based image generation and webpage screenshots. Drop-in skills that let any agent render an image from an HTML/CSS template, snapshot any live URL, and manage a template library — over the propzapi REST API.
Templates are HTML/CSS with {{variables}} and Jinja logic ({% if %}, {% for %}, filters). Fill the variables with one JSON call and get back a rendered PNG/JPEG/WEBP/PDF at a stable URL — no headless browser to run, no fonts to install. Perfect for Open Graph images, social cards, certificates, invoices, receipts, and data charts.
Free to start — grab a key (50-image trial, no card required) and you're rendering from Claude, Cursor, Cline, or your own agent loop in under two minutes.
Pure Python standard library. No dependencies. MIT-0 licensed.
Guides
Deep-dive walkthroughs on the propzapi blog:
- HTML to Image API: turn HTML and CSS into a PNG in one call
- Open Graph Image API: generate dynamic og:image URLs in one call
- HTML to PDF API: convert HTML to PDF in one call
- Bannerbear alternative: a pay-as-you-go image generation API
Install
# Claude Code, Cursor, Cline, etc. — `skills` CLI, installs straight from this repo
npx skills add paperandbeyond23-gif/propzapi-skills --all
# or pick one: npx skills add paperandbeyond23-gif/propzapi-skills --skill propzapi-full
# OpenClaw / ClawHub — published to the ClawHub registry
npx clawhub@latest install propzapi-full
Skills in this repo
| Skill | Purpose |
|---|---|
propzapi-full | Complete toolkit — generate images from templates, capture screenshots, and manage templates |
Tools
| Tool | Returns |
|---|---|
generate_image(template, modifications, format, scale, quality) | Rendered image {url, width, height, format, bytes} |
screenshot(url, full_page, width, height, format) | Screenshot of a live page {url, ...} |
list_templates() | Available built-in and custom templates |
create_template(name, html, width, height, variables) | Created template with its tpl_... id |
embed_url(template, modifications, format) | Signed GET render URL for <meta og:image> |
Authentication
Set the PROPZAPI_KEY environment variable to your propzapi key. It's sent as the X-API-Key header — the base URL is hardcoded, so the key never reaches any other host.
export PROPZAPI_KEY="your_key"
Get a free key — 50-image trial, no card required. You can also mint one with POST /v1/register → {api_key, plan, credits}. The same key works for these skills and direct REST calls.
Pricing
Each rendered image or screenshot costs 1 credit — the response returns the exact charge in the X-Credits-Cost header, and your balance in X-Credits-Remaining. Listing and creating templates is free.
| Plan | Price | Images / mo |
|---|---|---|
| Free trial | $0 | 50 |
| Starter | $29/mo | 1,000 |
| Growth | $79/mo | 3,500 |
| Pro | $199/mo | 12,000 |
Prefer pay-as-you-go? Credit packs: $5 / 150 images and $15 / 500 images. Manage plans at https://propzapi.com/pricing.
Source
- Docs: https://propzapi.com/docs · OpenAPI: https://api.propzapi.com/openapi.json
- MCP server: https://api.propzapi.com/mcp (same key,
X-API-Keyheader) — toolsgenerate_image,screenshot_url,list_templates - Quickstart: get a key at https://propzapi.com/app, then call any tool
Issues and contributions
See CONTRIBUTING.md. Security reports: SECURITY.md.
License
MIT No Attribution. Fork, ship, sublicense — no attribution required.
Independence
propzapi is an independent developer tool for rendering images from templates and capturing webpage screenshots. Images render from HTML/CSS you supply or select; you are responsible for the content you render and for the rights to any assets, fonts, and pages you screenshot. Comply with the laws of your jurisdiction and the terms of any site you capture.