We and selected third parties use cookies or similar technologies for technical purposes and, with your consent, to analyze how the site is used.

You can freely give, refuse or withdraw your consent at any time.

Geonode Scraper API

MCP server by Geonode

Extract web pages as Markdown or HTML, with crawl, map, search and batch jobs available using a Geonode API key.

Sign-in optional (Works without an account; sign in for more)Streamable HTTP

Connect to Geonode Scraper API

Sign-in is optional. Connect with Geonode Scraper API’s own URL:

https://scraper.geonode.io/mcp

It works without signing in. Sign in with Geonode for more access.

Share this server

Opens this page, with the URL and setup steps.

mcp.tc/i/geonode-scraper-api

About

Connects an assistant to Geonode's Scraper API. The extract tool fetches a web page and returns Markdown or HTML, with options for JavaScript rendering, proxy geo-targeting, custom headers and browser wait controls. With an API key, the server also exposes crawl, map, search, batch and job history tools.

Runs as a hosted streamable HTTP endpoint at https://scraper.geonode.io/mcp. No sign-in or API key is needed to use extract anonymously, which is synchronous only, has no JavaScript rendering and has a small per-client rate and daily limit. A Geonode API key sent in the X-Api-Key header removes these limits and unlocks the other tools.

What you can do

  • Extract page content as Markdown or HTML
  • Render JavaScript-heavy pages with a headless browser (API key)
  • Geo-target requests through proxies (API key)
  • Crawl and map websites (API key)
  • Search the web and run batch jobs (API key)
  • Poll asynchronous job status (API key)

Tools 16

  • extractRead-only

    Extract a web page as HTML or Markdown, with optional JS rendering, geo-targeting and custom…

  • jobRead-only

    Get an extraction job

  • jobsRead-only

    List extraction jobs

  • statisticsRead-only

    Get extraction statistics

  • batchWrites

    Start a batch extraction

  • batch_statusRead-only

    Get batch status and results

  • cancel_batchCan delete

    Cancel a batch job

  • crawlWrites

    Start a site crawl

  • crawl_statusRead-only

    Get crawl status and results

  • cancel_crawlCan delete

    Cancel a crawl job

  • mapRead-only

    Map a site's URLs

  • map_jobsRead-only

    List map jobs

Show 4 more tools
  • map_jobRead-only

    Get a map job

  • searchRead-only

    Search the web

  • search_jobsRead-only

    List search jobs

  • search_jobRead-only

    Get a search job

Read from the live server on 18 Nov 2026. Read-only, Writes and Can delete are hints the server declares; your client decides whether to ask before running a tool.

Example prompts

  • Extract the content of this product page as Markdown.

  • Fetch https://example.com/docs and summarize the page.

  • Crawl the official React documentation and list its main sections.

  • Check whether my extraction job has finished.

Set up

Every client connects to scraper.geonode.io. Pick yours; the page remembers your choice.

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport http geonode-scraper-api https://scraper.geonode.io/mcp
  1. Start Claude Code and type /mcp. geonode-scraper-api should show as connected. To sign in for more access, pick it and choose Authenticate.

Add --scope user to make it available in every project, not just this one. Works without a key. An API key from Geonode raises the limits: send it as X-Api-Key: <YOUR_API_KEY>.

Claude Desktop

  1. Open Customize → Connectors, click + Add, then Add custom connector.
  2. Name it Geonode Scraper API and paste this URL:
https://scraper.geonode.io/mcp
  1. Click Add, then Connect. Signing in to Geonode is optional.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

claude.ai

  1. Open the connector form on claude.ai. This button fills in the name and URL for you:
  1. Check that the URL reads https://scraper.geonode.io/mcp and click Add.
  2. Click Connect. Signing in to Geonode is optional.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under Organization settings → Connectors.

ChatGPT

  1. On chatgpt.com, go to Plugins, select +, then Add custom MCP server.
  2. Enter a name for the server.
  3. Under Connection, paste https://scraper.geonode.io/mcp as the server URL, then for authentication choose No authentication, or OAuth to sign in to Geonode for more access.
  4. Check I understand and want to continue, then select Create as a plugin.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

Cursor

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "mcpServers": {
    "geonode-scraper-api": {
      "url": "https://scraper.geonode.io/mcp"
    }
  }
}

Works without a key. An API key from Geonode raises the limits: send it as X-Api-Key: <YOUR_API_KEY>.

VS Code

Or from a terminal:

code --add-mcp '{"name":"geonode-scraper-api","type":"http","url":"https://scraper.geonode.io/mcp"}'

