n8n-nodes-deep-research 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Deep Research Node
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# n8n-nodes-deep-research
+
+> **Free, zero-API-key research node for n8n** — search the web, Reddit, Hacker News, Wikipedia, news feeds, scrape any page, and run deep multi-source research, all at zero cost.
+
+![n8n Community Node](https://img.shields.io/badge/n8n-community%20node-blue)
+![Free Forever](https://img.shields.io/badge/free-forever-green)
+![No API Key](https://img.shields.io/badge/no%20API%20key%20required-success)
+
+## Features
+
+| Operation | Source | Auth Required | Description |
+|-----------|--------|---------------|-------------|
+| **Web Search** | DuckDuckGo | No | General web search |
+| **Reddit Search** | Reddit JSON API | No | Search posts with sort & time filters |
+| **Hacker News** | HN Algolia API | No | Search stories, comments, Ask/Show HN |
+| **Wikipedia** | Wikipedia API | No | Search articles, get extracts, any language |
+| **News / RSS** | Google News, BBC, TechCrunch, Custom | No | Search news via RSS feeds |
+| **GitHub** | GitHub Public API | No | Search repos, issues, code, users |
+| **Scrape Web Page** | Any URL | No | Fetch page, extract text, links, metadata |
+| **Deep Research** | ALL sources combined | No | Aggregates from every source in parallel |
+
+## Install
+
+### Option 1: Install via npm (recommended)
+
+```bash
+# In your n8n custom nodes directory
+cd ~/.n8n/custom
+npm install n8n-nodes-deep-research
+```
+
+Then restart n8n.
+
+### Option 2: Install globally and link
+
+```bash
+# Clone or download this repo
+git clone https://github.com/your-username/n8n-nodes-deep-research.git
+cd n8n-nodes-deep-research
+npm install
+npm run build
+
+# Link globally
+npm link
+
+# In your n8n custom nodes directory
+cd ~/.n8n/custom
+npm link n8n-nodes-deep-research
+```
+
+### Option 3: Docker
+
+Add to your `docker-compose.yml`:
+
+```yaml
+volumes:
+  - ./n8n-nodes-deep-research:/usr/local/lib/node_modules/n8n-nodes-deep-research
+```
+
+Or in your Dockerfile:
+
+```dockerfile
+COPY n8n-nodes-deep-research /usr/local/lib/node_modules/n8n-nodes-deep-research
+RUN cd /usr/local/lib/node_modules/n8n-nodes-deep-research && npm install && npm run build
+```
+
+### Option 4: n8n Community Install (if published to npm)
+
+In n8n, go to **Settings → Community Nodes → Install** and search for `deep-research`.
+
+## Usage
+
+1. Open any n8n workflow
+2. Add a **Deep Research** node
+3. Select your operation from the dropdown
+4. Enter your search query
+5. Configure any source-specific options (sort, time filter, etc.)
+6. Run the workflow
+
+### Example: Search Reddit for product feedback
+
+```
+Operation: Reddit Search
+Query: "best mechanical keyboard 2025"
+Max Results: 15
+Sort By: Top
+Time Filter: Past Month
+```
+
+### Example: Deep Research on a topic
+
+```
+Operation: Deep Research
+Query: "quantum computing applications healthcare"
+Max Results: 25
+```
+
+This will run searches across DuckDuckGo, Reddit, Hacker News, Wikipedia, and Google News simultaneously and return all results.
+
+### Example: Scrape a web page
+
+```
+Operation: Scrape Web Page
+URL: https://example.com/article
+Extract Links: true
+Max Text Length: 20000
+```
+
+## Output Format
+
+Each result is returned as a separate item with these common fields:
+
+```json
+{
+  "title": "Result Title",
+  "url": "https://example.com/page",
+  "snippet": "Brief description or excerpt...",
+  "source": "duckduckgo|reddit|hackernews|wikipedia|news-google|github"
+}
+```
+
+### Source-specific extra fields:
+
+**Reddit**: `redditScore`, `redditAuthor`, `redditSubreddit`, `redditNumComments`, `redditCreatedUtc`
+
+**Hacker News**: `hnPoints`, `hnAuthor`, `hnNumComments`, `hnCreated`, `hnObjectId`
+
+**Wikipedia**: `wikiWordcount`, `wikiTimestamp`
+
+**GitHub**: `githubStars`, `githubForks`, `githubLanguage`, `githubTopics`
+
+**News/RSS**: `publishedAt`, `author`
+
+**Scrape**: `description`, `ogTitle`, `ogDescription`, `ogImage`, `textContent`, `textLength`, `links`, `linksCount`
+
+### Return as Single Item
+
+Enable **Additional Fields → Return as Single Item** to get all results wrapped in a single item:
+
+```json
+{
+  "operation": "deepResearch",
+  "totalResults": 25,
+  "results": [
+    { "title": "...", "url": "...", "source": "..." },
+    ...
+  ]
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start development with hot reload
+npm run dev
+
+# Build for production
+npm run build
+
+# Lint code
+npm run lint
+
+# Lint and auto-fix
+npm run lint:fix
+```
+
+## How It Works (No API Keys Needed)
+
+- **DuckDuckGo**: Parses their HTML search page (no API key needed)
+- **Reddit**: Uses the public `reddit.com/search.json` endpoint
+- **Hacker News**: Uses the Algolia HN API (`hn.algolia.com`)
+- **Wikipedia**: Uses the MediaWiki Action API
+- **News**: Parses RSS/Atom feeds from news sites
+- **GitHub**: Uses the unauthenticated public Search API (60 requests/hour)
+- **Scraping**: Fetches raw HTML and extracts content
+
+## Limitations
+
+- DuckDuckGo HTML parsing may break if DDG changes their page structure
+- Reddit's public API has rate limits (without OAuth)
+- GitHub unauthenticated API: 60 requests/hour
+- Web scraping depends on the target page's structure
+- No authentication means some rate-limited APIs may be slower
+
+## License
+
+MIT

package/dist/nodes/DeepResearch/DeepResearch.dark.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" fill="none">
+  <circle cx="24" cy="24" r="22" stroke="#718096" stroke-width="2.5" fill="#1A202C"/>
+  <circle cx="20" cy="20" r="9" stroke="#63B3ED" stroke-width="2.5" fill="none"/>
+  <line x1="27" y1="27" x2="36" y2="36" stroke="#63B3ED" stroke-width="2.5" stroke-linecap="round"/>
+  <circle cx="20" cy="20" r="4" fill="#63B3ED"/>
+  <path d="M14 32 Q18 36 24 38 Q30 36 34 32" stroke="#63B3ED" stroke-width="1.5" fill="none" stroke-dasharray="2 2"/>
+  <circle cx="14" cy="30" r="2" fill="#90CDF4"/>
+  <circle cx="34" cy="30" r="2" fill="#90CDF4"/>
+  <circle cx="24" cy="38" r="2" fill="#90CDF4"/>
+</svg>

package/dist/nodes/DeepResearch/DeepResearch.node.d.ts

@@ -0,0 +1,5 @@
+import { type IExecuteFunctions, type INodeExecutionData, type INodeType, type INodeTypeDescription } from 'n8n-workflow';
+export declare class DeepResearch implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}