claudeers.

🔓 unclaimed — this page was auto-generated from GitHub. Are you the creator?

Claim this page →
// Automation & Workflows

tara-bot

Tara Bot — AI Telegram agent: search flights, compare prices, inject affiliate links

Actively maintained
100/100
last commit 25 days ago
last release about 2 months ago
releases 1
open issues 0
// install
git clone https://github.com/thaolst/tara-bot

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 Lê Song Tiên Thảo · GitHub · LinkedIn · Facebook

Đây là side project. Repo chính của mình về AI x growth marketing: growth-mcp (MCP server, pip install growth-mcp) và ai-growth-prompts.

✨ Tính năng

Tính năngMô tảTrạng thái
💬 Chat tự nhiênHỏi "tìm vé SG Đà Nẵng cuối tuần" — Claude hiểu ngữ cảnh, tự gọi đúng tool
✈️ Tìm vé máy bayGiá real-time từ Google Flights, top 5 chuyến, link Google Flights
🛒 So sánh giá sản phẩmGoogle Shopping — giá, rating, shop, link mua trực tiếp
🗓️ Xem ngày giờ xuất hànhTính Can Chi, giờ Hoàng Đạo, xung hợp tuổi theo lịch can chi truyền thống. Chỉ chạy khi bạn chủ động hỏi, mặc định vẫn tìm vé thẳng. Tham khảo, không phải dự báo có cơ sở khoa học
👨‍👩‍👧 Xem ngày cho nhóm2-5 người cùng đi: loại ngày xung với bất kỳ ai, tìm ngày an toàn cho cả nhóm
🔔 Daily price monitor9AM mỗi sáng tự động check giá 4 tuyến SGN↔HAN/DAD/PQC, gửi Telegram
🧠 Memory trong sessionLLM nhớ toàn bộ lịch sử chat, hỏi tiếp không cần nhắc lại
Prompt cachingCache system prompt từ turn 2 → tiết kiệm ~90% token cost (Anthropic)
🧩 Adaptive thinkingClaude tự bật extended thinking khi câu hỏi phức tạp (Anthropic)
🔄 LLM mode switchHỗ trợ Anthropic Claude hoặc OpenAI-compatible (Gemini, local LLM)
🔁 Multi-turn tool loopMột lượt hỏi có thể gọi nhiều tool liên tiếp, tối đa 5 vòng
🔗 Google Flights linkMỗi kết quả vé kèm link tìm thêm trên Google Flights
🛡️ Private modeALLOWED_USER_ID — chỉ bạn mới dùng được bot
🔄 Commands/start /reset /uptime
🏥 Health checkHTTP endpoint cho Fly.io keepalive
🆕 Shopee cào giá🔜
🔔 Auto-deal alertNotify khi giá rẻ hơn ngưỡng đặt🔜
👥 Multi-user🔜

🎬 Demo

👤: tìm vé SG Hà Nội thứ 7 tuần này

