How to integrate Dataforseo MCP with Claude Agent SDK

This guide walks you through connecting Dataforseo to the Claude Agent SDK using the Composio tool router. By the end, you'll have a working Dataforseo agent that can analyze google serp for target keyword, find backlinks for competitor domain, research keyword volumes by location through natural language commands. This guide will help you understand how to give your Claude Agent SDK agent real control over a Dataforseo account through Composio's Dataforseo MCP server. Before we dive in, let's take a quick look at the key ideas and tools involved.

Dataforseo logoDataforseo
Basic

Dataforseo is an SEO data and analytics platform for SERP data, backlinks, keywords, and competitive intelligence. It gives teams reliable search data APIs to power SEO research, rank tracking, and market analysis.

312 Tools

Introduction

This guide walks you through connecting Dataforseo to the Claude Agent SDK using the Composio tool router. By the end, you'll have a working Dataforseo agent that can analyze google serp for target keyword, find backlinks for competitor domain, research keyword volumes by location through natural language commands.

This guide will help you understand how to give your Claude Agent SDK agent real control over a Dataforseo account through Composio's Dataforseo MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Dataforseo with

TL;DR

Here's what you'll learn:
  • Get and set up your Claude/Anthropic and Composio API keys
  • Install the necessary dependencies
  • Initialize Composio and create a Tool Router session for Dataforseo
  • Configure an AI agent that can use Dataforseo as a tool
  • Run a live chat session where you can ask the agent to perform Dataforseo operations

What is Claude Agent SDK?

The Claude Agent SDK is Anthropic's official framework for building AI agents powered by Claude. It provides a streamlined interface for creating agents with MCP tool support and conversation management.

Key features include:

  • Native MCP Support: Built-in support for Model Context Protocol servers
  • Permission Modes: Control tool execution permissions
  • Streaming Responses: Real-time response streaming for interactive applications
  • Context Manager: Clean async context management for sessions

What is the Dataforseo MCP server, and what's possible with it?

The Dataforseo MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Dataforseo account. It provides structured and secure access so your agent can perform Dataforseo operations on your behalf.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Composio API Key and Claude/Anthropic API Key
  • Primary know-how of Claude Agents SDK
  • A Dataforseo account
  • Some knowledge of Python
2

Getting API Keys for Claude/Anthropic and Composio

Claude/Anthropic API Key
  • Go to the Anthropic Console and create an API key. You'll need credits to use the models.
  • Keep the API key safe.
Composio API Key
  • Log in to the Composio dashboard.
  • Navigate to your API settings and generate a new API key.
  • Store this key securely as you'll need it for authentication.
3

Install dependencies

npm install @anthropic-ai/claude-agent-sdk @composio/core dotenv

Install the Composio SDK and the Claude Agents SDK.

What's happening:

  • @composio/core provides Composio integration for Anthropic
  • @anthropic-ai/claude-agent-sdk is the core agent framework
  • dotenv/config loads environment variables
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here

Create a .env file in your project root.

What's happening:

  • COMPOSIO_API_KEY authenticates with Composio
  • USER_ID identifies the user for session management
  • ANTHROPIC_API_KEY authenticates with Anthropic/Claude
5

Import dependencies

import 'dotenv/config';
import readline from 'node:readline';
import { Composio } from '@composio/core';
import { query, type Options } from "@anthropic-ai/claude-agent-sdk";

dotenv.config();
What's happening:
  • We're importing all necessary libraries including the Claude Agent SDK and Composio
  • The dotenv.config() function loads environment variables from your .env file
  • This setup prepares the foundation for connecting Claude with Dataforseo functionality
6

Create a Composio instance and Tool Router session

async function chat() {
  const { COMPOSIO_API_KEY, USER_ID } = process.env;
  if (!COMPOSIO_API_KEY || !USER_ID) {
    throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
  }

  const composio = new Composio({ apiKey: COMPOSIO_API_KEY });

  // Create Tool Router session for Dataforseo
  const session = await composio.create(USER_ID, {
    toolkits: ['dataforseo'],
  });
  const mcpUrl = session?.mcp.url;
What's happening:
  • The function checks for the required COMPOSIO_API_KEY environment variable
  • We're creating a Composio instance using our API key
  • The create method creates a Tool Router session for Dataforseo
  • The returned url is the MCP server URL that your agent will use
7

Configure Claude Agent with MCP

const options: Options = {
  permissionMode: 'bypassPermissions',
  mcpServers: {
    composio: {
      type: 'http',
      url: mcpUrl,
      headers: { 'x-api-key': COMPOSIO_API_KEY }
    }
  },
  systemPrompt: 'You are a helpful assistant with access to Dataforseo tools via Composio.',
  maxTurns: 10,
};
What's happening:
  • We're configuring the Claude Agent options with the MCP server URL
  • permissionMode: 'bypassPermissions' allows the agent to execute operations without asking for permission each time
  • The system prompt instructs the agent that it has access to Dataforseo
  • maxTurns: 10 limits the conversation length to prevent excessive API usage
8

Create client and start chat loop

const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: 'You: '
  });

  console.log('\nChat started. Type "exit" to quit.\n');

  let isProcessing = false;

  async function ask(prompt: string) {
    isProcessing = true;
    rl.pause();

    process.stdout.write('Claude is thinking...');
    const stream = query({ prompt, options });

    let firstChunk = true;
    for await (const msg of stream) {
      const content = (msg as any).message?.content || (msg as any).content;
      if (Array.isArray(content)) {
        for (const block of content) {
          if (block.type === 'text' && block.text) {
            if (firstChunk) {
              process.stdout.write('\r\x1b[K');
              process.stdout.write('Claude: ');
              firstChunk = false;
            }
            process.stdout.write(block.text);
          }
        }
      }
    }
    process.stdout.write('\n\n');

    isProcessing = false;
    rl.resume();
    rl.prompt();
  }

  rl.on('line', async (line) => {
    if (isProcessing) return;

    const input = line.trim();
    if (input === 'exit') {
      rl.close();
      process.exit(0);
    }
    if (input) await ask(input);
    else rl.prompt();
  });

  await ask('What can you help me with?');
}
What's happening:
  • The readline interface is created to handle user input and output
  • The query function is used to send the user's input to the agent
  • The chat loop continues until the user types 'exit' or 'quit'
