@youdotcom-oss/n8n-nodes-youdotcom 0.1.0 → 0.2.1

package/README.md

@@ -1,6 +1,6 @@
 # n8n-nodes-youdotcom
 
-An n8n community node for integrating [You.com APIs](https://you.com/api) into your n8n workflows. Search the web, extract content from URLs, or get AI-powered answers with citations.
+An n8n community node for integrating [You.com APIs](https://you.com/apis) into your n8n workflows. Search the web, extract content from URLs, or get AI-powered answers with citations.
 
 ## Installation
 
@@ -25,7 +25,7 @@ Search the web and news using You.com's search API.
 
 | Parameter        | Required | Description                                             |
 | ---------------- | -------- | ------------------------------------------------------- |
-| Query            | Yes      | The search query to retrieve relevant results           |
+| Query            | Yes      | The search query (supports search operators, see below) |
 | Count            | No       | Maximum number of results per section (1-100)           |
 | Country          | No       | Country code for geographical focus (e.g., US, GB, DE)  |
 | Freshness        | No       | Filter by recency: day, week, month, or year            |
@@ -34,10 +34,22 @@ Search the web and news using You.com's search API.
 | Livecrawl Format | No       | Format for livecrawled content (HTML or Markdown)       |
 | Offset           | No       | Pagination offset (0-9)                                 |
 | Safe Search      | No       | Content moderation: off, moderate, or strict            |
-| Site             | No       | Restrict results to a specific domain                   |
-| File Type        | No       | Filter results by file type (e.g., pdf, doc)            |
-| Exclude Terms    | No       | Terms to exclude (pipe-separated)                       |
-| Exact Terms      | No       | Require exact phrase matches (pipe-separated)           |
+
+**Search operators:**
+
+Include these directly in your query to refine results. See [search operators documentation](https://docs.you.com/search/search-operators) for details.
+
+| Operator   | Example                 | Description                                        |
+| ---------- | ----------------------- | -------------------------------------------------- |
+| `site:`    | `site:github.com`       | Restrict to a specific domain (including subdomains) |
+| `filetype:`| `filetype:pdf`          | Filter by file type                                |
+| `+`        | `+GAAP`                 | Require exact term in results                      |
+| `-`        | `-marketing`            | Exclude exact term from results                    |
+| `AND`      | `Python AND PyTorch`    | Logical AND to combine expressions                 |
+| `OR`       | `Python OR PyTorch`     | Logical OR to combine expressions                  |
+| `NOT`      | `NOT site:example.com`  | Negate an expression                               |
+
+**Example:** `machine learning (Python OR PyTorch) -TensorFlow filetype:pdf` searches for ML content about Python or PyTorch, excluding TensorFlow, in PDF format.
 
 ### Get Contents
 
@@ -72,7 +84,7 @@ Get AI-generated answers with web search and citations. Perfect for RAG (Retriev
 
 ## Credentials
 
-1. Visit [you.com/api](https://you.com/api) to get an API key
+1. Visit [you.com/platform/api-keys](https://you.com/platform/api-keys) to get an API key
 2. In n8n, go to **Credentials > New Credential**
 3. Search for "You.com API"
 4. Enter your API key and save
@@ -107,9 +119,10 @@ bun run check
 ## Resources
 
 - [You.com API Documentation](https://docs.you.com/)
-- [Search API Reference](https://docs.you.com/api-reference/search)
+- [Search API Reference](https://docs.you.com/api-reference/search/v1-search)
+- [Search Operators](https://docs.you.com/search/search-operators)
 - [Contents API Reference](https://docs.you.com/api-reference/search/contents)
-- [Express Agent Reference](https://docs.you.com/agents/overview#express-agent)
+- [Express Agent Reference](https://docs.you.com/api-reference/agents/express-agent/express-agent-runs)
 - [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
 
 ## License

package/dist/credentials/YouDotComApi.credentials.js

@@ -1,4 +1,38 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
 // credentials/YouDotComApi.credentials.ts
+var exports_YouDotComApi_credentials = {};
+__export(exports_YouDotComApi_credentials, {
+  YouDotComApi: () => YouDotComApi
+});
+module.exports = __toCommonJS(exports_YouDotComApi_credentials);
+
 class YouDotComApi {
   name = "youDotComApi";
   displayName = "You.com API";
@@ -14,7 +48,7 @@ class YouDotComApi {
       },
       default: "",
       required: true,
-      description: 'Your You.com API key. Get one at <a href="https://you.com/api" target="_blank">you.com/api</a>'
+      description: 'Your You.com API key. Get one at <a href="https://you.com/platform/api-keys" target="_blank">you.com/platform/api-keys</a>'
     }
   ];
   authenticate = {
@@ -37,6 +71,3 @@ class YouDotComApi {
     }
   };
 }
-export {
-  YouDotComApi
-};

package/dist/nodes/YouDotCom/YouDotCom.node.js

@@ -1,4 +1,21 @@
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -10,7 +27,12 @@ var __export = (target, all) => {
 };
 
 // nodes/YouDotCom/YouDotCom.node.ts
-import { NodeApiError, NodeOperationError } from "n8n-workflow";
+var exports_YouDotCom_node = {};
+__export(exports_YouDotCom_node, {
+  YouDotCom: () => YouDotCom
+});
+module.exports = __toCommonJS(exports_YouDotCom_node);
+var import_n8n_workflow = require("n8n-workflow");
 
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 var exports_external = {};
@@ -13548,18 +13570,12 @@ config(en_default());
 var SearchOptionsSchema = exports_external.object({
   count: exports_external.number().int().min(1).max(100).optional().describe("Number of search results to return (1-100)"),
   country: exports_external.string().optional().describe("Two-letter country code to filter results (e.g., US, GB)"),
-  excludeTerms: exports_external.string().optional().describe("Terms to exclude from search results"),
-  exactTerms: exports_external.string().optional().describe("Exact phrase to match in search results"),
-  fileType: exports_external.string().optional().describe("File type extension to filter results (e.g., pdf, doc)"),
   freshness: exports_external.enum(["day", "week", "month", "year"]).optional().describe("Filter results by recency"),
   language: exports_external.string().optional().describe("BCP 47 language code to filter results (e.g., en, es, fr)"),
   livecrawl: exports_external.enum(["web", "news", "all"]).optional().describe("Type of content to crawl in real-time"),
   livecrawl_formats: exports_external.enum(["html", "markdown"]).optional().describe("Format for live-crawled content"),
   offset: exports_external.number().int().min(0).max(9).optional().describe("Pagination offset for search results (0-9)"),
-  safesearch: exports_external.enum(["off", "moderate", "strict"]).optional().describe("Safe search filtering level"),
-  site: exports_external.string().optional().describe("Domain to restrict search results (e.g., example.com)").refine((val) => !val || /^[a-z0-9.-]+\.[a-z]{2,}$/i.test(val), {
-    message: "Must be a valid domain format (e.g., example.com)"
-  })
+  safesearch: exports_external.enum(["off", "moderate", "strict"]).optional().describe("Safe search filtering level")
 });
 var WebResultSchema = exports_external.object({
   url: exports_external.string().describe("URL of the search result"),
@@ -13684,8 +13700,8 @@ class YouDotCom {
           }
         },
         default: "",
-        placeholder: "e.g., latest AI news",
-        description: "The search query to retrieve relevant results from the web. Supports search operators for refined searches."
+        placeholder: "e.g., AI news site:github.com filetype:pdf",
+        description: "The search query. Supports operators: site: (domain), filetype: (file type), + (require), - (exclude), AND, OR, NOT. Example: Python OR PyTorch -TensorFlow filetype:pdf"
       },
       {
         displayName: "Search Options",
@@ -13756,30 +13772,6 @@ class YouDotCom {
               { name: "United States", value: "US" }
             ]
           },
-          {
-            displayName: "Exact Terms",
-            name: "exactTerms",
-            type: "string",
-            default: "",
-            placeholder: "e.g., machine learning|AI",
-            description: 'Require exact phrase matches (pipe-separated, e.g., "machine learning|deep learning")'
-          },
-          {
-            displayName: "Exclude Terms",
-            name: "excludeTerms",
-            type: "string",
-            default: "",
-            placeholder: "e.g., spam|ads",
-            description: 'Terms to exclude from results (pipe-separated, e.g., "spam|ads|promo")'
-          },
-          {
-            displayName: "File Type",
-            name: "fileType",
-            type: "string",
-            default: "",
-            placeholder: "e.g., pdf",
-            description: "Filter results by file type (e.g., pdf, doc, xls)"
-          },
           {
             displayName: "Freshness",
             name: "freshness",
@@ -13904,14 +13896,6 @@ class YouDotCom {
               { name: "Moderate", value: "moderate" },
               { name: "Strict", value: "strict" }
             ]
-          },
-          {
-            displayName: "Site",
-            name: "site",
-            type: "string",
-            default: "",
-            placeholder: "e.g., github.com",
-            description: "Restrict results to a specific domain (e.g., github.com)"
           }
         ]
       },
@@ -14060,7 +14044,7 @@ ${error48.issues.map((e, i2) => `  ${i2 + 1}. ${e.path.join(".") || "root"}: ${e
             });
             continue;
           }
-          throw new NodeApiError(this.getNode(), { message: errorMessage, issues: serializedIssues }, {
+          throw new import_n8n_workflow.NodeApiError(this.getNode(), { message: errorMessage, issues: serializedIssues }, {
             itemIndex: i
           });
         }
@@ -14073,7 +14057,7 @@ ${error48.issues.map((e, i2) => `  ${i2 + 1}. ${e.path.join(".") || "root"}: ${e
           });
           continue;
         }
-        throw new NodeApiError(this.getNode(), error48, {
+        throw new import_n8n_workflow.NodeApiError(this.getNode(), error48, {
           itemIndex: i
         });
       }
@@ -14101,14 +14085,6 @@ ${error48.issues.map((e, i2) => `  ${i2 + 1}. ${e.path.join(".") || "root"}: ${e
       qs.offset = options.offset;
     if (options.safesearch)
       qs.safesearch = options.safesearch;
-    if (options.site)
-      qs.site = options.site;
-    if (options.fileType)
-      qs.fileType = options.fileType;
-    if (options.excludeTerms)
-      qs.excludeTerms = options.excludeTerms;
-    if (options.exactTerms)
-      qs.exactTerms = options.exactTerms;
     const rawResponse = await context.helpers.httpRequestWithAuthentication.call(context, "youDotComApi", {
       method: "GET",
       url: "https://ydc-index.io/v1/search",
@@ -14127,7 +14103,7 @@ ${error48.issues.map((e, i2) => `  ${i2 + 1}. ${e.path.join(".") || "root"}: ${e
     const options = ContentsOptionsSchema.parse(rawOptions);
     const urls = urlsString.split(",").map((url2) => url2.trim()).filter((url2) => url2.length > 0);
     if (urls.length === 0) {
-      throw new NodeOperationError(context.getNode(), "At least one URL is required", { itemIndex });
+      throw new import_n8n_workflow.NodeOperationError(context.getNode(), "At least one URL is required", { itemIndex });
     }
     const body = { urls };
     if (options.formats && options.formats.length > 0) {
@@ -14190,6 +14166,3 @@ ${error48.issues.map((e, i2) => `  ${i2 + 1}. ${e.path.join(".") || "root"}: ${e
     return result;
   }
 }
-export {
-  YouDotCom
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdotcom-oss/n8n-nodes-youdotcom",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "n8n community node for You.com APIs - Search, Contents extraction, and Express AI agent",
   "license": "MIT",
   "engines": {
@@ -35,7 +35,7 @@
     "rag",
     "grounding"
   ],
-  "type": "module",
+  "type": "commonjs",
   "files": [
     "dist/**"
   ],
@@ -45,7 +45,7 @@
   "scripts": {
     "build": "bun run build:js && bun run build:assets",
     "build:assets": "cp nodes/YouDotCom/youdotcom.svg dist/nodes/YouDotCom/ && cp nodes/YouDotCom/YouDotCom.node.json dist/nodes/YouDotCom/ && cp nodes/YouDotCom/youdotcom.svg dist/credentials/",
-    "build:js": "bun build ./nodes/YouDotCom/YouDotCom.node.ts --outfile ./dist/nodes/YouDotCom/YouDotCom.node.js --target=node --external n8n-workflow && bun build ./credentials/YouDotComApi.credentials.ts --outfile ./dist/credentials/YouDotComApi.credentials.js --target=node --external n8n-workflow",
+    "build:js": "bun build ./nodes/YouDotCom/YouDotCom.node.ts --outfile ./dist/nodes/YouDotCom/YouDotCom.node.js --target=node --format cjs --external n8n-workflow && bun build ./credentials/YouDotComApi.credentials.ts --outfile ./dist/credentials/YouDotComApi.credentials.js --target=node --format cjs --external n8n-workflow",
     "check": "bun run check:biome && bun run check:types && bun run check:package",
     "check:biome": "biome check",
     "check:package": "format-package --check",
@@ -67,7 +67,7 @@
     "n8n-workflow": "^2.6.0"
   },
   "devDependencies": {
-    "@n8n/node-cli": "^0.18.0",
+    "@n8n/node-cli": "^0.19.0",
     "n8n-workflow": "^2.6.0",
     "zod": "^4.3.6"
   }