SERP CLI

A command-line tool for Google Search (SERP) via the AceDataCloud platform.

Features

• Web Search — Search Google and get structured results (organic, knowledge graph, answer box)
• Image Search — Find images with serp images
• News Search — Get news articles with time filtering
• Video Search — Find video content from YouTube and more
• Places Search — Find local businesses and places
• Maps Search — Search Google Maps for locations
• Rich Output — Beautiful terminal formatting with --json for scripting
• Localization — Country and language support for localized results

Installation

pip install serp-cli

Quick Start

# Set your API token
export ACEDATACLOUD_API_TOKEN=your_token_here

# Web search
serp search "artificial intelligence"

# Image search
serp images "sunset photography"

# Image search with image-size filter
serp images "sunset photography" --image-size 12mp

# News with time filter
serp news "tech news" --time-range qdr:d

# Places search
serp places "coffee shops near Times Square" -c us

# Search with pagination
serp search "python tutorials" -n 20 -p 2

# Get JSON output
serp search "hello world" --json | jq '.organic[0].title'

Commands

Search Options

Configuration

You can also use a .env file or pass --token directly.

Docker

docker compose run serp-cli search "hello world"

Development

# Install with dev dependencies
pip install -e ".[all]"

# Run tests
pytest

# Run linter
ruff check .
ruff format --check .

License

MIT License - see LICENSE for details.

Links

• AceDataCloud Platform
• API Documentation