# Surfer SEO MCP > Surfer SEO connects your AI agent to professional content optimization tools. It lets you run deep SERP audits, check live content scores, and extract high-ranking keyword guidelines—all without leaving your chat window or IDE. Use it to audit a URL with `create_seo_audit` or generate an editor draft using `create_content_editor`. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** serp-analysis, keyword-research, content-optimization, nlp-analysis, search-ranking ## Description **Surfer SEO MCP Server - Audit & Score Content with AI** You don't gotta jump between ten different tabs or copy-paste data back into a spreadsheet just to run an SEO audit. This server lets your agent handle deep content optimization directly inside your chat window or IDE. It treats your LLM like it’s got the full stack of professional tools, letting you run competitor analysis, check live scores, and build structured drafts—all from one place. ### Running Full Site Audits Need to know what's weak with a page? You start by kicking off an audit for any specific URL. Just tell your agent the full address and the target keyword; it runs that job using `create_seo_audit`. This initializes an SEO audit job, scanning the site for structural content gaps and ranking deficits against your specified keyword. Once that initial scan is done, you retrieve the final, detailed breakdown of everything found by calling `get_audit_details`. That gives you the exact metrics on what's missing from the page to improve its ranking potential. To keep track of all the work you do, your agent can show you a list of every single SEO audit run for your domain using `list_seo_audits`. ### Generating Structured Drafts and Scores Want to write something new? You initiate a Content Editor draft. This starts an asynchronous query using `create_content_editor`, letting you specify the target keywords and even the country code for localization. After that initial setup, your agent fetches all the usage guidelines and the full content parameters associated with that specific draft by calling `get_content_editor_details`. Once you have a working draft in place, checking its quality is simple: use `get_content_score` to pull up the current optimization score and see its structural readiness. You can also view all your previous Content Editor sessions—every single writing template you've started—by calling `list_content_editors`. ### Analyzing Competition and SERP Data If you want to know what top-ranking competitors are doing, first run a query using `create_serp_analyzer`. You feed it just the search term, and it maps out the common ranking factors based on how Google sees that search. Once that analysis job is done, your agent pulls those insights for you. It extracts high-value NLP terms—those specific keywords top content uses—with `get_prominent_terms`. If you want to see the raw data set from the competitor results, you can fetch everything by calling `get_serp_results`. ### Managing Your Workflow History Your agent keeps track of it all. You never lose a job or forget which audit you ran last month. To get a comprehensive list of every Content Editor query currently stored in your account's history, use `list_content_editors`. Likewise, to see a definitive record of every SEO audit that’s been performed for your site, just call `list_seo_audits`. This whole setup means you can run full audits, generate structured content drafts with real-time quality checks, and map out competitor search results—all without ever leaving the prompt line. ## Tools ### create_content_editor Starts an asynchronous query to build a new Content Editor draft using specified keywords and country code. ### create_seo_audit Creates an SEO audit job for any live URL, requiring the full address and target keyword. ### create_serp_analyzer Starts a query to identify core ranking factors based on a given search term. ### get_audit_details Retrieves the final, specific details for an SEO audit that was previously run. ### get_content_editor_details Pulls the full content and usage guidelines associated with a Content Editor draft query. ### get_content_score Checks the current optimization score for any active content editor entry, showing its structural quality. ### get_prominent_terms Extracts high-value NLP terms from a completed SERP analysis job, giving you specific keywords to use. ### get_serp_results Fetches the raw search results data generated by the SERP Analyzer for detailed review. ### list_content_editors Shows a list of all Content Editor queries currently stored in your account's history. ### list_seo_audits Displays a comprehensive list of every SEO audit that has been performed for your domain. ## Prompt Examples **Prompt:** ``` Analyze the URL 'example.com/blog' using the live API and report the content score alongside any missing prominent keywords. ``` **Response:** ``` Initiating SEO audit creation ('create_seo_audit') securely... The audit for 'example.com/blog' is processing natively. Retrieving audit details ('get_audit_details')... **Audit Summary Matrix**: - Current Content Score: 62. - Top missing NLP terms: 'content marketing strategy', 'organic traffic rationally', 'semantic search implicitly'. ``` **Prompt:** ``` Launch a SERP Analyzer for 'best CRM software' targeting the US market. ``` **Response:** ``` Commanding NLP engine via `create_serp_analyzer`... Task initiated successfully for 'best CRM software' (United States). The top competitors are currently being mapped. Expect results from `get_serp_results` shortly. ``` **Prompt:** ``` Create a Content Editor draft for the keyword 'how to invest in stocks' with a target score of 75. ``` **Response:** ``` Creating semantic envelope using `create_content_editor`... Success! Your Content Editor is ready. Primary NLP terms to include: 'stock market', 'index funds', 'brokerage account'. Hit `get_content_score` as you iterate to verify the 75 baseline. ``` ## Capabilities ### Run full site audits Creates an SEO audit for a specific URL, identifying structural content gaps and ranking deficits. ### Generate structured drafts Initializes a Content Editor draft based on target keywords, country code, and desired writing parameters. ### Check real-time quality scores Retrieves the current optimization score for any content draft you've started using `get_content_score`. ### Analyze competitor search results Runs a SERP Analyzer to map out common ranking factors and prominent NLP terms used by top competitors. ### Manage content workflows Lists all existing SEO audits (`list_seo_audits`) or Content Editor sessions (`list_content_editors`) in your account. ## Use Cases ### Need a full site audit before publishing? A content writer needs to check if the new landing page is ready. They ask their agent: "Audit this URL and list any missing NLP terms.". The agent runs `create_seo_audit`, waits for processing, then uses `get_audit_details` and `get_prominent_terms` to return a bulleted list of required keywords directly into the draft. ### How do I know if my competitor is beating me on topic coverage? A marketer wants to benchmark against rivals. They prompt: "Run SERP analysis for 'best CRM software' and give me all the prominent topics." The agent executes `create_serp_analyzer`, then calls `get_prominent_terms` to output a structured list of competitive keywords, saving hours of manual research. ### I need to draft content but don't know where to start. A writer starts with the core keyword. They ask their agent to `create_content_editor` for 'how to invest in stocks'. The agent generates a structured outline and immediately uses `get_content_score` so the writer knows if the initial draft is hitting the target quality metric. ### I need to compare two different articles against each other. A specialist wants to check two drafts. They first run an audit on Article A using `create_seo_audit`. Then, they manually paste Article B and ask the agent to run a comparison draft query (`create_content_editor`), allowing them to see which one has higher potential scores via `get_content_score`. ## Benefits - Stop switching tabs. By running `create_seo_audit` and getting results with `get_audit_details`, you keep your entire workflow—from input URL to structural deficit report—inside the chat window. - Drafting doesn't require leaving your agent. Use `create_content_editor` to instantly start a new piece, then validate its quality score using `get_content_score` before writing a single word. - Competitor data is instant. Instead of manually checking Google for keyword gaps, run `create_serp_analyzer` and pull out the exact required terms with `get_prominent_terms`. - Manage history effortlessly. Need to check last week's work? Use `list_seo_audits` or `list_content_editors` to instantly find all previous jobs by name or date. - Focus on writing, not data entry. These tools pull complex metrics (like word counts and Content Scores) so you only see actionable advice. ## How It Works The bottom line is that you tell your agent what SEO problem you have, and it runs the necessary tools sequentially until you get a clean, usable data set back. 1. Append the Surfer SEO MCP module to your integrations panel and submit your private `SURFER_KEY` for secure authentication. 2. Tell your agent what you need. For example: "Run a SERP Analyzer on 'best remote desktop software' targeting the US." The agent calls `create_serp_analyzer`. 3. Once the data is ready, ask the agent to retrieve results. You might use `get_prominent_terms` or `get_serp_results` to pull actionable keywords directly into your workflow. ## Frequently Asked Questions **How do I start the process with Surfer SEO? Do I use `create_seo_audit` first?** Yes, you should run `create_seo_audit` first. This establishes a baseline by scanning your URL and tells you exactly what structural or keyword gaps need filling before you write anything. **What's the difference between `get_serp_results` and `get_prominent_terms`?** `get_serp_results` gives you the raw, comprehensive data set from the top search results. `get_prominent_terms` filters that down for you, providing a clean list of the most critical NLP terms you should focus on. **Can I check my content score multiple times? Which tool do I use?** Yes. You call `get_content_score` every time you make a significant edit to your draft. It gives real-time feedback, confirming if your changes are pushing the score toward the target. **What if I want to check multiple URLs?** You'll need to run `create_seo_audit` for each URL individually and then use `list_seo_audits` later to review all the reports you ran today. **How can I view all previous audits using `list_seo_audits`?** The tool lists every SEO audit run in your connected account. It provides a quick summary of the date, target URL, and status for review. After listing them, you use `get_audit_details` to pull the full results matrix. **If I want to see all my saved Content Editor drafts, which tool should I call?** Use `list_content_editors`. This command returns a list of existing editor IDs. You then pass one of those specific IDs into `get_content_editor_details` to retrieve the full guidelines and content. **What credentials do I need before running `create_seo_audit`?** You must provide a valid API key, specifically your private `SURFER_KEY`. The system uses this credential pair to authenticate the audit request against your live Surfer account. Check the provider dashboard for the required key. **If I need to analyze multiple competitor URLs, what is the proper sequence using `create_serp_analyzer`?** Run `create_serp_analyzer` for each target URL one by one. You must wait for confirmation that the initial task is running before calling `get_serp_results`. This ensures you pull data from the correct, most recent analysis run. **Can the agent natively sequence multiple SERP SEO audits concurrently without degradation?** Yes. Commands natively hook into asynchronous API creations (like `create_content_editor`). Audits sequence seamlessly provided your API quota from Surfer supports the bulk volume. **What does the Content Score represent?** The Content Score is a 0–100 rating generated by Surfer's NLP engine. It measures how well your text covers the prominent terms, word count targets, and structural guidelines extracted from top-ranking pages for your target keyword. **Which Surfer SEO plan is required for API access?** API access is available on the Scale AI and Enterprise plans. You can generate your API key from the Surfer dashboard under your account settings once subscribed to an eligible plan.