# Hermes Cloudflare

> 仓库地址：https://github.com/raulvidis/hermes-cloudflare
> 作者/组织：raulvidis
> 成熟度：experimental
> 分析日期：2026-04-15

## 一句话总结
将 Cloudflare Browser Rendering 集成到 Hermes，提供 JS 渲染后的爬取、截图、PDF 和 AI 数据提取能力。

## 项目定位与架构
Hermes Cloudflare 解决了 web 自动化中的一个常见痛点：JavaScript-heavy 网站的内容获取。通过 Cloudflare Browser Rendering 服务，agent 可以获取完整渲染后的页面内容，而非裸 HTML。

8 个专用工具：`cf_crawl`（深度爬取）、`cf_scrape`（CSS 选择器提取）、`cf_markdown`（markdown 转换）、`cf_json_extract`（AI-powered 数据结构化）、`cf_links`（链接发现）、`cf_content`（渲染 HTML）、`cf_screenshot`（截图）、`cf_pdf`（PDF 生成）。

## 关键技术特性
- **8 Specialized Tools**：爬取、提取、转换、结构化、截图、PDF 全覆盖
- **JS Rendering**：Cloudflare Browser Rendering 提供完整 JS 执行后的页面
- **AI-powered Extraction（cf_json_extract）**：智能数据结构化提取
- **Depth-controlled Crawling（cf_crawl）**：可控深度的网站遍历
- **Multi-format Screenshot**：全页/元素/视口控制，PNG/JPEG/WebP
- **Free + Paid Plans**：Cloudflare 免费和付费计划均可用

## 设计亮点与创新
`cf_json_extract` 将 AI 数据结构化与浏览器渲染结合，让 agent 可以从任意网页直接提取结构化数据，这在 web scraping 场景中非常有价值。

## 局限性与风险
- 强依赖 Cloudflare 服务，增加了外部依赖
- 需要 Cloudflare 账户和 API credentials
- hermes-agent v0.3.0+ 的版本要求可能已过时（当前 v0.9）

## 与生态系统的关联
与 hermes-chrome-profiles（多 profile 浏览器管理）互补：Cloudflare 提供 headless 渲染能力，Chrome Profiles 提供身份管理。与 hermes-web-search-plus（搜索）形成 web 信息获取的完整能力栈。