Keyword Research agent
Keyword Research is an agent in Mark (Optimizely 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
The Keyword Research agent requires Optimizely Content Marketing Platform.
Install agent
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.
Install from the Directory
Install the agent from the Directory.
- Go to Directory > Agents.
- (Optional) Enter Keyword Research or use the drop-down list filters to narrow the list.
- Click Install on Keyword Research to add it to your Mark instance.

If Install is disabled, connect Optimizely Content Marketing Platform to your Mark instance.
Configure skills
Keyword Research uses skills 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
- Your target personas – Sample persona skill
- Your competitor details – Sample competitor skill
- Your tracked keywords – Sample tracked keyword skill
Use the agent
In Mark chat, 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, add it to your workflow. See Create a workflow agent.
Default agent details
These are the default details for the Keyword Research agent. After you install the agent in your Mark instance, customize these details for your organization's needs. See Manage agents 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
Default configuration
The agent uses the following default configuration:
- Inference level – Balanced, which provides reliable answers with additional reasoning.
- Files – None.
- Output – Text.
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.