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

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

@@ -14,7 +14,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 = {

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

@@ -13548,18 +13548,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 +13678,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 +13750,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 +13874,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)"
           }
         ]
       },
@@ -14101,14 +14063,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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdotcom-oss/n8n-nodes-youdotcom",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "n8n community node for You.com APIs - Search, Contents extraction, and Express AI agent",
   "license": "MIT",
   "engines": {
@@ -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"
   }