serp-cli 2026.4.5.0__tar.gz

serp_cli-2026.4.5.0/.env.example

@@ -0,0 +1,9 @@
+# AceDataCloud API Token
+# Get yours at https://platform.acedata.cloud
+ACEDATACLOUD_API_TOKEN=
+
+# Optional: Custom API base URL (default: https://api.acedata.cloud)
+# ACEDATACLOUD_API_BASE_URL=https://api.acedata.cloud
+
+# Optional: Request timeout in seconds (default: 30)
+# SERP_REQUEST_TIMEOUT=30

serp_cli-2026.4.5.0/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2025-01-21
+
+### Added
+
+- Initial release of SERP CLI
+- `search` command for Google web search with all search types
+- `images` shortcut command for Google Image search
+- `news` shortcut command for Google News search
+- `videos` shortcut command for Google Video search
+- `places` shortcut command for Google Places search
+- `maps` shortcut command for Google Maps search
+- `search-types` command to list available search types
+- `time-ranges` command to list time range filters
+- `config` command to show current configuration
+- Country and language localization support
+- Time range filtering for news and trending content
+- Pagination support with `--number` and `--page`
+- `--json` flag for machine-readable output on all commands
+- Rich terminal formatting for human-readable output
+- Docker support via Dockerfile and docker-compose.yaml

serp_cli-2026.4.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AceDataCloud
+
+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.