Or commit it to the repo in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "geonode-scraper-api": {
      "type": "http",
      "url": "https://scraper.geonode.io/mcp"
    }
  }
}

Works without a key. An API key from Geonode raises the limits: send it as X-Api-Key: <YOUR_API_KEY>.

Devin Desktop

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "geonode-scraper-api": {
      "serverUrl": "https://scraper.geonode.io/mcp"
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads serverUrl (or url) for remote servers. Works without a key. An API key from Geonode raises the limits: send it as X-Api-Key: <YOUR_API_KEY>.

Codex

codex mcp add geonode-scraper-api --url https://scraper.geonode.io/mcp

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.geonode-scraper-api]
url = "https://scraper.geonode.io/mcp"

Works without a key. An API key from Geonode raises the limits: send it as X-Api-Key: <YOUR_API_KEY>.

Gemini CLI

gemini mcp add --transport http geonode-scraper-api https://scraper.geonode.io/mcp

Then, inside Gemini CLI, run /mcp auth geonode-scraper-api to sign in (optional).

This adds it to the current project. Add -s user to use it everywhere. Works without a key. An API key from Geonode raises the limits: send it as X-Api-Key: <YOUR_API_KEY>.

Any client

Most clients accept this shape. Some name the URL field differently: serverUrl in Devin Desktop, httpUrl in Gemini CLI’s settings file.

{
  "mcpServers": {
    "geonode-scraper-api": {
      "type": "http",
      "url": "https://scraper.geonode.io/mcp"
    }
  }
}

Zed puts servers under context_servers in its settings. Cline needs "type": "streamableHttp", or it assumes SSE.

Client only starts local servers? Bridge it with npx -y mcp-remote https://scraper.geonode.io/mcp.

Works without a key. An API key from Geonode raises the limits: send it as X-Api-Key: <YOUR_API_KEY>.

Embed

Show Geonode Scraper API in a README or on your site. Each embed links to this page, uses the server’s own URL, and sets no cookies. How embeds work

The card, the iframe and the JSON are in English. Add ?lang=it, fr, de or es to their address for another language.

README badge

