Metadata-Version: 2.4
Name: viralanalyzer-cli
Version: 0.2.1
Summary: CLI for ViralAnalyzer — competitive intelligence + AI media generation (subtitles, music, voice, bg-remove) from your terminal. 48 actors, 20 MCP tools.
Author-email: ViralAnalyzer Team <contato@viralanalyzer.com.br>
License: Proprietary
Project-URL: Homepage, https://viralanalyzer.com.br
Project-URL: Documentation, https://api.viralanalyzer.com.br/docs
Project-URL: Repository, https://github.com/Pauloeduspbr/viral-analyzer
Project-URL: Apify Store, https://apify.com/viralanalyzer
Keywords: cli,ai,media,subtitles,music,voice,tts,background-removal,competitive-intelligence,viral,analytics,apify,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer[all]>=0.12.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: rich>=13.7.0
Requires-Dist: textual>=0.70.0
Provides-Extra: web
Requires-Dist: textual-serve>=1.1.0; extra == "web"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: respx>=0.21; extra == "dev"
Requires-Dist: coverage>=7.4; extra == "dev"
Requires-Dist: textual-serve>=1.1.0; extra == "dev"

# ViralAnalyzer CLI

> Competitive intelligence + AI media generation from your terminal.

[![PyPI version](https://badge.fury.io/py/viralanalyzer-cli.svg)](https://pypi.org/project/viralanalyzer-cli/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

## Install

```bash
pip install viralanalyzer-cli
```

## Quick Start

```bash
# Login
viral auth login --email you@email.com --password yourpass

# Browse viral content
viral content list --platform tiktok --limit 10

# Generate AI ideas
viral ideas generate --count 5

# Dashboard KPIs
viral dashboard stats
```

## AI Media Generation (NEW in v0.2.0)

Generate subtitles, music, voice, remove backgrounds, and erase hardcoded subtitles — all from the terminal.

```bash
# Generate TikTok-style subtitles for a video (99 languages)
viral media subtitle https://example.com/video.mp4 --style tiktok --lang auto

# Generate royalty-free music (MusicGen Large 3.3B)
viral media music "epic cinematic orchestral" --style cinematic --duration 30

# Remove background from image (BiRefNet AI)
viral media remove-bg https://example.com/photo.jpg --mode transparent

# Generate speech audio (Edge TTS, 8 voices, 8 languages)
viral media voice "Welcome to ViralAnalyzer" --voice narrator --lang pt

# Remove hardcoded subtitles from video (LAMA inpainting)
viral media erase-subtitle https://example.com/subtitled-video.mp4

# List media jobs
viral media jobs --type music_generator

# Check usage and costs
viral media usage
viral media dashboard
```

## All Command Groups

| Command | Description |
|---------|-------------|
| `viral auth` | Login, register, whoami |
| `viral content` | Browse and search collected content |
| `viral ideas` | AI-generated content ideas |
| `viral trends` | Platform trend analysis |
| `viral profiles` | Manage monitored profiles |
| `viral pipelines` | Pipeline execution and configs (43 scrapers) |
| `viral dashboard` | Dashboard KPIs and history |
| `viral billing` | Plan usage and billing info |
| `viral ai` | AI model settings and usage |
| `viral engage` | Engagement automation and stats |
| `viral analyze` | Analyze content files for viral potential |
| `viral hub` | Content Hub — format ideas into platform posts |
| `viral media` | **AI media generation (subtitles, music, voice, bg-remove)** |
| `viral mcp` | MCP server for AI assistants (Claude, Cursor, VS Code) |

## Platform Coverage

**48 actors** across 11 categories:

- **Social Media**: TikTok, Instagram, YouTube, Twitter/X, Reddit, LinkedIn, Pinterest, Telegram
- **E-Commerce**: Mercado Livre, Amazon BR, iFood, eBay, Shopify
- **Reviews**: Google Maps, Reclame Aqui, Trustpilot
- **Finance**: Yahoo Finance, TradingView, CoinGecko, Sports Betting
- **Knowledge**: Hacker News, GitHub, Stack Overflow, arXiv, Wikipedia, NPM, Steam
- **AI Media Studio**: Subtitle Generator, Music Generator, Background Remover, Voice Generator, Subtitle Eraser, Image Generator (FLUX.1)

## MCP Server (for AI Assistants)

Works with Claude Desktop, Cursor, Windsurf, and VS Code:

```bash
viral mcp serve
```

20 tools available including content search, trend analysis, idea generation, and all 5 media generation tools.

## API

All commands call the ViralAnalyzer API at `api.viralanalyzer.com.br`. You need an account to use the CLI.

- **Free trial**: 5 media jobs/month, 3 platforms
- **Starter** ($9/mo): 50 media jobs, 10 platforms
- **Business** ($29/mo): 200 media jobs, 25 platforms
- **Enterprise** ($99/mo): 1000 media jobs, all 43 platforms

## Links

- **Website**: [viralanalyzer.com.br](https://viralanalyzer.com.br)
- **API Docs**: [api.viralanalyzer.com.br/docs](https://api.viralanalyzer.com.br/docs)
- **Apify Store**: [apify.com/viralanalyzer](https://apify.com/viralanalyzer)
- **GitHub**: [github.com/Pauloeduspbr/viral-analyzer](https://github.com/Pauloeduspbr/viral-analyzer)

## License

Proprietary. See [viralanalyzer.com.br/termos](https://viralanalyzer.com.br/termos) for terms of service.
