> For the complete documentation index, see [llms.txt](https://docs.frase.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.frase.io/feature-reference/content-opportunities.md).

# Content Opportunities

Choose what to write next based on your site's existing content, performance, and competitor data, either one topic at a time or by planning several at once

<figure><img src="https://2279611032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1qovufZAMEOFfdX3BMUE%2Fuploads%2FWTqkPhYpI9zTaxh9f2Zd%2Fimage.png?alt=media&amp;token=42103509-ebe0-4751-ba80-982a9b294863" alt=""><figcaption></figcaption></figure>

Find **Opportunities** in the sidebar, in the **Plan & Create** group.

You can either claim a topic from the list and Frase writes it for you now, or pick several and add them to your content plan via [**Content Calendar**](/automations/content-calendar.md)**.**

{% hint style="success" %}
Ask the [Frase Agent](/automations/meet-the-frase-agent.md) *"What should I create next?"* In Claude with [Frase MCP](https://claude.ai/customize/connectors/directory/frase) connected, or ask for your top opportunities and have Frase turn one into a brief.&#x20;
{% endhint %}

## How It Works

Opportunities pulls from several data sources, scores every idea on impact and effort, and checks each against what your site already covers.&#x20;

### What's Analyzed

* [**Google Search Console**](https://docs.frase.io/integrations/connectors/google-search-console) *(if connected)*\
  Ranking opportunities and **Content Decay** grounded in your search performance.
* **Competitor Gaps** *(from your* [*Brand Hub* ](/feature-reference/brand-hub.md)*list)*\
  Topics your confirmed competitors cover where your ownership is weaker.
* **CMS Updates** *(if a* [*CMS*](/integrations/cms-publishing/frase-cms.md) *is connected)*\
  Recommendations tied to pages already published on your connected CMS.
* **Programmatic SEO** *(important if your site is multi-location)*\
  Pattern-based templates (comparisons, location pages, integrations) that can scale into multiple pages. Set these up from the **Geolocation Settings** button in the toolbar.
* **Visitor Questions** *(if you use* [*Frase Answers*](/feature-reference/frase-answers.md)*)*\
  Gaps pulled from real questions your Answers widget couldn't answer well to feed your content loop.
* And more!

{% hint style="warning" %}
**Frase only surfaces gaps from&#x20;*****confirmed*****&#x20;competitors**. If a competitor you care about isn't showing up, check **Brand Hub → Competitors**, then re-scan.
{% endhint %}

Start at the top, or use the Filters on the top right to drill deeper by impact, type, source, and more.&#x20;

You can also dismiss (**"Abandon"**) opportunities you'd like to skip.

<figure><img src="https://2279611032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1qovufZAMEOFfdX3BMUE%2Fuploads%2FEIF1FyhE4DFB4TlVkyoB%2Fimage.png?alt=media&amp;token=a5e49c0f-26c3-4bd5-9b7a-3c01e2e6504d" alt=""><figcaption></figcaption></figure>

### How Clusters Fit

Opportunities reads the [topic clusters ](/core-workflows/content-clusters.md)you're building on your site's Cluster map. Here's an example:&#x20;

<figure><img src="https://2279611032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1qovufZAMEOFfdX3BMUE%2Fuploads%2FKT2r08ZaKmo9HIPhCuJM%2Fimage.png?alt=media&amp;token=25aaafcd-a7da-4825-91a1-e9d6d323d656" alt=""><figcaption></figcaption></figure>

A topic that Frase matches to a cluster with high confidence pulls into Opportunities, so you can keep building strategically.&#x20;

A topic that doesn't fit what you're building will not show on your list.&#x20;

{% hint style="success" %}
Opportunities skips topics your brand has chosen to avoid. Manage these under [**Brand Hub** ](/feature-reference/brand-hub.md)→ *Never* Terms with the *Excluded topic* category.
{% endhint %}

## Using Opportunities

Opportunities has three tabs: **All**, **Recommended**, and **Clusters**.&#x20;

* **All** shows all your site's content by cluster for a full picture of what's covered, what's missing, and what needs a rewrite.&#x20;
* **Recommended** is your action center. Start at the top, or use the **Filters** on the right to narrow the list by impact, type, source, and more.&#x20;
* **Clusters** is your high-level view of the topic pillars you're creating, and any pieces waiting for assignment.&#x20;

{% hint style="success" %}
**Scans run once per site every 24 hours.** Use the **Re-scan icon** as needed to check for new opportunities.&#x20;
{% endhint %}

### Act on an Opportunity

Every opportunity has a recommendation you can either act on in the moment, or click **Skip for now** to return to later.&#x20;

Here are a few actions you may see:

<details>

<summary>Create Content</summary>

**For a topic you don't cover yet.** Frase starts researching and writing in the background right away, updating you when the brief and content draft is ready for your review.&#x20;

</details>

<details>

<summary>Update, Refresh, Expand, or Fix This Post</summary>

**For a page you already own.** Frase opens the existing article in the editor, importing it from your [CMS](https://docs.frase.io/integrations) first if it isn't in Frase yet, so you can refresh it with the opportunity's keywords in hand.

</details>

<details>

<summary>Generate Pages</summary>

**For a programmatic template.** Frase generates the full batch of pages from one shared research pass.

</details>

{% hint style="info" %}
Skipping a topic takes it off your list, and Frase treats that as a signal the next time it scans. These will show with an "**Abandoned**" status and can be restored if needed.&#x20;
{% endhint %}

### Add Several to Your Plan

When you'd rather schedule a batch than write one piece at a time, click **Plan**. This is how Opportunities feeds your [Content Calendar.](/automations/content-calendar.md)

<div align="left"><figure><img src="https://2279611032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1qovufZAMEOFfdX3BMUE%2Fuploads%2FVDVjUCkXBsymfG05h8yq%2Fimage.png?alt=media&amp;token=aef3a61d-78bb-42cb-81dc-b1276571debc" alt=""><figcaption></figcaption></figure></div>

Planning is for **new-topic opportunities** (the ones with the recommended action **Create Content**). Programmatic templates, decay alerts, and visitor questions can't be added to the plan by design.

**You can add up to 50 pieces at a time.** Here's how:

{% stepper %}
{% step %}

#### Select your topics

Tick the checkbox on each topic you want, or click **Plan several** to open the selection bar right away.
{% endstep %}

{% step %}

#### Add them to your plan

Choose **Add to plan**. (You can also **Compare** up to 5 selected topics side by side.)
{% endstep %}

{% step %}

#### Space them out

Pick how to space them out:

* **Spread evenly** places them at your site's publishing rate (2 per week unless you've set another), starting from the date you choose. You can change the rate in the sheet, from 1 to 7 per week.
* **All at once** puts every piece on the same day.
* **Pick dates** lets you set each date by hand.
  {% endstep %}

{% step %}

#### Confirm the plan

Remove any piece you've changed your mind about, then confirm with **Add to plan**.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Frase writes each piece on the scheduled date and takes it as far as your** [**Automation** ](/automations/automations.md)***Auto-Publishing*****&#x20;settings allow.** Your content will either land with a status of *Draft*, *Review*, or *Published* based on your setup.&#x20;
{% endhint %}

For more details on scheduling and publishing content, see [**Content Calendar.**](/automations/content-calendar.md)

## Best Practices

To get the most out of Opportunities:

1. **Confirm your competitors in Brand Hub** and **build at least one cluster first**, so the ranking has something to work from.
2. **Claim a topic** when you want it written today. **Add to plan** when you want a steady cadence.
3. **Check regularly for pages you already own that need a refresh.** Refreshing a decaying page is usually faster than starting over.
4. **Re-scan after major changes** (you change competitors, clusters, excluded topics, etc).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.frase.io/feature-reference/content-opportunities.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.