Propzapi Skills

propzapi-skills

用于基于模板生成图像和网页截图的 Agent 技能。 可直接使用的技能，让任何 Agent 都能通过 propzapi REST API 从 HTML/CSS 模板渲染图像、截取任意在线 URL 的页面，并管理模板库。

模板采用 HTML/CSS，支持 {{variables}} 和 Jinja 逻辑（{% if %}、{% for %}、过滤器）。只需一次 JSON 调用即可填充变量，并获取可通过稳定 URL 访问的渲染结果 PNG/JPEG/WEBP/PDF——无需运行无头浏览器，也无需安装字体。非常适合 Open Graph 图像、社交卡片、证书、发票、收据和数据图表。

免费开始——获取密钥（50 张图像的试用额度，无需信用卡），不到两分钟即可在 Claude、Cursor、Cline 或自己的 Agent 循环中开始渲染。

纯 Python 标准库。无依赖项。采用 MIT-0 许可证。

指南

propzapi 博客上的深度指南：

• HTML 转图像 API：一次调用即可将 HTML 和 CSS 转为 PNG
• Open Graph 图像 API：一次调用即可生成动态 og:image URL
• HTML 转 PDF API：一次调用即可将 HTML 转为 PDF
• Bannerbear 替代方案：按需付费的图像生成 API

安装

# 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

此仓库中的技能

技能	用途
propzapi-full	完整工具包——从模板生成图像、截取屏幕截图并管理模板

工具

工具	返回内容
generate_image(template, modifications, format, scale, quality)	渲染后的图像 {url, width, height, format, bytes}
screenshot(url, full_page, width, height, format)	在线页面的屏幕截图 {url, ...}
list_templates()	可用的内置模板和自定义模板
create_template(name, html, width, height, variables)	已创建的模板及其 tpl_... ID
embed_url(template, modifications, format)	用于 <meta og:image> 的带签名 GET 渲染 URL

身份验证

将 PROPZAPI_KEY 环境变量设为你的 propzapi 密钥。密钥会作为 X-API-Key 标头发送——基础 URL 是硬编码的，因此密钥不会发送到其他主机。

export PROPZAPI_KEY="your_key"

获取免费密钥——50 张图像的试用额度，无需信用卡。你也可以通过 POST /v1/register → {api_key, plan, credits} 生成密钥。同一个密钥可用于这些技能和直接 REST 调用。

定价

每张渲染图像或屏幕截图消耗 1 点额度——响应会在 X-Credits-Cost 标头中返回确切的扣费额度，并在 X-Credits-Remaining 标头中返回余额。列出和创建模板免费。

套餐	价格	每月图像数
免费试用	$0	50
入门版	$29/mo	1,000
成长版	$79/mo	3,500
专业版	$199/mo	12,000

更倾向于按需付费？额度包：$5 / 150 张图像和 $15 / 500 张图像。在 https://propzapi.com/pricing 管理套餐。

源码

• 文档：https://propzapi.com/docs · OpenAPI：https://api.propzapi.com/openapi.json
• MCP 服务：https://api.propzapi.com/mcp（使用相同密钥和 X-API-Key 标头）——工具 generate_image、screenshot_url、list_templates
• 快速入门：在 https://propzapi.com/app 获取密钥，然后调用任意工具

问题与贡献

请参阅 CONTRIBUTING.md。安全问题请报告至 SECURITY.md。

许可证

MIT No Attribution。你可以分叉、发布和再许可——无需注明出处。

独立性

propzapi 是一款独立的开发者工具，用于从模板渲染图像和截取网页屏幕截图。图像根据你提供或选择的 HTML/CSS 渲染；你需对所渲染的内容以及所用素材、字体和截图页面的权利负责。请遵守所在司法管辖区的法律以及你所截取网站的条款。