Find searches your competitors rank for and you don't

By

Run SEO Bot's Content Gaps check to list the searches competitor sites rank for that you don't, grouped into the pages or sections to write next.

You know who your competitors are. What you don’t know is which searches send them traffic while your site doesn’t show up at all. That’s a content gap: a topic your audience looks for, that someone else already answers, and that you never wrote about.

You can guess by reading their blogs, but that tells you what they published, not what ranks. A keyword tool can export a competitor’s rankings, and then you’re stuck diffing two spreadsheets with thousands of rows.

SEO Bot has a check called Content Gaps that does the diff for you. It asks DataForSEO which searches each competitor ranks for in Google’s top 20 where your site doesn’t rank, then groups those searches by the competitor page that ranks for them. Each group becomes one page to write, or one section to add to a page you already have.

At the end you’ll have a short list of pages to write, ordered by monthly searches, with a checklist a coding agent can work through.

What you need

SEO Bot runs on macOS 14 or later, on Apple silicon and Intel Macs. After purchasing it, download the app zip from your Polar receipt, unzip it, and move SEO Bot.app into Applications. The receipt also has the MIT-licensed source code of the same version.

Content Gaps needs a DataForSEO account. Add its API login and password in SEO Bot’s Settings, from the data-source card at the bottom of the sidebar. DataForSEO is a separate service that you pay per request. The check makes one DataForSEO request per competitor, which seobot tools puts at about $0.02 to $0.10 each, and each report shows what the run cost.

Google Search Console is optional here. When it’s connected, SEO Bot also checks which of your pages already show up for the missing searches, and that changes its advice from “write a new page” to “add a section”.

The commands use seobot, the command line tool inside the app. Install it with SEO Bot → Install Command Line Tool, which links it into ~/.local/bin. Everything also works from the app’s sidebar.

Before you start, check that DataForSEO is connected:

seobot status
Search Console  not set up
DataForSEO      connected
Plausible       not set up

Set up data sources in the SEO Bot app's Settings. Data: /Users/flavio/Library/Application Support/SEO Bot

The site, competitors and searches in this tutorial are examples. hostingpicker.dev is a fictional hosting comparison site, and deploydeck.dev, staticstack.dev and vpsatlas.dev are made-up competitors.

Add your competitors to the site

Content Gaps compares your site against a list of competitor domains you give it. SEO Bot doesn’t guess who your competitors are, and without the list the check stops before it spends anything. Pick sites that write for the same readers and rank for the searches you want, not only the companies you compete with in business. A big brand that sells the same product can rank for completely different searches than a niche blog that covers your exact topic. The check uses the first 5 domains in the list, so put the ones that matter most first.

Add the site with its competitors in one command:

seobot add https://hostingpicker.dev --competitors "deploydeck.dev, staticstack.dev, vpsatlas.dev"
Added hostingpicker.dev.

If the site is already in SEO Bot, set the list with edit. It changes only the options you pass, and a new --competitors value replaces the old list:

seobot edit hostingpicker.dev --competitors "deploydeck.dev, staticstack.dev, vpsatlas.dev"
Updated hostingpicker.dev.

In the app, the same list lives in the site’s settings, in the Competitors field under Keywords. The footer there says it plainly: “Competitors are for Content Gaps.” To clear the list, pass an empty value, --competitors "".

Pick the Google country and language

Rankings depend on where the search happens. Someone searching “cheap vps” in the UK sees different results than someone in the US, so a competitor can rank for a search in one country and not in another. SEO Bot asks DataForSEO for one market per site: a location and a language. New sites start with the United States and English. If most of your readers are somewhere else, change it before you run the check, or you’ll plan pages for an audience you don’t have.

Look at what the site uses now:

seobot sites --json
[
  {
    "competitors" : [
      "deploydeck.dev",
      "staticstack.dev",
      "vpsatlas.dev"
    ],
    "createdAt" : "2026-11-17T06:16:52Z",
    "hiddenTools" : [

    ],
    "id" : "208B4258-D442-4B89-9C12-902663730FE1",
    "keywords" : [

    ],
    "language" : "en",
    "location" : 2840,
    "name" : "hostingpicker.dev",
    "translationSuggestionsEnabled" : false,
    "url" : "https://hostingpicker.dev/"
  }
]

location is a DataForSEO location code. seobot help add lists a few: 2840 is the United States, 2826 the United Kingdom, 2276 Germany and 2380 Italy. Switch the site to the UK:

seobot edit hostingpicker.dev --location 2826 --language en
Updated hostingpicker.dev.

In the app, it’s the Google in picker and the Language field, right below Competitors. The same market is used by every keyword tool in SEO Bot, so the rank tracker and keyword clustering follow the change too.

Run Content Gaps and read the report

This is the step that costs money, so it’s worth knowing what happens under the hood. For each competitor, SEO Bot sends one request to DataForSEO’s domain intersection endpoint. It asks for searches where the competitor ranks in the top 20 and your site doesn’t rank at all, with at least 10 searches a month, sorted by volume, up to 300 per competitor. Then it merges the lists. A search that two competitors rank for is counted once, and it goes to the competitor page that ranks highest for it. Every competitor page becomes a group, and the groups are sorted by their total monthly searches.

How Content Gaps builds its groupsSEO Bot asks DataForSEO for each competitor's missing searches, merges them, files each search under the best-ranking competitor page, and turns each group into a new page or a new section.YesNoCompetitor list, upto 5One DataForSEOrequest percompetitorSearches they ranktop 20 for and youdon'tMerge duplicatesacross competitorsGroup by thebest-rankingcompetitor pageSearch Console showsone of your pagesfor these searches?Add a section tothat pageWrite a new page

Run the check:

seobot run content-gaps --site hostingpicker.dev

Progress goes to stderr, one line per competitor, like “Comparing with deploydeck.dev (1 of 3)…”. Then it prints the report as Markdown and saves it. I can’t show you a real report here, because it depends on live DataForSEO data, so here’s its shape.

The top line has the market, the time of the run and the DataForSEO cost. The summary reads “Your competitors rank for N searches you don’t, about N searches a month, grouped into N pages or sections to add.” Under Numbers you get four metrics: Missing searches, Searches/month, Pages or sections and Competitors.

The Findings section has one entry per group, up to 40. Each one is titled with the group’s biggest search and shows the competitor URL, the monthly searches, the number of keywords and the difficulty from 0 to 100. Below that it lists up to 12 searches, each with its volume and which competitors rank for it at which position. The report ends with this note:

## About the data

- Each group is the searches one competitor page ranks for in the top 20. Monthly searches and difficulty (0 to 100) come from DataForSEO.

Run seobot run content-gaps --site hostingpicker.dev --json to get the same report as JSON, for a script or an agent.

Example 1: Three competitors on a hosting site. You run Content Gaps on hostingpicker.dev with the three competitors above. Say staticstack.dev ranks #2 for “cloudflare pages vs netlify” and #5 for “netlify bandwidth limit” with the same comparison page, and deploydeck.dev ranks #4 for the first search with another page. Both searches end up in one group led by the staticstack.dev page, because #2 beats #4. The report counts the shared search once, and its note says 2 competitors rank for these searches, so “it’s a topic your audience expects.”

A second run asks DataForSEO again and costs the same. Content Gaps isn’t one of the checks SEO Bot reruns on its own, because it costs money per run, so it only runs when you ask.

Decide between a new page and a new section

A gap doesn’t always mean a missing page. Often you have a page on the topic that just doesn’t cover a part of it, and Google shows it far down for some of the searches. Writing a second page there would split your traffic between two pages. That’s keyword cannibalisation, the problem the cannibalisation tutorial fixes after the fact. When Search Console is connected, Content Gaps avoids it before it happens. It reads the last 90 days of your search data and looks for any of your pages that already shows up for searches in each group.

Connect Search Console in the app’s Settings, then run the check again:

seobot run content-gaps --site hostingpicker.dev

You’ll see one more progress line, “Checking which searches you already show up for…”. In the report, each finding now says either New page or Add a section to followed by one of your paths.

The first note on each finding explains the choice. With a matching page, it says the page “already shows up for” some of the searches, at an average position, and to “Add a section that covers them instead of writing a new page.” Without one, it says to write a new page for the main search that also covers the other searches.

Example 2: The same run with Search Console connected. Your page /netlify-review/ gets impressions for “netlify bandwidth limit” at position 34. DataForSEO’s view says you don’t rank, because position 34 is far outside the top 20 it checks. With Search Console connected, the Netlify group changes from New page to Add a section to /netlify-review/. The task tells you to add a section about the group’s main search and to cover the other searches too.

