n8n-nodes-gemini-search
Version:
n8n nodes to interact with Google Gemini API for search and content generation
124 lines (89 loc) • 4.18 kB
Markdown
# n8n-nodes-gemini-search
This is an n8n community node package that provides nodes to interact with Google's Gemini AI models for search and content generation capabilities.
 
## Features
- **Gemini Search Node**: A comprehensive node that can perform web searches and generate content using Google's Gemini models
- **Gemini Search Tool**: A simplified tool version optimized for quick searches with Google Gemini
- **URL Restriction**: Limit searches to specific websites or domains
- **Organization Context**: Provide company or domain-specific context for more relevant results
- **Multiple Model Support**: Choose from various Gemini models including latest versions (1.0 Pro, 1.5 Pro, 2.0 Flash, 2.0 Pro, 2.5 Pro)
## Installation
### In n8n Desktop
1. Go to Settings > Community Nodes
2. Select "Install"
3. Enter `n8n-nodes-gemini-search` in the "npm package name" field
4. Click "Install"
### In n8n Cloud
Use the Community Nodes feature to add this node to your cloud instance.
## Usage
### Gemini Search Node
This node offers two operations:
1. **Web Search**: Performs a web search using Gemini's capabilities
2. **Generate Content**: Generates content using Gemini without web search
#### Configuration Options:
- **API Key**: Google Gemini API key (required)
- **Model**: Select from available Gemini models
- **Prompt/Query**: Your search query or content generation prompt
- **Organization Context**: Optional context to focus the search on a specific organization
- **URL Restrictions**: Limit search to specific websites (comma-separated)
- **System Instruction**: Custom instructions to guide the AI behavior
- **Advanced Options**:
- Temperature: Control response randomness (0.0-1.0)
- Max Output Tokens: Limit response length
- Top P/Top K: Fine-tune token selection
- Extract Source URL: Retrieve source URLs for search results
### Gemini Search Tool
This is a simplified version focused on search, optimized for use as an n8n tool:
- **Query**: Enter your search query
- **Model**: Select from available Gemini models
- **Organization Context**: Optional context to focus on specific organizations
- **URL Restrictions**: Limit search to specific websites
- **Options**:
- Temperature: Control response randomness
- Max Output Tokens: Limit response length
- Custom System Instruction: Override default instructions
- Return Full Response: Include complete API response data
- Extract Source URL: Retrieve source URLs
## Example Workflows
### Basic Search
1. Create a new workflow
2. Add a "Gemini Search Tool" node
3. Configure your API credentials
4. Enter a search query
5. Execute and view the search results
### Advanced Content Generation
1. Create a new workflow
2. Add a "Gemini Search" node
3. Set operation to "Generate Content"
4. Configure model and prompt
5. Adjust temperature and token settings as needed
6. Execute to generate AI content
## Using as a Tool
This node can be used as a tool in n8n AI Agents. To enable community nodes as tools, you need to set the `N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE` environment variable to `true`.
### Setting the Environment Variable
#### Bash/Zsh Shell
```bash
export N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
n8n start
```
#### Docker (docker-compose.yml)
```yaml
environment:
- N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
```
#### Desktop App
Create a `.env` file in the n8n directory:
```
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
```
#### Permanent Setting (Mac/Linux)
Add to your `~/.zshrc` or `~/.bash_profile`:
```bash
export N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
```
## Credentials
This node requires a Google Gemini API key. You can get one from the [Google AI Studio](https://ai.google.dev/).
## Support
For issues or feature requests, please [open an issue](https://github.com/rufaromugabe/n8n-nodes-gemini-search/issues) on GitHub.
## License
[MIT](LICENSE)