9

Run the application

try {
  await chat();
} catch (error) {
  console.error(error);
  process.exit(1);
}
What's happening:
  • The chat function is the entry point for the application
  • The try-catch block is used to handle any errors that occur

Complete Code

Here's the complete code to get you started with Dataforseo and Claude Agent SDK:

import 'dotenv/config';
import readline from 'node:readline';
import { Composio } from '@composio/core';
import { query, type Options } from "@anthropic-ai/claude-agent-sdk";

async function chat() {
  const { COMPOSIO_API_KEY, USER_ID } = process.env;
  if (!COMPOSIO_API_KEY || !USER_ID) {
    throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
  }

  const composio = new Composio({ apiKey: COMPOSIO_API_KEY });
  const session = await composio.create(USER_ID, {
    toolkits: ['dataforseo']
  });
  const mcp_url = session?.mcp.url;

  const options: Options = {
    permissionMode: 'bypassPermissions',
    mcpServers: {
      composio: {
        type: 'http',
        url: mcp_url,
        headers: { 'x-api-key': COMPOSIO_API_KEY }
      }
    },
    systemPrompt: 'You are a helpful assistant with access to Dataforseo tools via Composio.',
    maxTurns: 10,
  };

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: 'You: '
  });

  console.log('\nChat started. Type "exit" to quit.\n');

  let isProcessing = false;

  async function ask(prompt: string) {
    isProcessing = true;
    rl.pause();

    process.stdout.write('Claude is thinking...');
    const stream = query({ prompt, options });

    let firstChunk = true;
    for await (const msg of stream) {
      const content = (msg as any).message?.content || (msg as any).content;
      if (Array.isArray(content)) {
        for (const block of content) {
          if (block.type === 'text' && block.text) {
            if (firstChunk) {
              process.stdout.write('\r\x1b[K');
              process.stdout.write('Claude: ');
              firstChunk = false;
            }
            process.stdout.write(block.text);
          }
        }
      }
    }
    process.stdout.write('\n\n');

    isProcessing = false;
    rl.resume();
    rl.prompt();
  }

  rl.on('line', async (line) => {
    if (isProcessing) return;

    const input = line.trim();
    if (input === 'exit') {
      rl.close();
      process.exit(0);
    }
    if (input) await ask(input);
    else rl.prompt();
  });

  await ask('What can you help me with?');
}

try {
  await chat();
} catch (error) {
  console.error(error);
  process.exit(1);
}

Conclusion

You've successfully built a Claude Agent SDK agent that can interact with Dataforseo through Composio's Tool Router.

Key features:

  • Native MCP support through Claude's agent framework
  • Streaming responses for real-time interaction
  • Permission bypass for smooth automated workflows
You can extend this by adding more toolkits, implementing custom business logic, or building a web interface around the agent.
TOOLS

Supported Tools

Every Dataforseo action and event your agent gets out of the box.

Create App Data Apple App Reviews Task

Tool to create Apple App Store reviews retrieval tasks.

Create Apple App Searches Task

Tool to create Apple App Store search tasks via DataForSEO API.

Create App Data Google App List Task

Tool to create Google Play Store app list retrieval tasks.

Create App Data Google App Reviews Task

Tool to create Google Play app reviews retrieval tasks.

Create Business Data Trustpilot Search Task

Tool to create Trustpilot search tasks for retrieving business profiles.

Create Keywords Data Google Trends Explore Task

Tool to create Google Trends Explore tasks for analyzing keyword popularity over time.

Create Keywords Data Bing Audience Estimation Task

Tool to create a Bing Audience Estimation task for ad campaign planning.

Create Keywords Data Google Keywords For Keywords Task

Tool to create Google Keywords For Keywords tasks for keyword research and analysis.

Create Merchant Amazon Sellers Task

Tool to create Merchant Amazon Sellers tasks.

Create On Page Lighthouse Task

Tool to create an On Page Lighthouse audit task for measuring web page quality based on Google's Lighthouse.

Create On Page Task

Tool to create an On Page crawl task for analyzing websites.

Create SERP Google Autocomplete Task

Tool to create Google Autocomplete SERP tasks.

Create SERP Google Events Task

Tool to create Google Events SERP tasks via DataForSEO API.

Create SERP Google Finance Explore Task

Tool to create Google Finance Explore SERP tasks.

Create SERP Google Local Finder Task

Tool to create Google Local Finder SERP tasks for retrieving local business search results.

Create SERP Google Maps Task

Tool to create Google Maps SERP tasks.

Create SERP Google Organic Task

Tool to create Google Organic SERP tasks for retrieving top search engine results.

Create SERP Seznam Organic Task

Tool to create a SERP Seznam Organic search task.

Create YouTube Video Comments Task

Tool to create YouTube Video Comments SERP tasks.

Create SERP YouTube Video Subtitles Task

Tool to create YouTube video subtitles extraction tasks.

Force Stop On Page Crawl

Tool to force stop On Page crawl tasks.

Get AI Keyword Data Available Filters

Tool to retrieve available filters for DataForSEO AI Keyword Data API endpoints.

Get AI Keyword Data Locations And Languages

Tool to retrieve the full list of locations and languages supported in AI Keyword Data API.

