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

# Simplescraper

> Automate web scraping and data extraction tasks

The Simplescraper MCP Server connects AI agents in Caylex to Simplescraper's powerful web scraping platform, enabling seamless extraction of structured data from any website. Agents can manage scraping recipes — collections of CSS selectors that define what data to pull from a page — as well as execute scrapes on demand and retrieve results. Beyond selector-based scraping, the server also supports AI-powered smart extraction that requires no CSS knowledge, making it accessible for a wide range of data collection tasks. Common use cases include competitor analysis, market research, content monitoring, and real-time data retrieval, all orchestrated automatically through your Caylex agents.

<Warning>
  **Prerequisites:**

  * A Simplescraper account is required; OAuth authentication must be completed to link your account.
  * Some features (such as integrations in Claude) may require a specific Simplescraper plan — verify your plan supports API/MCP access before connecting.
</Warning>

<Note>
  **Important API details:**

  * Authentication is handled via OAuth — users must complete the Simplescraper OAuth login flow when connecting the server in Caylex.
  * Recipes define the structure of a scrape using CSS selectors; they can be created, updated, and managed entirely through the available tools.
  * The smart\_extract tool uses AI to extract data without requiring CSS selectors, offering a simpler alternative to recipe-based scraping.
  * Batch operations are supported for managing and scraping multiple URLs at once via update\_batch\_urls.
</Note>

## Server Details

| Property        | Value                                                                |
| --------------- | -------------------------------------------------------------------- |
| **Transport**   | Streamable HTTP                                                      |
| **Server Type** | External                                                             |
| **Endpoint**    | [https://mcp.simplescraper.io/mcp](https://mcp.simplescraper.io/mcp) |
| **Categories**  | Web Scraping, Web Scraping & Browser Automation                      |

## Authentication

This server supports the following authentication method:

### Header Authentication

This server authenticates via HTTP headers. During the server onboarding flow, you will be prompted to confirm the required headers. Note that you do not provide the values for the headers during the server on-boarding.
Header values are provided by the users during the [Auth Link](/auth/auth-links) flow.

## Getting Started

<Steps>
  <Step title="Add the server">
    Navigate to the **Server Library** and click on the **New Server** button. Find **Simplescraper** in the Caylex Catalog.
  </Step>

  <Step title="Server Onboarding flow">
    Go through the server onboarding flow.
  </Step>

  <Step title="Use in a project">
    Add the server to a [project](https://app.caylex.dev/projects) by configuring project connections. Its tools are now available to any agents connected to that project.
  </Step>
</Steps>

## Related Servers

<CardGroup cols={2}>
  <Card title="Firecrawl" href="/server-catalog/firecrawl" icon="https://d338mlbnszozgc.cloudfront.net/logos/firecrawl.svg" />

  <Card title="Bright Data" href="/server-catalog/bright-data" icon="https://d338mlbnszozgc.cloudfront.net/logos/brightdata.png" />

  <Card title="Apify" href="/server-catalog/apify" icon="https://d338mlbnszozgc.cloudfront.net/logos/apify.svg" />
</CardGroup>

## References

<CardGroup cols={1}>
  <Card title="https://simplescraper.io/docs/mcp-server" href="https://simplescraper.io/docs/mcp-server" icon="arrow-up-right-from-square" />
</CardGroup>