BountyHunter

Tự động scan các nền tảng bounty (GitHub, Algora) → score độ phù hợp → AI draft sẵn solution → bạn review và submit.

Không phải máy in tiền. Đây là công cụ trợ lực: AI làm phần lọc + nháp, bạn chịu trách nhiệm submit dưới tài khoản thật của mình (vì các nền tảng đều yêu cầu KYC + account thật).

Cài đặt

cd /Users/thainguyen/Working/AI_Business/KiemTienClaudeCodeOnline

# Tạo virtualenv
python3.11 -m venv .venv
source .venv/bin/activate

# Cài deps
pip install -e .

# Cấu hình
cp .env.example .env
cp config.example.toml config.toml
# Sửa .env: thêm ANTHROPIC_API_KEY và GITHUB_TOKEN
# Sửa config.toml: chỉnh skills, min/max payout của bạn

Lấy API keys

• ANTHROPIC_API_KEY: https://console.anthropic.com/ → API Keys (nạp $10 là dùng được nhiều tháng)
• GITHUB_TOKEN: https://github.com/settings/tokens → "Fine-grained" → chỉ cần public_repo read. Tăng rate limit search từ 10/min → 30/min.

Cách dùng

One-shot

# Quét bounty mới
bountyhunter scrape

# Tính điểm
bountyhunter score

# Xem top 20 cơ hội ngon nhất
bountyhunter top

# AI nháp solution cho top bounty (tốn ~$0.10-0.50 mỗi cái)
bountyhunter draft

# Xem chi tiết 1 bounty + draft
bountyhunter show github:owner/repo#123

# Khi bạn đã submit PR, đánh dấu
bountyhunter submitted github:owner/repo#123 --pr-url https://github.com/.../pull/456

Chạy nền 24/7

# Quét + score + draft mỗi 10 phút
bountyhunter daemon --interval 600

# Hoặc chạy nền với nohup:
nohup bountyhunter daemon --interval 600 > logs/daemon.log 2>&1 &

Hoặc setup cronjob mỗi 15 phút:

*/15 * * * * cd /path/to/project && /path/to/.venv/bin/bountyhunter run >> logs/cron.log 2>&1

Workflow thực tế

1. Cứ vài tiếng, mở bountyhunter top xem có gì mới score cao.
2. Đọc draft trong data/drafts/<bounty-id>/draft.md — AI đã tóm tắt issue, đề xuất approach, đôi khi viết sẵn code.
3. Review nghiêm túc: AI có thể bịa file path, hiểu sai context. Đừng tin mù.
4. Verify chưa ai làm: vào issue, đọc comments + xem PR linked.
5. Fork → code → test → PR trên tài khoản GitHub của bạn.
6. Đánh dấu submitted trong DB.
7. Maintainer merge → bounty thanh toán qua platform → tiền về PayPal/Stripe/USDT của bạn.

Giới hạn — đọc kỹ

• Không tự động submit: cần account + KYC + signature của bạn
• Chất lượng > số lượng: spam PR rác → ban account. Mỗi PR phải thật sự tốt
• Cạnh tranh: bounty cao = nhiều người nhìn. Phải nhanh + chất lượng
• Algora coverage: API per-org, danh sách org seed có sẵn, mở rộng dần
• Replit Bounties đã đóng cửa 2024 → không support
• Không bao gồm: HackerOne (cần kỹ năng security), Immunefi/Sherlock (smart contract audit chuyên nghiệp)

Roadmap

• Scrape Gitcoin
• Scrape Bountycaster (Farcaster)
• Telegram/Discord notifications cho top bounty
• Auto-clone repo + run tests trong sandbox
• Browser auto-fill submission forms (Playwright) — cần đăng nhập có sẵn

---

English Summary

BountyHunter is a Python CLI that scrapes open bounty issues from public platforms (Algora, GitHub bounty labels, and others), scores them on payout, relevance to your stack, and competition, then uses Claude to draft a candidate solution that you review and submit manually. It is a research and triage aid, not an autosubmitter.

Quickstart

python3.11 -m venv .venv && source .venv/bin/activate
pip install -e .
cp .env.example .env                  # add ANTHROPIC_API_KEY and GITHUB_TOKEN
cp config.example.toml config.toml
bountyhunter scrape && bountyhunter score && bountyhunter top

Lightweight Watchers

If you only want a low-overhead cron job that pings you when new bounties drop, without running the full scrape-score-draft pipeline, see:

• scripts/algora_watcher.py — polls Algora org bounty pages
• scripts/tt_bounty_watcher.py — polls the Tenstorrent bounty feed

Both are designed to run from cron and write to logs/.

License and Contributing

• License: LICENSE (MIT)
• How to contribute, set up a dev environment, and add new scrapers: CONTRIBUTING.md
• Security reports: SECURITY.md

Honest Disclaimer

This is a research-grade tool, not a money printer. Manual submission is required (KYC and account ownership). Drafted solutions are starting points that need human review, testing, and adaptation before they are worth submitting. Bounty competition is real and payout is never guaranteed.