Get AI Optimization Chat GPT LLM Scraper HTML by ID

Tool to retrieve AI Optimization Chat GPT LLM Scraper task results in HTML format.

Get AI Optimization ChatGPT LLM Scraper Task (Advanced)

Tool to retrieve advanced ChatGPT LLM scraper task results by task ID.

Get AI Optimization Gemini LLM Scraper Task Advanced

Tool to retrieve advanced AI Optimization Gemini LLM scraper task results by task ID.

Get Live ChatGPT LLM Responses

Tool to retrieve live structured responses from ChatGPT AI models via DataForSEO.

Get Gemini LLM Scraper HTML Results

Retrieve HTML results for a completed Gemini LLM Scraper task by its unique ID.

Get AI Optimization LLM Mentions Top Domains Live

Tool to get live aggregated LLM mentions grouped by most frequently mentioned domains.

Get Apple App List Task Results

Tool to retrieve Apple App Store app list results for a previously created task.

Get Apple App Searches Task Advanced

Tool to retrieve Apple App Searches task results from DataForSEO.

Get App Data Google App Info Task HTML By ID

Tool to retrieve HTML content for a Google Play app by task ID.

Get App Data Google App List Task Advanced By ID

Tool to retrieve Google Play app list results for a previously created task.

Get App Data Google App Reviews Task HTML

Tool to retrieve HTML content for Google Play app reviews by task ID.

Get App Data Google App Searches HTML By ID

Tool to retrieve raw HTML results for a Google Play app searches task by ID.

Get Appendix Errors

Tool to retrieve the complete list of DataForSEO API error codes and HTTP status codes.

Get Appendix Status

Tool to get current operational status of all DataForSEO APIs and endpoints.

Get Appendix User Data

Tool to retrieve current user account data including balance, rate limits, spending statistics, and pricing information.

Get App Data Google App Reviews Task Advanced By ID

Tool to retrieve Google Play app review results for a previously created task.

Get App Data Google App Searches Task Advanced By ID

Tool to retrieve Google Play app search results for a previously created task.

Get Apple App Info Task Advanced

Tool to retrieve advanced results for a previously created Apple App Info task.

Get Backlinks Bulk Pages Summary Live

Tool to get comprehensive backlinks summary data for multiple pages, domains, or subdomains in a single request.

Get Backlinks Bulk Spam Score Live

Tool to get spam scores for multiple domains, subdomains, or pages in a single request.

Get Backlinks Summary Live

Tool to get a comprehensive overview of backlinks data for a domain, subdomain, or webpage.

Get Bing Keyword Performance Locations And Languages

Tool to retrieve the full list of locations and languages supported in Bing Keyword Performance API endpoints.

Get Business Data Business Listings Available Filters

Tool to retrieve available filters for Business Data Business Listings API endpoints.

Get Business Data Google Hotel Info Task Advanced By ID

Tool to retrieve Google Hotel Info task results by task ID.

Get Business Data Google Hotel Searches Task By ID

Tool to retrieve Google Hotel Searches task results by task ID.

Get Business Data Google My Business Updates Task By ID

Tool to retrieve Google My Business updates and posts by task ID.

Get Business Data Google Questions And Answers Task

Tool to retrieve Google Business questions and answers data by task ID.

Get Business Data Google Extended Reviews Task

Tool to retrieve Google Business extended reviews data by task ID.

Get Business Data Google My Business Info Task

Tool to retrieve Google My Business information by task ID.

Get Business Data Google Reviews Task

Tool to retrieve Google Reviews task results by task ID.

Get Business Data TripAdvisor Reviews Task By ID

Tool to retrieve TripAdvisor Reviews task results by task ID.

Get Business Data TripAdvisor Search Task By ID

Tool to retrieve TripAdvisor Search task results by task ID.

Get Business Data Trustpilot Search Task By ID

Tool to retrieve Trustpilot search task results by task ID.

Get ChatGPT LLM Scraper Locations By Country

Tool to retrieve available ChatGPT LLM Scraper locations filtered by country ISO code.

Get DataForSEO Labs Available Filters

Tool to retrieve available filters for DataForSEO Labs API endpoints.

Get Bing Related Keywords Live

Tool to retrieve Bing related keywords appearing in 'searches related to' SERP element.

Get DataForSEO Labs Google Available History

Tool to retrieve available historical dates for DataForSEO Labs domain metrics.

Get DataForSEO Labs Google Top Searches Live

Tool to retrieve top Google search keywords with comprehensive metrics including search volume, competition, CPC, trends, and intent data.

Get DataForSEO Labs Status

Tool to retrieve last update dates for DataForSEO Labs data sources (Google, Bing, and Amazon).

Get DataForSEO Trends Locations By Country

Tool to retrieve DataForSEO Trends locations filtered by country ISO code.

Get Domain Analytics Technologies Technology Stats Live

Tool to retrieve historical technology adoption statistics across domains.

Get Gemini LLM Responses Task Results

Tool to retrieve structured Gemini LLM responses from a specific task by ID.

Get Google Historical Bulk Traffic Estimation Live

Tool to get historical monthly traffic volumes for up to 1000 domains, subdomains, or webpages on Google over a specified time range.

Get Keywords Data Bing Keywords For Site Task

Tool to retrieve Bing Keywords For Site task results by task ID.

Get Bing Search Volume Task By ID

Tool to retrieve Bing search volume task results by task ID.

Get Keywords Data Google Ads Status

Tool to get current status of Google Ads keyword data updates.

Get Keywords Data Google Search Volume Task

Tool to retrieve Google Search Volume task results by task ID.

Get Keywords Data Bing Audience Estimation Industries

Tool to retrieve the list of industries supported by Bing Ads Audience Estimation endpoint.

