Propzapi Skills

propzapi-skills

テンプレートベースの画像生成とウェブページのスクリーンショット撮影に使えるエージェントスキルです。 どのエージェントにも追加できるスキルで、propzapi REST API を通じて、HTML/CSS テンプレートからの画像生成、任意のライブ URL のスナップショット撮影、テンプレートライブラリの管理ができます。

テンプレートは {{variables}} と Jinja のロジック（{% if %}、{% for %}、フィルター）を使った HTML/CSS です。1 回の JSON 呼び出しで変数を設定すると、安定した URL からレンダリング済みの PNG/JPEG/WEBP/PDF が返されます。ヘッドレスブラウザーの実行も、フォントのインストールも不要です。Open Graph 画像、ソーシャルカード、証明書、請求書、レシート、データチャートに最適です。

無料で始められます。キーを取得（50 枚の画像を試せるトライアル。カード登録不要）すれば、2 分もかからずに Claude、Cursor、Cline、または独自のエージェントループから画像をレンダリングできます。

Python 標準ライブラリのみを使用しています。依存関係はありません。MIT-0 ライセンスです。

ガイド

propzapi ブログの詳しい解説記事：

• HTML から画像への API：HTML と CSS を 1 回の呼び出しで PNG に変換
• Open Graph 画像 API：動的な og:image URL を 1 回の呼び出しで生成
• HTML から PDF への API：HTML を 1 回の呼び出しで 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 API の直接呼び出しの両方で使用できます。

料金

レンダリングされた画像またはスクリーンショット 1 枚につき、クレジットを 1 消費します。レスポンスの X-Credits-Cost ヘッダーに正確な消費量が、X-Credits-Remaining に残高が返されます。テンプレートの一覧表示と作成は無料です。

プラン	料金	画像数／月
無料トライアル	$0	50
Starter	$29/mo	1,000
Growth	$79/mo	3,500
Pro	$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 からレンダリングされます。レンダリングするコンテンツ、およびスクリーンショットに含めるアセット、フォント、ページの権利については、お客様が責任を負います。適用される法令と、撮影対象サイトの利用規約を遵守してください。