n8n community node for OpenSERP. It supports web search, image search, single and batch URL extraction, OpenSERP Cloud account/pricing calls, Cloud engine capability/status calls, and use as a tool by n8n AI Agents.
In n8n, install the community package:
@openserp/n8n-nodes-openserp
Install with npm:
npm install @openserp/n8n-nodes-openserpCreate an OpenSERP API credential.
OpenSERP Cloud:
API Key: osk_live_...
Base URL: leave empty, or use https://api.openserp.org/v1
API keys are available at https://openserp.org/dashboard/keys.
Self-hosted OpenSERP:
API Key: leave empty
Base URL: http://localhost:7000
For a server running on another machine, set Base URL to that server's root URL, for example http://openserp-host:7000. Do not append /v1 to a self-hosted URL.
The credential test calls /v1/me when an API key is present and /health when no API key is present.
OpenSERP uses n8n's native app-node tool wrapper. The normal OpenSERP node and the generated OpenSERP Tool are shipped in this same package; a second repository or npm package is not required.
- Install or update to
@openserp/n8n-nodes-openserp@0.2.0or later, then restart n8n. - Add an AI Agent and connect a chat model.
- From the AI Agent's Tool connector, add OpenSERP Tool.
- Select the OpenSERP credential, resource, operation, and any limits you want to keep under workflow-owner control.
- For fields the model should choose, select n8n's Let the model define this parameter button.
Recommended AI-controlled fields:
- Query for web or image search.
- Region, Language, Date Range, File Extension, and Site when the user's request should determine filters.
- URL for single-page extraction.
Recommended workflow-controlled fields:
- Resource and Operation, which define the tool's purpose.
- Limit, Engines, Mode, extraction depth, and timeout, which affect cost, latency, and result size.
- Credentials and base URL.
For example, configure one OpenSERP Tool as Search / Mega, keep Limit: 10, Mode: Balanced, and Extract Top Results: false, then let the model fill Query, Region, and Language. A second tool can be configured as Extract / Get Content and let the model fill only URL.
n8n adds a generated tool description based on the selected resource and operation. You can switch it to a manual description when the agent needs stricter routing instructions, for example: Search the public web for current factual information. Return source URLs with the result.
On older self-hosted n8n releases that block community packages from being used as tools, set the following environment variable and restart n8n:
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
The $fromAI() function and the model-fill button only work while the node is connected to an AI Agent as a tool. Keep fixed limits for untrusted prompts so the model cannot create unexpectedly large searches or extraction requests.
- Search: Single returns one n8n item per web result from one engine.
- Search: Mega returns one n8n item per merged web result across selected engines.
- Image: Single returns one n8n item per image result from one engine.
- Image: Mega returns one n8n item per merged image result across selected engines.
- Extract: Get Content returns extracted content for one URL.
- Extract: Get Content (Many URLs) returns one n8n item per URL for up to 20 URLs in a single request. A URL that fails becomes an item carrying an
errorinstead of failing the whole batch. - Account: Get Me / Get Pricing returns OpenSERP Cloud account and pricing metadata.
- Engines: Get Capabilities / Get Status returns OpenSERP Cloud engine metadata.
Search and image operations add openserp_meta to the first output item. This contains request telemetry such as status, request ID, credits, engine used, and response metadata.
- Feed fresh Google or Bing results into an AI workflow.
- Monitor a keyword set and send rank changes to Slack or Sheets.
- Extract readable page content before summarizing it.
- Check Cloud usage before a scheduled batch job runs.
Web search:
Resource: Search
Operation: Single
Engine: Google
Query: openserp
Limit: 10
Multi-engine image search:
Resource: Image
Operation: Mega
Engines: Google, Bing, DuckDuckGo
Mode: Balanced
Query: openserp logo
Extract a URL:
Resource: Extract
Operation: Get Content
URL: https://openserp.org
Mode: Auto
Extract several URLs in one request:
Resource: Extract
Operation: Get Content (Many URLs)
URLs: https://openserp.org
https://openserp.org/docs
Mode: Auto
Read a geo-fenced page as a local visitor by setting the Region extract option to a two-letter country code such as DE. On OpenSERP Cloud this adds 1 credit per extracted URL.