Get Keywords Data Bing Keywords For Keywords Task By ID

Tool to retrieve Bing Keywords For Keywords task results by task ID.

Get Keywords Data Bing Keyword Suggestions For URL Live

Tool to get Bing keyword suggestions based on a target URL with search volume, competition, and CPC metrics.

Get Bing Keyword Suggestions for URL Task

Tool to retrieve Bing keyword suggestions for a URL from a previously created task.

Get Keywords Data Google Ads Ad Traffic By Keywords Task

Tool to retrieve Google Ads Ad Traffic By Keywords task results by task ID.

Get Keywords Data Google Ads Keywords For Keywords Live

Tool to retrieve Google Ads keyword suggestions for specified keywords with comprehensive metrics.

Get Keywords Data Google Ads Keywords For Keywords Task

Tool to retrieve Google Ads Keywords For Keywords task results by task ID.

Get Google Ads Keywords For Site Task

Tool to retrieve Google Ads Keywords For Site task results by task ID.

Get Keywords Data Google Ads Search Volume Task

Tool to retrieve Google Ads Search Volume task results by task ID.

Get Keywords Data Google Keywords For Category Live

Tool to retrieve live Google keywords for a specific product/service category.

Get Keywords Data Google Keywords For Keywords Task

Tool to retrieve Google Keywords For Keywords task results by task ID.

Get Keywords Data Google Trends Explore Task

Tool to retrieve Google Trends Explore task results by task ID.

Get Google Trends Locations By Country

Tool to retrieve available Google Trends locations filtered by country ISO code.

Get LLM Mentions Available Filters

Tool to fetch available filters for AI Optimization LLM Mentions API endpoints.

Get Merchant Amazon ASIN Task Advanced By ID

Tool to retrieve Amazon product information by ASIN task ID.

Get Merchant Amazon ASIN Task HTML

Tool to retrieve raw HTML results for an Amazon ASIN merchant task by ID.

Get Merchant Amazon Products Task (Advanced)

Tool to retrieve advanced Amazon Products task results by task ID.

Get Merchant Amazon Products Task HTML By ID

Tool to retrieve raw HTML results for a Merchant Amazon Products task by ID.

Get Merchant Amazon Sellers Task Advanced

Tool to retrieve Amazon sellers task results from DataForSEO.

Get Merchant Amazon Sellers Task HTML By ID

Tool to retrieve raw HTML results for a Merchant Amazon Sellers task by ID.

Get Merchant Google Products Task (Advanced)

Tool to retrieve advanced Google Shopping Products task results by task ID.

Get Merchant Google Products Task HTML

Tool to retrieve raw HTML results for a Merchant Google Products task by ID.

Get Merchant Google Sellers Task (Advanced)

Tool to retrieve advanced Google Sellers task results by task ID.

Get Merchant Google Product Info Task (Advanced)

Tool to retrieve advanced Google Product Info task results by task ID.

Get On Page Duplicate Content

Tool to retrieve duplicate content analysis for a specific page using the SimHash algorithm.

Get On Page Duplicate Tags

Tool to retrieve pages with duplicate title or description tags from On Page crawl tasks.

Get On Page Keyword Density

Tool to get keyword density and keyword frequency data from an On Page task.

Get On Page Lighthouse Audits

Tool to retrieve the complete list of available Lighthouse audits for the OnPage API.

Get On Page Lighthouse Task Get Json

Tool to retrieve On Page Lighthouse task results in JSON format.

Get On Page Links

Tool to retrieve internal and external links detected on a target website by task ID.

Get On Page Non Indexable

Tool to retrieve non-indexable pages from an On-Page crawl task by task ID.

Get On Page Pages

Tool to retrieve crawled pages with on-page metrics and optimization data.

Get On Page Pages By Resource

Tool to retrieve pages that use a specific resource from a completed OnPage crawl task.

Get On Page Summary

Tool to retrieve On Page Summary information for a scanned website by task ID.

Get SERP Baidu Locations By Country

Tool to retrieve supported Baidu SERP locations by country.

Get SERP Baidu Organic Task (Advanced)

Tool to retrieve advanced Baidu Organic SERP task results by task ID.

Get SERP Bing Organic Task Regular By ID

Tool to retrieve Bing Organic SERP task results by task ID.

Get SERP Google Dataset Search Task (Advanced)

Tool to retrieve Google Dataset Search task results by task ID.

Get SERP Google Finance Explore Task (Advanced)

Tool to retrieve Google Finance Explore task results by task ID.

Get SERP Google Finance Ticker Search Task (Advanced)

Tool to retrieve Google Finance Ticker Search task results by task ID.

Get SERP Google Local Finder Task (Advanced)

Tool to retrieve Google Local Finder SERP task results by task ID.

Get SERP Google Ads Advertisers Live Advanced

Tool to get live Google Ads Advertisers results via DataForSEO API.

Get SERP Google Ads Advertisers Task Advanced

Tool to retrieve Google Ads advertiser transparency data for a previously created task.

Get SERP Google Ads Search Live Advanced

Tool to get live Google Ads Search advanced results.

Get SERP Google AI Mode Task Advanced Results

Tool to retrieve Google AI Mode SERP task results by task ID.

Get SERP Google Autocomplete Task (Advanced)

Tool to retrieve Google Autocomplete task results by task ID.

Get SERP Google Dataset Info Task (Advanced)

Tool to retrieve Google Dataset Info task results by task ID.

Get SERP Google Finance Markets Task HTML By ID

Tool to retrieve raw HTML results for a Google Finance Markets SERP task by ID.

Get SERP Google Finance Quote Task (Advanced)

Tool to retrieve Google Finance Quote task results by task ID.

Get SERP Google Finance Quote HTML By ID

