Skip to main content
Glama
Wafle-Scraper

Wafle-Scraper

by creandoaldia
██╗    ██╗  █████╗  ███████╗██╗     ███████╗
██║    ██║ ██╔══██╗ ██╔════╝██║     ██╔════╝
██║ █╗ ██║ ███████║ █████╗  ██║     █████╗
██║███╗██║ ██╔══██║ ██╔══╝  ██║     ██╔══╝
╚███╔███╔╝ ██║  ██║ ██║     ███████╗███████║
 ╚══╝╚══╝  ╚═╝  ╚═╝ ╚═╝     ╚══════╝╚══════╝

Wafle-Scraper — Universal MCP Server for Safe Web Scraping

Wafle-Scraper is an MCP server that lets AI agents (OpenCode, Claude, Cursor) extract data from the web safely and responsibly.

Safety First

Rule

Enforcement

No private data

Every browser session is incognito — no cookies, no localStorage, no saved passwords

Only what you ask

The scraper never mines extra data beyond your explicit request

No localhost

Internal/private IPs are blocked by default

Rate limited

Minimum 2 seconds between requests — never floods servers

CAPTCHA = human only

No automated CAPTCHA solving. If one appears, you solve it interactively

User-Agent rotation

Each request looks like a real browser

Related MCP server: sessemi-mcp

Quick Start

pip install wafle-scraper
playwright install chromium
wafle-scraper

Configuration

OpenCode / Claude Desktop / Cursor

{
  "mcpServers": {
    "wafle-scraper": {
      "command": "wafle-scraper",
      "description": "Web scraping & browser automation — incognito, audited, safe"
    }
  }
}

CLI Options

wafle-scraper                    # MCP stdio mode (default for agents)
wafle-scraper --http --port 8000 # HTTP SSE mode
wafle-scraper --version          # Show version

MCP Tools

Tool

Description

Safety

scrape_url

Extract text from a static URL (requests + BeautifulSoup)

✅ Read-only, no JS

scrape_browser

Navigate a page in isolated incognito browser and extract text

✅ Incognito, no cookies

scrape_reddit

Fetch public posts from a subreddit via official API

✅ API, no scraping

extract_emails

Find email addresses on a public page

✅ Only what you ask

browser_interact

Click, type, scroll, extract, screenshot in live browser

✅ You control the actions

Browser Backend (Playwright)

  • Incognito always: storage_state=None, fresh context per session

  • No permissions: No camera, mic, location access

  • Anti-detection: Rotating UA, viewport, locale, timezone

  • Natural delays: Human-like timing between actions

  • Gradual scroll: Loads lazy content naturally

CAPTCHA Handling

Wafle-Scraper does NOT solve CAPTCHAs automatically. When a CAPTCHA is detected:

  1. The scraper pauses

  2. Prompts you to open the URL in your browser

  3. You solve the CAPTCHA manually

  4. Type done and the scraper continues

This is the only ethical and reliable approach without paid services.

Security

  • Blocked: localhost, 127.0.0.1, private IPs, file://, chrome://

  • Rate limiting (configurable, default 2s min interval)

  • Scope enforcement — only processes what you explicitly request

  • User-Agent rotation

  • Browser isolation — Playwright contexts are fully sandboxed

Requirements

  • Python 3.10+

  • Playwright with Chromium installed (playwright install chromium)

  • Windows, macOS, Linux

Dependencies

Standalone — no other MCP servers required.

Known Issues

Issue

Detail

Status

CDP health check unstable

_cdp_health_check() creates a throwaway context just to eval 1+1. Masks real CDP issues instead of diagnosing them.

🟡 Medium

CAPTCHA handler is interactive only

CAPTCHA solver relies on stdin — doesn't work in MCP server mode (no stdin available in stdio transport).

🔴 High

_safe_goto only 2 retries

No exponential backoff, no proxy fallback. If 2 attempts fail, the whole scrape fails.

🟡 Medium

Error strings instead of exceptions

browser_navigate, browser_click, etc. return "Error: ..." strings instead of raising. Consumers must parse strings.

🟡 Medium

Single browser context

Only 1 context at a time. Concurrent scrape_browser calls cause race conditions.

🔴 High

Reddit HTML fallback is silent

If JSON API fails, falls back to old.reddit.com without logging the fallback path.

🟢 Low

Installation from Source

git clone https://github.com/creandoaldia/wafle-scraper.git
cd wafle-scraper
pip install -e .
playwright install chromium

License

MIT

Why "Wafle-Scraper"?

Part of the WAFLE ecosystem (Web AI Framework for Language Ecosystems). Wafle-Scraper gives WAFLE agents the ability to read the live web — safely, transparently, and under your control.

Available Tools

5 tools
browser_interactC

Interact with the active browser page (click, type, extract).

Inputs: action (required), value, selector. Returns: result

extract_emailsB

Find email addresses on a public page.

Inputs: url (required). Returns: result

scrape_browserC

Navigate a page in an isolated incognito browser and extract text.

Inputs: url (required), scroll, wait_selector. Returns: result

scrape_redditB

Fetch public posts from a subreddit via the official Reddit API.

Inputs: subreddit (required), sort, limit. Returns: result

scrape_urlC

Extract readable text content from a static URL.

Inputs: url (required), extract_links, extract_images. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 5 tools

    Disambiguation4/5

    Most tools have clear purposes: extract_emails, scrape_reddit, and scrape_url are distinct. However, browser_interact and scrape_browser both involve browser interaction, potentially causing confusion despite different contexts (active page vs. isolated browser).

    Naming Consistency3/5

    Tools use snake_case but mix patterns: 'browser_interact' is noun_verb, while others like 'extract_emails' and 'scrape_browser' are verb_noun. The inconsistent placement of 'browser' in two tool names adds confusion.

    Tool Count5/5

    With 5 tools, the server covers static scraping, browser scraping, interaction, email extraction, and Reddit API access. This is a well-scoped set for a scraping-focused server.

    Completeness4/5

    The tool set covers core scraping needs: static URLs, dynamic pages, specific platform (Reddit), email extraction, and interaction. Minor gaps like handling pagination or form submission exist but are acceptable for this scope.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to scrape any website by providing tools for JavaScript rendering, antibot bypass, and automatic captcha solving. It supports synchronous, asynchronous, and batch scraping operations with built-in proxy rotation.
      5
      207 npm
      33 PyPI
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to scrape websites protected by Cloudflare, DataDome, and Akamai, bypassing anti-bot measures to retrieve page content.
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to perform web searches, fetch and extract page content, and crawl sites with caching, rate limiting, and robots.txt compliance, all without needing API keys.
      17
      649 PyPI
      2
      MIT