@youdotcom-oss/n8n-nodes-youdotcom 0.0.1

package/README.md

@@ -0,0 +1,117 @@
+# 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.
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+```bash
+npm install @youdotcom-oss/n8n-nodes-youdotcom
+```
+
+Or install via the n8n UI:
+
+1. Go to **Settings > Community Nodes**
+2. Select **Install**
+3. Enter `@youdotcom-oss/n8n-nodes-youdotcom`
+4. Agree to the risks and select **Install**
+
+## Operations
+
+### Search
+
+Search the web and news using You.com's search API.
+
+| Parameter        | Required | Description                                             |
+| ---------------- | -------- | ------------------------------------------------------- |
+| Query            | Yes      | The search query to retrieve relevant results           |
+| 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            |
+| Language         | No       | Language of results (BCP 47 format)                     |
+| Livecrawl        | No       | Fetch full page content for web, news, or all results   |
+| 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)           |
+
+### Get Contents
+
+Extract content from one or more URLs. Returns clean text, HTML, or structured metadata.
+
+| Parameter     | Required | Description                                              |
+| ------------- | -------- | -------------------------------------------------------- |
+| URLs          | Yes      | Comma-separated list of URLs to extract content from     |
+| Formats       | No       | Output formats: Markdown, HTML, and/or Metadata          |
+| Crawl Timeout | No       | Timeout in seconds for page crawling (1-60)              |
+
+**Output formats:**
+
+- **Markdown** - Clean text content, ideal for LLM processing
+- **HTML** - Full HTML with layout preserved
+- **Metadata** - Structured data (JSON-LD, OpenGraph, Twitter Cards)
+
+### Express (AI Agent)
+
+Get AI-generated answers with web search and citations. Perfect for RAG (Retrieval-Augmented Generation) workflows.
+
+| Parameter         | Required | Description                                          |
+| ----------------- | -------- | ---------------------------------------------------- |
+| Input             | Yes      | Question or prompt for the AI agent                  |
+| Enable Web Search | No       | Whether the AI should search the web (default: true) |
+
+**Response includes:**
+
+- `answer` - AI-generated response with citations
+- `searchResults` - Web search results used for grounding (when web search is enabled)
+- `agent` - Agent identifier
+
+## Credentials
+
+1. Visit [you.com/api](https://you.com/api) 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
+
+## Example Use Cases
+
+- **Research workflows**: Search for information and extract full content from top results
+- **Content aggregation**: Monitor news across topics with customizable filters
+- **AI assistants**: Build chatbots with real-time web knowledge using Express
+- **Data enrichment**: Extract metadata from URLs in your workflows
+- **RAG pipelines**: Ground LLM responses with current web information
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Build the package
+bun run build
+
+# Run tests
+bun test
+
+# Type checking
+bun run check:types
+
+# Linting and formatting
+bun run check
+```
+
+## Resources
+
+- [You.com API Documentation](https://docs.you.com/)
+- [Search API Reference](https://docs.you.com/api-reference/search)
+- [Contents API Reference](https://docs.you.com/api-reference/search/contents)
+- [Express Agent Reference](https://docs.you.com/agents/overview#express-agent)
+- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@youdotcom-oss/n8n-nodes-youdotcom",
+  "version": "0.0.1",
+  "description": "n8n community node for You.com APIs - Search, Contents extraction, and Express AI agent",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18",
+    "bun": ">= 1.2.21"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/youdotcom-oss/dx-toolkit.git",
+    "directory": "packages/n8n-nodes-youdotcom"
+  },
+  "bugs": {
+    "url": "https://github.com/youdotcom-oss/dx-toolkit/issues"
+  },
+  "homepage": "https://github.com/youdotcom-oss/dx-toolkit/tree/main/packages/n8n-nodes-youdotcom#readme",
+  "author": {
+    "name": "You.com",
+    "url": "https://you.com"
+  },
+  "keywords": [
+    "n8n",
+    "n8n-community-node-package",
+    "you.com",
+    "search",
+    "web search",
+    "ai search",
+    "contents",
+    "scrape",
+    "crawl",
+    "express",
+    "ai agent",
+    "rag",
+    "grounding"
+  ],
+  "type": "module",
+  "main": "./dist/main.js",
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "default": "./dist/main.js"
+    }
+  },
+  "files": [
+    "dist/**"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "bun run build:js && bun run build:types && 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 ./src/main.ts --outfile ./dist/main.js --target=node && bun build ./nodes/YouDotCom/YouDotCom.node.ts --outfile ./dist/nodes/YouDotCom/YouDotCom.node.js --target=node && bun build ./credentials/YouDotComApi.credentials.ts --outfile ./dist/credentials/YouDotComApi.credentials.js --target=node",
+    "build:types": "tsc --project tsconfig.build.json",
+    "check": "bun run check:biome && bun run check:types && bun run check:package",
+    "check:biome": "biome check",
+    "check:package": "format-package --check",
+    "check:types": "tsc --noEmit",
+    "check:write": "bun run format && bun run lint:fix && bun run format:package",
+    "format": "biome format --write",
+    "format:check": "biome format",
+    "format:package": "format-package --write",
+    "lint": "biome lint",
+    "lint:fix": "biome lint --write",
+    "lint:n8n": "n8n-node lint",
+    "test": "bun test"
+  },
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/YouDotComApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/YouDotCom/YouDotCom.node.js"
+    ]
+  },
+  "types": "./dist/main.d.ts",
+  "dependencies": {
+    "@n8n/node-cli": "^0.18.0",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "^2.6.0"
+  },
+  "devDependencies": {
+    "eslint": "^9.29.0",
+    "n8n-workflow": "^2.6.0"
+  }
+}