Description

n8n-nodes-simplescraper

n8n community node for Simplescraper. Scrape any URL, run saved scrape recipes, extract structured data with AI, capture screenshots, and discover URLs from sitemaps – without writing scraping code.

Install

In n8n: Settings → Community Nodes → Install → enter n8n-nodes-simplescraper and confirm.

Self-hosted instances can also npm install n8n-nodes-simplescraper in their custom-nodes directory. The package follows the standard n8n community node convention.

Credentials

Get your API key from your Simplescraper account page. In n8n: Credentials → New → Simplescraper API, paste the key, save. The credential test hits GET /recipes – a green check means the key is valid.

Operations

Recipe

Work with saved Simplescraper recipes.

| Operation | What it does |
|—|—|
| Run | Runs a saved recipe. Optionally override the recipe’s saved URL, or pass a list of URLs to scrape many pages through the recipe in one async run. Returns a results_id for long-running scrapes. |
| Get Latest Results | Fetches the most recent scrape results for a recipe – one item per scraped row. |
| Get History | Lists the last 100 runs of a recipe – one item per run. |
| Get Results by ID | Fetches a run’s results by its results_id (from an async Run or the New Results trigger) – one item per scraped row. |

Page

Scrape any URL without a saved recipe.

| Operation | What it does |
|—|—|
| Extract Data | One-shot scrape of any URL. Optionally returns Markdown, raw HTML, and a screenshot URL. |
| AI Extract | Uses AI to extract structured data from a URL given a schema (e.g. name, price, availability). |
| Screenshot | Captures a pixel-perfect screenshot of any URL (1 credit). Returns a hosted URL by default. |

URL

| Operation | What it does |
|—|—|
| Extract URLs | Discovers all URLs from a website’s sitemap – one item per URL. No credits consumed. |

Example: scrape every blog post on a site

Combine operations to discover blog URLs and extract their content as clean markdown:

1. URL > Extract URLs with https://simplescraper.io – returns one item per URL in the site’s sitemap. No credits consumed.
2. Filter (n8n core node) keeping items where {{ $json.url }} contains "blog".
3. Page > Extract Data with Include Markdown enabled and URL set to {{ $json.url }} – pulls clean markdown from each filtered blog URL.

Useful for content audits, SEO inventories, or building a RAG corpus from a public site’s blog. The Extract URLs step is free; each blog scrape costs 2 credits.

Long-running scrapes

For recipes that take more than ~30 seconds, the Run operation uses async mode by default and returns immediately with a resultsid and status: "running". Use the Get Results by ID operation with that resultsid to fetch the data once status becomes completed.

AI Extract follows the same pattern – if the response status is running, poll GET /v1/smart-extract/{extract_uid}.

Links

• Simplescraper – the service
• API documentation – endpoint reference
• Report a bug or request a feature
• npm package

Changelog

0.2.0

• Get Results by ID operation – fetch a run’s results by results_id.
• URLs field on the Run a Recipe operation – scrape many pages through one recipe in a single async run.
• Get Results by ID, Get Latest Results, and Extract URLs return one item per record (per scraped row, per URL).
• Renamed the Extract URLs action to “Extract all URLs from a website”.

0.1.4

• Packaging and verification fixes for n8n community-node verification (provenance, icon, listing metadata). No functional changes.

0.1.0

• Initial release: Recipe, Page, and URL operations.

License

MIT