> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DataForSEO

> Run keyword research, competitor analysis, and backlink audits with AI-powered SEO automation.

DataForSEO is a pay-as-you-go SEO data provider. The DataForSEO MCP server lets you research keywords, analyze competitors, audit backlinks, and pull live Google results using natural language.

## Prerequisites

None. DataForSEO works out of the box on Gumloop's shared account, billed in Gumloop credits.

If you have your own DataForSEO account, you can connect it instead. Your calls then run on your own API balance and cost **no Gumloop credits**. Add your API login and password on the [Credentials page](https://www.gumloop.com/personal/connectors).

<Info>
  The API password is generated by DataForSEO in your [API access dashboard](https://app.dataforseo.com/api-access). It is not your account password.
</Info>

## What Can It Do?

* **Research keywords** with search volume, difficulty, CPC, and search intent
* **Analyze competitors** by shared keywords, rankings, and traffic estimates
* **Audit backlinks**, referring domains, anchor text, and authority scores
* **Pull live Google results** for any keyword

## Where to Use It

### In Agents (Recommended)

Add DataForSEO as a tool to any agent. The agent can then perform SEO research conversationally, choosing the right actions based on context.

<video autoPlay muted loop playsInline className="w-full rounded-xl border border-pink-200 dark:border-pink-800" src="https://mintcdn.com/agenthub/B_VSlOOQHPvtlTyv/images/Connect_MCP_Tool_Agents.mp4?fit=max&auto=format&n=B_VSlOOQHPvtlTyv&q=85&s=f297b8516c66ea5697f7d5ef1cce934a" data-path="images/Connect_MCP_Tool_Agents.mp4" />

**To add an MCP tool to your agent:**

1. Open your agent's configuration
2. Click **Add tools** → **Connect an app with MCP**
3. Search for the integration and select it
4. Connect your account, or skip to use Gumloop's

<Tip>
  You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.
</Tip>

### In Workflows (Via Agent Node)

For automated pipelines, use an [Agent Node](/core-concepts/agent_node) with DataForSEO tools. This gives you the flexibility of an agent within a deterministic workflow.

### As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.

<div className="rounded-2xl overflow-hidden border border-pink-200 dark:border-pink-800">
  <iframe src="https://player.vimeo.com/video/1084821932" style={{ width: '100%', aspectRatio: '16/9' }} frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" title="MCP Nodes tutorial" />
</div>

**To create a custom MCP node:**

1. Go to your node library and search for the integration
2. Click **Create a node with AI**
3. Describe the specific action you want (e.g., "Get ranked keywords for hubspot.com")
4. Test the node and save it for reuse

<Info>
  Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.
</Info>

## Available Tools

Credits apply only when running on Gumloop's shared account. With your own DataForSEO account connected, every tool costs zero Gumloop credits.

### Keyword Research

| Tool                             | Description                                                                    | Credits      |
| -------------------------------- | ------------------------------------------------------------------------------ | ------------ |
| **Get Keyword Overview**         | Get search volume, CPC, competition, and difficulty for specific keywords      | 8 + 1/result |
| **Get Related Keywords**         | Get keywords from Google's "searches related to" block for a seed keyword      | 8 + 1/result |
| **Get Keyword Suggestions**      | Get long-tail keyword suggestions that include the seed keyword                | 8 + 1/result |
| **Get Keyword Ideas**            | Get keyword ideas that share a search intent with the seed keywords            | 8 + 1/result |
| **Get Bulk Keyword Difficulty**  | Get keyword difficulty scores for up to 1000 keywords in one call              | 8 + 1/result |
| **Get Search Intent**            | Classify keywords as informational, navigational, commercial, or transactional | 8 + 1/result |
| **Get Keywords For Site**        | Get keywords a domain ranks for, with search volume and difficulty             | 8 + 1/result |
| **Get Google Ads Search Volume** | Get Google Keyword Planner search volume, CPC, and competition                 | 54           |

### Domains and Competitors

| Tool                             | Description                                                                              | Credits       |
| -------------------------------- | ---------------------------------------------------------------------------------------- | ------------- |
| **Get Domain Rank Overview**     | Get a domain's organic and paid metrics: traffic, keyword count, estimated traffic value | 8 + 1/result  |
| **Get Ranked Keywords**          | Get the keywords a domain or URL ranks for, with position and traffic estimates          | 8 + 1/result  |
| **Get Domain Competitors**       | Get domains competing for the same organic keywords as the target                        | 8 + 1/result  |
| **Get Domain Intersection**      | Get keywords that two domains both rank for, with each domain's position                 | 8 + 1/result  |
| **Get Page Intersection**        | Get keywords for which a set of pages all appear in the same SERP                        | 8 + 1/result  |
| **Get Subdomains**               | Get the ranking subdomains of a domain with their keyword and traffic metrics            | 8 + 1/result  |
| **Get Relevant Pages**           | Get a domain's best performing pages ranked by organic traffic                           | 8 + 1/result  |
| **Get Serp Competitors**         | Get the domains ranking for a set of keywords, with average position and visibility      | 8 + 1/result  |
| **Get Categories For Domain**    | Get the product and service categories a domain ranks in                                 | 8 + 1/result  |
| **Get Historical Rank Overview** | Get a domain's monthly organic and paid metrics over time                                | 72 + 1/result |
| **Get Bulk Traffic Estimation**  | Get estimated monthly organic traffic for up to 1000 domains                             | 72 + 1/result |

### Backlinks

| Tool                           | Description                                                                    | Credits       |
| ------------------------------ | ------------------------------------------------------------------------------ | ------------- |
| **Get Backlinks Summary**      | Get a backlink profile summary: total backlinks, referring domains, spam score | 15 + 1/result |
| **Get Backlinks**              | Get individual backlinks pointing to a domain or URL                           | 15 + 1/result |
| **Get Backlinks Anchors**      | Get anchor text distribution across a domain's backlink profile                | 15 + 1/result |
| **Get Referring Domains**      | Get the domains linking to a target, with authority and link counts            | 15 + 1/result |
| **Get Referring Networks**     | Get the IP subnets or networks that backlinks originate from                   | 15 + 1/result |
| **Get Backlinks Domain Pages** | Get the pages on a domain that have backlinks, ranked by link count            | 15 + 1/result |
| **Get Backlinks Competitors**  | Get domains with a backlink profile similar to the target                      | 15 + 1/result |
| **Get Backlinks History**      | Get a domain's monthly backlink and referring domain history                   | 15 + 1/result |
| **Get Bulk Ranks**             | Get authority rank scores for up to 1000 domains, subdomains, or pages         | 15 + 1/result |

### Search Results

| Tool                 | Description                                          | Credits |
| -------------------- | ---------------------------------------------------- | ------- |
| **Get Serp Results** | Get live Google organic search results for a keyword | 3       |

<Tip>
  Tools that return a list charge per result, so use the `max_limit` parameter to control both cost and response size. Asking for 10 keywords instead of 1000 is a large difference in credits.
</Tip>

## Example Prompts

Use these with your agent or in the Agent Node:

**Keyword research:**

```text theme={"dark"}
Get the search volume and difficulty for "digital nomad visa"
```

**Competitive analysis:**

```text theme={"dark"}
Who are the top organic competitors for monday.com?
```

**Keyword gap:**

```text theme={"dark"}
Which keywords do zapier.com and make.com both rank for?
```

**Backlink audit:**

```text theme={"dark"}
Show me the referring domains and anchor text for shopify.com
```

**Live results:**

```text theme={"dark"}
Get the top 10 Google results for "ai workflow automation" and summarize what each page covers
```

## Location and Language

Most tools accept `location_name` and `language_name`, defaulting to United States and English. Pass a country name such as "United Kingdom" or "Germany" to target a different market.

## Troubleshooting

| Issue                            | Solution                                                                                                                          |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Agent not finding the right data | Use exact domain names without https\://                                                                                          |
| "Invalid Field" error            | The location or language name was not recognized. Use a full country name such as "United States", not a code.                    |
| Empty results                    | The domain or keyword may have no data in that market. Try a broader location or a better known domain to confirm the tool works. |
| Credentials rejected             | Check you used the API password from your DataForSEO API access dashboard, not your account password.                             |
| Tool not available               | Verify the tool is [enabled in your agent's MCP configuration](/core-concepts/agents#tool-management-and-approvals)               |

<Tip>
  Agents chain tools together. Asking "Analyze competitor.com's SEO" will typically pull a rank overview, then ranked keywords, then competitors. If results seem off, review the agent's step-by-step reasoning.
</Tip>

## Need Help?

* [Agents documentation](/core-concepts/agents) for setup and best practices
* [Agent Node guide](/core-concepts/agent_node) for workflow integration
* Need help? [Reach out to us](https://portal.usepylon.com/gumloop/forms/help)
* Contact [support@gumloop.com](mailto:support@gumloop.com) for assistance

***

**Use this integration directly in Claude or Cursor.** Connect remotely to the DataForSEO MCP server using credentials from your [Connectors page](https://www.gumloop.com/personal/connectors).