@youdotcom-oss/n8n-nodes-youdotcom 0.0.1 → 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

@@ -0,0 +1,42 @@
+// credentials/YouDotComApi.credentials.ts
+class YouDotComApi {
+  name = "youDotComApi";
+  displayName = "You.com API";
+  icon = { light: "file:youdotcom.svg", dark: "file:youdotcom.svg" };
+  documentationUrl = "https://docs.you.com/get-started/quickstart";
+  properties = [
+    {
+      displayName: "API Key",
+      name: "apiKey",
+      type: "string",
+      typeOptions: {
+        password: true
+      },
+      default: "",
+      required: true,
+      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 = {
+    type: "generic",
+    properties: {
+      headers: {
+        "X-API-Key": "={{$credentials.apiKey}}"
+      }
+    }
+  };
+  test = {
+    request: {
+      baseURL: "https://ydc-index.io",
+      url: "/v1/search",
+      method: "GET",
+      qs: {
+        query: "test",
+        count: 1
+      }
+    }
+  };
+}
+export {
+  YouDotComApi
+};

package/dist/credentials/youdotcom.svg

@@ -0,0 +1,9 @@
+<svg width="65" height="65" viewBox="0 0 65 65" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M27.4941 1.22885C30.6309 -0.409588 34.3672 -0.409644 37.5039 1.22885L59.1709 12.5521C62.7539 14.4242 65 18.1405 65 22.1937V30.6312H50.0488C41.4318 30.6311 34.4492 23.629 34.4492 14.9886V7.81869H30.5488V14.9886C30.5488 23.6289 23.5662 30.631 14.9492 30.6312H7.79785V34.5413H14.9492C23.5662 34.5415 30.5488 41.5479 30.5488 50.1839V65.0003C29.4968 64.8058 28.4686 64.4554 27.4941 63.9496L5.8291 52.6204C2.24614 50.7505 3.91808e-05 47.032 0 42.9788V22.1956C8.82192e-05 18.1426 2.2462 14.4263 5.8291 12.5521L27.4941 1.22885ZM64.9971 34.5413V42.9788C64.9971 47.0321 62.751 50.7506 59.168 52.6204L37.5029 63.9496C36.5285 64.4532 35.5002 64.8058 34.4482 65.0003V50.1839H34.4463C34.4463 41.5479 41.429 34.5415 50.0459 34.5413H64.9971Z" fill="url(#paint0_linear_9856_18465)"/>
+<defs>
+<linearGradient id="paint0_linear_9856_18465" x1="65" y1="0" x2="-0.000328063" y2="65" gradientUnits="userSpaceOnUse">
+<stop offset="0.15" stop-color="#A0A4EE"/>
+<stop offset="0.8" stop-color="#596CED"/>
+</linearGradient>
+</defs>
+</svg>