> ## 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.

# AI 关键词数据搜索

> 配置一个工作流步骤，返回关键词的 AI 搜索量和 12 个月趋势数据

# AI 关键词数据搜索

当你希望工作流步骤查询一个或多个关键词的 AI 搜索量（含 12 个月趋势），并将这些数据传递给后续步骤时，使用 **AI Keyword Data Search**。

## 配置

| 选项                  | 必填 | 说明                                                                                |
| ------------------- | -- | --------------------------------------------------------------------------------- |
| Name                | 否  | 工作流画布上的步骤标签。                                                                      |
| Keywords            | 是  | 每行一个关键词，或用逗号分隔。最多 1000 个关键词，每个不超过 250 个字符。此字段支持通过 **Insert Variable** 使用工作流变量。    |
| Language            | 否  | **Language** 中的语言值。可从列表中选择或启用 **Custom Value**。                                   |
| Location            | 否  | **Location** 中的数字位置代码（例如 `2840`）。可从列表中选择，或启用 **Custom Value** 并填写数字代码或解析为数字代码的变量。 |
| When the step fails | 否  | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。                              |

从 **Search steps...** 的 **Research** 分组中添加此步骤。

关键词字段支持 **Insert Variable**。**Language** 和 **Location** 控件可以使用内置列表，也可以切换为 **Custom Value**。

## 输出

点击步骤标题中的 **Run** 进行测试。运行完成后，Fetch Hive 会在 **Output** 中显示关键词搜索量结果。

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

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

输出包含 `items_count` 和 `items` 数组。每项包括关键词、当前 AI 搜索量，以及 12 个月的 `ai_monthly_searches` 趋势。要使用第一个关键词的搜索量：

```text theme={null}
{{step_2.output.items[0].ai_search_volume}}
```

测试运行后，使用变量选择器检查 `ai_monthly_searches` 等嵌套字段。

## 示例

从 **Search steps...** 的 **Research** 分组中添加 **AI Keyword Data Search**。

将 **Name** 设为类似 `关键词搜索量` 的名称。

在 **Keywords** 中输入一个或多个关键词，每行一个或用逗号分隔。如果列表应复用先前步骤的数据，点击 **Insert Variable** 并添加该引用。

选择 **Language** 和 **Location**，然后点击 **Run**，在 **Output** 中查看返回的搜索量，再在后续步骤中使用。

## 说明

* 单次运行最多可发送 1000 个关键词。每个关键词最多 250 个字符。
* 此步骤会返回所提交关键词的完整结果集，没有分页。
* 托管运行会将记录的服务费用加上 6% 服务费转换为任务积分。请参阅 [任务费用](../../../resources/task-costs)。

另请参阅：[创建和编辑](../../creating-and-editing)、[测试与迭代](../../testing-and-iteration) 和 [错误处理](../../error-handling)