crivum

n8n community node for the Crivum API: measure a text against three reference models, screen a draft for free, read your balance and list published records.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: Crivum

Available Nodes

Documentation generating…

Crivum icon
Crivum
Measure a text against three reference models, screen a draft for free, read your credit balance and list published records

Documentation

n8n-nodes-crivum

This is an n8n community node for the Crivum API. Use it to measure a text against three reference models, screen a draft for free, check your credit balance and list the works published on Crivum.

n8n is a fair-code licensed workflow automation platform.

This is not peer review and the score is not an accreditation. Crivum reads any language and answers in the language of the text, and the criteria were calibrated in Portuguese and English, so comparing results across languages is a reading nobody has measured yet.

Installation

Self-hosted n8n

  1. Open Settings > Community Nodes.
  2. Select Install.
  3. Enter n8n-nodes-crivum and confirm.

You can also install it from the command line inside your n8n user folder (usually ~/.n8n/nodes):

npm install n8n-nodes-crivum

Then restart n8n. See the community nodes installation guide for details.

n8n Cloud

Only verified community nodes are available on n8n Cloud. This node will appear there once verification is complete.

Credentials

Create a Crivum API credential with:

Field Description
API Key A key created in your Crivum account. Live keys start with crv_live_, test keys with crv_test_.
Base URL Address of the API. Keep the default https://crivum.org.

When you save the credential, n8n checks it by reading your balance (GET /v1/saldo). This check never uses credits.

Operations

Resource Operation What it does Uses credits
Work Measure Sends a text to be measured by the three reference models and waits for the result Yes
Work Get Reads a measurement back by the reference you sent with it No
Text Screen Quick free reading of whether a draft is ready to be measured No, limited per origin
Account Get Balance Free and paid credits of the account that owns the key No
Record List Published Works published on Crivum, newest first, with pagination No

Work > Measure

  • Title, Text and Work Type are required. The list of work types is loaded from Crivum, so you never type it by hand.
  • Level calibrates the tier. Leave it on Automatic to let the reference models infer it.
  • Reference is your own identifier, up to 200 characters. Sending the same reference again returns the same result and is never charged twice, which makes retries safe.
  • A measurement can take up to five minutes. If Crivum reports it is still running, the node keeps checking until it finishes or until Max Wait is reached. After that, run Get with the same reference.

Errors

The Crivum API answers in Portuguese. The node translates every error code and every measurement failure cause into English. The original response is always kept under raw, both in the error details and, when Continue On Fail is on, in the output item:

{
  "error": "This API key exceeded its request rate limit",
  "description": "Wait for the time indicated in the response and try again. Retry after 12 seconds.",
  "code": "limite_de_vazao",
  "httpCode": 429,
  "retryAfterSeconds": 12,
  "raw": { "ok": false, "codigo": "limite_de_vazao", "...": "..." }
}

Use as an AI Agent tool

The node is marked as usable as a tool, so it can be attached to the n8n AI Agent.

Planned

  • Copy compliance (checking a piece of marketing copy against a brief) is planned for a later version. It is not part of this package yet.

Compatibility

Built against n8n-workflow 2.x. Requires Node.js 20.15 or later.

Resources

License

MIT

Discussion