Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ivorpad/mercadona-cli/llms.txt
Use this file to discover all available pages before exploring further.
Mercadona CLI is distributed as a single static binary compiled from Go with no runtime dependencies — no Node, no Python, no shared libraries. Once the binary is on your PATH, every command works immediately. Four installation methods are supported depending on your platform and workflow.
npm (recommended)
curl (macOS / Linux)
Manual binary
From source
The npm package is the easiest cross-platform option. It downloads and installs the correct prebuilt binary for your OS and architecture during postinstall, then wires up the mercadona command via a thin Node wrapper.Install globally to put mercadona on your PATH:npm install -g @ivorpad/mercadona
npx:npx @ivorpad/mercadona search queso
The npm package does not bundle the binary. During npm install, a postinstall script detects your operating system and CPU architecture, then downloads the matching prebuilt binary from the GitHub Releases page. Node.js 16 or later is required to run the installer script, but Node is not needed to run mercadona itself after installation.
The shell installer detects your OS and architecture, downloads the matching binary from GitHub Releases, verifies the SHA-256 checksum, and places mercadona in an appropriate directory.curl -fsSL https://raw.githubusercontent.com/ivorpad/mercadona-cli/main/install.sh | sh
| Variable | Description | Default |
|---|
MERCADONA_VERSION | Pin a specific release tag, e.g. v0.1.0 | Latest release |
MERCADONA_INSTALL_DIR | Override the install directory | /usr/local/bin if writable, else ~/.local/bin |
MERCADONA_VERSION=v0.1.0 MERCADONA_INSTALL_DIR=~/.local/bin \
curl -fsSL https://raw.githubusercontent.com/ivorpad/mercadona-cli/main/install.sh | sh
PATH, the installer will print a reminder:==> note: ~/.local/bin is not on your PATH — add: export PATH="~/.local/bin:$PATH"
~/.bashrc, ~/.zshrc, etc.) and reload your shell.After installation, verify: Download a prebuilt archive directly from the GitHub Releases page.
-
Go to the releases page and find the latest release.
-
Download the archive for your platform. Archive names follow the pattern
mercadona_<version>_<os>_<arch>.tar.gz (.zip on Windows):
| Platform | Archive |
|---|
| macOS (Apple Silicon) | mercadona_<version>_darwin_arm64.tar.gz |
| macOS (Intel) | mercadona_<version>_darwin_amd64.tar.gz |
| Linux (x86-64) | mercadona_<version>_linux_amd64.tar.gz |
| Linux (ARM64) | mercadona_<version>_linux_arm64.tar.gz |
| Windows (x86-64) | mercadona_<version>_windows_amd64.zip |
-
Extract the archive and move the
mercadona binary to a directory on your PATH, for example /usr/local/bin on macOS/Linux:
tar -xzf mercadona_<version>_darwin_arm64.tar.gz
mv mercadona /usr/local/bin/
-
Verify the installation:
A checksums.txt file is published alongside each release. You can verify the download with sha256sum before extracting. Build from source if you want to run unreleased changes or prefer to compile the binary yourself. Go 1.26 or later is required.git clone https://github.com/ivorpad/mercadona-cli.git
cd mercadona-cli
go build -o mercadona ./cmd/mercadona
mercadona binary to a directory on your PATH:mv mercadona /usr/local/bin/
go install github.com/ivorpad/mercadona-cli/...@latest is not wired up yet — the module path in go.mod does not match the repository URL, so the standard go install flow will not resolve correctly. Use go build as shown above.
Verify your installation
After any installation method, confirm the binary is reachable and print its version:
A local go build prints dev. A release binary prints the version, short commit hash, and build date:
v0.1.0 (abc1234, 2025-01-01T00:00:00Z)
Next steps
Once installed, follow the Quickstart to search products and price a shopping list in under five minutes, or jump straight to Authentication to set up the authenticated cart and checkout flow.