feat: add SERPdive API tool node - #6653
Conversation
|
Caution The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased. |
|
Update while this is open: SERPdive now has a free tier, which changes the calculus for this integration.
Why it matters here: the usual objection to adding a search provider is that reviewers and users need a paid key just to try it. That objection is gone — anyone can run this integration end to end for free, including whoever reviews this PR. Nothing in this PR needs to change for that: the default stays |
SERPdive serves three models; this integration listed two, so the free one was not selectable. `krill` is free and unlimited under fair use — no card, no credits — and returns a smaller set of the same sentences, one request at a time, at low priority, with no written answer. Added to the existing selector and its description. `mako` remains the default, so existing flows are unchanged.
What this adds
A new tool node for SERPdive, a web search API built for AI agents: one call returns extracted, answer-ready page content instead of a list of links to fetch. This gives Flowise users a third search-API option next to Tavily and Exa.
Measured, not asserted: on a public 1,000-question benchmark judged blind by an independent model, SERPdive won 60.7% of decided quality duels against Tavily's default (basic) search while returning 20.2% fewer tokens at the same speed (the advanced tier was not benchmarked). Methodology and per-question results are open: serpdive-benchmark. Free tier: 1,000 credits/month, no card.
Changes
packages/components/nodes/tools/SerpdiveAPI/SerpdiveAPI.ts— node + tool class in one file, following the Searxng pattern (self-containedToolsubclass,secureFetchfromsrc/httpSecurityfor the outbound call). Inputs mirror the API contract exactly: model (mako/moby), include answer, max results (1-10). No new dependency.packages/components/credentials/SerpdiveApi.credential.ts— API key astype: 'password', per the credential security rule in CONTRIBUTING.packages/components/nodes/tools/SerpdiveAPI/serpdive.svg— vector icon.Validation
packages/components/tsconfig.json(strict) and formatted with the repo's prettier config.tool.call(...)as an agent would): real search returns results + optional written answer in ~2 s; an invalid key surfaces the API's error message.I kept the diff minimal and self-contained. If this node is not something you want to carry, no hard feelings, feel free to close. Also glad to add a docs page in FlowiseDocs if the node is accepted.