Badge preview, lightBadge preview, dark
Markdown
[![Geonode Scraper API on mcp.tc](https://mcp.tc/i/geonode-scraper-api/badge.svg)](https://mcp.tc/i/geonode-scraper-api)
HTML
<a href="https://mcp.tc/i/geonode-scraper-api"><img src="https://mcp.tc/i/geonode-scraper-api/badge.svg" alt="Geonode Scraper API on mcp.tc" height="20"></a>

It follows the reader’s light or dark mode. Add ?theme=light or ?theme=dark to fix it, or ?style=compact to show the mark without the word.

Website card

HTML
<script src="https://mcp.tc/w/geonode-scraper-api.js" async></script>

The card appears where the tag is. Add data-theme="dark" or data-size="compact" to the tag to change it. The file holds everything it needs, so it makes no other requests and sets no cookies.

iframe

HTML
<iframe src="https://mcp.tc/embed/geonode-scraper-api" title="Geonode Scraper API on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Use it on pages that don’t allow scripts. Add ?theme=light or ?theme=dark to the address to fix the colors.

JSON

The listing as data for your own pages and tools: name, tagline, the server’s own URL, tools and the “Add to” links. Any site can read it (CORS is open).

https://mcp.tc/i/geonode-scraper-api.json

What each field means

AI prompt

Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the Geonode Scraper API card to your site.

Markdown
Add the mcp.tc card for Geonode Scraper API, an MCP server, to my website. It is one static script: no build step, no package to install, no cookies.

Put this tag where the card should appear. The card renders right before it:

```html
<script src="https://mcp.tc/w/geonode-scraper-api.js" async></script>
```

To show the card somewhere else, put this placeholder there and load the same script once, for example before `</body>`. Keep the link inside: visitors without JavaScript see it.

```html
<div data-mcptc="geonode-scraper-api"><a href="https://mcp.tc/i/geonode-scraper-api">Geonode Scraper API on mcp.tc</a></div>
```

Options:
- `data-theme="light"` or `"dark"` on the tag or the placeholder fixes the colors. Without it, the card follows the visitor’s light or dark mode.
- `data-size="compact"` gives a smaller card without the tagline.
- The CSS variable `--mcptc-max-width` on the placeholder or a parent sets the width (default `520px`).
- `?lang=` on the script URL sets the card’s language: `en`, `it`, `fr`, `de` or `es`.

If the site has a Content Security Policy, allow `script-src https://mcp.tc` and `img-src data:` (the icon is inline).

For a README or other Markdown docs, use the badge instead:

```markdown
[![Geonode Scraper API on mcp.tc](https://mcp.tc/i/geonode-scraper-api/badge.svg)](https://mcp.tc/i/geonode-scraper-api)
```

Reference: https://mcp.tc/embed

Change history

We read this server’s tool list every 3 hours and record what changes. Last read 18 Nov 2026, 02:38 UTC.

Follow Geonode Scraper API and we’ll email you when something changes.

  1. , Automatic check

    1 tool changed.

    Details, 13 Nov 2026, 11:53 UTC

    Changed 1

    • searchinput schema
  2. , Automatic check

    3 tools changed.

    Details, 9 Nov 2026, 08:52 UTC

    Changed 3

    • jobsdescription and input schema
      Before

      List extraction jobs with optional filters. Filter by job ID, URL, status (pending, running, completed, failed), output format, or date range. Results are paginated; use 'page' and 'page_size' to navigate large result sets. Requires a Geonode API key, sent as the X-Api-Key header.

      After

      List extraction jobs with optional filters. Filter by full job ID (exact match), status (pending, running, completed, failed), output format, or date range. Results are paginated; use 'page' and 'page_size' to navigate large result sets. Requires a Geonode API key, sent as the X-Api-Key header.

      • Removed parameters: url
    • map_jobsdescription and input schema
      Before

      List map jobs for the authenticated user with optional filters. Filter by base URL (partial match), status (pending, running, completed, failed), or date range. Results are paginated; use 'page' and 'page_size' to navigate. Requires a Geonode API key, sent as the X-Api-Key header.

      After

      List map jobs for the authenticated user with optional filters. Filter by status (pending, running, completed, failed) or date range. Results are paginated; use 'page' and 'page_size' to navigate. Requires a Geonode API key, sent as the X-Api-Key header.

      • Removed parameters: url
    • search_jobsdescription and input schema
      Before

      List search jobs for the authenticated user with optional filters. Filter by query (partial match), status (pending, running, completed, failed), or date range. Results are paginated; use 'page' and 'page_size' to navigate. Requires a Geonode API key, sent as the X-Api-Key header.

      After

      List search jobs for the authenticated user with optional filters. Filter by status (pending, running, completed, failed) or date range. Results are paginated; use 'page' and 'page_size' to navigate. Requires a Geonode API key, sent as the X-Api-Key header.

      • Removed parameters: query
  3. , Automatic check

    1 tool changed.

    Details, 5 Nov 2026, 11:52 UTC

    Changed 1

    • searchdescription
      Before

      Run a web search and return ranked results. Supports locale targeting (a language code like 'en', a language-region tag like 'en-US', or 'all'), pagination via 'page', safe-search filtering, and restricting results to a recency window via 'time_range'. By default the service rotates across its engines and falls back on failure; set 'engine' to pin one engine with no fallback. Returns the result list, the engine that served it, query suggestions, and any spelling correction. Requires a Geonode API key, sent as the X-Api-Key header.

      After

      Run a web search and return ranked results. Supports locale targeting (a language code like 'en', a language-region tag like 'en-US', or 'all'), pagination via 'page', safe-search filtering, and restricting results to a recency window via 'time_range'. By default the service rotates across its engines and falls back on failure; set 'engine' to pin one engine with no fallback. Returns the result list, the engine that served it, query suggestions, and any spelling correction. An empty result list means the engine answered and found nothing; such a search is not charged. Requires a Geonode API key, sent as the X-Api-Key header.

  4. , Automatic check

    New version 1.0.1 (was 0.1.0). Reported by the server.

  5. , Automatic check

    15 tools added. Server instructions changed.

    New tool marked destructive, New server instructions

    Details, 27 Oct 2026, 08:42 UTC

    Added 15

    • batchWrites

      Start an asynchronous batch extraction job from an explicit list of URLs. Supports HTML and Markdown output formats, optional JavaScript rendering, proxy settings, custom headers, and the grouped wait_config browser wait policy. Omit wait_config or set it to null to keep adaptive browser settling for child extractions; send {} or concrete values to opt every child extraction into explicit mode. Returns a job ID that can be polled with the 'batch_status' tool. Requires a Geonode API key, sent as the X-Api-Key header.

    • batch_statusRead-only

      Retrieve the status and paginated results of a batch extraction job by its job ID. Returns item counts, invalid URLs, and the current page of per-URL extraction results. Requires a Geonode API key, sent as the X-Api-Key header.

    • cancel_batchCan delete

      Cancel a batch job by its job ID. Stops scheduling new batch items while allowing in-flight child extractions to drain. Requires a Geonode API key, sent as the X-Api-Key header.

    • cancel_crawlCan delete

      Cancel a crawl job by its job ID. Stops scheduling new crawl pages while allowing in-flight page work to drain. Requires a Geonode API key, sent as the X-Api-Key header.

    • crawlWrites

      Start a website crawl job from a seed URL. Crawls pages breadth-first (BFS) up to the 'depth' parameter (BFS levels from the seed) and the 'limit' parameter (maximum number of pages to crawl). Supports Markdown and HTML output formats, optional JavaScript rendering, proxy geo-targeting, domain filtering, and the grouped wait_config browser wait policy. Omit wait_config or set it to null to keep adaptive browser settling for page extractions; send {} or concrete values to opt every page extraction into explicit mode. Returns a job ID that can be polled with the 'crawl_status' tool. Requires a Geonode API key, sent as the X-Api-Key header.

    • crawl_statusRead-only

      Retrieve the status and results of a crawl job by its job ID. Returns the current status (queued, running, completed, or failed), page counts, and once completed, the crawled page results with extracted content. Results are paginated; use 'page' and 'page_size' to navigate. Requires a Geonode API key, sent as the X-Api-Key header.

    • jobRead-only

      Retrieve the result of an asynchronous extraction job by its job ID. Returns the current status (pending, running, completed, or failed) and, once completed, the extracted content and metadata. Use this tool to poll for results after submitting an extraction with processing_mode='async'. Requires a Geonode API key, sent as the X-Api-Key header.

    • jobsRead-only

      List extraction jobs with optional filters. Filter by job ID, URL, status (pending, running, completed, failed), output format, or date range. Results are paginated; use 'page' and 'page_size' to navigate large result sets. Requires a Geonode API key, sent as the X-Api-Key header.

    • mapRead-only

      Discover all URLs under a base URL by combining sitemap parsing with HTML link extraction from the seed page. By default discovery is scoped to the exact seed host (a leading 'www.' is treated as equivalent) and, when the URL includes a path, to URLs under that path; sibling subdomains and outbound links are excluded. Set include_subdomains=true to widen the scope to the whole registrable domain and probe common subdomains (docs, blog, help, support). The optional 'search' parameter filters the discovered URLs by case-insensitive substring match — it does NOT query a search engine. Runs synchronously and returns the discovered links immediately. Requires a Geonode API key, sent as the X-Api-Key header.

    • map_jobRead-only

      Retrieve the full details and discovered links for a map job by its job ID. Returns the current status and, once completed, the discovered links and their source. Requires a Geonode API key, sent as the X-Api-Key header.

    • map_jobsRead-only

      List map jobs for the authenticated user with optional filters. Filter by base URL (partial match), status (pending, running, completed, failed), or date range. Results are paginated; use 'page' and 'page_size' to navigate. Requires a Geonode API key, sent as the X-Api-Key header.

    • searchRead-only

      Run a web search and return ranked results. Supports locale targeting (a language code like 'en', a language-region tag like 'en-US', or 'all'), pagination via 'page', safe-search filtering, and restricting results to a recency window via 'time_range'. By default the service rotates across its engines and falls back on failure; set 'engine' to pin one engine with no fallback. Returns the result list, the engine that served it, query suggestions, and any spelling correction. Requires a Geonode API key, sent as the X-Api-Key header.

    • search_jobRead-only

      Retrieve the full details and results for a search job by its job ID. Returns the current status and, once completed, the search results, suggestions, and any spelling correction applied. Requires a Geonode API key, sent as the X-Api-Key header.

    • search_jobsRead-only

      List search jobs for the authenticated user with optional filters. Filter by query (partial match), status (pending, running, completed, failed), or date range. Results are paginated; use 'page' and 'page_size' to navigate. Requires a Geonode API key, sent as the X-Api-Key header.

    • statisticsRead-only

      Retrieve aggregated extraction statistics for the authenticated user. Returns metrics such as total jobs, success and failure counts, and usage breakdowns over the specified date range: at most 366 days, counted back from the end date (an older start date is moved up; an end date after now is moved back to now). Defaults to the last 30 days when no dates are provided. Requires a Geonode API key, sent as the X-Api-Key header.

    Server instructions

    Before

    Without an API key only the `extract` tool is listed. Without an API key, extraction is synchronous only, without JavaScript rendering or request headers other than Accept-Language, and limited to a small per-client rate and daily volume. An API key, sent as the X-Api-Key header, lifts these restrictions; the plan's own limits apply instead. With a key, all tools are listed.

    After

    Every tool is listed, but without an API key only `extract` runs. Without an API key, extraction is synchronous only, without JavaScript rendering or request headers other than Accept-Language, and limited to a small per-client rate and daily volume. An API key, sent as the X-Api-Key header, lifts these restrictions; the plan's own limits apply instead. The other tools require an API key.

  6. , Automatic check

    1 tool changed. Server instructions changed.

    New server instructions

    Details, 19 Oct 2026, 19:37 UTC

    Changed 1

    • extractdescription
      Before

      Extract content from a web page. Supports HTML and Markdown output formats, optional JavaScript rendering via headless browser, proxy geo-targeting, custom HTTP headers, and explicit browser wait controls via the wait_config object. Can run synchronously (returns content immediately) or asynchronously (returns a job ID that can be polled with the 'job' tool). Use 'render_js=true' for pages that require JavaScript to load their content; supplying wait_config also enables browser rendering automatically. Omit wait_config or set it to null to keep the adaptive browser settle path; send {} or concrete values to opt into explicit mode. Anonymous use (no API key) is synchronous only, without JavaScript rendering or custom headers other than Accept-Language, and limited to a small per-client rate and daily volume. An API key, sent as the X-Api-Key header, removes these limits and unlocks crawl, map, search, batch and job history: https://geonode.com/pricing?utm_source=mcp-anon&utm_medium=mcp…

      After

      Extract content from a web page. Supports HTML and Markdown output formats, optional JavaScript rendering via headless browser, proxy geo-targeting, custom HTTP headers, and explicit browser wait controls via the wait_config object. Can run synchronously (returns content immediately) or asynchronously (returns a job ID that can be polled with the 'job' tool). Use 'render_js=true' for pages that require JavaScript to load their content; supplying wait_config also enables browser rendering automatically. Omit wait_config or set it to null to keep the adaptive browser settle path; send {} or concrete values to opt into explicit mode. Without an API key, extraction is synchronous only, without JavaScript rendering or request headers other than Accept-Language, and limited to a small per-client rate and daily volume. An API key, sent as the X-Api-Key header, lifts these restrictions; the plan's own limits apply instead.

    Server instructions

    Before

    Without an API key only the `extract` tool is listed. Anonymous use (no API key) is synchronous only, without JavaScript rendering or custom headers other than Accept-Language, and limited to a small per-client rate and daily volume. An API key, sent as the X-Api-Key header, removes these limits and unlocks crawl, map, search, batch and job history: https://geonode.com/pricing?utm_source=mcp-anon&utm_medium=mcp&utm_campaign=keyless-access

    After

    Without an API key only the `extract` tool is listed. Without an API key, extraction is synchronous only, without JavaScript rendering or request headers other than Accept-Language, and limited to a small per-client rate and daily volume. An API key, sent as the X-Api-Key header, lifts these restrictions; the plan's own limits apply instead. With a key, all tools are listed.

  7. , Automatic check

    Tracking started: 1 tool.

FAQ

Can I paste mcp.tc/i/geonode-scraper-api into my MCP client?

No. mcp.tc links are pages, not server addresses. Connect with https://scraper.geonode.io/mcp, so your client talks to Geonode Scraper API directly. The quick link is for sharing: it opens this page, with setup steps for every client.

Does Geonode Scraper API need an API key or a sign-in?

Not to start. Geonode Scraper API works without signing in and offers sign-in for more access.

Is Geonode Scraper API a remote or a local server?

Remote. Geonode hosts it at https://scraper.geonode.io/mcp, and it speaks Streamable HTTP. There’s nothing to install.

What can Geonode Scraper API do?

It has 16 tools, including extract, job and jobs. You can extract page content as Markdown or HTML, render JavaScript-heavy pages with a headless browser (API key) and Geo-target requests through proxies (API key).

Which clients can use it?

Any client that supports remote MCP servers: Claude Code, Claude Desktop, claude.ai, ChatGPT, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. The setup steps cover each one.

Does mcp.tc track changes to Geonode Scraper API?

Yes. Geonode Scraper API’s History tab shows each change we find to its tools, down to descriptions and parameters, plus new versions and edits by its owner. Follow the listing to get an email when it changes.

Who wrote this page?

mcp.tc’s robot read Geonode Scraper API’s own metadata (its MCP handshake, tool list and public pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

mcp.tc isn’t affiliated with Geonode. This page was built from Geonode Scraper API’s public metadata, last checked on 18 Nov 2026, and an AI model wrote the description, so it can be wrong. Names and marks belong to their owners. Something off? Report this listing.