Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Extract web data, capture screenshots, scrape content, and generate AI images via OpenGraph.io. Use when working with URLs (unfurling, previews, metadata), capturing webpage screenshots, scraping HTML content, asking questions about webpages, or generating images (diagrams, icons, social cards, QR codes). Triggers: 'get the OG tags', 'screenshot this page', 'scrape this URL', 'generate a diagram', 'create a social card', 'what does this page say about'.
Extract web data, capture screenshots, scrape content, and generate AI images via OpenGraph.io. Use when working with URLs (unfurling, previews, metadata), capturing webpage screenshots, scraping HTML content, asking questions about webpages, or generating images (diagrams, icons, social cards, QR codes). Triggers: 'get the OG tags', 'screenshot this page', 'scrape this URL', 'generate a diagram', 'create a social card', 'what does this page say about'.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Extract web data, capture screenshots, and generate AI-powered images via OpenGraph.io APIs. 🤖 AI Agents: For complete parameter docs and patterns, also read references/for-ai-agents.md.
NeedEndpointMeta tags / link preview dataGET /site/{url}Raw HTML contentGET /scrape/{url} (add use_proxy=true if geo-blocked)Specific elements (h1, h2, p)GET /extract/{url}?html_elements=h1,h2,pAI answer about the pagePOST /query/{url} ⚠️ paidVisual screenshotGET /screenshot/{url}
NeedSettingsTechnical diagramkind: "diagram" — use diagramCode + diagramFormat for controlApp icon/logokind: "icon" — set transparent: trueSocial card (OG/Twitter)kind: "social-card" — use aspectRatio: "og-image"Basic QR codekind: "qr-code"Premium QR marketing cardkind: "illustration" — describe full design in promptGeneral illustrationkind: "illustration"
Basic (kind: "qr-code"): Just the functional QR code. Premium (kind: "illustration"): Full marketing asset with QR embedded in designed composition (gradients, 3D elements, CTAs, device mockups). Example prompt: "Premium marketing card with QR code for https://myapp.com, cosmic purple gradient with floating 3D spheres, glowing accents, 'SCAN TO DOWNLOAD' call-to-action"
Use diagramCode + diagramFormat for reliable syntax (bypasses AI generation) Use outputStyle: "standard" for structure-critical diagrams (premium may alter layout) ❌ Don't mix syntax with description: "graph LR A-->B make it pretty" will fail
FeatureFree TierPaid PlansSite/Unfurl✅ 100/monthUnlimitedScreenshot✅ 100/monthUnlimitedScrape✅ 100/monthUnlimitedExtract✅ 100/monthUnlimitedQuery (AI)❌✅Image Generation✅ 4/monthUnlimited 💡 Try image generation free! Get 4 premium image generations per month on the free plan — no credit card required. Sign up at dashboard.opengraph.io
Sign up at dashboard.opengraph.io — free trial available Configure (choose one): Option A: Clawdbot config (recommended) // ~/.clawdbot/clawdbot.json { skills: { entries: { "opengraph-io": { apiKey: "YOUR_APP_ID" } } } } Option B: Environment variable export OPENGRAPH_APP_ID="YOUR_APP_ID"
Use curl with the OPENGRAPH_APP_ID environment variable. Base URL: https://opengraph.io/api/1.1/
# Get OG tags from a URL curl -s "https://opengraph.io/api/1.1/site/$(echo -n 'https://example.com' | jq -sRr @uri)?app_id=${OPENGRAPH_APP_ID}" Response includes hybridGraph.title, hybridGraph.description, hybridGraph.image, etc.
# Capture screenshot (dimensions: sm, md, lg, xl) curl -s "https://opengraph.io/api/1.1/screenshot/$(echo -n 'https://example.com' | jq -sRr @uri)?app_id=${OPENGRAPH_APP_ID}&dimensions=lg" Response: { "screenshotUrl": "https://..." }
# Fetch rendered HTML (with optional proxy) curl -s "https://opengraph.io/api/1.1/scrape/$(echo -n 'https://example.com' | jq -sRr @uri)?app_id=${OPENGRAPH_APP_ID}&use_proxy=true"
# Pull h1, h2, p tags curl -s "https://opengraph.io/api/1.1/extract/$(echo -n 'https://example.com' | jq -sRr @uri)?app_id=${OPENGRAPH_APP_ID}&html_elements=h1,h2,p"
curl -s -X POST "https://opengraph.io/api/1.1/query/$(echo -n 'https://example.com' | jq -sRr @uri)?app_id=${OPENGRAPH_APP_ID}" \ -H "Content-Type: application/json" \ -d '{"query": "What services does this company offer?"}'
Base URL: https://opengraph.io/image-agent/
SESSION=$(curl -s -X POST "https://opengraph.io/image-agent/sessions?app_id=${OPENGRAPH_APP_ID}" \ -H "Content-Type: application/json" \ -d '{"name": "my-session"}') SESSION_ID=$(echo $SESSION | jq -r '.sessionId')
curl -s -X POST "https://opengraph.io/image-agent/sessions/${SESSION_ID}/generate?app_id=${OPENGRAPH_APP_ID}" \ -H "Content-Type: application/json" \ -d '{ "prompt": "A beautiful QR code linking to https://example.com with modern gradient design", "kind": "qr-code", "aspectRatio": "square", "quality": "high" }' Image kinds: illustration, diagram, icon, social-card, qr-code Style presets: github-dark, vercel, stripe, neon-cyber, pastel, minimal-mono Aspect ratios: square, og-image (1200×630), twitter-card, instagram-story, etc.
ASSET_ID="<from-generate-response>" curl -s "https://opengraph.io/image-agent/assets/${ASSET_ID}/file?app_id=${OPENGRAPH_APP_ID}" -o output.png
curl -s -X POST "https://opengraph.io/image-agent/sessions/${SESSION_ID}/iterate?app_id=${OPENGRAPH_APP_ID}" \ -H "Content-Type: application/json" \ -d '{ "assetId": "<previous-asset-id>", "prompt": "Change the background to blue" }'
When users ask in natural language, translate to the appropriate API call: User saysAPI to use"Get the OG tags from URL"GET /site/{url}"Screenshot this page"GET /screenshot/{url}"Scrape the HTML from URL"GET /scrape/{url}"What does this page say about X?"POST /query/{url}"Generate a QR code for URL"POST /image-agent/sessions/{id}/generate with kind: "qr-code""Create a premium QR marketing card"POST /image-agent/sessions/{id}/generate with kind: "illustration" + design in prompt"Create a social card for my blog"POST /image-agent/sessions/{id}/generate with kind: "social-card""Make an architecture diagram"POST /image-agent/sessions/{id}/generate with kind: "diagram"
Basic QR Code (kind: "qr-code"): Generates just the functional QR code with minimal styling. Premium QR Marketing Card (kind: "illustration"): Generates a complete marketing asset with the QR code embedded in a professionally designed composition - gradients, 3D elements, CTAs, device mockups, etc. # Premium QR marketing card example curl -s -X POST "https://opengraph.io/image-agent/sessions/${SESSION_ID}/generate?app_id=${OPENGRAPH_APP_ID}" \ -H "Content-Type: application/json" \ -d '{ "prompt": "Premium marketing card with QR code for https://myapp.com, cosmic purple gradient background with floating 3D spheres, glowing accents, SCAN TO DOWNLOAD call-to-action", "kind": "illustration", "aspectRatio": "square", "outputStyle": "premium", "brandColors": ["#6B4CE6", "#9B6DFF"], "stylePreferences": "modern, cosmic, premium marketing, 3D elements" }'
For AI clients that support MCP, use the MCP server: # Interactive installer npx opengraph-io-mcp --client cursor --app-id YOUR_APP_ID # Or configure manually: { "mcpServers": { "opengraph": { "command": "npx", "args": ["-y", "opengraph-io-mcp"], "env": { "OPENGRAPH_APP_ID": "YOUR_APP_ID" } } } } See references/mcp-clients.md for client-specific setup.
references/for-ai-agents.md — AI agent reference (tool schemas, decision trees, patterns) references/api-reference.md — Complete API documentation (all endpoints, parameters, response schemas) references/platform-support.md — Platform support guide (YouTube, Vimeo, TikTok, social media, e-commerce) references/troubleshooting.md — Troubleshooting guide (common errors, debugging tips) references/image-generation.md — Image presets, styles, templates references/mcp-clients.md — MCP client configurations
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.