跳转到正文
skillsafebeta
← 报告库
用途分类 / 开发辅助

Firecrawl Build Scrape Skill 安全审计

作者说它能做什么（原文）

Integrate Firecrawl `/scrape` into product code for single-page extraction. Use when an app already has a URL and needs markdown, HTML, links, screenshots, metadata, or structured page output. Prefer this skill over broader crawl patterns when the feature is page-level.

第三方安全检查结论

发现安全风险

已检查文件
2
发现的风险
2
会不会运行危险命令？检查是否下载程序后直接运行、让他人远程控制电脑，或藏起要运行的命令。未发现风险
会不会泄露文件和密钥？检查是否发送含密码或密钥的文件，以及代码里是否直接写了密钥。发现 1 项风险
中风险

托管抓取会把完整目标 URL 交给第三方服务

原文依据：3 处
发现了什么

该 Skill 要求托管 Firecrawl 请求使用 API 密钥，并让应用对已有 URL 调用 `/scrape`。若 URL 含签名查询参数、访问令牌、内部标识或其他机密，这些值会随抓取目标提交给 Firecrawl。材料中没有要求先清理或限制 URL。

为什么需要注意

Firecrawl 及其请求日志可能获得原本只应由用户或应用持有的秘密 URL 信息；带令牌的链接可能授予对私有文件或账户资源的访问。

该 Skill 的正常用途是把应用已有的 URL 提交给 `/scrape`；使用托管 Firecrawl 时还需要其 API 密钥。材料没有要求过滤 URL。因此，如果应用传入带签名参数、令牌或内部标识的 URL，这些信息可能被托管服务接收。材料未证明任何数据已经发送，而且可选的自托管地址会改变接收方。用户可要求作者限制允许的域名和协议、移除敏感查询参数，并明确托管服务的数据处理方式。

SKILL.md:11来自说明文档打开原文件
inputs:  - name: FIRECRAWL_API_KEY    description: Firecrawl API key for hosted Firecrawl requests.    required: true  - name: FIRECRAWL_API_URL    description: Optional base URL for self-hosted Firecrawl deployments.    required: falsereferences:
查看另外 2 个位置
SKILL.md:23来自说明文档打开原文件
Use this when the application already has the URL and needs content from one page.
references/freshness-and-liveness.md:34来自说明文档打开原文件
- `cachedAt` — ISO timestamp of the reused copy, present on a `"hit"`.- `sourceURL` — the URL you requested.- `url` — the URL the response came from. Differing values mean the request was  redirected. Equal values are not proof that no redirect occurred, because
会不会删除文件或一直在后台运行？检查是否大范围删除文件、改写磁盘，或设置自动启动。未发现风险
会不会绕过安全保护？检查是否跳过网站安全验证、开放过多文件权限，或取消操作前的确认。未发现风险
会不会误导 AI 或隐藏内容？检查工作说明是否要求 AI 忽略你的指令、干扰检查结果，或夹带看不见的文字。发现 1 项风险
中风险

实现过程被要求信任并遵循运行时获取的外部网页

原文依据：2 处
发现了什么

该 Skill 将多个 Firecrawl 网页称为“Source of Truth”，并要求代理在编写代码前读取它们。这些网页内容未包含在已审计材料中且可在 Skill 发布后变化；如果页面或其交付链被篡改，其中的命令、安装步骤或提示注入可能影响代理生成的代码或操作。

为什么需要注意

在代理把网页文字当成指令执行的环境中，变化或恶意内容可能诱导其安装不必要的软件、执行无关命令、泄露环境信息，或生成扩大权限和数据访问范围的集成。

这是生效中的实现指令：代理必须在编写代码前读取外部 Firecrawl 文档，并将其称为“Source of Truth”。读取官方文档本身是合理的开发行为，但页面不在本次审计材料中且可能变化；如果内容或交付链被篡改，代理可能据此生成不安全代码或执行其中的安装命令。材料未证明页面已被篡改。用户可要求只采用固定版本或已审阅的文档，并禁止未经确认执行网页中的命令、安装包或传送凭据。

