---
title: Keyword Research agent
slug: agent-platform/docs/keyword-research-agent
docTags: 
createdAt: 2026-08-12T15:37:11.000Z
---

**Keyword Research** is an agent in Agent Platform. It takes a topic and returns a curated list of keywords to maximize content visibility and search traffic. The agent uses data from Optimizely Content Marketing Platform (CMP) Idea Lab and the broader web.

- **Challenge** – Identifying the most effective keywords to maximize content visibility and search traffic requires extensive research and analysis.
- **Agent outcome** – Researches keywords to maximize content visibility and search traffic rankings.
- **Value** – Improved search engine optimization (SEO), increased visibility, higher rankings.

## Required Optimizely products

Optimizely Content Marketing Platform

## Install agent

:::hint{type="info"}
**Note**

**Mark Administrators**, **Agent Builders**, and users with the **Add, edit, and install specialized agents** attribute for a custom role can add agents to their organization's Mark instance. See [Add users and set permissions.](../../get-started/get-started-with-optimizely-opal-for-administrators.mdx)
:::

### Install from the Directory

Install the agent from the **Directory**.

1. Go to **Directory > Agents**.
2. (Optional) Begin entering *Keyword Research* or use the drop-down list filters to narrow the list.
3. Click **Install** on **Keyword Research** to add it to your Mark instance.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/J4D5CfJfMlQB-rj8BPsql_keyword-research-tile.png" size="100" isUploading="false" width="2402" height="1106" darkWidth="2402" darkHeight="1106" showCaption="false" indent="1"}

If **Install** is disabled, connect Optimizely Content Marketing Platform to your Mark instance.

## Configure skills

**Keyword Research** uses [skills](docId:1HTjxW2J-ZOkYEZMwnasU) about your company, products, target personas, competitors, and existing keywords to tailor its output. Create the following skills before running the agent. Use each sample link as a starting point.

- **Your products and services** – [Sample products and services skill](docId\:vM2HBZeDy26L5KXqz5v1t)
- **Your target personas** – [Sample persona skill](docId:7gQ0NBQMELRL-yLBM6Lv2)
- **Your competitor details** – [Sample competitor skill](docId\:RbVWAa4qI5_oh-72ZiDt-)
- **Your tracked keywords** – [Sample tracked keyword skill](docId\:s7pDedyvd0g7PjAAkneIB)

## Use the agent

In [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM), enter *@keyword\_research* and provide the following details:

- `topic` – Enter the topic or theme to research keywords for.

The agent returns a curated keyword list grouped by funnel stage. The list includes search intent, target personas, search volume, and an analysis of why each keyword was selected.

To use the **Keyword Research** agent in a [workflow agent](docId:2HD0fUsIsfdek516VtN9l), drag and drop it into your workflow. See [Create a workflow agent](docId\:KWaI2TBwD38sN7p74exoy).

## Details

These are the default details for the **Keyword Research** agent. After you [install the agent in your Mark instance](docId:35btzWbo_UrnZLQl_Bv8s), customize these details for your organization's needs. See [Manage agents](docId\:SSeNiblVMXwVvDR_lhtvI) for instructions.

### Input variables

The **Keyword Research** agent takes the following input:

- `topic`

### Tools

The **Keyword Research** agent uses the following tools internally to process your request:

- `get_idealab_keyword_infos`
- `get_idealab_keyword_keyword_questions`
- `get_idealab_keyword_related_keywords`
- `search_web`

### Additional details

The agent uses the following default configuration:

- **Inference level** – Balanced. Provides reliable answers with additional reasoning.
- **Files** – None.
- **Output** – Text.

:::hint{type="info"}
**Note**

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See [Turn generative AI off across Optimizely applications](docId\:X5U0kKD2azV5cIdNqwGNj).
:::