> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 页面 SEO 审计

> 配置一个工作流步骤，审计单个网页的页面内 SEO

当你需要对单个页面做一次技术 SEO 检查时，使用 **页面 SEO 审计**：标题、元描述、标题层级、canonical 链接、状态码、字数、链接、加载时间，以及页面整体的 SEO 得分。该步骤会为你提供的页面返回一个对象。

## 配置

| 选项 | 必填 | 说明 |
| - | - | - |
| 名称 | 否 | 步骤在工作流画布上的标签。 |
| 页面 URL | 是 | 单个页面的完整 URL，以 `https://` 开头。该字段支持通过 **插入变量** 使用工作流变量。 |
| 在浏览器中渲染 | 否 | 开启后，页面会在真实浏览器中加载，从而得到最大内容绘制等页面加载时间。费用略高。默认开启。 |
| 运行 JavaScript | 否 | 开启后，审计前会运行页面的 JavaScript，以便统计由脚本添加的内容。默认开启。 |
| 设备 | 否 | **桌面端** 或 **移动端**。渲染页面所用的屏幕。仅在开启 **在浏览器中渲染** 时生效。默认为 **桌面端**。 |
| 步骤失败时 | 否 | 控制此步骤失败时，工作流应 **终止工作流** 还是 **继续**。 |

在 **搜索步骤...** 的 **研究** 分组中添加此步骤。

没有协议的值（例如 `example.com/pricing`）会被当作 `https://` URL。只能审计网页（`http://` 或 `https://`）。要审计多个页面，请将此步骤放入循环，并把每个页面 URL 传给 **页面 URL**。

## 输出

点击步骤标题中的 **运行** 来测试该步骤。运行完成后，Fetch Hive 会在 **输出** 中显示审计结果。

在后续步骤中使用变量选择器，可以插入该次运行可用的准确输出路径。基础引用为：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

输出是一个对象，包含：

* `url`、`status_code` 和 `onpage_score`（页面整体的页面内 SEO 得分）。
* `title`、`title_length`、`meta_description`、`description_length` 和 `canonical`。
* `headings`：一个对象，包含每个层级的标题列表，例如 `headings.h1` 和 `headings.h2`。
* `word_count`、`internal_links_count`、`external_links_count`、`images_count` 和 `has_images_missing_alt`。
* `page_timing`：包含 `largest_contentful_paint`、`dom_complete` 和 `time_to_interactive` 等加载时间。
* `checks`：页面的一组真/假标记；`issues`：发现的问题检查项列表。

使用得分和第一个标题：

```text theme={null}
{{step_2.output.onpage_score}}
{{step_2.output.headings.h1.0}}
```

此步骤没有 `items` 或 `results` 列表。当页面未提供某些字段，或关闭了 **在浏览器中渲染** 时，部分字段可能为空。

## 示例

在 **搜索步骤...** 的 **研究** 分组中添加 **页面 SEO 审计**。

将 **名称** 设为类似 `定价页审计` 的内容。

在 **页面 URL** 中输入 `https://example.com/pricing`，或插入一个解析为页面 URL 的变量。点击 **运行**，并在 **输出** 中查看结果，然后再在后续步骤中使用其中的字段，例如让一个 **Prompt** 步骤根据 `{{step_2.output.issues}}` 写出最重要的三项修复建议。

## 费用

托管运行会把记录的服务成本加上 6% 服务费换算为任务积分。费用按每个页面计算。开启 **在浏览器中渲染** 或 **运行 JavaScript** 会略微提高服务成本。请参阅 [任务费用](https://docs.fetchhive.com/zh/resources/task-costs.md)。

## 备注

* 如果无法访问该页面，步骤会失败或返回页面给出的状态码，错误信息即为提供方的信息。随后由 **步骤失败时** 决定工作流是停止还是继续。
* 不使用个人模型密钥。此步骤始终作为托管的提供方调用运行。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.