Skip to content
MCP server

Scrape.ly

Find, run and read results from Scrape.ly Actors inside any MCP client

Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.3.15
Listing updated
3 days ago

About Scrape.ly

Scrape.ly is a freemium MCP server for web search and scraping. It can run locally on your machine or as a hosted remote server.

Tools are grouped into categories: actors, docs, runs and storage. A --tools flag swaps the default set for the categories or tool names you pick, and --actors user/actor can expose a specific Actor as its own tool.

The hosted endpoint at mcp.scrape.ly uses streamable HTTP and signs you in with OAuth 2.1 and PKCE, or accepts a bearer token from the dashboard. Agents without an account can pay per call in USDC through x402. A Python package, scrapely-mcp, runs the same server over stdio for clients that cannot reach a remote server.

The server acts with your token's permissions, so an agent can start paid runs. The docs suggest scoped API keys, such as a read-only preset, to limit what it can do.

Install

Run in a terminal

claude mcp add --transport http scrapely-mcp-server https://mcp.scrape.ly

Add to Settings → Connectors → Add custom connector

https://mcp.scrape.ly
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "scrapely-mcp-server": {
      "url": "https://mcp.scrape.ly"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "scrapely-mcp-server": {
      "type": "http",
      "url": "https://mcp.scrape.ly"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "scrapely-mcp-server": {
      "serverUrl": "https://mcp.scrape.ly"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "scrapely-mcp-server": {
      "type": "http",
      "url": "https://mcp.scrape.ly"
    }
  }
}

Configuration

  • SCRAPELY_TOKENScrape.ly API token
  • SCRAPELY_API_BASE_URLScrape.ly API origin

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

search-actors
Search the Store for Actors.
fetch-actor-details
Read details of an Actor.
call-actor
Run an Actor.
search-scrapely-docs
Search the documentation.
fetch-scrapely-docs
Fetch a documentation page.
get-actor-run
Read the state of a run.
get-actor-output
Read a run's output.
get-actor-run-list
List runs.
get-actor-log
Read a run's log.
abort-actor-run
Stop a running Actor.
get-dataset
Read dataset metadata.
get-dataset-items
Read items from a dataset.
get-dataset-schema
Read a dataset's schema.
get-key-value-store
Read a key-value store.

What it does

Actor search and run
Look up Actors in the Store, read their details and start them with call-actor.
Run monitoring
Check run status, list recent runs, read logs or abort a run.
Dataset and store access
Read dataset items and schemas and key-value store records from finished runs.
OAuth or token sign-in
Connect with OAuth, a bearer token or a query-parameter token.
Scoped API keys
Limit an agent to permissions such as actors:run and datasets:read.
Remote or local
Use the hosted endpoint or the stdio Python package.

Good for

  • Run a Google Maps or social scraper from a chat and read the results back
  • Let an agent poll a long scraping run and fetch its log
  • Give a read-only key to an agent that only needs to inspect stored datasets
  • Search the Scrape.ly docs from within the coding assistant

Pricing

Freemium, from $19 a month

Free plan with $5 monthly usage; Starter $19/mo, Scale $199/mo, Business $999/mo

Prices change. Check scrape.ly before you buy.

Scrape.ly FAQ

How do I authenticate?

Use OAuth when your client supports it, a bearer token from Settings, API & Integrations, or a token in the URL query string. The docs advise a header over the query string because URLs end up in logs.

Can I restrict what the agent does?

Yes. Create a scoped API key, for example the read-only preset, or limit it to actors:run, runs:read, datasets:read and keyValueStores:read.

Is there a local version?

Yes. The scrapely-mcp Python package runs over stdio and reads SCRAPELY_TOKEN from the environment.

Does the MCP server cost extra?

The pricing page lists the MCP server on every plan, including Free, which comes with $5 of usage a month. Runs themselves are billed from your prepaid balance.

Is Scrape.ly free?

Scrape.ly has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

How do I add Scrape.ly to Claude Code?

Run this command in your terminal: claude mcp add --transport http scrapely-mcp-server https://mcp.scrape.ly

What are the best alternatives to Scrape.ly?

The closest alternatives to Scrape.ly are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.

Alternatives to Scrape.ly

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. Search AI tools, agents and MCP servers and get install configs from inside your AI assistant.

    • 4 tools
    • Remote
    • Free
    • Developer tools
  6. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce