mcpField
S
search-intent-coverage

search-intent-coverage

github.com/younesbenallalMarketing & growth143 installsUpdated 2d ago
Repository

About search-intent-coverage

search-intent-coverage is a skill for turning search results or supplied competitor material into a differentiated content outline. It identifies search intent and recurring topics, then organizes a non-overlapping outline with evidence-based additions.

Key features

  1. 01Collect query, market, and audience context
  2. 02Analyze live SERPs or supplied competitor pages
  3. 03Classify dominant search intent
  4. 04Extract recurring topics and proof elements
  5. 05Build a non-overlapping content outline
  6. 06Add evidence-linked differentiators

Use cases

  1. 01Plan an article around a target query
  2. 02Shape content for a specific language and country
  3. 03Use competitor outlines when live SERPs are unavailable
  4. 04Identify useful additions beyond ranking-page patterns

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/younesbenallal/seo-skills --skill search-intent-coverage

After installing, type/search-intent-coveragein Claude Code to confirm it loaded.

Details

From the project README

Search intent coverage (SERP → outline)

You help the user build an outline that matches what Google is ranking and adds differentiated value.

Shared context first

Run the shared preflight in ../docs/credentials-and-tooling.md. Read .seo-context.md when present, reuse its saved market, audience, topic, and competitor context, and ask only for query- or draft-specific gaps.

Inputs to collect

  • Primary query
  • Market (language + country)
  • Intended audience and content type, when they are not clear from context
  • Business goal or desired reader action, when it affects the outline
  • Optional: the user’s current URL/draft

Tooling & credentials

  • Auth mode: none or mcp, depending on the SERP source
  • Requires: live SERP access through a structured provider API, SERP MCP, or browser tool
  • Fallback: use a browser to inspect live results, or analyze user-provided competitor URLs or outlines and label the result competitor-only
  • If no live SERP path is available: use the documented competitor-only branch without claiming current SERP coverage

Live SERP analysis needs a live SERP source. Use structured data from a provider API or MCP when available, and use a browser when it is not. If no live source is available, continue with the documented competitor-only branch when the user provides suitable pages or outlines.

Workflow

  1. Fetch the SERP for the query (top 10), or record that the run is competitor-only and use the supplied pages.
  2. Identify dominant intent type:
    • informational / commercial / transactional / navigational
  3. Extract patterns:
    • repeated H2 topics
    • repeated definitions/FAQs
    • common “proof” elements (examples, templates, calculators)
  4. Build a non-overlapping outline:
    • above-the-fold “answer fast”
    • core explanation
    • decision help (when commercial)
    • pitfalls, FAQs, examples Give each section one job, remove repeated topics, and note any intentional overlap (such as a short answer that expands later).
  5. Add 2–3 differentiated elements (proprietary angle), labeling each as one of:
    • checklist, interactive component idea, original data, teardown, template Prefer three when evidence supports them; return two when a third would be decorative or weak, and explain the omission.

Output

  • “What people want” (1 paragraph)
  • Non-overlapping outline (H1 → H2 → H3)
  • “Differentiators to win” (2–3 bullets, each tied to a gap or evidence point)

Comments

Markdown supported