Metadata-Version: 2.4
Name: calyprium
Version: 1.0.4
Summary: Calyprium CLI — autonomous web scraping from the command line
Author-email: Calyprium <hello@calyprium.com>
License: MIT
Project-URL: Homepage, https://calyprium.com
Project-URL: Documentation, https://docs.calyprium.com
Project-URL: Repository, https://github.com/Aarkc/calyprium-cli
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.25
Requires-Dist: html2text>=2024.2
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: trafilatura>=2.0
Provides-Extra: dev
Dynamic: license-file

# Calyprium CLI

Command-line tool for [Calyprium](https://calyprium.com) — autonomous web scraping from natural language.

## Install

```bash
pip install calyprium-cli
```

## Authentication

The CLI requires authentication. Choose one method:

### API Key (recommended for automation)

```bash
export CALYPRIUM_API_KEY=clp_your_key_here
calyprium spider list
```

### Browser Login (interactive)

```bash
calyprium login
```

This opens your browser for Keycloak SSO. Tokens are cached in `~/.calyprium/tokens.json`.

### Client Credentials (service accounts)

```bash
export KEYCLOAK_CLIENT_SECRET=your_secret
calyprium spider list
```

## Usage

```bash
# Scrape a website
calyprium scrape https://example.com

# Manage spiders
calyprium spider list
calyprium spider run my-spider

# Domain intelligence
calyprium intel analyze example.com

# Fetch a page with stealth browser
calyprium fetch https://example.com --stealth

# See all commands
calyprium --help
```

## Environment Variables

| Variable | Description |
|----------|-------------|
| `CALYPRIUM_API_KEY` | API key for authentication (preferred) |
| `CALYPRIUM_URL` | Agent API URL |
| `FORGE_URL` | Backend API URL |
| `MIMIC_URL` | Browser service URL |
| `PRISM_URL` | Domain analysis URL |
| `KEYCLOAK_URL` | Keycloak server URL |
| `KEYCLOAK_CLIENT_SECRET` | Client credentials auth |

## License

MIT
