n8n-nodes-hixy-intelligence-cloud

An n8n node for the Hixy Intelligence Cloud.

Hixy's advanced system is now accessible through the N8N node. It generates actionable data for
decisions: ask a business question in plain language and get grounded recommendations, audience
sentiments, content ideas based on demand, opportunities, forecasts and trend intelligence — with
confidence, a reasoning trace and safe source attribution. Built as a native, programmatic node
with output modes, a dynamic industry picker, credit safety and idempotency. It's also usable
as an AI Agent tool.

Install · Credentials · Resources · Output modes · Credit controls · Templates

Installation

Community-nodes install (recommended): Settings → Community Nodes → Install →
n8n-nodes-hixy-intelligence-cloud.

Local development:

npm install --legacy-peer-deps   # starter toolchain peer-dep workaround
npm run build
npm run lint
npm run dev                       # local n8n with the node linked

Credentials

Create an API key in the developer console at web.hixy.app/hic → API Keys
(keys look like hxk_…). The Hixy Intelligence Cloud API credential:

The connection Test calls the authenticated GET /usage, so an invalid key fails here
(unlike /status, which is public).

Resources & operations

A single node with four resources, each mapped to a clear action (HIX = credits):

Ask HIC

Provide a Question and an Industry (dynamic dropdown from the live catalogue, or a
name/slug/expression). The engine classifies the question and returns an answer, ranked
recommendations, confidence, reasoning, evidence and sources. Intent is auto-detected by
default; override it under Options.

Forecast

Pick a Target (Trend / Topic / Industry), a Time Horizon (7d, 14d, 30d, 60d or 90d), and get
forward-looking movement. Simplify Output flattens it to current_stage / predicted_stage / probability / confidence / risk / predicted_peak_date / predicted_lifespan — ideal for an IF node.

Get Trend

Full intelligence for one public trend by ID. Trend ID accepts an expression, so it chains
from Ask HIC (map its trend_id). Include-Sources / Include-Rationale prune client-side.

Get HIC Status

Liveness, data freshness and capabilities. Fail if Data Is Stale (+ Maximum Data Age)
turns it into a guard that stops a workflow when HTE data is too old.

Output modes

Ask HIC emits results three ways:

• Full Response — one item = the whole analysis (storage/reports).
• One Item Per Recommendation — split each recommendation into its own item (best for IF /
  Slack / Notion automation).
• Top Recommendation Only — just the highest-ranked one.

Simplify Output returns clean, decision-friendly fields. Minimum Confidence and
Maximum Items filter/cap client-side.

Credit controls

Because HIC spends HIX, the node makes cost visible and safe:

• Maximum HIX to Spend — a preflight (via /analyze/estimate) that blocks a request
  before any HIX is spent if the estimate exceeds your limit.
• Idempotency Key — a repeat with the same key replays the stored answer without
  re-charging. Auto-generated per item when blank, so retries never double-charge.
• On Insufficient Credits — Stop Workflow (default) / Continue With Error Item / Skip Item.
• Return Usage Metadata — attach hix_used / hix_remaining to each item.
• Cache Identical Requests — dedupe identical requests within one execution.
• Execute Once — process only the first input item (avoid spending HIX per incoming item).

Errors are mapped to actionable messages: 401 invalid key, 402 shows required vs available
HIX, 403 scope, 404 not found, 429 respects Retry-After (auto-retried with backoff+jitter;
free GET on 429/5xx, POST only on 429/502/503/504, and the charged GET /trend on 429 only so a
post-charge failure is never re-charged).

Using it as an AI tool

The node sets usableAsTool: true. Under an AI Agent node the agent can call Ask HIC /
Forecast / Get Trend directly — HIC is AI-native (returns a synthesized, grounded answer).

Templates

Importable starter workflows live in templates/ — in n8n use Import from File:

• 01-weekly-trend-alert — Schedule → Ask HIC (Trends) → IF confidence ≥ 0.8 → alert
• 02-opportunity-monitor — Schedule → Ask HIC (Opportunities) → IF opportunity ≥ 75 → store
• 03-weekly-content-plan — Schedule → Ask HIC (Content Ideas) → draft
• 04-forecast-watch — Schedule → Forecast → IF probability > 0.75 → alert
• 05-trend-enrichment — Ask HIC → Get Trend (chained) → store
• 06-multi-industry-report — Industry list → loop → Ask HIC → aggregate

Compatibility

• n8n with community-node support, n8nNodesApiVersion 1.
• Built + linted with @n8n/node-cli (strict). No runtime deps beyond peer n8n-workflow.

Resources

• Developer console & docs: https://web.hixy.app/_hte/console/docs
• n8n community nodes: https://docs.n8n.io/integrations/#community-nodes

License

MIT