The second note always names the competitor page and its position, like “staticstack.dev ranks #2 with” its URL, and tells you to read it. Do that. The competitor’s page shows what Google rewards for those searches: the comparison table, the pricing details, the answer in the first paragraph.

Hand the gaps to a coding agent and mark them done

A Content Gaps report reads like a content plan, and turning a plan into pages is work you can delegate. The report opens with a Tasks section, the same checklist SEO Bot gives every tool. Gaps that need a section are filed under the page to edit. New pages have no file yet, so they go under Across the site. Each task names the main search, the monthly volume of the group, up to 8 other searches to cover, and the competitor page to read first. Give the site its source folder first, so the agent works in the right project.

seobot edit hostingpicker.dev --source ~/dev/hostingpicker
Updated hostingpicker.dev.

Then start an agent with the latest report:

seobot prompt latest --site hostingpicker.dev --tool content-gaps --codex

--codex opens a new Codex chat in the site’s folder, and --cursor starts an agent in Cursor’s Agents window. Neither sends the prompt until you do, so you can trim it first. I’d hand over two or three groups at a time instead of all 40. Each one is a page that needs real writing, and you’ll want to review them one by one.

Without a flag, seobot prompt prints the prompt instead, for any other agent. The post on running SEO checks from the terminal covers this handoff for every SEO Bot tool.

When the pages are live, mark the report fixed. --skip takes a finding’s ID or URL, once per group you left alone on purpose, and --note says what you did:

seobot fixed 6ae3b6de --skip https://vpsatlas.dev/kubernetes-hosting/ --note "New page /cloudflare-pages-vs-netlify/ and a bandwidth section on /netlify-review/. Kubernetes hosting skipped: not our readers."

Marking it fixed adds a follow-up to the To Do list. For Content Gaps that’s 8 weeks later, when Google has had time to rank the new pages. If you marked the wrong report, seobot fixed 6ae3b6de --undo clears the mark.

If something looks wrong

  • If the run stops with seobot: Add your DataForSEO login and password in Settings., DataForSEO isn’t connected. Open Settings from the card at the bottom of the sidebar, add the API login and password, and check that seobot status shows DataForSEO connected.
  • If it stops with an error that tells you to add competitors, the site has no competitor list. See Example 3 below.
  • If seobot edit says --location takes a DataForSEO location code, like 2840., you passed a name like uk. Use the number, like 2826.
  • If the summary says “Your competitors don’t rank in the top 20 for anything you’re missing.”, the competitors rank for the same searches you do, or the market is wrong. Check location and language in seobot sites --json, then try competitors closer to your niche.
  • If a sixth competitor never shows up in the report, that’s expected. Content Gaps uses the first 5 domains in the list.
  • If every finding says New page although you have pages on those topics, Search Console isn’t connected or the site has no property. Run seobot status and connect it.
  • If the agent’s prompt doesn’t name your project files, the site has no source folder. Set one with seobot edit hostingpicker.dev --source ~/dev/hostingpicker.
  • If you want to start over, don’t run seobot remove on the site: it removes the site and all its reports. Clear the list with --competitors "" instead.

Example 3: Running the check before adding competitors. You add hostingpicker.dev, connect DataForSEO and run Content Gaps right away. It stops before sending any request, so nothing is billed:

seobot run content-gaps --site hostingpicker.dev
seobot: Add up to 5 competitor domains in the site's settings, or with 'seobot edit hostingpicker.dev --competitors a.com,b.com'.

The fix is the command in the message, with your real competitors. If DataForSEO isn’t connected either, you’ll see the DataForSEO error first, because SEO Bot checks the data source before it reads the competitor list.

For a free check of the searches where you already rank but sit on page one or two, run Quick Wins next. Gaps tell you what to write, and Quick Wins tells you what to improve.

Get SEO Bot

Run 16 SEO checks on your websites and turn each report into concrete work for you, Cursor or Codex. Includes a native Mac app, CLI and full MIT source.

See SEO Bot → · Read the docs · $20. See the app page for tax details, with full source code.

More tutorials for my apps →

Want me to talk about your product? You can sponsor this site.