Skip to main content
Glama
robot-resources

Robot Resources Scraper

npm version License: MIT

@robot-resources/scraper-mcp

⚠️ VERALTET — integriert in @robot-resources/scraper. Dieser MCP-Server wird jetzt als integrierte scraper-mcp-Binärdatei innerhalb des Haupt-Scraper-Pakets ausgeliefert. Installieren Sie ein Paket und erhalten Sie das MCP. Automatische Konfiguration über npx robot-resources --for=cursor oder npx robot-resources --for=claude-code. Die Tools (scraper_compress_url, scraper_crawl_url) und die unten aufgeführten Parameter sind unverändert.

MCP-Server für Scraper — Kontextkompression für KI-Agenten.

Was ist Robot Resources?

Human Resources, aber für Ihre KI-Agenten.

Robot Resources verleiht KI-Agenten zwei Superkräfte:

  • Router — Leitet jeden LLM-Aufruf an das günstigste fähige Modell weiter. 60-90 % Kosteneinsparungen bei OpenAI, Anthropic und Google.

  • Scraper — Komprimiert Webseiten zu sauberem Markdown. 70-80 % weniger Token pro Seite.

Beides läuft lokal. Ihre API-Schlüssel verlassen niemals Ihren Rechner. Kostenlos, unbegrenzt, keine Stufen.

Installieren Sie die komplette Suite

npx robot-resources

Ein Befehl richtet alles ein. Erfahren Sie mehr unter robotresources.ai


Related MCP server: Scraper MCP

Über diesen MCP-Server

Dieses Paket stellt KI-Agenten zwei Tools zur Verfügung, um Webinhalte über das Model Context Protocol in token-effizientes Markdown zu komprimieren: Einzelseiten-Kompression und mehrseitiges BFS-Crawling.

Installation

npx @robot-resources/scraper-mcp

Oder global installieren:

npm install -g @robot-resources/scraper-mcp

Claude Desktop-Konfiguration

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "scraper": {
      "command": "npx",
      "args": ["-y", "@robot-resources/scraper-mcp"]
    }
  }
}

Tools

scraper_compress_url

Komprimieren Sie eine einzelne Webseite in Markdown mit 70-90 % weniger Token.

Parameter:

Parameter

Typ

Erforderlich

Standard

Beschreibung

url

string

ja

—

Zu komprimierende URL

mode

string

nein

'auto'

'fast', 'stealth', 'render' oder 'auto'

timeout

number

nein

10000

Abruf-Timeout in Millisekunden

maxRetries

number

nein

3

Maximale Wiederholungsversuche (0-10)

Beispiel-Prompt: "Komprimiere https://docs.example.com/getting-started"

scraper_crawl_url

Crawlen Sie mehrere Seiten von einer Start-URL aus unter Verwendung der BFS-Link-Erkennung.

Parameter:

Parameter

Typ

Erforderlich

Standard

Beschreibung

url

string

ja

—

Start-URL zum Crawlen

maxPages

number

nein

10

Maximale Anzahl der zu crawlendenden Seiten (1-100)

maxDepth

number

nein

2

Maximale Link-Tiefe (0-5)

mode

string

nein

'auto'

'fast', 'stealth', 'render' oder 'auto'

include

string[]

nein

—

Einzuschließende URL-Muster (Glob)

exclude

string[]

nein

—

Auszuschließende URL-Muster (Glob)

timeout

number

nein

10000

Timeout pro Seite in Millisekunden

Beispiel-Prompt: "Crawle die Dokumentation unter https://docs.example.com mit maximal 20 Seiten"

Abrufmodi

Modus

Wie

Verwendung bei

'fast'

Einfaches HTTP

Standard-Websites, APIs, Dokumentationen

'stealth'

TLS-Fingerabdruck-Impersonation

Anti-Bot-geschützte Websites

'render'

Headless-Browser (Playwright)

JS-gerenderte SPAs

'auto'

Schnell → Stealth-Fallback bei 403/Challenge

Unbekannte Websites (Standard)

Stealth erfordert impit und Render erfordert playwright als Peer-Abhängigkeiten von @robot-resources/scraper.

Anforderungen

  • Node.js 18+

Verwandtes

Lizenz

MIT

Available Tools

2 tools
scraper_compress_urlB

