Skip to main content

MCP server for Sessemi — scrape anti-bot protected sites from AI agents

Project description

sessemi-mcp

MCP server that gives AI agents the ability to scrape websites protected by Cloudflare, DataDome, and Akamai.

Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP-compatible client.

Zero framework dependencies — implements MCP protocol directly. Only depends on the sessemi Python client.

Install

pip install sessemi-mcp

Or run directly with uvx:

uvx sessemi-mcp

Setup

Get a free API key at app.sessemi.com.

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "sessemi": {
      "command": "uvx",
      "args": ["sessemi-mcp"],
      "env": {
        "SESSEMI_KEY": "your_api_key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "sessemi": {
      "command": "uvx",
      "args": ["sessemi-mcp"],
      "env": {
        "SESSEMI_KEY": "your_api_key"
      }
    }
  }
}

Tools

scrape

Scrape a URL, bypassing anti-bot protection. Returns page content.

Parameter Type Description
url string Target URL (required)
country string Two-letter country code for geo-targeting (FR, US, DE). Auto-selects residential proxies.
render bool Force browser rendering for JS-heavy pages
session string Session name for cookie/IP persistence across requests
headers string Custom HTTP headers as JSON string

credits

Check your remaining credit balance, tier, and usage.

Example

Ask Claude:

"Scrape the Idealista listings page for Madrid apartments"

Claude will call the scrape tool with the URL and country: "ES", get back the full HTML, and extract the data you need.

"How many credits do I have left?"

Claude calls credits and reports your balance.

How it works

Sessemi handles the hard parts automatically:

  • Cloudflare — turnstile challenges, JS challenges, managed challenges
  • DataDome — device checks, slider CAPTCHAs, interstitials
  • Akamai — sensor validation, bot manager

Your AI agent sends a URL → Sessemi returns the page content. No browser config, no proxy setup, no CAPTCHA services.

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sessemi_mcp-0.1.0.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sessemi_mcp-0.1.0-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file sessemi_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: sessemi_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.0

File hashes

Hashes for sessemi_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 3e68d502156dc5451cf19befcb9ed7e6033aa71f7752f380ea8a02252f7bb746
MD5 34ca2b49e9fbc0347175d1a052b159f8
BLAKE2b-256 3755cfd4b59ecc511b63587ca6abc0a45619c2fdb2632b76b2eae04eeb4be6e7

See more details on using hashes here.

File details

Details for the file sessemi_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: sessemi_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.0

File hashes

Hashes for sessemi_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8b77543e0c721e92e0e6a012c02ede452bc31f5be2150f669cd807a4f4d00d63
MD5 7204381afe9cbea8bdf61e4fcddb230b
BLAKE2b-256 c33a04ad17ba81633c5f01e1dce9c2eb69a08ea7825abd97f2282f68eb06f546

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page