n8n-nodes-scrapesense

n8n community node for the ScrapeSense public API.

This package lets you run ScrapeSense scans, read places, clean emails, and work with campaign and billing data without custom HTTP nodes.

Installation

In n8n UI (self-hosted)

1. Open Settings > Community Nodes.
2. Click Install.
3. Enter package name: n8n-nodes-scrapesense.
4. Install and restart n8n.

Manual install (self-hosted)

cd ~/.n8n/nodes
npm install n8n-nodes-scrapesense

Operations

The ScrapeSense node supports:

• Utility: Get Status
• Campaigns: Create, List, Get, List Emails, Start, Pause, Resume, Cancel, Approve Email, Approve All, Send Email, Send All Approved, Approve and Send All, Retry Failed, Delete
• Scan: Create, Get, List, Pause, Resume, Cancel, Delete
• Place: List from Scan, Get
• Email Cleaning: Preview, Apply
• Billing: Get Credits, List Transactions, Get Spend, Get Settings, Update Settings

Credentials

Use the ScrapeSense API credential:

• Base URL
  • Cloud: https://api.scrapesense.com/v1
  • Local/self-hosted backend: http://localhost:3005/api/v1
• API Key (Bearer token from ScrapeSense developer settings)

Credential test calls GET /status.

Example workflow

1. Add ScrapeSense node with resource Scan and operation Create.
2. Store returned scanId.
3. Add a loop with Wait + ScrapeSense (Scan -> Get) until status is completed.
4. Add ScrapeSense (Campaign -> Create) after scan completion.

Local development

npm install
npm run lint
npm run build

Publishing

This repo includes .github/workflows/publish-n8n-node.yml for npm publish with provenance.

1. Add repository secret NPM_TOKEN.
2. Bump version in package.json.
3. Run the GitHub Action manually, or publish a release tag matching n8n-node-v*.

Community submission

After publishing to npm, submit in the n8n Creator Portal:

• https://creators.n8n.io/nodes

References

• https://docs.n8n.io/integrations/community-nodes/installation/
• https://docs.n8n.io/integrations/creating-nodes/deploy/submit-community-nodes/