🤖: ✈️ Sài Gòn → Hà Nội
    📅 2026-05-16 → 2026-05-21 (5 chuyến)

    🏆 1,450,000đ 06:00→08:05 (2h5)
       `Vietjet Air VJ123` · *Thẳng*

    🥈 1,890,000đ 09:30→11:35 (2h5)
       `Bamboo Airways QH201` · *Thẳng*

    🥉 2,100,000đ 08:30→10:30 (2h0)
       `Vietnam Airlines VN123` · *Thẳng*

    [🔍 Xem thêm trên Google Flights](https://google.com/travel/flights?...)
👤: iPhone 16 giá bao nhiêu

🤖: 🛒 iPhone 16 (6 kết quả)

    🥇 *22,990,000đ* 🔥 — CellphoneS
       ⭐⭐⭐⭐ 4.8 (2,341 đánh giá)
       🔗 https://cellphones.com.vn/...

    🥈 *23,500,000đ* — Thế Giới Di Động
       ⭐⭐⭐⭐ 4.7 (1,890 đánh giá)
👤: mình sinh 1995, xem ngày tốt đi Đà Nẵng tháng 7

🤖: Tuổi Hợi 🐗 (1995), mình xem ngày xuất hành tháng 7 cho bạn.

    Ngày đẹp nhất là 2026-07-06 (Thứ 2), ngày Đinh Mão 🐰 - rất tốt, tam hợp.
    Giờ tốt trong ngày: 07:00-09:00, 11:00-13:00, 17:00-19:00.

    Mấy ngày khác cũng đẹp nếu cần lùi lịch:
    🟢 2026-07-05 (Chủ Nhật) - rất tốt
    🟢 2026-07-09 (Thứ 5) - tốt

    Bạn muốn mình tìm vé cho ngày nào không?

    Lưu ý: đây chỉ là tham khảo theo lịch can chi truyền thống,
    không phải dự báo có cơ sở khoa học.

🧱 Tech stack

┌──────────────┐     ┌──────────────────────────┐     ┌──────────────────┐
│   Telegram   │ ←→  │      LLM Backend          │ ←→  │     SerpAPI      │
│     Bot      │     │(Anthropic / OpenAI-compat)│     │  · Google Flights│
│              │     │  · Multi-turn tool loop   │     │  · Google Shopping│
│  /start      │     │  · Prompt caching         │     └──────────────────┘
│  /reset      │     │  · Adaptive thinking      │
│  /uptime     │     │  · Session memory         │
└──────────────┘     └──────────────────────────┘
│  /uptime     │     └──────────────────────────┘
└──────────────┘
                      ┌──────────────────────────┐
                      │      GitHub Actions       │
                      │  · 9AM daily monitor      │
                      │  · 4 tuyến bay cố định    │
                      └──────────────────────────┘
Thành phầnChi tiết
AIClaude Sonnet 4.6 (Anthropic) hoặc OpenAI-compatible (Gemini, ...)
Botpython-telegram-bot v20+
SearchSerpAPI — Google Flights + Google Shopping
HostFly.io free tier, region Singapore
SchedulerGitHub Actions cron, 9AM Vietnam (UTC+7)
LanguagePython 3.11+

🚀 Deploy trong 5 phút

1. Chuẩn bị API keys

KeyLấy ở đâuFree quota
TELEGRAM_TOKEN@BotFather/newbotKhông giới hạn
ALLOWED_USER_ID@userinfobot/start
TELEGRAM_CHAT_IDGiống ALLOWED_USER_ID
LLM_MODEanthropic or openaianthropic
ANTHROPIC_API_KEYconsole.anthropic.com$5 free credit
OPENAI_API_KEYGoogle AI StudioFree tier
SERPAPI_KEYserpapi.com250 req/tháng

2. Deploy lên Fly.io

git clone https://github.com/thaolst/tara-bot
cd tara-bot

fly auth login
fly launch --from Dockerfile --name tara-bot-yourname

fly secrets set \
  TELEGRAM_TOKEN=xxx \
  ANTHROPIC_API_KEY=xxx \
  SERPAPI_KEY=xxx \
  ALLOWED_USER_ID=xxx \
  TELEGRAM_CHAT_ID=xxx

fly deploy

3. Bật daily monitor

  • GitHub repo → Settings → Secrets → Actions → thêm 3 secrets: SERPAPI_KEY, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID
  • Actions tabFlight Monitor → Enable workflow

Chi tiết đầy đủ: DEPLOY.md

⚙️ Cấu hình

Env varBắt buộcMô tả
ANTHROPIC_API_KEYAnthropic API key
TELEGRAM_TOKENTelegram Bot token từ @BotFather
ALLOWED_USER_IDTelegram user ID — chỉ ID này mới dùng được bot
SERPAPI_KEYSerpAPI key cho Flights + Shopping
TELEGRAM_CHAT_IDChat ID nhận daily monitor (thường = ALLOWED_USER_ID)
AFFILIATE_TEMPLATETemplate URL affiliate (coming soon)

📁 Cấu trúc

tara-bot/
├── src/
│   ├── bot.py          # Telegram bot — polling, session, /start /reset /uptime
│   ├── agents.py       # Claude agent — tool loop, prompt caching, adaptive thinking
│   ├── config.py       # Env config loader
│   └── tools/
│       ├── serpapi.py      # Flight search + Shopping search
│       └── lucky_dates.py  # Xem ngày giờ tốt theo lịch can chi (tham khảo)
├── scripts/
│   └── monitor.py      # Daily price check — chạy bởi GitHub Actions
├── .github/workflows/
│   └── monitor.yml     # Cron 9AM Vietnam daily
├── Dockerfile
├── fly.toml            # Fly.io config — region Singapore, 1GB RAM
├── DEPLOY.md
└── CHANGELOG.md

💰 Chi phí

ServiceCostGhi chú
Fly.io$0Free tier đủ dùng
SerpAPI$0250 req/tháng free
Anthropic~$0.50/thángPrompt caching giảm ~90% cost
GitHub Actions$0Public repo free
Tổng~$0.50/tháng

🗺️ Roadmap

  • Flight search — top 5 chuyến, compact format, Google Flights link
  • Shopping search — giá, rating, shop, link mua
  • Xem ngày giờ xuất hành theo lịch can chi — Can Chi, giờ Hoàng Đạo, xung hợp tuổi, opt-in (tham khảo, có disclaimer)
  • Xem ngày cho nhóm 2-5 người — loại ngày xung với bất kỳ ai
  • Daily price monitor 9AM (GitHub Actions)
  • 24/7 bot trên Fly.io (Singapore)
  • Prompt caching — tiết kiệm token cost
  • Adaptive thinking — extended thinking tự động
  • Multi-turn tool loop (max 5 iter)
  • Private mode (ALLOWED_USER_ID)
  • /reset /uptime commands
  • Affiliate link injection đầy đủ
  • Shopee price scraper
  • Auto-deal alert (notify khi giá rẻ hơn ngưỡng)
  • Multi-user support

⚠️ Về tính năng xem ngày giờ tốt

Tính năng này tính Can Chi, giờ Hoàng Đạo và xung hợp tuổi theo lịch can chi truyền thống. Nó được thiết kế để:

  • Chỉ chạy khi người dùng chủ động hỏi về ngày tốt. Mặc định bot vẫn tìm vé thẳng, không tự xem ngày.
  • Nhận thông tin linh hoạt: chỉ năm sinh cũng chạy được, đủ ngày tháng thì tính thêm Nhật Trụ cho sát hơn, thêm giờ sinh thì ghi nhận đủ Tứ Trụ.
  • Luôn kèm một câu nhắc rõ ràng ở cuối mỗi kết quả.

Đây là nội dung tham khảo theo quy ước truyền thống, không phải dự báo có cơ sở khoa học và không thể kiểm chứng như giá vé hay thời tiết. Phần xem ngày cho nhóm là cách dung hòa do mình tự thiết kế (tử vi truyền thống vốn xem cho một người), nên càng đông người thì ngày an toàn càng hiếm. Mình build phần này chủ yếu để thực hành thiết kế tool nhận input linh hoạt và tool routing có điều kiện, đồng thời giữ sự thành thật về giới hạn của chính sản phẩm.

📝 License

MIT — free to use, fork, modify.

Tara Bot — build public để chia sẻ và học hỏi, không phải product thương mại.

Các repo khác của mình

Nếu bạn làm growth marketing hoặc quan tâm đến AI agent cho công việc thực tế:

RepoMô tả
ai-growth-agents-for-marketersPrompts và Python agents cho campaign brief, MEU planning, A/B test — build từ campaign fintech thực tế
growth-mcpMCP server cho growth marketing, có CSV data layer phân tích A/B test và retention từ data thật — pip install growth-mcp
ai-growth-promptsPrompt collection cho voucher design, segmentation, game mechanics

Other repos

If you work in growth marketing or are interested in AI agents for real work:

RepoDescription
ai-growth-agents-for-marketersPrompts and Python agents for campaign brief, MEU planning, A/B test — built from real fintech campaigns
growth-mcpMCP server for growth marketing with a CSV data layer for A/B test and retention analysis on real data — pip install growth-mcp
ai-growth-promptsPrompt collection for voucher design, segmentation, game mechanics

// compatibility

Platformsapi
Operating systems
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

// faq

What is tara-bot?

Tara Bot — AI Telegram agent: search flights, compare prices, inject affiliate links. It is open-source on GitHub.

Is tara-bot free to use?

tara-bot is open-source under the MIT license, so it is free to use.

What category does tara-bot belong to?

tara-bot is listed under automation in the Claudeers registry of Claude-compatible tools.

0 views
59 stars
unclaimed
updated 15 days ago

// embed badge

tara-bot on Claudeers
[![Claudeers](https://claudeers.com/api/badge/tara-bot.svg)](https://claudeers.com/tara-bot)

// retro hit counter

tara-bot hit counter
[![Hits](https://claudeers.com/api/counter/tara-bot.svg)](https://claudeers.com/tara-bot)

// reviews

// guestbook

0/500

// related in Automation & Workflows

🔓

The agent that grows with you

// automationNousResearch/Python211,605MIT[ claude ]
🔓

The API to search, scrape, and interact with the web at scale. 🔥

// automationfirecrawl/TypeScript143,720AGPL-3.0[ claude ]
🔓

🌐 Make websites accessible for AI agents. Automate tasks online with ease.

// automationbrowser-use/Python103,709MIT[ claude ]
🔓

An open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message…

// automationbytedance/Python76,016MIT[ claude ]
→ see how tara-bot connects across the ecosystem