n8n-nodes-exa-official 0.3.3 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +39 -79
- package/dist/credentials/ExaApi.credentials.d.ts +2 -1
- package/dist/credentials/ExaApi.credentials.js +3 -1
- package/dist/credentials/ExaApi.credentials.js.map +1 -1
- package/dist/credentials/exa.svg +3 -0
- package/dist/nodes/Exa/Exa.node.d.ts +3 -3
- package/dist/nodes/Exa/Exa.node.js +12 -1017
- package/dist/nodes/Exa/Exa.node.js.map +1 -1
- package/dist/nodes/Exa/Exa.node.json +4 -4
- package/dist/nodes/Exa/v1/ExaV1.node.d.ts +5 -0
- package/dist/nodes/Exa/v1/ExaV1.node.js +1027 -0
- package/dist/nodes/Exa/v1/ExaV1.node.js.map +1 -0
- package/dist/nodes/Exa/v2/ExaV2.node.d.ts +6 -0
- package/dist/nodes/Exa/v2/ExaV2.node.js +15 -0
- package/dist/nodes/Exa/v2/ExaV2.node.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/agent/cancel.operation.d.ts +30 -0
- package/dist/nodes/Exa/v2/actions/agent/cancel.operation.js +15 -0
- package/dist/nodes/Exa/v2/actions/agent/cancel.operation.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/agent/common.descriptions.d.ts +2 -0
- package/dist/nodes/Exa/v2/actions/agent/common.descriptions.js +13 -0
- package/dist/nodes/Exa/v2/actions/agent/common.descriptions.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/agent/create.operation.d.ts +30 -0
- package/dist/nodes/Exa/v2/actions/agent/create.operation.js +241 -0
- package/dist/nodes/Exa/v2/actions/agent/create.operation.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/agent/get.operation.d.ts +30 -0
- package/dist/nodes/Exa/v2/actions/agent/get.operation.js +15 -0
- package/dist/nodes/Exa/v2/actions/agent/get.operation.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/agent/getEvents.operation.d.ts +30 -0
- package/dist/nodes/Exa/v2/actions/agent/getEvents.operation.js +83 -0
- package/dist/nodes/Exa/v2/actions/agent/getEvents.operation.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/agent/getMany.operation.d.ts +30 -0
- package/dist/nodes/Exa/v2/actions/agent/getMany.operation.js +45 -0
- package/dist/nodes/Exa/v2/actions/agent/getMany.operation.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/agent/index.d.ts +8 -0
- package/dist/nodes/Exa/v2/actions/agent/index.js +94 -0
- package/dist/nodes/Exa/v2/actions/agent/index.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/answer/get.operation.d.ts +30 -0
- package/dist/nodes/Exa/v2/actions/answer/get.operation.js +85 -0
- package/dist/nodes/Exa/v2/actions/answer/get.operation.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/answer/index.d.ts +4 -0
- package/dist/nodes/Exa/v2/actions/answer/index.js +58 -0
- package/dist/nodes/Exa/v2/actions/answer/index.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/common.descriptions.d.ts +3 -0
- package/dist/nodes/Exa/v2/actions/common.descriptions.js +137 -0
- package/dist/nodes/Exa/v2/actions/common.descriptions.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/contents/get.operation.d.ts +30 -0
- package/dist/nodes/Exa/v2/actions/contents/get.operation.js +49 -0
- package/dist/nodes/Exa/v2/actions/contents/get.operation.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/contents/index.d.ts +4 -0
- package/dist/nodes/Exa/v2/actions/contents/index.js +58 -0
- package/dist/nodes/Exa/v2/actions/contents/index.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/router.d.ts +2 -0
- package/dist/nodes/Exa/v2/actions/router.js +85 -0
- package/dist/nodes/Exa/v2/actions/router.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/search/index.d.ts +4 -0
- package/dist/nodes/Exa/v2/actions/search/index.js +58 -0
- package/dist/nodes/Exa/v2/actions/search/index.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/search/search.operation.d.ts +30 -0
- package/dist/nodes/Exa/v2/actions/search/search.operation.js +265 -0
- package/dist/nodes/Exa/v2/actions/search/search.operation.js.map +1 -0
- package/dist/nodes/Exa/v2/actions/versionDescription.d.ts +2 -0
- package/dist/nodes/Exa/v2/actions/versionDescription.js +79 -0
- package/dist/nodes/Exa/v2/actions/versionDescription.js.map +1 -0
- package/dist/nodes/Exa/v2/helpers/interfaces.d.ts +29 -0
- package/dist/nodes/Exa/v2/helpers/interfaces.js +10 -0
- package/dist/nodes/Exa/v2/helpers/interfaces.js.map +1 -0
- package/dist/nodes/Exa/v2/helpers/utils.d.ts +23 -0
- package/dist/nodes/Exa/v2/helpers/utils.js +92 -0
- package/dist/nodes/Exa/v2/helpers/utils.js.map +1 -0
- package/dist/nodes/Exa/v2/transport/index.d.ts +19 -0
- package/dist/nodes/Exa/v2/transport/index.js +183 -0
- package/dist/nodes/Exa/v2/transport/index.js.map +1 -0
- package/dist/package.json +9 -5
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +9 -5
package/README.md
CHANGED
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
# n8n-nodes-exa-official
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
[Exa](https://exa.ai) is an AI-powered search engine that provides embeddings-based semantic search, deep web research, and structured content extraction.
|
|
3
|
+
An n8n community node for the [Exa](https://exa.ai) API: web search, content extraction, and research agents. This node is usable both as a regular node and as a tool for an n8n AI Agent.
|
|
6
4
|
|
|
7
5
|
[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
|
|
8
6
|
|
|
@@ -19,28 +17,35 @@ Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes
|
|
|
19
17
|
|
|
20
18
|
## Operations
|
|
21
19
|
|
|
22
|
-
|
|
20
|
+
### Search — `POST /search`
|
|
21
|
+
|
|
22
|
+
Semantic web search. Search types: `auto`, `instant`, `fast`, `deep-lite`, `deep`, `deep-reasoning`.
|
|
23
|
+
|
|
24
|
+
Output formats:
|
|
25
|
+
|
|
26
|
+
- **Results** — the ranked list of pages.
|
|
27
|
+
- **Text** — a single written answer synthesised from the results.
|
|
28
|
+
- **Structured (JSON Schema)** — JSON matching a schema you provide.
|
|
29
|
+
|
|
30
|
+
Options include category (`company`, `publication`, `news`, `personal site`, `financial report`, `people`), domain and text filters, published-date ranges, additional queries for the deep types, moderation, a system prompt and user location. Content extraction (text, highlights, summary, links, images, `maxAgeHours`, subpages) is available on every search.
|
|
23
31
|
|
|
24
|
-
###
|
|
25
|
-
- **Search**: Intelligently search the web with neural or keyword-based search
|
|
26
|
-
- Supports multiple search types: auto, neural, keyword, fast
|
|
27
|
-
- Filter by domain, date, category, and text content
|
|
28
|
-
- Extract page contents (text, highlights, summaries)
|
|
29
|
-
- Configure livecrawl and subpage crawling
|
|
32
|
+
### Contents — `POST /contents`
|
|
30
33
|
|
|
31
|
-
|
|
32
|
-
- **Get Contents**: Retrieve cleaned text, highlights, and summaries from a list of URLs
|
|
34
|
+
Fetch cleaned text, highlights, summaries, links and images for a list of URLs. Per-URL statuses are merged onto the results, so pages that failed to crawl arrive as items carrying `status` and `error` instead of silently disappearing.
|
|
33
35
|
|
|
34
|
-
###
|
|
35
|
-
- **Find Similar Links**: Discover pages similar to a given URL
|
|
36
|
+
### Answer — `POST /answer`
|
|
36
37
|
|
|
37
|
-
|
|
38
|
-
- **Get Answer**: Get an AI-generated answer to a query using Exa's research capabilities
|
|
38
|
+
A grounded answer with citations, optionally as JSON matching a schema, optionally including the full text of each citation.
|
|
39
39
|
|
|
40
|
-
###
|
|
41
|
-
|
|
42
|
-
-
|
|
43
|
-
|
|
40
|
+
### Agent — `/agent/runs`
|
|
41
|
+
|
|
42
|
+
Multi-step research, list building and enrichment.
|
|
43
|
+
|
|
44
|
+
- **Create Run** — start a run, optionally waiting for it to finish by streaming server-sent events or by polling. Supports effort, system prompt, structured output, input rows, metadata, connector data sources and continuation from a previous run.
|
|
45
|
+
- **Get Run** — status and output of a run.
|
|
46
|
+
- **Get Many Runs** — recent runs, with pagination.
|
|
47
|
+
- **Get Run Events** — list a run's events, or hold an SSE connection open and collect them until the run finishes.
|
|
48
|
+
- **Cancel Run** — stop a queued or running run.
|
|
44
49
|
|
|
45
50
|
## Credentials
|
|
46
51
|
|
|
@@ -54,65 +59,23 @@ Add the API key to your n8n credentials as "Exa API".
|
|
|
54
59
|
|
|
55
60
|
## Compatibility
|
|
56
61
|
|
|
57
|
-
-
|
|
58
|
-
- Tested against n8n
|
|
62
|
+
- Requires n8n 1.60.0 or newer, and Node.js 20.15 or newer.
|
|
63
|
+
- Tested against n8n 2.32.
|
|
59
64
|
|
|
60
65
|
## Usage
|
|
61
66
|
|
|
62
|
-
###
|
|
63
|
-
|
|
64
|
-
1. Add the Exa node to your workflow
|
|
65
|
-
2. Select "Search" as the resource
|
|
66
|
-
3. Enter your search query (e.g., "Latest AI research papers")
|
|
67
|
-
4. Configure search type (auto, neural, keyword, or fast)
|
|
68
|
-
5. Optionally add filters:
|
|
69
|
-
- Category (research paper, news, company, etc.)
|
|
70
|
-
- Date range (published date)
|
|
71
|
-
- Domain filters (include/exclude specific domains)
|
|
72
|
-
- Text filters (include/exclude specific text)
|
|
73
|
-
|
|
74
|
-
### Content Extraction
|
|
67
|
+
### As an AI Agent tool
|
|
75
68
|
|
|
76
|
-
|
|
77
|
-
- **Text**: Get cleaned page text
|
|
78
|
-
- **Highlights**: Get relevant excerpts
|
|
79
|
-
- **Summary**: Get AI-generated summaries
|
|
80
|
-
- **Livecrawl**: Crawl pages in real-time
|
|
81
|
-
- **Subpages**: Crawl linked subpages
|
|
69
|
+
Set the node's connection to an **AI Agent** and it appears as a tool. Any parameter can be filled by the model with `{{ $fromAI('query', 'what to search for', 'string') }}`, which makes Search and Answer useful as web-grounding tools for agents.
|
|
82
70
|
|
|
83
|
-
###
|
|
71
|
+
### Waiting for an agent run
|
|
84
72
|
|
|
85
|
-
**
|
|
86
|
-
```
|
|
87
|
-
Start Published Date: 2024-01-01
|
|
88
|
-
End Published Date: 2024-12-31
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
**Domain Control**: Focus on or exclude specific domains
|
|
92
|
-
```
|
|
93
|
-
Include Domains: arxiv.org, github.com
|
|
94
|
-
Exclude Domains: reddit.com
|
|
95
|
-
```
|
|
73
|
+
**Wait for Completion** holds the workflow until the run reaches a terminal state:
|
|
96
74
|
|
|
97
|
-
**
|
|
98
|
-
-
|
|
99
|
-
- Research papers
|
|
100
|
-
- News articles
|
|
101
|
-
- PDFs
|
|
102
|
-
- GitHub repositories
|
|
103
|
-
- Twitter/LinkedIn profiles
|
|
104
|
-
- Financial reports
|
|
75
|
+
- **Stream** keeps one server-sent events connection open and returns the finished run (optionally with every event that led to it).
|
|
76
|
+
- **Poll** re-requests the run on an interval.
|
|
105
77
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
1. Add an Exa node and set **Resource** to `Research` with the **Create Research Task** operation.
|
|
109
|
-
2. Provide a clear research instruction (for example, "Compare emerging open-source RAG frameworks and summarize trade-offs").
|
|
110
|
-
3. Choose the Research product tier (`exa-research` or `exa-research-pro`) and optional guardrails like domain/category allowlists.
|
|
111
|
-
4. Store the returned `id` or use paired nodes (Set/Code) to persist it inside the workflow.
|
|
112
|
-
5. Add another Exa node in the same workflow set to **Get Research Task** and reference the saved `id` to poll results until the status becomes `completed`.
|
|
113
|
-
6. Inspect the response for `insights`, `sources`, `outline`, or generated assets, then continue your workflow (e.g., send a Slack summary or populate a database).
|
|
114
|
-
|
|
115
|
-
For bulk monitoring, use **List Research Tasks** and apply parameters for pagination, status filtering, or creation date ranges.
|
|
78
|
+
For long runs, turn **Wait for Completion** off, store the returned `id`, and follow the run later with **Get Run** — the run keeps going server-side.
|
|
116
79
|
|
|
117
80
|
## Resources
|
|
118
81
|
|
|
@@ -130,15 +93,12 @@ npm install
|
|
|
130
93
|
|
|
131
94
|
# Build the node
|
|
132
95
|
npm run build
|
|
96
|
+
npm run lint
|
|
133
97
|
|
|
134
|
-
#
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
cd ~/.n8n/custom
|
|
139
|
-
npm link n8n-nodes-exa-official
|
|
140
|
-
|
|
141
|
-
# Start n8n
|
|
98
|
+
# Install the node in your n8n instance
|
|
99
|
+
mkdir -p ~/.n8n/custom && cd ~/.n8n/custom
|
|
100
|
+
npm init -y
|
|
101
|
+
npm install /path/to/n8n-integration
|
|
142
102
|
n8n start
|
|
143
103
|
```
|
|
144
104
|
|
|
@@ -1,7 +1,8 @@
|
|
|
1
|
-
import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
|
|
1
|
+
import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
|
|
2
2
|
export declare class ExaApi implements ICredentialType {
|
|
3
3
|
name: string;
|
|
4
4
|
displayName: string;
|
|
5
|
+
icon: "file:exa.svg";
|
|
5
6
|
documentationUrl: string;
|
|
6
7
|
properties: INodeProperties[];
|
|
7
8
|
authenticate: IAuthenticateGeneric;
|
|
@@ -5,7 +5,8 @@ class ExaApi {
|
|
|
5
5
|
constructor() {
|
|
6
6
|
this.name = 'exaApi';
|
|
7
7
|
this.displayName = 'Exa API';
|
|
8
|
-
this.
|
|
8
|
+
this.icon = 'file:exa.svg';
|
|
9
|
+
this.documentationUrl = 'https://exa.ai/docs/reference/getting-started';
|
|
9
10
|
this.properties = [
|
|
10
11
|
{
|
|
11
12
|
displayName: 'API Key',
|
|
@@ -34,6 +35,7 @@ class ExaApi {
|
|
|
34
35
|
url: '/search',
|
|
35
36
|
body: {
|
|
36
37
|
query: 'n8n credential verification',
|
|
38
|
+
type: 'instant',
|
|
37
39
|
numResults: 1,
|
|
38
40
|
},
|
|
39
41
|
},
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ExaApi.credentials.js","sourceRoot":"","sources":["../../credentials/ExaApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,MAAM;IAAnB;QACC,SAAI,GAAG,QAAQ,CAAC;QAChB,gBAAW,GAAG,SAAS,CAAC;QACxB,qBAAgB,GAAG,+CAA+C,CAAC;QACnE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,gEAAgE;aAC7E;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,WAAW,EAAE,0BAA0B;iBACvC;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,oBAAoB;gBAC7B,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,SAAS;gBACd,IAAI,EAAE;oBACL,KAAK,EAAE,6BAA6B;oBACpC,UAAU,EAAE,CAAC;iBACb;aACD;SACD,CAAC;IACH,CAAC;CAAA;
|
|
1
|
+
{"version":3,"file":"ExaApi.credentials.js","sourceRoot":"","sources":["../../credentials/ExaApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,MAAM;IAAnB;QACC,SAAI,GAAG,QAAQ,CAAC;QAChB,gBAAW,GAAG,SAAS,CAAC;QACxB,SAAI,GAAG,cAAuB,CAAC;QAC/B,qBAAgB,GAAG,+CAA+C,CAAC;QACnE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,gEAAgE;aAC7E;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,WAAW,EAAE,0BAA0B;iBACvC;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,oBAAoB;gBAC7B,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,SAAS;gBACd,IAAI,EAAE;oBACL,KAAK,EAAE,6BAA6B;oBACpC,IAAI,EAAE,SAAS;oBACf,UAAU,EAAE,CAAC;iBACb;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAxCD,wBAwCC"}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
<svg width="94" height="114" viewBox="0 0 94 114" fill="none" xmlns="http://www.w3.org/2000/svg">
|
|
2
|
+
<path fill-rule="evenodd" clip-rule="evenodd" d="M0 112.14C0 112.691 0.446944 113.138 0.998277 113.138H92.1741C92.7255 113.138 93.1724 112.691 93.1724 112.14V107.396C93.1724 106.932 93.0115 106.483 92.7173 106.125L52.4924 57.203C52.1895 56.8346 52.1895 56.3034 52.4924 55.935L92.7173 7.0126C93.0115 6.6547 93.1724 6.20573 93.1724 5.74239V0.998283C93.1724 0.446953 92.7255 7.62939e-06 92.1741 7.62939e-06H0.998276C0.446943 7.62939e-06 0 0.446953 0 0.998283V112.14ZM47.1293 63.7789C46.8618 63.4535 46.363 63.4554 46.098 63.7828L13.756 103.735C13.4037 104.17 13.7134 104.819 14.2733 104.819H79.4644C80.0266 104.819 80.3356 104.165 79.9785 103.731L47.1293 63.7789ZM9.20606 96.1337C8.91009 96.4993 8.31897 96.29 8.31897 95.8196V61.394C8.31897 61.0264 8.61693 60.7285 8.98448 60.7285H36.4724C37.0322 60.7285 37.3419 61.3776 36.9897 61.8127L9.20606 96.1337ZM36.4724 52.4095C37.0322 52.4095 37.3419 51.7604 36.9897 51.3252L9.20606 17.0043C8.91009 16.6387 8.31897 16.848 8.31897 17.3183V51.744C8.31897 52.1115 8.61693 52.4095 8.98448 52.4095H36.4724ZM13.756 9.40324C13.4037 8.96811 13.7134 8.31898 14.2733 8.31898H79.4644C80.0266 8.31898 80.3356 8.97291 79.9785 9.40717L47.1293 49.3591C46.8618 49.6845 46.363 49.6826 46.098 49.3552L13.756 9.40324Z" fill="#1F40ED"/>
|
|
3
|
+
</svg>
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
2
|
-
export declare class Exa
|
|
3
|
-
|
|
1
|
+
import { VersionedNodeType } from 'n8n-workflow';
|
|
2
|
+
export declare class Exa extends VersionedNodeType {
|
|
3
|
+
constructor();
|
|
4
4
|
}
|