n8nir-google-custom-search

Package Information

Released: 5/27/2025
Downloads: 1,029 weekly / 1,029 monthly
Latest Version: 0.0.4
Author: jackvatan

Documentation

n8n-nodes-google-custom-search

This is a custom n8n node that allows you to perform Google Custom Search operations using OAuth2 authentication.

Features

  • Perform Google Custom Search operations
  • Use OAuth2 authentication with Google
  • Customize search parameters
  • Filter search results

Prerequisites

  • n8n (version 0.125.0 or later)
  • Google Cloud Platform account with Custom Search API enabled
  • Google Custom Search Engine ID

Installation

In n8n desktop app

  1. Go to Settings > Community Nodes
  2. Click on Install
  3. Enter n8n-nodes-google-custom-search in the Name field
  4. Click on Install

In n8n docker installation

  1. Add the following to your docker-compose.yml file:
volumes:
  - ./custom:/home/node/.n8n/custom
  1. Install the node using npm:
npm install n8n-nodes-google-custom-search
  1. Copy the node to your custom directory:
cp -r node_modules/n8n-nodes-google-custom-search ~/.n8n/custom/

Setup

Google Cloud Platform Setup

  1. Go to the Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable the Custom Search API
  4. Create OAuth2 credentials (Client ID and Client Secret)
  5. Configure the OAuth consent screen
  6. Add the redirect URI: https://your-n8n-domain.com/rest/oauth2-credential/callback

Google Custom Search Engine Setup

  1. Go to the Google Programmable Search Engine
  2. Create a new search engine
  3. Configure the sites to search
  4. Get your Search Engine ID

Usage

  1. Add the Google Custom Search node to your workflow
  2. Create a new credential of type "Google Custom Search API"
  3. Enter your Client ID and Client Secret
  4. Complete the OAuth2 authentication flow
  5. Configure the node with your Search Engine ID and query
  6. Run the workflow

Parameters

Operation

  • Search: Perform a custom search

Required Parameters

  • Search Engine ID: Your Google Custom Search Engine ID
  • Query: The search query to use

Optional Parameters

  • Return All Results: Whether to return all results or only up to a given limit
  • Limit: Max number of results to return (when not returning all)
  • Additional Fields: Various search customization options

License

MIT

Discussion