serp_cli-2026.4.5.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.1
+Name: serp-cli
+Version: 2026.4.5.0
+Summary: CLI tool for Google SERP (Search Engine Results) via AceDataCloud API
+Project-URL: Homepage, https://github.com/AceDataCloud/SerpCli
+Project-URL: Repository, https://github.com/AceDataCloud/SerpCli
+Project-URL: Issues, https://github.com/AceDataCloud/SerpCli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/SerpCli/blob/main/CHANGELOG.md
+Author-email: AceDataCloud <support@acedata.cloud>
+Maintainer-email: AceDataCloud <support@acedata.cloud>
+License: MIT
+License-File: LICENSE
+Keywords: acedata,cli,command-line,google,search,serp,web-search
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: all
+Requires-Dist: serp-cli[dev,release,test]; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: release
+Requires-Dist: build>=1.2.0; extra == 'release'
+Requires-Dist: twine>=6.1.0; extra == 'release'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Requires-Dist: respx>=0.21.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# SERP CLI
+
+A command-line tool for Google Search (SERP) via the [AceDataCloud](https://platform.acedata.cloud) 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
+
+```bash
+pip install serp-cli
+```
+
+## Quick Start
+
+```bash
+# Set your API token
+export ACEDATACLOUD_API_TOKEN=your_token_here
+
+# Web search
+serp search "artificial intelligence"
+
+# Image search
+serp images "sunset photography"
+
+# 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
+
+| Command | Description |
+|---------|-------------|
+| `search` | Google web search (all types via `-t`) |
+| `images` | Google Image search |
+| `news` | Google News search |
+| `videos` | Google Video search |
+| `places` | Google Places search |
+| `maps` | Google Maps search |
+| `search-types` | List available search types |
+| `time-ranges` | List time range filters |
+| `config` | Show current configuration |
+
+## Search Options
+
+| Option | Description |
+|--------|-------------|
+| `-t`, `--type` | Search type: search, images, news, maps, places, videos |
+| `-c`, `--country` | Country code (e.g. us, cn, uk) |
+| `-l`, `--language` | Language code (e.g. en, zh-cn, fr) |
+| `--time-range` | Time filter: qdr:h (hour), qdr:d (day), qdr:w (week), qdr:m (month) |
+| `-n`, `--number` | Number of results per page (default: 10) |
+| `-p`, `--page` | Page number for pagination |
+| `--json` | Output raw JSON |
+
+## Configuration
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| `ACEDATACLOUD_API_TOKEN` | API authentication token | (required) |
+| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
+| `SERP_REQUEST_TIMEOUT` | Request timeout in seconds | `30` |
+
+You can also use a `.env` file or pass `--token` directly.
+
+## Docker
+
+```bash
+docker compose run serp-cli search "hello world"
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[all]"
+
+# Run tests
+pytest
+
+# Run linter
+ruff check .
+ruff format --check .
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [AceDataCloud Platform](https://platform.acedata.cloud)
+- [API Documentation](https://docs.acedata.cloud)

serp_cli-2026.4.5.0/README.md

@@ -0,0 +1,110 @@
+# SERP CLI
+
+A command-line tool for Google Search (SERP) via the [AceDataCloud](https://platform.acedata.cloud) 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
+
+```bash
+pip install serp-cli
+```
+
+## Quick Start
+
+```bash
+# Set your API token
+export ACEDATACLOUD_API_TOKEN=your_token_here
+
+# Web search
+serp search "artificial intelligence"
+
+# Image search
+serp images "sunset photography"
+
+# 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
+
+| Command | Description |
+|---------|-------------|
+| `search` | Google web search (all types via `-t`) |
+| `images` | Google Image search |
+| `news` | Google News search |
+| `videos` | Google Video search |
+| `places` | Google Places search |
+| `maps` | Google Maps search |
+| `search-types` | List available search types |
+| `time-ranges` | List time range filters |
+| `config` | Show current configuration |
+
+## Search Options
+
+| Option | Description |
+|--------|-------------|
+| `-t`, `--type` | Search type: search, images, news, maps, places, videos |
+| `-c`, `--country` | Country code (e.g. us, cn, uk) |
+| `-l`, `--language` | Language code (e.g. en, zh-cn, fr) |
+| `--time-range` | Time filter: qdr:h (hour), qdr:d (day), qdr:w (week), qdr:m (month) |
+| `-n`, `--number` | Number of results per page (default: 10) |
+| `-p`, `--page` | Page number for pagination |
+| `--json` | Output raw JSON |
+
+## Configuration
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| `ACEDATACLOUD_API_TOKEN` | API authentication token | (required) |
+| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
+| `SERP_REQUEST_TIMEOUT` | Request timeout in seconds | `30` |
+
+You can also use a `.env` file or pass `--token` directly.
+
+## Docker
+
+```bash
+docker compose run serp-cli search "hello world"
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[all]"
+
+# Run tests
+pytest
+
+# Run linter
+ruff check .
+ruff format --check .
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [AceDataCloud Platform](https://platform.acedata.cloud)
+- [API Documentation](https://docs.acedata.cloud)

serp_cli-2026.4.5.0/pyproject.toml

@@ -0,0 +1,118 @@
+[project]
+name = "serp-cli"
+version = "2026.4.5.0"
+description = "CLI tool for Google SERP (Search Engine Results) via AceDataCloud API"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "AceDataCloud", email = "support@acedata.cloud" }
+]
+maintainers = [
+    { name = "AceDataCloud", email = "support@acedata.cloud" }
+]
+keywords = [
+    "cli",
+    "serp",
+    "google",
+    "search",
+    "web-search",
+    "acedata",
+    "command-line",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Internet :: WWW/HTTP :: Indexing/Search",
+    "Environment :: Console",
+]
+dependencies = [
+    "click>=8.1.0",
+    "httpx>=0.27.0",
+    "python-dotenv>=1.0.0",
+    "rich>=13.0.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "ruff>=0.4.0",
+    "mypy>=1.10.0",
+    "pre-commit>=3.7.0",
+]
+test = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=5.0.0",
+    "respx>=0.21.0",
+]
+release = [
+    "build>=1.2.0",
+    "twine>=6.1.0",
+]
+all = [
+    "serp-cli[dev,test,release]",
+]
+
+[project.scripts]
+serp-cli = "serp_cli.main:cli"
+serp = "serp_cli.main:cli"
+
+[project.urls]
+Homepage = "https://github.com/AceDataCloud/SerpCli"
+Repository = "https://github.com/AceDataCloud/SerpCli"
+Issues = "https://github.com/AceDataCloud/SerpCli/issues"
+Changelog = "https://github.com/AceDataCloud/SerpCli/blob/main/CHANGELOG.md"
+
+[build-system]
+requires = ["hatchling>=1.21.0,<1.22.0"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["serp_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "serp_cli/",
+    "tests/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    ".env.example",
+]
+
+# Mypy Configuration
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+check_untyped_defs = true
+
+# Pytest Configuration
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+markers = [
+    "integration: marks tests that require real API access",
+    "slow: marks slow tests",
+]
+
+# Ruff Configuration
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "B", "C4", "UP", "ARG", "SIM"]
+ignore = ["E501"]
+
+[tool.ruff.format]
+quote-style = "double"

serp_cli-2026.4.5.0/serp_cli/__init__.py

@@ -0,0 +1 @@
+"""SERP CLI - Google Search via AceDataCloud API."""

serp_cli-2026.4.5.0/serp_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as python -m serp_cli."""
+
+from serp_cli.main import cli
+
+cli()

serp_cli-2026.4.5.0/serp_cli/commands/info.py

@@ -0,0 +1,50 @@
+"""Info and utility commands."""
+
+import click
+
+from serp_cli.core.config import settings
+from serp_cli.core.output import console, print_search_types
+
+
+@click.command("search-types")
+def search_types() -> None:
+    """List available search types."""
+    print_search_types()
+
+
+@click.command("time-ranges")
+def time_ranges() -> None:
+    """List available time range filters."""
+    from rich.table import Table
+
+    table = Table(title="Time Range Filters")
+    table.add_column("Code", style="bold cyan")
+    table.add_column("Period")
+    table.add_column("Description")
+
+    table.add_row("qdr:h", "Past Hour", "Results from the last hour")
+    table.add_row("qdr:d", "Past Day", "Results from the last 24 hours")
+    table.add_row("qdr:w", "Past Week", "Results from the last 7 days")
+    table.add_row("qdr:m", "Past Month", "Results from the last 30 days")
+    table.add_row("(none)", "Any Time", "No time restriction (default)")
+
+    console.print(table)
+
+
+@click.command()
+def config() -> None:
+    """Show current configuration."""
+    from rich.table import Table
+
+    table = Table(title="SERP CLI Configuration")
+    table.add_column("Setting", style="bold cyan")
+    table.add_column("Value")
+
+    table.add_row("API Base URL", settings.api_base_url)
+    table.add_row(
+        "API Token",
+        f"{settings.api_token[:8]}..." if settings.api_token else "[red]Not set[/red]",
+    )
+    table.add_row("Request Timeout", f"{settings.request_timeout}s")
+
+    console.print(table)