# OpenSEO

> Let Marketing research keywords, competitors, backlinks and rankings in OpenSEO with your own key. Starting a rank tracker or a site audit waits for your Approve.

OpenSEO is an open source SEO tool, an open alternative to the big paid suites. It looks up keywords, competitors, backlinks and search results, tracks your rankings, audits a site and reads your Search Console and Analytics data. Once you connect it with your own key, Marketing can do that research and bring the numbers into its plans and reports.

## Which assistants use it

- [Marketing](/docs/personas/marketing)

## What assistants can do

OpenSEO connects through the tool's own hosted connector, on your own key.

| Ability | How it runs |
| --- | --- |
| Research keywords, competitors, backlinks and rankings | Reads on its own |
| Read local search, business profiles and reviews | Reads on its own |
| Read Search Console, Analytics, site audits and rank trackers | Reads on its own |
| Read saved keywords, projects and reports | Reads on its own |
| Save keywords and reports, and change a project's context | Runs on its own when you asked for it |
| Start a rank tracker or a site audit | Waits for your Approve |
| Delete keywords, reports or an audit | Waits for your Approve |
| Share a report with a public link | Waits for your Approve |
| Tell search engines about changed pages | Waits for your Approve |
| Change which Google site or property a project uses | Never run from chat |

Saving, creating and changing are offered to Marketing when it works on a task you gave it on stellarfirm.ai. The Approve for a rank tracker or an audit says what it will check and that it bills your own data account, and for a tracker how often it repeats.

## Setup

1. In OpenSEO, open the settings for the MCP connection and create a key.
2. In OpenSEO, set up your DataForSEO key. OpenSEO uses it for its lookups, and DataForSEO bills that usage to you.
3. Open [Integrations](https://stellarfirm.ai/app/integrations) in StellarFirm and pick OpenSEO.
4. Paste the key, switch on the live option, and press Connect.

## Permissions

- Lookups run on their own and draw on your own DataForSEO usage. They are not StellarFirm credits and they only read, so they do not wait for an Approve.
- A rank tracker, extra tracked keywords, a tracker run, a site audit and an AI visibility check can bill your account again every day or week, so each one waits for your Approve, and Marketing shows you an estimate first.
- Deleting, a public report link and telling search engines about pages wait for your Approve too.
- Revoke the key in OpenSEO whenever you want to cut access.

## Good to know

- Every volume, difficulty, ranking and backlink count comes from OpenSEO, with the date and country it covers. Marketing never invents a number.
- Marketing starts with small sets of keywords, because each lookup draws on your usage.
- Your key stays with your account. StellarFirm does not provide one for you.
- Only the hosted OpenSEO address is supported for now.

## Prompts to try

```prompt title="Find easy wins"
Marketing, list my OpenSEO projects, then pull the top 20 keywords our site ranks for with their search volume and position, and tell me which three pages are closest to page one, with the date of the data.
```

```prompt title="Compare with a competitor"
Marketing, compare [our domain] with [competitor domain] in OpenSEO: their strongest keywords we do not rank for, grouped by topic, with volume and difficulty and the date of the data.
```

```prompt title="Plan a rank tracker"
Marketing, get the estimate from OpenSEO for a weekly rank tracker for [domain] with these 15 keywords and show it to me. Do not start it until I approve.
```

---

Source: https://stellarfirm.ai/docs/integrations/openseo
