How to integrate Scrapegraph ai MCP with Atomic Agent

Connect Atomic Agent to Scrapegraph ai MCP. Extract product prices from amazon search results, summarize latest news headlines from bbc homepage, and more using natural language, with authentication handled for you.

Scrapegraph ai logoScrapegraph ai
Api Key

Scrapegraph ai is an AI-powered web scraping API that lets you extract structured data from any website using natural language prompts. Easily turn web pages into ready-to-use data for your apps and agents.

27 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Scrapegraph ai.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Scrapegraph ai account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Scrapegraph ai with

How Atomic Agent connects to Scrapegraph ai

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Scrapegraph ai to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Scrapegraph ai. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Scrapegraph ai account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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

The Scrapegraph ai MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Scrapegraph ai account. It provides structured and secure access to powerful web scraping and data extraction tools, so your agent can perform actions like running AI-powered scrapers, converting webpages to markdown, monitoring job statuses, and managing your account usage with ease.

  • AI-powered web scraping and search: Instruct your agent to extract structured data from any website or perform detailed web searches with parsed, organized results.
  • Webpage to markdown conversion: Let your agent instantly convert any webpage into clean, readable markdown for easy documentation or analysis.
  • Automated job status tracking: Check on the progress and results of ongoing scraping, crawling, or conversion jobs to stay updated without manual effort.
  • Smart multi-page crawling: Direct the agent to launch intelligent crawlers that gather data across multiple linked pages in a single workflow.
  • Account usage monitoring and feedback: Retrieve your remaining credits, track API usage, and submit feedback on completed tasks—all through your AI agent.

Use Scrapegraph ai from Atomic Agent

With your account connected, ask Atomic Agent to work with Scrapegraph ai in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

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

Convert Webpage to Markdown (V2)

Tool to convert any webpage into clean, well-formatted Markdown with full parameter control.

Generate Schema

Generate or modify a JSON schema based on a search query for structured data extraction.

Get Agentic Scraper History

Retrieve paginated history of agentic scraper jobs.

Get Crawler History

Retrieve the history of crawler jobs for your account.

Get Credits

Retrieve credit information for your ScrapeGraphAI account, including remaining credits and usage.

Get Endpoint Suggestions

Tool to get AI-powered suggestions for creating scraping endpoints.

Get Live Session URL

Tool to get a URL for a live browser session.

Get Markdownify History

Tool to retrieve the history of markdownify webpage-to-Markdown conversion jobs.

Get Scrape History

Retrieve the history of scrape jobs from your ScrapeGraphAI account.

Get Searchscraper History

Get the history of searchscraper jobs with pagination support.

Get Sitemap History

Tool to retrieve the history of sitemap extraction jobs.

Get Smartscraper History

Tool to retrieve the history of smartscraper jobs.

Get Usage Timeline

Tool to retrieve usage timeline statistics for your ScrapeGraphAI account.

Get Webhook Logs

Retrieve webhook delivery logs for a crawler job.

List Scheduled Jobs

Retrieve a paginated list of all scheduled scraping jobs for your account.

Markdownify Status

Check the status and retrieve results of a Markdownify webpage-to-Markdown conversion job.

Save Endpoint Configuration

Tool to save custom scraping endpoint configurations to ScrapeGraphAI.

Search Scraper

Perform web searches and scrape results, with AI-powered structured extraction or raw Markdown content.

Check SearchScraper Status

Check the status and results of an asynchronous SearchScraper job.

SmartCrawler Status

Check the status and retrieve results of a SmartCrawler web crawling job.

Start Smart Scraper

Extract structured JSON from one URL, HTML document, or Markdown document using ScrapeGraphAI v2.

Look Up SmartScraper Request

Retrieve the v2 History record for a SmartScraper Extract request ID.

Start Smart Crawler (Async)

Start a multi-page SmartCrawler job for AI-powered structured data extraction or markdown conversion.

Submit Feedback

Submit feedback and ratings for completed ScrapeGraphAI requests.

Submit Product Feedback

Submit product feedback for ScrapeGraphAI.

Convert JSON to TOON Format

Convert a JSON object to TOON (Token-Oriented Object Notation) for compact LLM processing while maintaining data structure.

Validate API Key

Check whether your ScrapeGraphAI API key is valid and authorized for use before making other API calls.

FAQ

Frequently asked questions

Start with Scrapegraph ai.It takes 30 seconds.

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

Start building