SEO

Turn search demand into a content plan

Find content gaps and plan what to write next from Search Console data: group the queries the site already gets impressions for into topic clusters, map each cluster to the page that serves it, and surface clusters with real demand but no dedicated page.

The playbook

The best content plan comes from queries Google is already testing the site against. Every impression is Google saying "this site might be relevant here". Clusters of those impressions that no page is built for are the gaps worth writing to, and they come with proof of demand attached.

Steps

  1. Pull the query inventory. google_search_console.query with dimensions: ["query", "page"], a 90-day window ending 3 days ago, rowLimit: 5000. Strip branded queries. Keep rows with at least 30 impressions and state the floor.

  2. Cluster the queries. Group by shared head term and intent. Do this in sequel_workbench or by inspection; either way, state the method. Label each cluster with a representative query and an intent: informational, commercial investigation, transactional, or navigational.

  3. Score each cluster. Total impressions, total clicks, impression-weighted average position, the distinct pages that received impressions for it, and which single page received the most.

  4. Classify the clusters.

    • Gap: meaningful impressions, average position above 20, impressions spread thinly across pages that were not written for the topic. No page serves this; a dedicated one probably would.
    • Cannibalised: several pages each receiving a solid share. Continue with keyword-cannibalization-check rather than adding another page.
    • Under-clicked: one page, good position, low CTR. Continue with ctr-underperformers.
    • Served: one page, position under 10. Leave it alone.
  5. Size the top gaps (if Ahrefs is connected). Pass the representative queries of the top gap clusters to ahrefs.keywords_overview for volume, difficulty and CPC. Drop gaps whose difficulty is far above what the site already ranks for. High CPC marks commercial intent.

  6. Report. A cluster table (cluster, intent, impressions, clicks, position, serving page, classification), then briefs for the top five gaps: working title, the queries to target, the intent to satisfy, and which existing page should link to the new one. Explicitly list the clusters you are recommending nothing for.

Gotchas

  • Plan clusters, not keywords. One page per cluster. A page per query is how cannibalization starts.
  • Do not build a page for a cluster an existing page already serves at position under 10. Improve that page instead; a new one splits the signal.
  • Search Console omits the anonymised long tail. The inventory is a sample of demand, not all of it. Clusters are more robust to this than individual queries, which is another reason to cluster.
  • Ahrefs numbers are estimates. Use them to rank gaps against each other, not as a forecast of traffic.
  • Intent decides the format. An informational cluster wants a guide; a commercial one wants a comparison; a transactional one wants a product or landing page. Say which in each brief.

Sequel CLI

Install Sequel skills into your agent

One command connects your agent to Sequel and installs the Sequel skill, so it knows this playbook exists and reads it when a question matches. The CLI signs you in, provisions a scoped API key and writes the config for you.

Already have an MCP client?

https://api.sequel.sh/mcp

Point it at this URL and sign in when prompted, or send an API key from Settings as a Bearer token. Skills come with it; nothing else to install. Manual setup per client

  1. 1

    Install the Sequel CLI

    One line installs the latest CLI with whatever package manager you have.

    curl -fsSL https://sequel.sh/install | sh
  2. 2

    Sign in

    Authenticate in your browser and pick an organization.

    sequel login
  3. 3

    Install into your agent

    Writes the MCP config and installs the Sequel skill file for agents that support skills. Pick an agent from the list, or target one directly by its slug.

    sequel install
    • Claude Code
      sequel install claude-code
    • Claude
      sequel install claude
    • Cursor
      sequel install cursor
    • VS Code
      sequel install vscode
    • Windsurf
      sequel install windsurf
    • Zed
      sequel install zed
    • Codex
      sequel install codex
    • OpenClaw
      sequel install openclaw
    • Hermes
      sequel install hermes

More like this

Other SEO skills

Analyze high-ranking landing pages

See which pages perform best in organic search: the landing pages that earn the most clicks and impressions, the queries behind each one, and how they compare with competitor estimates from Ahrefs.

Audit internal links to important pages

Audit the site's own internal linking: crawl navigation and body links between the site's pages to find valuable pages with too few inbound internal links, orphan pages, and the handful of cross-links that would lift striking-distance rankings.

Audit or draft an llms.txt

Check whether the site has an llms.txt, whether it follows the spec and points at the pages that matter, and if it is missing draft one from the pages Search Console shows people actually find, so AI assistants get a curated map of the site instead of guessing.

Audit redirect chains and loops

Follow every redirect on the URLs Search Console still sends traffic to, on the sitemap, and on backlinked pages, to find chains, loops, redirects to the homepage, and temporary redirects that should be permanent, so link equity and crawl budget stop leaking.

Audit referring domain quality

Grade the domains linking to a site by authority, traffic and link count, spot concentration risk and link-farm patterns, and separate the referring domains that carry weight from the ones that are noise.

Audit titles and meta descriptions

Compare the title and meta description of each top page against the queries it actually ranks for in Search Console, and find missing, duplicate, truncated or misaligned metadata on the pages where a rewrite would earn the most clicks.

Put this playbook to work

Connect a source, ask the question, and the agent follows these steps. Free to start.