surferseo/surfer
Track AI search visibility, write end-to-end articles, optimize existing content, and act on data-backed recommendations with one command.
Use when Surfer MCP tools are unavailable or the user asks to connect, install, or set up Surfer in their AI assistant. Triggers include "connect the Surfer MCP server", "add Surfer to this client", "install Surfer MCP", and "how do I sign in to Surfer". It follows the current client setup guide, verifies the connection, and returns to the interrupted surfer-* workflow.
Use when the user wants to act on Surfer's site recommendations. Triggers include "what should I optimize next", "turn my Surfer recommendations into articles", "find a content opportunity and act on it", and "run the write or optimize workflow from my workspace". It selects recommendation-led Optimize or Write work and delegates drafting and optimization to the focused Surfer skills.
Use when the user wants a writer-ready content brief grounded in Surfer's SEO and AI Search guidance. Triggers include "make a content brief", "brief a writer for this keyword", "what should an article cover", and "give me an SEO and AI Search brief". Also use it for SERP or competitor research with no draft, such as "analyze the SERP for this keyword" or "what do the top-ranking pages cover". It reports the SERP-derived competitors, structure, terms, and questions without writing anything. It creates or reuses a manual Content Editor and assembles its outline, SEO guidelines, and source-attributed AI Search facts into a concise brief. For an outline alone, use surfer-create-outline. For an article draft, use surfer-write-article.
Use when the user wants a Surfer-derived, SERP-informed article outline without a full draft. Triggers include "create an outline for X", "plan headings for this keyword", "make a Surfer outline", and "outline an article before writing". It creates or reuses a Content Editor in manual-writing mode, returns its SEO-oriented outline, and can verify the requested brand, template, instructions, and competitor choices. For a writer-ready plan that also includes AI Search facts, or for SERP or competitor research with no deliverable, use surfer-create-content-brief. For a complete AI-written draft, use surfer-write-article.
Use when the user wants to create, inspect, update, choose, or delete a reusable Surfer content template. Triggers include "create a custom template", "turn this article into a Surfer template", "list our templates", "set a default template", and "update or delete a content template". For a writing style or tone profile, use custom voices. For one article's direction, use the custom instructions in surfer-write-article.
Use when the user has existing content, a URL or a draft, and wants to improve its Surfer SEO Score, AI Search Score, or both. Triggers include "optimize my article", "improve this page's content score", "auto-optimize this", "make this rank better", "optimize for SEO and AI search", and "improve my AI or LLM visibility". For writing a new article from scratch, use surfer-write-article instead.
Use when the user wants Surfer to produce a brand-new article or blog post from a keyword or topic. Triggers include "write an SEO article about X", "draft optimized content for this keyword", "generate a Surfer AI article", and "write for SEO and AI Search". To improve content that already exists, use surfer-optimize-content. For a writer brief without a draft, use surfer-create-content-brief.