How to connect Simplescraper MCP to Claude

Connect Claude Web, Desktop and Cowork to Simplescraper MCP. Create a recipe to extract product prices, scrape latest news headlines from example.com, and more using natural language, with authentication handled for you.

Simplescraper MCP logoSimplescraper MCP
Dcr Oauth

Simplescraper MCP is a web scraping service that creates scraping recipes and extracts structured site data. Use it to pull up-to-date structured web data without managing scrapers.

13 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Simplescraper account to Claude via Composio Connect, enabling it to create a recipe to extract product prices, scrape latest news headlines from example.com, fetch job listings from careers page, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Simplescraper MCP with

Connecting Simplescraper to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Simplescraper account

Back in Claude, ask it to connect to Simplescraper or give it any Simplescraper-related task.

For example, ask Claude to:

  • "Create a recipe to extract product prices"
  • "Scrape latest news headlines from example.com"
  • "Fetch job listings from careers page"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Simplescraper account is ready to use.

What is the Simplescraper Claude Connector, and what's possible with it?

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

Troubleshooting

1. Why does Claude not use the Composio connector for Simplescraper?

The connector can show as connected, but Claude must use it in each Simplescraper conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Simplescraper again.

2. Why does Claude show an MCP server error before Simplescraper connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Simplescraper.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Simplescraper.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Simplescraper authorization link not work?

The Composio connector is one server. Your Simplescraper account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Simplescraper connection.
  • Composio creates a fresh Simplescraper authorization link.
  • Open that link in your browser and finish the Simplescraper sign-in.

4. Why do Simplescraper actions fail after they worked before?

The Simplescraper connection can expire or lose permission.

  • Ask Claude to inspect the Simplescraper connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Simplescraper account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Simplescraper.
  • If the action still fails with a permission error, check that the connected account has that permission in Simplescraper itself.

5. How do I switch to a different Simplescraper account?

Claude can manage the Simplescraper connection for you.

  • Ask Claude to disconnect or delete the current Simplescraper account.
  • Ask Claude to connect Simplescraper again.
  • Open the new Composio authorization link for Simplescraper.
  • Sign in with the other Simplescraper account in the browser.
  • After the account connects, ask Claude to retry the Simplescraper task.

6. Why is my Simplescraper connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Simplescraper connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Simplescraper tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Simplescraper.
TOOLS

Supported Tools

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

Create recipe

Create a new scrape recipe with a name, URL, and selectors.

Extract markdown

Fetch one page and return its body as clean Markdown.

Extract urls

Discover all page URLs on a website by parsing its sitemap (and the sitemap index if present).

Get latest results

Get the most recent scraped results for a recipe.

Get recipe

Retrieve full details of a specific scrape recipe: name, URL, creation date, last run time, and selectors.

Get results

Fetch the scraped data from a specific run by results_id.

Get results history

List previous scrape runs for a recipe.

List recipes

List the user's scrape recipes, with optional filters by domain, name keyword, or recent activity, and sorting by creation date, last-run, or name.

Run recipe

Run a scrape recipe to extract fresh data from its configured URL.

Screenshot

Capture a screenshot of a web page (1 credit per request).

Smart extract

Extract specific named fields from one page using AI.

Update batch urls

Add or replace the list of batch (crawler) URLs for a recipe.

Update recipe

Update an existing scrape recipe's name, URL, or selectors.

FAQ

Frequently asked questions

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

Yes, you can. Claude Cowork 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 Simplescraper tools.

Yes, absolutely. You can configure which Simplescraper 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 Simplescraper data and credentials are handled as safely as possible.

Start with Simplescraper MCP.It takes 30 seconds.

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

Start building