Description

n8n-nodes-sourcey

Use Sourcey-generated documentation inside n8n workflows.

This community node reads the public artefacts emitted by a Sourcey static
docs site:

• documents.json for search candidates: every page, operation and schema,

each with its own Markdown, which the node reads for its content

• llms-full.txt for whole pages, and for a document whose Markdown cannot be

read

• sitemap.xml for ingestion

A site built before Sourcey 3.7.1 publishes search-index.json in place of
documents.json, and the node reads that instead.

It does not need credentials for public docs and does not run sourcey build
inside n8n.

Installation

Install n8n-nodes-sourcey from the n8n community nodes panel, or install it
manually in a self-hosted n8n instance.

The package is published on npm as n8n-nodes-sourcey, from GitHub Actions
with npm provenance, which its npm page shows for each release:

• npm:
• source:

Creator Portal verification is pending. Until n8n grants verified status, the
package is available as a community node for self-hosted n8n installs and any
n8n environment that allows community packages.

Operations

Retrieve Context

Returns one item with:

• context: packed documentation context ready for an AI Agent prompt
• citations: source URLs and titles
• documents: hydrated source documents
• confidence: none, low, medium, or high
• status: ok, weakresults, or noresults

Use this for Chat Trigger -> Sourcey -> AI Agent -> Respond workflows.

Search

Returns one item per ranked result from documents.json, each page, operation
and schema a result of its own. Each item includes title, URL, excerpt, tab,
category, score, and metadata, with the method and path of an operation.

Use this for branching, result selection, and support routing.

Fetch Page

Fetches one page by path or URL. It prefers llms-full.txt and falls back to
HTML text extraction when the LLM artefact is missing.

Load All

Returns one item per page or chunk for ingestion workflows. Use this with
embeddings and vector-store nodes.

Docs Building

Build docs in CI, then use this node against the deployed site.

The recommended workflow is:

1. n8n receives a GitHub webhook, schedule, release event, or manual trigger.
2. n8n dispatches a GitHub Actions workflow using sourcey/build-docs.
3. GitHub Actions builds and deploys the static Sourcey site.
4. n8n waits for the deployment URL.
5. n8n runs Sourcey Retrieve Context, Search, Fetch Page, or Load All.

This keeps build work in CI and keeps the n8n node fast, dependency-free, and
verification-friendly.

Example Workflows

Import the JSON files in workflows/:

• ask-docs-chatbot.json
• vector-store-ingestion.json
• support-question-router.json
• build-and-index-sourcey-docs.json

The workflows avoid Code and Function nodes. If an example needs custom
JavaScript glue, the Sourcey node API should be improved instead.

Credentials

None in Phase 1. The node consumes public Sourcey docs sites.

Compatibility

This package is generated from the official n8n-node scaffold and uses the
programmatic node style. It keeps runtime dependencies empty for verified
community-node eligibility. Releases are published from GitHub Actions so npm
can attach provenance, which n8n requires for Creator Portal verification.

Development

npm install
npm run typecheck
npm test
npm run build

Run a local n8n instance with the node loaded:

npm run dev

Resources

• Sourcey
• Sourcey on GitHub
• n8n community nodes documentation