Tool to retrieve raw HTML results for a Google Finance Quote task by ID.

Get SERP Google Images Task (Advanced)

Tool to retrieve Google Images SERP task results by task ID.

Get SERP Google Images Task HTML By ID

Tool to retrieve raw HTML results for a Google Images SERP task by ID.

Get SERP Google Jobs Task (Advanced)

Tool to retrieve Google Jobs SERP task results by task ID.

Get SERP Google Maps Task (Advanced)

Tool to retrieve Google Maps SERP task results by task ID.

Get SERP Google News Task (Advanced)

Tool to retrieve Google News SERP task results by task ID.

Get SERP Google Organic Task (Advanced)

Tool to retrieve advanced Google Organic SERP task results by task ID.

Get SERP Google Organic Task HTML By ID

Tool to retrieve raw HTML results for a Google Organic SERP task by ID.

Get SERP Google Organic Task Regular By ID

Tool to retrieve Google Organic SERP task results by task ID.

Get SERP Google Search By Image HTML By ID

Tool to retrieve raw HTML results for a Google Search By Image task by ID.

Get SERP Naver Organic Task (Advanced)

Tool to retrieve advanced Naver Organic SERP task results by task ID.

Get SERP Naver Organic Task Regular By ID

Tool to retrieve Naver Organic SERP task results by task ID.

Get SERP Seznam Organic Task (Advanced)

Tool to retrieve Seznam Organic SERP task results by task ID.

Get Serp Seznam Organic Task Get Regular By Id

Tool to retrieve Seznam Organic SERP task results by task ID.

Get SERP Yahoo Organic Task (Advanced)

Tool to retrieve Yahoo Organic SERP task results by task ID.

Get SERP Yahoo Organic Task Regular By ID

Tool to retrieve Yahoo Organic SERP task results by task ID.

Get YouTube Video Comments Task (Advanced)

Tool to retrieve advanced YouTube Video Comments SERP task results by task ID.

Get SERP YouTube Video Subtitles Task Advanced By ID

Tool to retrieve YouTube video subtitles from a specific task by ID.

List Chat GPT AI Models

Retrieve the list of available Chat GPT AI models from DataForSEO.

List Ready AI Optimization LLM Response Tasks

Tool to list completed AI optimization LLM response tasks that are ready for result collection.

List AI Optimization ChatGPT LLM Scraper Languages

Tool to list available languages for DataForSEO ChatGPT LLM Scraper.

List ChatGPT LLM Scraper Locations

Tool to retrieve the list of available locations for DataForSEO ChatGPT LLM Scraper.

List AI Optimization Claude LLM Tasks Ready

Tool to list completed AI Optimization Claude LLM response tasks that are ready for collection.

List AI Optimization Gemini LLM Scraper Tasks Ready

Tool to retrieve completed Gemini LLM Scraper tasks that haven't been collected yet.

List Gemini LLM Scraper Languages

Tool to retrieve the list of available languages for DataForSEO AI Optimization Gemini LLM Scraper API.

List Gemini LLM Scraper Locations

Tool to list available locations for AI Optimization Gemini LLM Scraper.

List AI Optimization LLM Mentions Locations and Languages

Tool to retrieve the full list of locations and languages supported in DataForSEO AI Optimization LLM Mentions API.

List AI Optimization Perplexity LLM Response Models

Tool to list available Perplexity AI models for LLM responses with their capabilities.

List Apple App List Ready Tasks

Tool to retrieve completed Apple App List tasks that are ready for collection.

List App Data Apple Categories

Tool to retrieve the complete list of app categories available on Apple App Store.

List App Data Apple Languages

Tool to list available languages for DataForSEO Apple App Data API.

List Apple App Data Locations

Tool to retrieve the list of Apple App Store locations supported in DataForSEO App Data API.

List App Data Errors

Tool to retrieve information about App Data API tasks that returned errors within the past 7 days.

List Google App Info Ready Tasks

Tool to retrieve completed Google App Info tasks that are ready for collection.

List App Data Google App Listings Categories

Tool to list all available Google Play app categories with their listing counts.

List Google App List Ready Tasks

Tool to retrieve completed Google App List tasks that are ready for collection.

List Google App Reviews Ready Tasks

Tool to retrieve completed Google App Reviews tasks that are ready for collection.

List Google App Searches Ready Tasks

Tool to retrieve completed Google App Searches tasks that are ready for collection.

List App Data Google Categories

Tool to list available Google Play app categories.

List App Data Google Languages

Tool to list available languages for DataForSEO Google App Data API.

List App Data Task IDs

Tool to retrieve a list of App Data task IDs within a specified time period.

List App Data Ready Tasks

Tool to retrieve completed App Data tasks that are ready for collection.

List Apple App Searches Tasks Ready

Tool to retrieve list of completed Apple App Searches tasks that are ready for collection.

List Backlinks Available Filters

Tool to retrieve available filters for DataForSEO Backlinks API endpoints.

List Backlinks Errors

Tool to retrieve information about Backlinks API tasks that returned errors within the past 7 days.

List Bing Search Volume History Locations

Tool to retrieve the list of locations and languages supported by Bing Search Volume History endpoint.

List Google Extended Reviews Ready Tasks

Tool to retrieve completed Google Extended Reviews tasks that are ready for collection.

List Business Data Google Hotel Searches Tasks Ready

Tool to retrieve completed Business Data Google Hotel Searches tasks ready for collection.

List Google My Business Info Ready Tasks

Tool to retrieve completed Google My Business Info tasks that are ready for collection.

List Google My Business Updates Ready Tasks

Tool to retrieve completed Google My Business Updates tasks that are ready for collection.

List Google Questions And Answers Ready Tasks

Tool to retrieve completed Google Questions And Answers tasks that are ready for collection.

List TripAdvisor Reviews Ready Tasks

Tool to retrieve completed TripAdvisor Reviews tasks that are ready for collection.

List Business Data Business Listings Categories

Tool to list Business Data Business Listings categories by business count.

List Business Data Business Listings Locations

Tool to list available locations for Business Listings data.

List Business Data Errors

Tool to retrieve information about Business Data API tasks that returned errors within the past 7 days.

List Google Hotel Info Ready Tasks

Tool to retrieve completed Google Hotel Info tasks that are ready for collection.

List Business Data Google Languages

Tool to list available languages for DataForSEO Google Business Data API.

List Google Reviews Ready Tasks

Tool to retrieve completed Google Reviews tasks that are ready for collection.

List Business Data Ready Tasks

Tool to retrieve completed Business Data tasks that are ready for collection.

List Business Data TripAdvisor Languages

Tool to list available TripAdvisor languages supported in Business Data API.

List TripAdvisor Search Ready Tasks

Tool to retrieve completed TripAdvisor Search tasks that are ready for collection.

List Trustpilot Reviews Ready Tasks

Tool to retrieve completed Trustpilot Reviews tasks that are ready for collection.

List Trustpilot Search Ready Tasks

Tool to retrieve completed Trustpilot Search tasks that are ready for collection.

List Claude LLM Response Models

Tool to list available Claude AI models for AI optimization and LLM responses.

List Content Analysis Available Filters

Tool to retrieve available filters for DataForSEO Content Analysis API.

List Content Analysis Categories

Tool to list all available Content Analysis categories based on Google product and service categories.

List Content Analysis Languages

Tool to list available languages supported in Content Analysis API.

List Content Analysis Locations

Tool to list available locations supported in Content Analysis API.

List DataForSEO Labs Categories

Tool to retrieve the complete hierarchical list of Google categories used by DataForSEO Labs.

List DataForSEO Labs Errors

Tool to retrieve information about DataForSEO Labs API tasks that returned errors within the past 7 days.

List DataForSEO Labs Locations and Languages

Tool to list available locations and languages supported in DataForSEO Labs API.

List Domain Analytics Errors

Tool to retrieve information about Domain Analytics API tasks that returned errors within the past 7 days.

List Domain Analytics Task IDs

Tool to retrieve a list of Domain Analytics task IDs within a specified time period.

List Domain Analytics Technologies

Tool to retrieve the complete list of available technologies in DataForSEO Domain Analytics API, organized by groups and categories.

List Domain Analytics Technologies Filters

Tool to retrieve available filters for DataForSEO Domain Analytics Technologies API endpoints.

List Domain Analytics Technologies Languages

Tool to list available languages for Domain Analytics Technologies API.

List Domain Analytics Technologies Locations

Tool to list available locations supported in Domain Analytics Technologies API.

List Domain Analytics Whois Filters

Tool to retrieve available filters for DataForSEO Domain Analytics Whois API endpoint.

List Gemini LLM Models

Tool to list available Gemini LLM response models with their capabilities.

List Gemini LLM Responses Tasks Ready

Tool to retrieve a list of completed Gemini LLM response tasks that haven't been collected yet.

List Keywords Data Bing Languages

Tool to list available languages for DataForSEO Bing Keywords Data API.

List Bing Search Volume Ready Tasks

Tool to retrieve completed Keywords Data Bing Search Volume tasks that are ready for collection.

List Keywords Data Dataforseo Trends Locations

Tool to list available locations supported in DataForSEO Trends API.

List Keywords Data Endpoints

Tool to retrieve all available Keywords Data API endpoints.

List Keywords Data Errors

Tool to retrieve Keywords Data API tasks that returned errors within the past 7 days.

List Keywords Data Google Ads Languages

Tool to list available languages for DataForSEO Keywords Data Google Ads API.

List Keywords Data Google Categories

Tool to list available Google AdWords product/service categories.

List Keywords Data Google Languages

Tool to list available languages for DataForSEO Google Keywords Data API.

List Keywords Data Google Trends Categories

Tool to list available Google Trends categories for Keywords Data API.

List Keywords Data Google Trends Languages

Tool to list available languages for DataForSEO Google Trends API.

List Keywords Data Google Trends Locations

Tool to list available Google Trends locations for Keywords Data API.

List Keywords Data Bing Audience Estimation Job Functions

Tool to retrieve the list of job functions with job_function_id supported by Bing Ads Audience Estimation endpoint.

List Bing Audience Estimation Ready Tasks

Tool to retrieve completed Keywords Data Bing Audience Estimation tasks that are ready for collection.

List Bing Keywords For Keywords Ready Tasks

Tool to retrieve completed Bing Keywords For Keywords tasks that are ready for collection.

List Bing Keywords For Site Ready Tasks

Tool to retrieve completed Bing Keywords For Site tasks that are ready for collection.

List Bing Keyword Performance Ready Tasks

Tool to retrieve completed Bing Keyword Performance tasks that are ready for collection.

List Keywords Data Bing Keyword Suggestions For URL Languages

Tool to list available languages for DataForSEO Bing Keyword Suggestions API.

List Keywords Data Bing Keyword Suggestions For URL Tasks Ready

Tool to retrieve completed Bing Keyword Suggestions For URL tasks that haven't been collected yet.

List Bing Search Volume History Ready Tasks

Tool to retrieve completed Bing Search Volume History tasks that are ready for collection.

List Keywords Data Clickstream Data Locations And Languages

Tool to retrieve the full list of locations and languages supported in DataForSEO Clickstream Data API.

List Google Ads Ad Traffic by Keywords Ready Tasks

Tool to retrieve completed Google Ads Ad Traffic by Keywords tasks that are ready for collection.

List Google Ads Keywords For Keywords Ready Tasks

