Metadata-Version: 2.5
Name: fastcrawl-cli
Version: 0.1.0
Summary: Fastcrawl CLI — turn any URL into clean, LLM-ready markdown from your terminal. Free via guest /try, or full API with FASTCRAWL_API_KEY.
Project-URL: Homepage, https://fastcrawl.net
Project-URL: Repository, https://github.com/Fastcrawl-net/fastcrawl-cli
Project-URL: Documentation, https://fastcrawl.net/docs
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,cli,fastcrawl,llm,markdown,scraping,web-scraping
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Text Processing :: Markup
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# fastcrawl-cli

Turn any URL into **clean, LLM-ready markdown** straight from your terminal. Zero dependencies (Python stdlib only).

The Fastcrawl CLI works **free out of the box** — no API key needed. It uses the guest [Fastcrawl try endpoint](https://fastcrawl.net) by default. Set a `FASTCRAWL_API_KEY` and it transparently upgrades to the full API (scrape, html, all formats).

```bash
pip install fastcrawl-cli
```

## Quick start

```bash
# Free — no key needed (guest /try, 10 req/hr/IP)
fastcrawl https://example.com

# Save to a file
fastcrawl https://example.com -o page.md

# Full API with a key (scrape endpoint, no rate limits, up to 2,000 free credits/mo)
export FASTCRAWL_API_KEY=fc_...
fastcrawl https://example.com

# Full JSON response (markdown + metadata + credits)
fastcrawl https://example.com --json
```

## Why

- **Zero dependencies** — pure stdlib, installs anywhere, no bloat.
- **Free tier works instantly** — guest endpoint, no signup.
- **Upgrades seamlessly** — the same command hits the full API once you set a key.
- **Agent-friendly** — clean markdown is exactly what LLM pipelines and RAG need.

## Usage

```
fastcrawl [URL] [-o FILE] [--json] [--html] [--timeout SECONDS]
```

| Flag | Description |
|---|---|
| `-o, --output FILE` | Write markdown to a file instead of stdout |
| `--json` | Print the full JSON response (markdown, metadata, credits) |
| `--html` | Also request HTML output (requires `FASTCRAWL_API_KEY`) |
| `--timeout SECONDS` | Request timeout (default 30) |

## API

```python
from fastcrawl_cli import scrape

result = scrape("https://example.com")
# {"success": True, "markdown": "...", "duration_ms": 87}
```

## License

MIT. Built with the [Fastcrawl API](https://fastcrawl.net) — cloud scraping & crawling for AI agents. 2× the free credits of other scraping APIs.
