Skip to content

dynamicfeed/n8n-nodes-dynamicfeed

Repository files navigation

n8n-nodes-dynamicfeed

An n8n community node for Dynamic Feed — the live, verifiable data layer for AI: 56 tools across 18 verticals, every datapoint carrying a freshness + provenance envelope (source, licence, timestamp, age), and tamper-evident Ed25519-signed proof endpoints.

Use it to pull live ground truth into any n8n workflow: weather, earthquakes, hazard scans around a point, CVE lookups, anti-hallucination reality checks, parametric trigger attestations, and signed compliance receipts.

Installation

In the n8n GUI (recommended)

  1. Open Settings → Community Nodes.
  2. Click Install.
  3. Enter n8n-nodes-dynamicfeed and confirm.
  4. The Dynamic Feed node appears in the node picker.

(Community nodes require a self-hosted n8n instance, or n8n Cloud plans that allow verified community nodes.)

Manually (self-hosted)

# in your n8n installation directory (e.g. ~/.n8n/nodes)
npm install n8n-nodes-dynamicfeed

Restart n8n afterwards. For Docker, install into the /home/node/.n8n/nodes volume.

Credentials (optional)

The node has an optional Dynamic Feed API credential — a single API key sent as the X-API-Key header.

  • Keyless operations (no credential needed): Nearby Hazards, Parametric Attest, Signed Receipt. These are the signed /v1/* proof endpoints.
  • Key-gated operations (credential required): Current Weather, Weather Forecast, Earthquakes, Reality Check, CVE / Vulnerability Check.

Get a free API key at https://dynamicfeed.ai (free tier, paid plans for higher quotas).

Operations

Operation Endpoint Key needed What it returns
Current Weather GET /weather?city= Yes Live temperature, feels-like, wind, humidity, precipitation, conditions (Open-Meteo)
Weather Forecast GET /forecast?city=&days= Yes Multi-day forecast, up to 16 days
Earthquakes GET /earthquakes?min_magnitude=&limit= Yes Recent quakes worldwide (USGS) — magnitude, depth, PAGER alert, tsunami flag
Nearby Hazards GET /v1/nearby?lat=&lon=&radius_km= No Ed25519-signed scan of live hazards near a point — USGS quakes, NASA EONET events, GDACS disasters (+ live bushfire hotspots in Australia), nearest first
Reality Check GET /reality-check?claim= Yes Fact-check a statement against live data — verdict + current value + source (the anti-hallucination check)
CVE / Vulnerability Check GET /advisories?q=&limit= Yes Recent security advisories matching a package name or CVE/GHSA id — severity, CVSS, patched version
Parametric Attest GET /v1/attest?metric=&op=&threshold=&lat=&lon= No Ed25519-signed MET / NOT-MET attestation of "metric op threshold" against the live measurement — the dispute-proof record a parametric payout can settle against
Signed Receipt POST /v1/receipt ({"data": <any JSON>}) No Ed25519-signed, timestamped receipt of arbitrary JSON — provable evidence of what an AI was told (or asserted), and when

Verifying signatures

Dynamic Feed responses carry verifiable provenance: every datapoint ships a freshness + provenance envelope, and the proof endpoints used by Nearby Hazards, Parametric Attest and Signed Receipt return a detached Ed25519 signature field. Verify any signed envelope against the published public keys at:

https://dynamicfeed.ai/.well-known/keys

To verify: remove the signature field, canonicalize the remaining JSON (sorted keys, compact separators), and check the Ed25519 signature against the key id in the envelope. An in-browser verifier and reference scripts live at https://dynamicfeed.ai/proof. Signed envelopes can additionally be anchored to Bitcoin via POST /v1/anchor for independent proof of when.

Example workflow

A minimal workflow that runs a signed hazard scan around Tokyo (keyless — no credential needed). Paste into n8n via Workflow → Import from File/Clipboard:

{
	"name": "Dynamic Feed — signed hazard scan",
	"nodes": [
		{
			"parameters": {},
			"id": "9a1d6c2e-0001-4a7b-8f10-000000000001",
			"name": "When clicking 'Execute workflow'",
			"type": "n8n-nodes-base.manualTrigger",
			"typeVersion": 1,
			"position": [0, 0]
		},
		{
			"parameters": {
				"operation": "nearbyHazards",
				"lat": 35.6762,
				"lon": 139.6503,
				"radiusKm": 300
			},
			"id": "9a1d6c2e-0002-4a7b-8f10-000000000002",
			"name": "Dynamic Feed",
			"type": "n8n-nodes-dynamicfeed.dynamicFeed",
			"typeVersion": 1,
			"position": [220, 0]
		}
	],
	"connections": {
		"When clicking 'Execute workflow'": {
			"main": [
				[
					{
						"node": "Dynamic Feed",
						"type": "main",
						"index": 0
					}
				]
			]
		}
	},
	"settings": {}
}

The output is a signed nearby/v1 envelope — hazards[] sorted nearest-first, plus the signature you can verify against https://dynamicfeed.ai/.well-known/keys.

The node is also flagged usableAsTool, so on recent n8n versions you can hand it to an AI Agent node as a tool.

Compatibility

  • Requires n8n 1.x (declarative/routing-style node, n8nNodesApiVersion 1)
  • Node.js >= 20.15

Development

npm install
npm run build   # tsc + copy icons to dist/
npm run lint

License

MIT

About

Official n8n community node for Dynamic Feed — live, verifiable data for AI workflows: weather, earthquakes, signed hazard scans, CVE checks, reality checks, parametric attestations and Ed25519-signed receipts.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors