For the six core workflows, ask for a skill instead of
prompting each step.
Before you start
Four things make every prompt below more reliable.Locations and language
The location you choose, together with the keyword, sets the SERP Surfer analyzes and the language of the guidelines.- Use a location name exactly as Surfer lists it, such as
United States. Surfer does not reject a misspelled location. A Content Editor falls back to United States, and a workspace stores the misspelling, which breaks its SERP work later. - A location with a language suffix, such as
Canada - FRorSwitzerland - DE, uses that language. - A location without a suffix uses Surfer’s default language for that country. For example,
Indiauses Hindi whileIndia - ENuses English, andCanadauses English whileCanada - FRuses French.
https://app.surferseo.com/api/v1/locations or see List supported locations.
Provide sufficient context
Name the workspace and the target keyword in each prompt, or paste a link from the Surfer app. Without either, the assistant has to guess or ask. Your assistant can find a workspace or a Content Editor by name and keyword. That takes extra tool calls, and it can pick the wrong editor when several share a keyword. A link from the Surfer app carries the ids, so the assistant goes straight to the right object.- By name
- By link
The assistant lists your workspaces and Content Editors to find the match. If several editors share the keyword, it asks you which one.
Credits and limits
Each prompt below that spends a credit says so. Credits and limits lists every action that charges and the limits that apply.Ask for retry keys when you create in bulk
Creating a Content Editor, a content template, or a custom voice accepts a retry key (an idempotency key). If a create times out and your assistant retries with the same key, Surfer returns the original result instead of creating and charging for a duplicate. Keys expire after 24 hours. Your assistant does not always send a retry key on its own. When you create several Content Editors in one request, ask for one key per editor:Content creation
Choose how you want the article written.- Write with your assistant
- Write with Surfer AI
- Surfer creates the Content Editor for one Content Editor credit and analyzes the SERP.
- Your assistant reads the guidelines and facts, then writes the draft itself.
- After each revision, it replaces the editor’s content and waits for the recalculated scores.
Optimization
Load an existing page into a Content Editor, see what it is missing, then fix it with your assistant or with Auto-Optimize.- Optimize with your assistant
- Optimize with Auto-Optimize
Surfer creates the Content Editor for one Content Editor credit. Once it has finished analyzing, you get:
- How often each recommended term appears in your draft, next to how often the top-ranking competitors use it, scaled to your draft’s length.
- The AI Search score, the facts your draft already covers, and the facts it lacks. Each fact carries its source URL and where that URL was found: the SERP, Google AI Overviews and AI Mode, Gemini, OpenAI, or Perplexity.
- Whether the introduction sets expectations, names the audience, explains why the topic matters, and answers the main question up front.
AI Tracker
These prompts need an AI Tracker project in the workspace; your assistant lists the projects to find it. What every read shares:- Refresh: reports refresh once a day.
- Window: choose a supported report period. The assistant can tell you which dates have reports.
- Model families: Google AI Mode, Google AI Overviews, OpenAI, Perplexity, or Gemini. The summary covers every family at once; the other reads cover one family or all of them combined.
- Surfer returns cited source URLs, each flagged by whether the page mentions your brand.
- Your assistant opens each candidate page and quotes where it mentions the competitor.
- It drafts the email in the chat or with your other connected tools.
Recommendations
Surfer recommends existing pages to optimize, content ideas to write, and pages where your brand can earn a mention in AI answers. Each list is sorted by score, highest first.- Optimize existing pages
- Write new content
- Earn mentions
Pages to optimize come from Content Audit. Each carries its URL, its keyword, and the keyword’s average Google position over the last 30 days next to the 30 days before.For each page that has not been started, Surfer opens the page’s own Content Editor. That is the same action as the Optimize button in the app.
- It costs one Content Editor credit, unless that editor was already paid for.
- You get each editor’s SEO Guidelines: structure targets, competitors, recommended terms, and topics.
Workspace management
Create a workspace, then set its brand knowledge, templates, and voices. Locations and language explains how the location sets the language. Creating a workspace needs:- An organization owner or admin.
- A name.
- The site URL.
- A location.
- Setup runs in the background and your assistant checks the workspace until it is ready for activation.
- Your assistant activates the workspace, making it available for brand reads and content work.
- You get the generated brand knowledge to review. Brand analysis is skipped on plans without brand knowledge.
Reporting
These prompts only read: Content Editor lists, content scores, recommendations, AI Tracker reports, and Search Console data. None of them consumes a credit. Surfer does not schedule reports; if your client can run a saved prompt on a schedule, these are the prompts to schedule. You get every Content Editor created since the date you name in the workspaces you belong to, each with:- Its main keyword.
- Its state: scheduled, executing, completed, or failed.
- Its SEO, AI Search, and total scores.
- Pages to optimize carry their average position over the last 30 days and the 30 days before, so position drops stand out.
- Ideas to write carry search volume and difficulty.
- You get a daily trend per AI model family, one family at a time, over a 90 day window.
- The mention gap reports, per competitor, how many cited webpages mention them and how many mention both brands.
Tips
- Name the workspace when you have more than one, or keep a standing instruction in your client about which workspace to use. Otherwise the assistant lists your workspaces and asks.
- Choose which outline you want to review. The SERP outline is available after editor analysis. Reviewing an AI Article outline requires starting generation first, so on plans with separate AI Article credits the credit is already reserved before approval.
- Chain with your CMS’s own MCP server. Your assistant reads the finished document as Markdown or HTML and hands it to the CMS server to publish in the same conversation. No Surfer tool publishes anywhere.