# Send Opengraph Io to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "opengraph-io-skill", "name": "Opengraph Io", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/primeobsession/opengraph-io-skill", "canonicalUrl": "https://clawhub.ai/primeobsession/opengraph-io-skill", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/opengraph-io-skill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=opengraph-io-skill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "examples/EXAMPLES.md", "references/api-reference.md", "references/for-ai-agents.md", "references/image-generation.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "opengraph-io-skill", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-06T18:03:26.124Z", "expiresAt": "2026-05-13T18:03:26.124Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=opengraph-io-skill", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=opengraph-io-skill", "contentDisposition": "attachment; filename=\"opengraph-io-skill-1.4.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "opengraph-io-skill" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/opengraph-io-skill" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/opengraph-io-skill", "downloadUrl": "https://openagent3.xyz/downloads/opengraph-io-skill", "agentUrl": "https://openagent3.xyz/skills/opengraph-io-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/opengraph-io-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/opengraph-io-skill/agent.md" } } ``` ## Documentation ### OpenGraph.io 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. ### "I need data from a URL" 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} ### "I need to generate an image" 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" ### QR Code: Basic vs Premium 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" ### Diagram Tips 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 ### Pricing & Requirements 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 ### Quick Setup 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" ### Clawdbot Usage (REST API) Use curl with the OPENGRAPH_APP_ID environment variable. Base URL: https://opengraph.io/api/1.1/ ### Extract OpenGraph Data (Site/Unfurl) # 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. ### Screenshot a Webpage # 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://..." } ### Scrape HTML Content # 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" ### Extract Specific Elements # 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" ### Query (Ask AI About a Page) 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?"}' ### Image Generation (REST API) Base URL: https://opengraph.io/image-agent/ ### Step 1: Create a Session 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') ### Step 2: Generate an Image 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. ### Step 3: Download the Asset ASSET_ID="" curl -s "https://opengraph.io/image-agent/assets/${ASSET_ID}/file?app_id=${OPENGRAPH_APP_ID}" -o output.png ### Step 4: Iterate (Refine an Image) 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": "", "prompt": "Change the background to blue" }' ### Natural Language Examples 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" ### QR Code Options 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" }' ### MCP Integration (for Claude Desktop, Cursor, etc.) 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. ### More Details 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 ## Trust - Source: tencent - Verification: Indexed source record - Publisher: primeobsession - Version: 1.4.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-06T18:03:26.124Z - Expires at: 2026-05-13T18:03:26.124Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/opengraph-io-skill) - [Send to Agent page](https://openagent3.xyz/skills/opengraph-io-skill/agent) - [JSON manifest](https://openagent3.xyz/skills/opengraph-io-skill/agent.json) - [Markdown brief](https://openagent3.xyz/skills/opengraph-io-skill/agent.md) - [Download page](https://openagent3.xyz/downloads/opengraph-io-skill)