TARA BOT 🤖✈️🛒

AI agent cá nhân trên Telegram — săn vé máy bay, so sánh giá, cào deal.

Build bởi Tara Le — AI × Growth Marketing

---

✨ Tính năng

Tính năng	Mô tả	Trạng thái
💬 Chat tự nhiên	Hỏi "tìm vé SG Đà Nẵng cuối tuần" — Claude hiểu, SerpAPI search	✅
✈️ Tra cứu chuyến bay	Giá, hãng, giờ bay real-time từ Google Flights	✅
🛒 So sánh giá đồ	Search sản phẩm, so sánh từ nhiều nguồn	✅
🔔 Daily monitor	Mỗi sáng check giá các tuyến quen thuộc, gửi alert	✅
🧠 Context-aware	Claude nhớ lịch sử chat trong session	✅
🔗 Affiliate inject	Tự động thêm affiliate link vào kết quả	✅
🆕 Shopee cào giá	(coming soon)

🎬 Demo

Screenshot / GIF sẽ update sau khi deploy

👤: tìm vé SG ra Hà Nội thứ 7 tuần này
🤖: ✈️ SGN → HAN
    📅 2026-05-16 → 2026-05-21

    1. Vietjet Air — 1,450,000 VND (2h05m)
       SGN 06:00 → HAN 08:05

    2. Vietnam Airlines — 2,100,000 VND (2h)
       SGN 08:30 → HAN 10:30

🧱 Tech stack

┌──────────┐     ┌───────────┐     ┌──────────┐
│ Telegram │ ←→ │  Claude   │ ←→ │ SerpAPI  │
│   Bot    │     │ Sonnet 4.6│     │(Flights+ │
│          │     │(Tool-call)│     │ Shopping)│
└──────────┘     └───────────┘     └──────────┘
                       ↕
                 ┌──────────┐
                 │ GitHub   │
                 │ Actions  │
                 │(scheduler)│
                 └──────────┘

• Telegram Bot — python-telegram-bot v20+
• Claude Sonnet 4.6 — NLU + tool-calling (Anthropic API)
• SerpAPI — Google Flights + Google Shopping (250 free/tháng)
• Fly.io — host 24/7 (free tier)
• GitHub Actions — daily cron monitor (free)

🚀 Deploy 5 phút

1. Fork repo → git clone https://github.com/thaolst/tara-bot
2. Get API keys:
   • @BotFather → tạo bot → copy token
   • SerpAPI → sign up → copy key (500 free/tháng)
   • Anthropic API → copy key
3. Deploy lên Fly.io:

   fly launch --from Dockerfile
   fly secrets set TELEGRAM_TOKEN=xxx ANTHROPIC_API_KEY=xxx SERPAPI_KEY=xxx ALLOWED_USER_ID=xxx
   fly deploy

4. Bật monitor:
   • Settings → Secrets → thêm vào GitHub repo
   • Actions → enable workflow

Chi tiết: DEPLOY.md

📁 Cấu trúc

src/
├── bot.py              # Telegram bot entry point
├── agents.py           # Claude agent + tool-calling
├── config.py           # Env config loader
└── tools/
    └── serpapi.py      # Flight + shopping search
.github/workflows/
└── monitor.yml         # Daily price check

🗺️ Roadmap

• Flight search (SerpAPI)
• Shopping price compare
• Daily price monitor (GitHub Actions)
• 24/7 Telegram bot (Fly.io)
• Shopee price scraper
• Affiliate link injection vào kết quả
• Auto-deal: notify khi deal tốt xuất hiện
• Multi-user support

📝 License

MIT — free to use, fork, modify.

---

Tara Bot — AI agent cá nhân, build public để chia sẻ, không phải product thương mại.