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.
Connect to Geonode Scraper API
Sign-in is optional. Connect with Geonode Scraper API’s own URL:
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-apiAbout
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-onlyExtract a web page as HTML or Markdown, with optional JS rendering, geo-targeting and custom…
jobRead-onlyGet an extraction job
jobsRead-onlyList extraction jobs
statisticsRead-onlyGet extraction statistics
batchWritesStart a batch extraction
batch_statusRead-onlyGet batch status and results
cancel_batchCan deleteCancel a batch job
crawlWritesStart a site crawl
crawl_statusRead-onlyGet crawl status and results
cancel_crawlCan deleteCancel a crawl job
mapRead-onlyMap a site's URLs
map_jobsRead-onlyList map jobs
Show 4 more tools
map_jobRead-onlyGet a map job
searchRead-onlySearch the web
search_jobsRead-onlyList search jobs
search_jobRead-onlyGet 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
- Run this in a terminal, in your project folder:
claude mcp add --transport http geonode-scraper-api https://scraper.geonode.io/mcp- 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
- Open Customize → Connectors, click + Add, then Add custom connector.
- Name it Geonode Scraper API and paste this URL:
https://scraper.geonode.io/mcp- 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
- Open the connector form on claude.ai. This button fills in the name and URL for you:
Add to claude.ai (opens in a new tab)
- Check that the URL reads
https://scraper.geonode.io/mcpand click Add. - 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
- On chatgpt.com, go to Plugins, select +, then Add custom MCP server.
- Enter a name for the server.
- Under Connection, paste
https://scraper.geonode.io/mcpas the server URL, then for authentication choose No authentication, or OAuth to sign in to Geonode for more access. - 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
Add to Cursor (opens in a new tab)
Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):
{
"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
Install in VS Code (opens in a new tab)
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:
{
"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
- Add it to
~/.config/devin/mcp_config.json(macOS and Linux) or%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"geonode-scraper-api": {
"serverUrl": "https://scraper.geonode.io/mcp"
}
}
}- 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/mcpOr edit ~/.codex/config.toml directly:
[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/mcpThen, 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
[](https://mcp.tc/i/geonode-scraper-api)<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
<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
<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.jsonAI 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.
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
[](https://mcp.tc/i/geonode-scraper-api)
```
Reference: https://mcp.tc/embedChange history
We read this server’s tool list every 3 hours and record what changes. Last read 18 Nov 2026, 02:38 UTC.
-
1 tool changed.
Details, 13 Nov 2026, 11:53 UTC
Changed 1
searchinput schema
-
3 tools changed.
Details, 9 Nov 2026, 08:52 UTC
Changed 3
jobsdescription and input schemaBeforeList 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.AfterList 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
- Removed parameters:
map_jobsdescription and input schemaBeforeList 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.AfterList 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
- Removed parameters:
search_jobsdescription and input schemaBeforeList 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.AfterList 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
- Removed parameters:
-
1 tool changed.
Details, 5 Nov 2026, 11:52 UTC
Changed 1
searchdescriptionBeforeRun 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.
AfterRun 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.
-
New version 1.0.1 (was 0.1.0). Reported by the server.
-
15 tools added. Server instructions changed.
New tool marked destructive, New server instructions
Details, 27 Oct 2026, 08:42 UTC
Added 15
batchWritesStart 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-onlyRetrieve 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 deleteCancel 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 deleteCancel 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.
crawlWritesStart 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-onlyRetrieve 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-onlyRetrieve 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-onlyList 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-onlyDiscover 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-onlyRetrieve 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-onlyList 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-onlyRun 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-onlyRetrieve 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-onlyList 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-onlyRetrieve 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
BeforeWithoutan API key onlythe`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, alltoolsare listed.AfterEvery 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.
-
1 tool changed. Server instructions changed.
New server instructions
Details, 19 Oct 2026, 19:37 UTC
Changed 1
extractdescriptionBeforeExtract 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 (noAPIkey)is synchronous only, without JavaScript rendering orcustomheaders 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,removesthese limitsand unlocks crawl, map, search, batch and job history: https://geonode.com/pricing?utm_source=mcp-anon&utm_medium=mcp…AfterExtract 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
BeforeWithout an API key only the `extract` tool is listed.
Anonymous use (noAPIkey)is synchronous only, without JavaScript rendering orcustomheaders 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,removesthese limitsand unlocks crawl, map, search, batch and job history: https://geonode.com/pricing?utm_source=mcp-anon&utm_medium=mcp&utm_campaign=keyless-accessAfterWithout 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.
-
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.