Tool to retrieve completed Google Ads Keywords For Keywords tasks that are ready for collection.

List Keywords Data Google Ads Keywords For Site Tasks Ready

Tool to retrieve completed Google Ads Keywords For Site tasks that haven't been collected yet.

List Google Ads Search Volume Ready Tasks

Tool to retrieve completed Google Ads Search Volume tasks that are ready for collection.

List Keywords For Keywords Ready Tasks

Tool to retrieve completed Google Keywords For Keywords tasks that are ready for collection.

List Keywords Data Google Keywords For Site Tasks Ready

Tool to retrieve completed Google Keywords For Site tasks that haven't been collected yet.

List Google Search Volume Ready Tasks

Tool to retrieve completed Google Search Volume tasks that are ready for collection.

List Google Trends Explore Ready Tasks

Tool to retrieve completed Google Trends Explore tasks that are ready for collection.

List DataForSEO Labs Google Categories for Keywords Languages

Tool to list available languages for DataForSEO Labs Google Categories for Keywords API.

List Merchant Amazon Asin Ready Tasks

Tool to retrieve completed Merchant Amazon Asin tasks that are ready for collection.

List Merchant Amazon Languages

Tool to list available languages for DataForSEO Amazon Merchant Data API.

List Merchant Amazon Products Ready Tasks

Tool to retrieve completed Merchant Amazon Products tasks that are ready for collection.

List Merchant Amazon Sellers Ready Tasks

Tool to retrieve completed Merchant Amazon Sellers tasks that are ready for collection.

List Merchant Errors

Tool to retrieve information about Merchant API tasks that returned errors within the past 7 days.

List Merchant Google Languages

Tool to list available languages for DataForSEO Merchant Google API.

List Merchant Google Product Info Ready Tasks

Tool to retrieve completed Merchant Google Product Info tasks that are ready for collection.

List Merchant Google Products Ready Tasks

Tool to retrieve completed Merchant Google Products tasks that are ready for collection.

List Merchant Google Reviews Ready Tasks

Tool to retrieve completed Merchant Google Reviews tasks that are ready for collection.

List Merchant Google Sellers Ready Tasks

Tool to retrieve completed Merchant Google Sellers tasks that are ready for collection.

List Merchant Ready Tasks

Tool to retrieve completed Merchant tasks that are ready for collection.

List OnPage Available Filters

Tool to retrieve available filters for DataForSEO OnPage API endpoints.

List OnPage Errors

Tool to retrieve information about OnPage API tasks that returned errors within the past 7 days.

List On Page Lighthouse Languages

Tool to list available languages for DataForSEO On Page Lighthouse API.

List On Page Lighthouse Tasks Ready

Tool to retrieve the list of completed On Page Lighthouse tasks that haven't been collected yet.

List OnPage Lighthouse Versions

Tool to list available Lighthouse versions for OnPage API audits.

List On Page Resources

Tool to retrieve resources from a completed OnPage crawl task.

List On Page Ready Tasks

Tool to retrieve completed On Page tasks that haven't been collected yet.

List Serp Baidu Languages

Tool to list available languages for DataForSEO Baidu SERP API.

List Baidu Organic Fixed Tasks

Tool to retrieve re-parsed Baidu organic SERP tasks that haven't been collected yet.

List SERP Baidu Organic Ready Tasks

Tool to retrieve completed SERP Baidu Organic tasks that are ready for collection.

List SERP Bing Languages

Tool to list available languages for DataForSEO Bing SERP API.

List SERP Bing Organic Tasks Fixed

Tool to retrieve list of re-parsed Bing Organic SERP tasks that haven't been collected yet.

List SERP Bing Organic Ready Tasks

Tool to retrieve completed SERP Bing Organic tasks that are ready for collection.

List SERP Endpoints

Tool to retrieve the complete list of available SERP API endpoints for task setup.

List SERP Errors

Tool to retrieve SERP API tasks that returned errors within the past 7 days.

List SERP Google Finance Ticker Search Ready Tasks

Tool to retrieve completed SERP Google Finance Ticker Search tasks that are ready for collection.

List SERP Google Ads Advertisers Locations

Tool to list available Google Ads advertiser locations for SERP API queries.

List SERP Google Ads Advertisers Ready Tasks

Tool to retrieve completed SERP Google Ads Advertisers tasks that are ready for collection.

List SERP Google Ads Search Locations

Tool to list available Google Ads Search locations for SERP API.

List SERP Google Ads Search Ready Tasks

Tool to retrieve completed SERP Google Ads Search tasks that are ready for collection.

List SERP Google AI Mode Languages

Tool to list available languages for DataForSEO Google AI Mode SERP API.

List SERP Google AI Mode Tasks Fixed

Tool to retrieve re-parsed SERP Google AI Mode tasks that haven't been collected yet.

List SERP Google AI Mode Ready Tasks

Tool to retrieve completed SERP Google AI Mode tasks that are ready for collection.

List Google Autocomplete Fixed Tasks

Tool to retrieve re-parsed Google autocomplete SERP tasks that haven't been collected yet.

List SERP Google Autocomplete Ready Tasks

Tool to retrieve completed SERP Google Autocomplete tasks that are ready for collection.

List SERP Google Dataset Info Fixed Tasks

Tool to retrieve re-parsed Google Dataset Info tasks that haven't been collected yet.

List SERP Google Dataset Info Ready Tasks

Tool to retrieve completed SERP Google Dataset Info tasks that are ready for collection.

List Google Dataset Search Fixed Tasks

Tool to retrieve re-parsed Google Dataset Search SERP tasks that haven't been collected yet.

List SERP Google Dataset Search Ready Tasks

Tool to retrieve completed SERP Google Dataset Search tasks that are ready for collection.

List Google Events Fixed Tasks

