Skip to main content

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

pip install agentic-shop-tg
agentic-shop-tg init

Or with pipx (no install needed):

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

Release files for agentic-shop-tg 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agentic-shop-tg 0.1.0
File Size Uploaded
agentic_shop_tg-0.1.0.tar.gz 4.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agentic-shop-tg 0.1.0
File Interpreter ABI Platform
agentic_shop_tg-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.9 kB

Release files / agentic_shop_tg-0.1.0.tar.gz

Download URL agentic_shop_tg-0.1.0.tar.gz
Size 4.8 kB
Tags Source
SHA-256 checksum
How to use checksums
8e68777ef9be10ecbfa88297813886a0d98807bd7fee7244abb05abdfdfc55e2
BLAKE2b-256 checksum
How to use checksums
aacaeb097330eb5daaf864cfbb624b5cce910ed21a3855f8d7ccd6791d74484e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / agentic_shop_tg-0.1.0-py3-none-any.whl

Download URL agentic_shop_tg-0.1.0-py3-none-any.whl
Size 5.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ef6c04a9d894e29c8786b5a1bfa5b1322de7c01c3e0a61d3e5474542a391cc49
BLAKE2b-256 checksum
How to use checksums
b053a854a7982aafca5a0d1d6cd2ec4f87731123126d8898993593be2590b441
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page