every-app/seo-party-skills

Keyword gap analysis

Compare the keywords a site ranks for against a few competitors and list the ones the competitors rank for and the site doesn't. Needs the OpenSEO MCP server connected (https://openseo.so).

Inputs

• The user's site. If an OpenSEO project already exists for it, use that project; call list_projects to find its projectId.
• Two or three competitor domains. If the user has none, ask for them, or offer to find them with find_serp_competitors on five to ten of the site's main keywords.

Steps

1. The site's keywords. Call get_ranked_keywords with target set to the user's domain, maxRank: 100 and limit: 100. Keep the keyword list.
2. Each competitor's keywords. Call get_ranked_keywords for each competitor with maxRank: 20, minSearchVolume: 50 and limit: 100. Top-20 rankings show what the competitor is actually winning.
3. Find the gaps. A keyword is a gap when a competitor ranks for it in the top 20 and the user's site doesn't rank in the top 100. Match keywords case-insensitively. Drop branded terms for the competitor (its name or product names).
4. Rank the gaps. Put keywords more than one competitor ranks for first, then sort by search volume. Note the search intent from the rows; informational gaps usually mean a missing article, commercial or transactional gaps a missing product or landing page.
5. Group them. Put gaps that would be answered by the same page together, and name the page each group needs.

Output

A short report:

• One line per competitor: how many keywords it ranks for in the top 20, and how many of those are gaps.
• A table of the top 20 gaps: keyword, monthly searches, intent, which competitors rank and at what position, and the competitor URL that ranks.
• Three to five page ideas, each covering one group of gaps, best opportunity first.

Then offer to save the top gaps to the project with save_keywords, tagged keyword-gap. Ask before saving or tagging.

Notes

• Each get_ranked_keywords call uses OpenSEO credits. Three competitors plus the site is four calls. Tell the user before going past ten calls.
• Ranking data is an estimate for one market. Use the project's default market unless the user names another country.