# spots

> Finds all places in an area using grid-based Google Places scanning, not just the ones Google surfaces. Supports location or coordinate search, filtering by rating and reviews, and exporting results to JSON, CSV, or an interactive map.

- Skill: `johnalbertini14-glitch/spots` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add johnalbertini14-glitch/spots`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/spots/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics, Data Analysis
- Tags: Csv, Geocoding, Google Places, Json, Location Search, Map Export, Places Api
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/johnalbertini14-glitch/spots

---


# spots

**Find the hidden gems Google doesn't surface.**

Binary: `~/projects/spots/spots` or `go install github.com/foeken/spots@latest`

## Usage

```bash
# Search by location name
spots "Arnhem Centrum" -r 800 -q "breakfast,brunch" --min-rating 4

# Search by coordinates (share location from Telegram)
spots -c 51.9817,5.9093 -r 500 -q "coffee"

# Get reviews for a place
spots reviews "Koffiebar FRENKIE"

# Export to map
spots "Amsterdam De Pijp" -r 600 -o map --out breakfast.html

# Setup help
spots setup
```

## Options

| Flag | Description | Default |
|------|-------------|---------|
| `-c, --coords` | lat,lng directly | - |
| `-r, --radius` | meters | 500 |
| `-q, --query` | search terms | breakfast,brunch,ontbijt,café,bakkerij |
| `--min-rating` | 1-5 | - |
| `--min-reviews` | count | - |
| `--open-now` | only open | false |
| `-o, --output` | json/csv/map | json |

## Setup

Needs Google API key with Places API + Geocoding API enabled.

```bash
spots setup  # full instructions
export GOOGLE_PLACES_API_KEY="..."
```

Key stored in 1Password: `op://Echo/Google API Key/credential`

## Source

https://github.com/foeken/spots