> ## Agent Instructions
>
> Base URL: https://api.anysite.io
> Authentication: send the `access-token` header. Do NOT use `Authorization: Bearer`.
> Full endpoint catalog: https://app.anysite.io/docs
# Installation

Install and configure Anysite CLI

## Installation

  
#### One-Line Installer

    The fastest way to install — no Python or Homebrew required (macOS / Linux):
    ```bash
    curl -fsSL https://raw.githubusercontent.com/anysiteio/anysite-cli/main/install.sh | bash
    ```
    This installs all extras by default (datasets, LLM, PostgreSQL, ClickHouse). Options:
    ```bash
    # Minimal install (no optional dependencies)
    curl -fsSL https://raw.githubusercontent.com/anysiteio/anysite-cli/main/install.sh | bash -s -- --extras none

    # Upgrade existing installation
    curl -fsSL https://raw.githubusercontent.com/anysiteio/anysite-cli/main/install.sh | bash -s -- --upgrade

    # Uninstall
    curl -fsSL https://raw.githubusercontent.com/anysiteio/anysite-cli/main/install.sh | bash -s -- --uninstall
    ```
  
  
#### Homebrew

    ```bash
    brew tap anysiteio/cli https://github.com/anysiteio/anysite-cli
    brew install anysite
    ```
  
  
#### pip

    ```bash
    pip install anysite-cli
    ```
    
> 
      Requires **Python 3.11** or higher.
    
  
  
#### From Source

    ```bash
    git clone https://github.com/anysiteio/anysite-cli.git
    cd anysite-cli
    python -m venv .venv
    source .venv/bin/activate
    pip install -e .
    ```
  

### Optional Extras

Install additional capabilities based on your needs:

| Package | Command | What It Adds |
|---------|---------|--------------|
| **Data** | `pip install "anysite-cli[data]"` | DuckDB + PyArrow for dataset pipelines and SQL querying |
| **LLM** | `pip install "anysite-cli[llm]"` | LLM analysis with OpenAI and Anthropic models |
| **PostgreSQL** | `pip install "anysite-cli[postgres]"` | PostgreSQL database adapter |
| **ClickHouse** | `pip install "anysite-cli[clickhouse]"` | ClickHouse database adapter |
| **All** | `pip install "anysite-cli[all]"` | All optional dependencies |

### Verify Installation

```bash
anysite --version
```

## Configuration

### Set Your API Key

Get your API key from [app.anysite.io](https://app.anysite.io) and configure it:

```bash
anysite config set api_key YOUR_API_KEY
```

### Update Schema Cache

The schema cache enables endpoint discovery and automatic type conversion:

```bash
anysite schema update
```

### Configuration Management

```bash
# View all settings
anysite config list

# Get a specific setting
anysite config get api_key

# Set a value
anysite config set api_key sk-xxxxx

# Show config file path
anysite config path

# Reset to defaults
anysite config reset
```

### Configuration Priority

Settings are resolved in this order (highest priority first):

1. **CLI flags** — `--format csv`, `--parallel 5`
2. **Environment variables** — `ANYSITE_API_KEY`
3. **Config file** — `~/.anysite/config.yaml`
4. **Defaults** — built-in default values

> 
  Use environment variables for CI/CD environments and the config file for local development.

## Claude Code Skill

Install the anysite-cli skill for [Claude Code](/docs/mcp-server/claude-code-tool/installation) to get AI-assisted data collection directly in your terminal:

  
#### Add the skills marketplace

    ```bash
    /plugin marketplace add https://github.com/anysiteio/agent-skills
    ```
  
  
#### Install the skill

    ```bash
    /plugin install anysite-cli@anysite-skills
    ```
  

The skill gives Claude Code full knowledge of all anysite commands, dataset pipeline configuration, database operations, and LLM analysis — so you can describe what data you need in natural language and let the agent build and run the pipeline for you.

## Global Options

These options are available for all commands:

```bash
anysite [OPTIONS] COMMAND

Options:
  --api-key TEXT       API key (or set ANYSITE_API_KEY)
  --base-url TEXT      API base URL
  --debug              Enable debug output
  --no-color           Disable colored output
  --json               Force JSON output (even in terminal)
  --human              Force human-readable output (even in pipes)
  --non-interactive    Disable interactive prompts
  --version, -v        Show version
  --help               Show help
```

> 
  The `--json` and `--human` flags control [Agent Protocol](/docs/cli/agent-protocol) output mode. By default, the CLI auto-detects: JSON in pipes, human-readable in terminals.

## Troubleshooting

  
#### Command not found: anysite

    Make sure the Python scripts directory is in your `PATH`. If you installed in a virtual environment, activate it first:
    ```bash
    source .venv/bin/activate
    ```
    Or install globally:
    ```bash
    pip install --user anysite-cli
    ```
  
  
#### Python version error

    Anysite CLI requires Python 3.11+. Check your version:
    ```bash
    python3 --version
    ```
    Consider using [pyenv](https://github.com/pyenv/pyenv) to manage multiple Python versions.
  
  
#### Schema update fails

    If `anysite schema update` fails, check your API key and network connection:
    ```bash
    anysite config get api_key
    curl -s https://api.anysite.io/openapi.json | head -c 100
    ```
  
  
#### Permission denied on install

    Use a virtual environment or the `--user` flag:
    ```bash
    python -m venv .venv && source .venv/bin/activate
    pip install anysite-cli
    ```
  

## Next Steps

  
#### Discover Endpoints

    Browse and search 118+ available API endpoints
  
  
#### Make API Calls

    Start extracting data with single API requests