核心功能
OpenGraph.io 是一款面向开发者和AI Agent的网页数据处理与视觉生成工具集，提供五大核心能力：
1. 网页元数据提取（Site/Unfurl）
- 自动解析任意URL的OpenGraph标签、Twitter Cards、常规meta信息
- 返回标准化结构：
hybridGraph.title、description、image等字段 - 适用于链接预览、内容聚合、SEO分析场景
2. 网页截图（Screenshot）
- 支持多尺寸预设（sm/md/lg/xl）
- 返回可持久化访问的截图URL
- 适用于页面存档、视觉回归测试、内容审核
3. 内容抓取（Scrape/Extract）
/scrape：获取渲染后的完整HTML（支持代理绕过地理限制）/extract：精准提取指定DOM元素（h1/h2/p等），支持CSS选择器- 适用于数据挖掘、竞品监控、内容迁移
4. AI页面查询（Query）
- 对网页内容发起自然语言提问，由AI生成答案
- 付费功能，需订阅计划
5. AI图像生成（Image Agent）
- diagram：技术架构图、流程图（支持Mermaid/Graphviz语法）
- icon：应用图标/Logo（支持透明背景）
- social-card：社交媒体卡片（1200×630标准OG尺寸）
- qr-code：基础功能二维码
- illustration：高端营销视觉（含QR嵌入、3D效果、品牌定制）
- 支持迭代优化、风格预设（GitHub Dark/Vercel/Stripe等）、品牌色配置
显著优点
- 免费层级实用：100次/月网页API调用 + 4次AI图像生成，零信用卡门槛
- 一站式整合：数据提取与视觉生成统一平台，减少多供应商管理成本
- 企业级图像能力：
illustration模式可生成专业营销资产，非简单QR叠加 - 协议友好：支持REST直连、MCP协议（Claude Desktop/Cursor等AI客户端）
- 代理支持：自动处理地理限制和反爬场景
潜在局限
- 付费墙限制：AI页面查询（/query）完全付费；免费图像额度极少（4张/月）
- 无本地执行：纯云服务，依赖网络稳定性和API可用性
- 图像生成流程复杂：需session创建→生成→下载三步，非单API调用
- Mermaid语法需分离：diagram模式下混用描述与代码会导致失败
- 数据隐私：网页内容需上传至OpenGraph.io服务器处理
适合人群
- 需要批量生成社交媒体卡片的营销团队
- 构建链接预览功能的SaaS开发者
- 需要技术图解的文档工程师、架构师
- AI Agent开发者（MCP协议原生支持）
- 快速原型设计阶段的独立开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| API密钥泄露 | `OPENGRAPH_APP_ID`需妥善保管，避免硬编码 |
| 成本失控 | 图像生成消耗快，免费额度耗尽后自动计费（若绑定付费） |
| 内容合规 | 抓取他人网站需遵守robots.txt及当地法律 |
| 图像版权 | AI生成图像的商用授权需确认服务条款更新 |
| 服务依赖 | 截图/抓取功能受目标网站可用性影响（非OpenGraph.io故障） |