# SpyFu MCP > SpyFu gives your AI agent deep access to SEO and PPC data. You can analyze a domain's estimated traffic, check competitor ad copy history, find high-value keywords, or map out who owns the search results for any industry. It turns complex market research into simple commands from Claude, Cursor, or any MCP client. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** seo-analysis, ppc-research, competitor-analysis, keyword-tracking, marketing-intelligence ## Description You connect your AI agent to the SpyFu MCP Server. This gives you deep access to SEO and PPC data, letting you run serious competitive analysis right through Claude, Cursor, or whatever client you're using. You don't just guess what works; you check the real numbers. When you need to assess a site's overall standing in the market, use the `get_domain_overview` tool. This pulls high-level metrics for any website you throw at it, giving you an instant read on its health. You'll get estimates for total organic traffic and even rough ideas about their paid ad budgets—it’s a quick way to gauge if they’re playing in the major leagues or just scratching out a living. It tells you what kind of market gravity that domain has. Need to drill down on specific search terms? Use `get_keyword_stats`. You feed it any keyword, and it hands back hard data: the estimated monthly volume for that term, the difficulty score (so you know how tough it'll be to rank), and the expected cost per click (CPC). This helps you decide if a keyword is worth your time or if you should skip it entirely. It’s the litmus test for any paid campaign. If you gotta understand who owns the market, start with `get_domain_competitors`. You plug in your domain name, and this tool identifies all its major players—both the ones ranking high naturally through organic search and the ones running aggressive paid ads. It maps out every angle of the competition so you know exactly where the gaps are. When it comes to understanding how competitors run their ad campaigns, `get_ad_history` is what you want. You specify a competitor, and this tool retrieves their actual historical Google Ads copy along with its performance data. You can see what they ran before, how well it performed, and figure out how to fine-tune your own PPC approach so you don't repeat their mistakes. It’s pure intel. You can also list exactly where a domain ranks naturally using `get_organic_keywords`. This tool generates a specific, actionable list of keywords that the site already owns in search results. You get to see which terms they are banking on without running paid ads for them. By combining these tools, you're not just looking at data; you’re building a full picture of market dominance. You check out the big picture with `get_domain_overview`, then pinpoint exact keywords using `get_keyword_stats` and `get_organic_keywords`. After that, you map the entire playing field with `get_domain_competitors` to see who's fighting for what. Finally, you dive deep into their tactics by reviewing their past ad copy via `get_ad_history`. It’s a complete workflow that turns complex market research into simple commands from your AI client. ## Tools ### get_ad_history Retrieves the historical Google Ads copy and performance for a specified competitor. ### get_domain_competitors Identifies all top organic and paid competitors for any given domain name. ### get_domain_overview Pulls high-level SEO and PPC metrics, like estimated traffic and ad budgets, for a domain. ### get_keyword_stats Gathers specific data (volume, difficulty, CPC) for any target keyword you provide. ### get_organic_keywords Lists the exact keywords where a domain currently ranks naturally in search results. ## Prompt Examples **Prompt:** ``` Get a domain overview for spyfu.com to see their SEO and PPC metrics. ``` **Response:** ``` I've retrieved the overview for spyfu.com. They have an estimated monthly organic traffic of 450k visits and a paid budget of approximately $12k/month, ranking for over 80k organic keywords. ``` **Prompt:** ``` What are the keyword stats for 'AI marketing tools' in the US? ``` **Response:** ``` For 'AI marketing tools', the search volume is 12,100 per month with an SEO difficulty of 74/100. The estimated CPC is $4.50. ``` **Prompt:** ``` List the top 10 organic keywords for example.com. ``` **Response:** ``` Here are the top organic keywords for example.com: 1. 'domain examples' (Pos: 1), 2. 'example website' (Pos: 1), 3. 'test domain' (Pos: 2)... [full list provided]. ``` ## Capabilities ### Assess Domain Health You pull high-level metrics—like estimated monthly traffic and ad budgets—for any target website. ### Check Keyword Viability You get hard data on specific search terms, including their volume, difficulty score, and cost per click. ### Map the Competition You identify all major organic and paid competitors for a given domain to understand market gaps. ### Analyze Ad Copy History You view a competitor's past Google Ads copy and its performance data, refining your own PPC approach. ### List Organic Keywords You generate a list of specific keywords where a domain already ranks naturally in search results. ## Use Cases ### Launching a new product page You're building a landing page and need to know if the topic is worth tackling. You ask your agent: 'Run `get_keyword_stats` for X, then use `get_domain_overview` on our top three competitors.' The agent returns keyword viability alongside competitor traffic estimates, letting you decide where to focus efforts. ### Reacting to a competitor's ad campaign A rival launched a new paid search campaign. You need details fast. You run `get_ad_history` on their site and cross-reference that with `get_domain_competitors`. This shows you not just who they are, but what specific messaging worked for them. ### Auditing an old client website A long-term client needs a full SEO check. You start by running `get_domain_overview` to set the baseline. Then you use `get_organic_keywords` and `get_keyword_stats` on their biggest gaps, giving them a clear list of immediate content opportunities. ### Identifying underserved niches You suspect an entire segment is missing from the market. You first use `get_domain_competitors` to see who's there, then run `get_keyword_stats` on broad terms in that sector. If volume is high but difficulty scores are low for specific keywords, you found a gap. ## Benefits - See exactly who's competing with you. The `get_domain_competitors` tool maps out all top organic and paid rivals for any domain, instantly showing market gaps. - Know the money spent by others on ads. Use `get_ad_history` to view a competitor’s actual Google Ads copy and its performance metrics—it's better than guessing. - Validate keyword potential before writing anything. Running `get_keyword_stats` gives you volume, difficulty, and CPC data for immediate prioritization. - Quickly assess market size. The `get_domain_overview` tool pulls high-level SEO/PPC metrics—like estimated monthly traffic or ad budgets—to set the context. - Build content based on real rankings. Use `get_organic_keywords` to get a list of keywords where a domain already ranks, giving you specific targets. ## How It Works The bottom line is: your AI client talks to the server; the server runs the deep data query; you get the actionable results, all without leaving your workflow. 1. Subscribe to the SpyFu server and enter your API key into your AI client. 2. Tell your agent what you need—for example, 'Show me the keyword stats for X in the US.' 3. The agent calls the appropriate tool (like `get_keyword_stats`) and passes back a clear report with the required metrics. ## Frequently Asked Questions **How does SpyFu MCP Server help me find keyword stats for a new niche?** You run `get_keyword_stats` directly. You just tell the agent the search term and location, and it returns the volume, difficulty score (out of 100), and estimated CPC right away. **Can I use get_domain_competitors to find all my rivals?** Yes. You provide a target domain, and `get_domain_competitors` identifies the top organic sites and paid advertisers competing in that space. **What is the difference between get_organic_keywords and get_keyword_stats?** `get_organic_keywords` lists the specific terms a domain *already* ranks for. `get_keyword_stats`, however, gives you raw data (volume/difficulty) for any term you care about, whether they rank or not. **Does get_ad_history show me current ad copy?** No, it shows the *historical* Google Ads copy and performance. This is great because you can see what worked for them in the past to refine your own strategy. **What credentials are needed before running `get_domain_overview`?** You must connect an active SpyFu account with a valid API key. Vinkius requires you to input this key to authorize the agent's access and execute the query. **Are there rate limits when calling `get_keyword_stats` for a large list of keywords?** Yes, external API calls are subject to rate limits. For bulk research, structure your request in batches rather than sending hundreds of individual keyword queries. **After running `get_domain_competitors`, how do I get the ad history for those rivals?** You must take the domain names identified by the competitor tool and pass them directly as input to the `get_ad_history` function. This links the two analyses together. **Besides estimated traffic, what other data does `get_domain_overview` provide?** It provides high-level PPC metrics, including an estimate of the domain’s monthly ad budget and the total count of keywords for which it ranks organically. **Can I see how much a competitor is spending on Google Ads?** Yes. By using the `get_domain_overview` tool, the agent can retrieve the estimated monthly ad budget for any specific domain. **How do I find out who the main organic competitors are for a website?** You can use the `get_domain_competitors` tool with the `type` parameter set to 'organic'. This will return a list of domains competing for the same search results. **Is it possible to see the actual ad copy used by a competitor in the past?** Yes, the `get_ad_history` tool allows you to retrieve historical ad copy and performance data for a domain, helping you understand their messaging strategy.