Compress web content from a URL for reduced token usage. Returns markdown with 70-90% fewer tokens than raw HTML.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYesURL to compress
modeNoFetch mode: 'fast' (plain HTTP), 'stealth' (TLS fingerprint), 'render' (headless browser), 'auto' (fast with fallback). Default: 'auto'
timeoutNoFetch timeout in milliseconds (default: 10000)
maxRetriesNoMax retry attempts (default: 3)

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions the token reduction benefit but fails to disclose critical traits like rate limits, authentication needs, error handling, or what happens with invalid URLs. The description is minimal and does not compensate for the lack of annotations, leaving significant gaps in understanding the tool's behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is highly concise and front-loaded, consisting of two sentences that directly state the tool's function and outcome without any fluff. Every sentence earns its place by delivering essential information efficiently, making it easy to grasp the tool's purpose quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of a tool with 4 parameters, no annotations, and no output schema, the description is incomplete. It lacks details on behavioral aspects, error cases, and output format beyond 'markdown,' failing to provide sufficient context for safe and effective use. The description does not compensate for the absence of structured data, leaving key operational questions unanswered.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, providing clear details for all parameters (url, mode, timeout, maxRetries). The description adds no additional parameter semantics beyond what the schema already explains, such as usage examples or implications of mode choices. Thus, it meets the baseline score of 3, as the schema adequately covers parameter information.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with a specific verb ('compress') and resource ('web content from a URL'), and distinguishes it from its sibling 'scraper_crawl_url' by focusing on token reduction rather than crawling. It explicitly mentions the outcome: 'Returns markdown with 70-90% fewer tokens than raw HTML.'

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus its sibling 'scraper_crawl_url' or any alternatives. It lacks context about prerequisites, such as when compression is beneficial or when to choose specific modes, offering only a basic functional statement without comparative or exclusionary advice.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

scraper_crawl_urlA

Crawl multiple pages from a starting URL using BFS link discovery. Returns compressed markdown for each page with 70-90% fewer tokens than raw HTML.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYesStarting URL to crawl
maxPagesNoMax pages to crawl (default: 10)
maxDepthNoMax link depth (default: 2)
modeNoFetch mode: 'fast' (plain HTTP), 'stealth' (TLS fingerprint), 'render' (headless browser), 'auto' (fast with fallback). Default: 'auto'
includeNoURL patterns to include (glob)
excludeNoURL patterns to exclude (glob)
timeoutNoPer-page timeout in milliseconds (default: 10000)

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden and does well by disclosing key behavioral traits: the BFS crawling algorithm, multi-page scope, and the 70-90% token reduction in output. It doesn't mention rate limits, authentication needs, or error handling, but provides substantial operational context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences that efficiently convey the core functionality and key output characteristic. Every word earns its place with no redundancy or unnecessary elaboration. The description is front-loaded with the primary action and scope.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 7-parameter tool with no annotations and no output schema, the description provides good operational context but lacks details about return format structure, error conditions, or performance characteristics. It mentions compressed markdown output but doesn't describe the data structure or pagination approach.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds no parameter-specific information beyond what's already in the schema descriptions. It mentions 'starting URL' which is covered by the url parameter description, but doesn't elaborate on parameter interactions or usage patterns.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with specific verbs ('crawl multiple pages', 'returns compressed markdown') and resources ('starting URL', 'BFS link discovery'). It distinguishes from the sibling tool scraper_compress_url by emphasizing multi-page crawling rather than single-page compression.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage context through 'crawl multiple pages' and 'starting URL', suggesting this is for web scraping tasks. However, it doesn't explicitly state when to use this tool versus the sibling scraper_compress_url or other alternatives, nor does it provide exclusion criteria.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

  1. 2 tool updatesv0.1.2
    • First observedscraper_compress_url
    • First observedscraper_crawl_url

TDQS

B3.4/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: scraper_compress_url handles single-page compression, while scraper_crawl_url performs multi-page crawling with BFS link discovery. There is no overlap or ambiguity between them.

Naming Consistency5/5

Both tools follow a consistent verb_noun pattern (scraper_compress_url and scraper_crawl_url), using the same prefix and snake_case style throughout. The naming is predictable and uniform.

Tool Count2/5

With only two tools, the server feels thin for a scraper domain, lacking essential operations like error handling, configuration, or content filtering. This minimal set may limit agent workflows and cause dead ends.

Completeness2/5

The tool surface is severely incomplete for web scraping; it misses basic CRUD-like operations such as updating crawl parameters, deleting cached data, or retrieving specific page elements. Agents will struggle with incomplete coverage.

Maintenance

ActivitySlowing
ResponsivenessSyncing

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Fast, token-efficient web content extraction tool that converts websites to clean Markdown for AI agents, featuring smart caching, content extraction with Mozilla Readability, and polite crawling capabilities.
    1
    503 npm
    161
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    A context-optimized web scraping server that converts HTML to markdown/text and applies CSS selectors server-side, reducing token usage by 70-90% while providing AI tools with clean, filtered web content.
    7
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Fetches web pages and converts them to clean, readable markdown format by extracting main content while removing navigation, ads, and other non-essential elements to minimize token usage.
    4
    -
  • A
    license
    A
    quality
    B
    maintenance
    Converts any URL to clean, token-efficient Markdown for AI agents. Strips ads, navigation, and scripts. Supports CSS selectors, batch processing (10 URLs), token counting, and smart caching.
    3
    3 npm
    MIT