Metadata-Version: 2.4
Name: agentic-shop-tg
Version: 0.1.0
Summary: Turn any online shop into a Telegram storefront bot — scrape products, browse, add to cart, and checkout inside Telegram
Author-email: Zak Krevitt <zakkrevitt@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/ZakKrevitt/shop-to-telegram-template
Project-URL: Repository, https://github.com/ZakKrevitt/shop-to-telegram-template
Keywords: telegram,bot,shop,ecommerce,scraper
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: python-telegram-bot
Requires-Dist: requests
Requires-Dist: beautifulsoup4
Requires-Dist: playwright
Requires-Dist: python-dotenv

# agentic-shop-tg

Turn any online shop into a Telegram storefront bot — scrape products, let users browse, add to cart, and checkout, all inside Telegram.

## Install & run

```bash
pip install agentic-shop-tg
agentic-shop-tg init
```

Or with pipx (no install needed):

```bash
pipx run agentic-shop-tg
```

The wizard scaffolds a project, asks for your Telegram bot token and shop URL, and gets you running in under a minute.

## What it sets up

- `bot.py` — ShopEngine + CartManager + Telegram message formatting
- `scraper.py` — base scraper class (plug in Playwright or BeautifulSoup)
- `products.json` — product catalog (edit directly or regenerate via scraper)
- `.env` — your bot token and shop config

## Customizing

- Implement `ShopScraper.scrape()` to pull real products from your shop
- Wire the checkout callback to Stripe, Shopify, or your payment provider
- Swap CartManager for Redis/database for persistent carts

## License

MIT