Tool to retrieve re-parsed Google Events SERP tasks that haven't been collected yet.

List SERP Google Events Ready Tasks

Tool to retrieve completed SERP Google Events tasks that are ready for collection.

List SERP Google Finance Explore Ready Tasks

Tool to retrieve completed SERP Google Finance Explore tasks that are ready for collection.

List SERP Google Finance Markets Ready Tasks

Tool to retrieve completed SERP Google Finance Markets tasks that are ready for collection.

List SERP Google Finance Quote Ready Tasks

Tool to retrieve completed SERP Google Finance Quote tasks that are ready for collection.

List Google Images Fixed Tasks

Tool to retrieve re-parsed Google Images SERP tasks that haven't been collected yet.

List SERP Google Images Ready Tasks

Tool to retrieve completed SERP Google Images tasks that are ready for collection.

List Google Jobs Fixed Tasks

Tool to retrieve re-parsed Google Jobs SERP tasks that haven't been collected yet.

List SERP Google Jobs Ready Tasks

Tool to retrieve completed SERP Google Jobs tasks that are ready for collection.

List SERP Google Languages

Tool to list available languages for DataForSEO Google SERP API.

List Google Local Finder Fixed Tasks

Tool to retrieve re-parsed Google Local Finder SERP tasks that haven't been collected yet.

List Google Local Finder Ready Tasks

Tool to retrieve completed SERP Google Local Finder tasks that are ready for collection.

List Google Maps Fixed Tasks

Tool to retrieve re-parsed Google Maps SERP tasks that haven't been collected yet.

List SERP Google Maps Ready Tasks

Tool to retrieve completed SERP Google Maps tasks that are ready for collection.

List Google News Fixed Tasks

Tool to retrieve re-parsed Google News SERP tasks that haven't been collected yet.

List SERP Google News Ready Tasks

Tool to retrieve completed SERP Google News tasks that are ready for collection.

List Google Organic Fixed Tasks

Tool to retrieve re-parsed Google Organic SERP tasks that haven't been collected yet.

List SERP Google Organic Ready Tasks

Tool to retrieve completed SERP Google Organic tasks that are ready for collection.

List Google Search By Image Fixed Tasks

Tool to retrieve re-parsed Google Search by Image SERP tasks that haven't been collected yet.

List SERP Google Search By Image Ready Tasks

Tool to retrieve completed SERP Google Search By Image tasks that are ready for collection.

List SERP Task IDs

Tool to retrieve a list of SERP task IDs within a specified time period.

List Naver Organic Fixed Tasks

Tool to retrieve re-parsed Naver organic SERP tasks that haven't been collected yet.

List SERP Naver Organic Ready Tasks

Tool to retrieve completed SERP Naver Organic tasks that are ready for collection.

List Serp Seznam Languages

Tool to list available languages for DataForSEO Seznam SERP API.

List Seznam Organic Fixed Tasks

Tool to retrieve re-parsed Seznam organic SERP tasks that haven't been collected yet.

List Seznam Organic SERP Ready Tasks

Tool to retrieve completed Seznam Organic SERP tasks that are ready for collection.

List SERP Ready Tasks

Tool to retrieve completed SERP tasks that are ready for collection.

List SERP Yahoo Languages

Tool to list available languages for DataForSEO Yahoo SERP API.

List Yahoo Organic Fixed Tasks

Tool to retrieve re-parsed Yahoo organic SERP tasks that haven't been collected yet.

List Yahoo Organic SERP Ready Tasks

Tool to retrieve completed Yahoo Organic SERP tasks that are ready for collection.

List SERP YouTube Languages

Tool to list available languages for DataForSEO YouTube SERP API.

List YouTube Organic Ready Tasks

Tool to retrieve completed YouTube Organic SERP tasks that are ready for collection.

List YouTube Video Comments Fixed Tasks

Tool to retrieve re-parsed YouTube Video Comments SERP tasks that haven't been collected yet.

List YouTube Video Comments Ready Tasks

Tool to retrieve completed YouTube video comments SERP tasks that are ready for collection.

List YouTube Video Info Fixed Tasks

Tool to retrieve re-parsed YouTube Video Info SERP tasks that haven't been collected yet.

List SERP YouTube Video Info Ready Tasks

Tool to retrieve completed SERP YouTube Video Info tasks that are ready for collection.

List SERP YouTube Video Subtitles Fixed Tasks

Tool to retrieve re-parsed SERP YouTube Video Subtitles tasks that haven't been collected yet.

List SERP YouTube Video Subtitles Ready Tasks

Tool to retrieve completed SERP YouTube Video Subtitles tasks that are ready for collection.

Get Bulk Keyword Difficulty Live

Tool to retrieve bulk keyword difficulty scores from DataForSEO Labs.

Create Bing Search Volume Task

Tool to create a Bing Search Volume task for keyword analysis.

Post Keywords Data Google Search Volume Task

Tool to submit a Google search volume task for specified keywords.

Create Google Keywords For Category Task

Tool to create a Google Keywords For Category task to retrieve keyword suggestions for a specific product/service category.

Post On Page Summary

Tool to retrieve On Page Summary information for multiple scanned websites via POST request.

Resend Appendix Webhooks

Tool to resend webhooks (pingbacks and postbacks) for completed tasks.

FAQ

Frequently asked questions

With a standalone Dataforseo MCP server, the agents and LLMs can only access a fixed set of Dataforseo tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Dataforseo and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Agent SDK fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Dataforseo tools.

Yes, absolutely. You can configure which Dataforseo scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Dataforseo data and credentials are handled as safely as possible.

Start with Dataforseo.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Dataforseo tool your agent needs.Free to start.

Start building
Dataforseo MCP Integration with Claude Agent SDK | Composio