Skip to content

feat(ai-tool): expose OpenSERP to n8n agents - #2

Merged
ramgalin merged 2 commits into
openserpapi:mainfrom
ALIENvsROBOT:fix/openserp-ai-tool
Aug 25, 2026
Merged

ramgalin merged 2 commits into
openserpapi:mainfrom
ALIENvsROBOT:fix/openserp-ai-tool

Conversation

@ALIENvsROBOT

Copy link
Copy Markdown
Contributor

Summary

  • Expose the existing OpenSERP app node as OpenSERP Tool for n8n AI Agents.
  • Document how to use model-controlled parameters for searches and extraction while keeping credentials, operations, limits, and execution settings owned by the workflow.
  • Document the correct self-hosted Base URL format and cap the result limit at 100.
  • Bump the package version to 0.2.0.

Why

The community package currently provides only the standard workflow node. Marking the node as usableAsTool lets n8n generate the AI-tool variant from the same package, without duplicating the implementation.

Validation

  • Verified a self-hosted OpenSERP API for health, readiness, web search, image search, multi-engine search, single extraction, and batch extraction.
  • Verified the package manifest and TypeScript syntax.
  • Verified the package dry-run output contains the OpenSERP node source.

Closes #1

- Mark the OpenSERP node as usable by n8n AI Agents through the generated tool wrapper.

- Document AI-controlled parameters and self-hosted OpenSERP configuration for agent workflows.

- Bump the package to version 0.2.0 and enforce the OpenSERP result limit of 100.
@ALIENvsROBOT

Copy link
Copy Markdown
Contributor Author

@karust would be nice if you could review and merge this change thanks 😎

@ramgalin

Copy link
Copy Markdown
Contributor

Thanks @ALIENvsROBOT for this. The issue is well specified.
I ran CI steps locally against 56545c6 and the lint step (npm run lint) has failed:

105:3  Add final period            node-param-description-missing-final-period
114:4  Remove `maxValue`           node-param-type-options-max-value-present
207:5  Replace with "['main']"     node-class-description-inputs-wrong-regular-node
208:5  Replace with "['main']"     node-class-description-outputs-wrong

All four lint errors are introduced by this PR — main is currently lint-clean. Lint is a required step in .github/workflows/ci.yml, so this would go red once the workflow is approved to run. Details are in the inline comments.

- Add the required final period to the AI tool query description.

- Remove the disallowed result maxValue while preserving the existing minimum validation.

- Restore literal main input and output declarations required for regular n8n nodes.

- Follow-up for openserpapi#1 and PR openserpapi#2.
@ramgalin
ramgalin merged commit 05d56b5 into openserpapi:main Aug 25, 2026
1 check passed
@ALIENvsROBOT

Copy link
Copy Markdown
Contributor Author

@ramgalin @karust please do publish latest release so I could use openserp as tool 😃

Thanks

@ramgalin

Copy link
Copy Markdown
Contributor

@ALIENvsROBOT done.
Sorry, distracted by the daily job routine and it slipped my mind :)

@ALIENvsROBOT
ALIENvsROBOT deleted the fix/openserp-ai-tool branch August 26, 2026 08:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: expose OpenSERP as an n8n AI Agent tool

2 participants