MrScraper for Claude

MrScraper connects Claude to a hosted MCP server for retrieving public web pages as HTML, Markdown, or screenshots, Google discovery, and account usage. The plugin also includes three focused skills that help Claude choose the right workflow and preserve raw page content.

What this plugin adds

• The hosted Streamable HTTP endpoint at https://mcp.mrscraper.com/mcp.
• OAuth 2.1 authentication through Claude; no credential is stored in this repository.
• OAuth access pinned to the scrape:read, scrape:write, and account:read scopes the tools need.
• A retrieve-first workflow that keeps raw page responses available for analysis, verification, and follow-up transformations.

Requirements

• A current version of Claude Code.
• A MrScraper account.
• Permission to access and process the target content.

Install

Add this repository as a marketplace and install the plugin:

claude plugin marketplace add mrscraper-com/mrscraper-claude-plugin
claude plugin install mrscraper@mrscraper-claude

In Claude's Add marketplace dialog, paste:

mrscraper-com/mrscraper-claude-plugin

If the dialog expects a full Git repository URL, use:

https://github.com/mrscraper-com/mrscraper-claude-plugin.git

Restart Claude or reload plugins after installation. Open /mcp if Claude asks you to authenticate, then complete the MrScraper OAuth flow in your browser. Never paste OAuth tokens or API keys into chat.

Try it

Fetch https://www.scrapethissite.com/pages/simple/ and summarize the page.

The connection should expose these MCP tools:

Tool	Purpose
scraperAPI	Retrieve a known page as HTML, Markdown, a screenshot, or a combination.
webSearch	Discover public pages through Google.
status	Inspect subscription status, token usage, and remaining tokens.

Retrieve-first routing

When a public URL is already known, the skills direct Claude to retrieve it with scraperAPI first and treat the raw response as the source of truth. Claude can read, summarize, compare, or derive structured output locally without losing details.

For roughly 100 known pages that share a layout, Claude can retrieve pages concurrently, retain every raw response, and apply one reusable local extractor.

Data and permissions

The plugin sends MCP tool inputs, including target URLs and search queries, to MrScraper's hosted service. Page responses and tool results are then available to Claude for the requested task. Use it only with public or otherwise authorized content, and follow the target site's requirements.

Review MrScraper's MCP documentation, Privacy Policy, and Acceptable Use Policy before use.

Update or remove

claude plugin marketplace update mrscraper-claude
claude plugin update mrscraper@mrscraper-claude
claude plugin uninstall mrscraper@mrscraper-claude

Support and security

• Product help: MrScraper MCP documentation
• Bugs and feature requests: GitHub Issues
• Account help: support@mrscraper.com
• Security reports: see SECURITY.md

Development

The repository is both an installable Claude marketplace and the source of the mrscraper plugin:

.claude-plugin/marketplace.json
plugins/mrscraper/
├── .claude-plugin/plugin.json
├── .mcp.json
└── skills/

Validate both manifests and all plugin components before a release:

claude plugin validate . --strict
claude plugin validate plugins/mrscraper --strict

The plugin uses semantic versions from its plugin manifest. Bump that version for every release and record user-visible changes in CHANGELOG.md. Use PUBLISHING.md for the release and Anthropic submission checklist.

License

MIT