SKILL.md:62来自说明文档打开原文件
## Docs (Source of Truth)Read the source-of-truth page for your project language before writing integration code:- **Node / TypeScript**: [docs.firecrawl.dev/agent-source-of-truth/node](https://docs.firecrawl.dev/agent-source-of-truth/node)- **Python**: [docs.firecrawl.dev/agent-source-of-truth/python](https://docs.firecrawl.dev/agent-source-of-truth/python)
查看另外 1 个位置
SKILL.md:67来自说明文档打开原文件
- **Node / TypeScript**: [docs.firecrawl.dev/agent-source-of-truth/node](https://docs.firecrawl.dev/agent-source-of-truth/node)- **Python**: [docs.firecrawl.dev/agent-source-of-truth/python](https://docs.firecrawl.dev/agent-source-of-truth/python)- **Rust**: [docs.firecrawl.dev/agent-source-of-truth/rust](https://docs.firecrawl.dev/agent-source-of-truth/rust)- **Java**: [docs.firecrawl.dev/agent-source-of-truth/java](https://docs.firecrawl.dev/agent-source-of-truth/java)- **Elixir**: [docs.firecrawl.dev/agent-source-of-truth/elixir](https://docs.firecrawl.dev/agent-source-of-truth/elixir)- **cURL / REST**: [docs.firecrawl.dev/agent-source-of-truth/curl](https://docs.firecrawl.dev/agent-source-of-truth/curl)
会不会偷偷改推广链接或收款方？检查是否强制替换推广链接或收款对象，同时要求隐瞒更改。未发现风险

Skill 逻辑拆解

8 个说明模块

该 Skill 的用途是把 Firecrawl 的单页 `/scrape` 接入产品代码，从已知 URL 提取 Markdown、HTML、链接、截图、元数据或结构化内容；它要求托管请求使用 Firecrawl API 密钥。

查看原文
SKILL.md:3来自说明文档打开原文件
name: firecrawl-build-scrapedescription: Integrate Firecrawl `/scrape` into product code for single-page extraction. Use when an app already has a URL and needs markdown, HTML, links, screenshots, metadata, or structured page output. Prefer this skill over broader crawl patterns when the feature is page-level.license: ISC
SKILL.md:11来自说明文档打开原文件
inputs:  - name: FIRECRAWL_API_KEY    description: Firecrawl API key for hosted Firecrawl requests.    required: true  - name: FIRECRAWL_API_URL

它说明 `/scrape` 可能返回近期索引的缓存副本，并建议通过 `maxAge`、`cacheState` 和 `cachedAt` 判断新鲜度；同时明确抓取成功并不证明页面所描述的对象仍然有效。

查看原文
SKILL.md:39来自说明文档打开原文件
- Firecrawl reuses recently indexed content, which is what makes repeat reads of the same URL fast. Set `maxAge` (milliseconds) to bound how old a reused copy may be, or `maxAge: 0` to skip index reuse for a freshness-critical read.- Read `metadata.cacheState` and `metadata.cachedAt` to see what you actually got.- A successful scrape reports what the page returned. Whether the thing the page describes is still active is a source-specific judgment your code makes.- See [references/freshness-and-liveness.md](references/freshness-and-liveness.md) for the tradeoff, the metadata, and the decision rule.
references/freshness-and-liveness.md:42来自说明文档打开原文件
Firecrawl supplies page evidence; your application interprets it in its ownterms. `200` plus non-empty content means the fetch succeeded, not that the itemdescribed by the page is still active — plenty of sites serve a full page for aremoved record.

该 Skill 建议保持集成范围狭窄，并仅在消费者确有需要时请求链接、截图或品牌数据等更丰富的输出。

查看原文
SKILL.md:58来自说明文档打开原文件
- Keep the integration narrow: one feature, one URL, one extraction contract.- Treat `/scrape` as the default primitive for downstream LLM or indexing pipelines.- Request richer formats only when the consumer needs them, such as links, screenshots, or branding data.
从这里开始 · 工作说明SKILL.md
firecrawl-build-scrape
连线表示工作说明包含的模块，不是实际运行顺序。点击模块可查看原文。

文件引用关系图

1 处引用
哪些文件发起引用引用了什么
连线表示真实的文件引用，不是运行顺序。点击节点可高亮相关连线，并查看具体文件和原文位置。虚线表示还有文件需要定位。
文件与检查记录2 个文件

检查范围与遗漏

逐文件查看涉及的内容

下方列出本次涉及的原文范围；纳入检查不代表已查清所有问题。

  • SKILL.md已纳入全文
  • references/freshness-and-liveness.md已纳入全文

这份报告只针对上方版本。我们看了拿到的代码和说明文件，没有实际运行 Skill，也没有检查它另外安装的软件包。因此，这不是“保证安全”的承诺；换了版本或使用环境，结果也可能不同。

  • SKILL.md工作说明
  • references/freshness-and-liveness.md配套文件

代码和说明中提到的操作

连接外部网站
SKILL.md:8来自说明文档打开原文件
  version: "0.1.0"  homepage: https://www.firecrawl.dev  source: https://github.com/firecrawl/skills
SKILL.md:9来自说明文档打开原文件
  homepage: https://www.firecrawl.dev  source: https://github.com/firecrawl/skillsinputs:
SKILL.md:12来自说明文档打开原文件
  - name: FIRECRAWL_API_KEY    description: Firecrawl API key for hosted Firecrawl requests.    required: true
读取密钥或账号配置
SKILL.md:11来自说明文档打开原文件
inputs:  - name: FIRECRAWL_API_KEY    description: Firecrawl API key for hosted Firecrawl requests.
读取了多少行
130
文件校验值（用于核对版本）
ebb09ece6b658265a23cdfc2f119f1baeb92797b357bb3df141198c6364312e0