GitHub Bounty Hunter
Find and solve GitHub issues that pay bounties. Submit quality PRs and get paid.
Core Workflow
- Find bounty issues using the included bounty-finder script
- Verify bounty legitimacy and competition level
- Assess repo compatibility (fork, clone, implement)
- Submit PR via GitHub API (REST, no git clone needed)
- Track PR status and respond to review comments
Finding Bounty Issues
Run the bounty finder:
node scripts/bounty-finder.js [platform] [min-bounty]
Platforms: illbnm (homelab-stack, $50-300/bounty), opire (opire.io), claudi-builders (claude-builders-bounty)
Example:
node scripts/bounty-finder.js illbnm 100
Manual search: Look for repos with bounty label, issues with $ amounts in title, or bounty platform repos.
Key Bounty Repos (High Value)
| Repo | Bounty Range | Competition | |------|-------------|-------------| | illbnm/homelab-stack | $50-300 USDT | HIGH (5-8 PRs/issue) | | claude-builders-bounty | $25-200 | MEDIUM | | TechGuyTest/* | $20-100 | LOW |
Before Working an Issue
Required: Check Competition
node scripts/check-competition.js [owner] [repo] [issue-number]
This shows how many other PRs exist for the same issue.
Assessment Checklist
- [ ] Is this a legitimate bounty (has $ amount)?
- [ ] How many other PRs are already submitted?
- [ ] Is the issue still open and unassigned?
- [ ] Can you genuinely complete this in 2-4 hours?
- [ ] Is the bounty amount worth the effort?
Implementing and Submitting
Step 1: Fork the repo (via GitHub API)
POST /repos/:owner/:repo/forks
Step 2: Get issue details
GET /repos/:owner/:repo/issues/:number
Step 3: Get file contents for modification
GET /repos/:owner/:repo/contents/:path?ref=:branch
Returns base64-encoded content.
Step 4: Make changes and create commit
POST /repos/:owner/:repo/git/blobs // create new file blob
POST /repos/:repo/:owner/:git/trees // create tree
POST /repos/:owner/:repo/git/commits // create commit
PATCH /repos/:owner/:repo/git/refs/heads/:branch // update branch
Step 5: Create PR
POST /repos/:owner/:repo/pulls
With title: [BOUNTY $X] Issue Title to make it clear.
PR Submission Script
Use scripts/pr-submitter.js:
node scripts/pr-submitter.js [owner] [repo] [issue-num] [commit-sha] [title]
Critical Rules
- Quality over quantity - One merged PR > 10 rejected PRs
- Check for CLA - Google/Microsoft repos often require CLA (blocks merge)
- Don't spam - If issue says "good first issue", one agent should do it
- Respond to reviews - Check PR comments daily, fix requested changes
- No competing if others already delivered - Check existing PRs before starting
Competition Strategy
- Empty competition: If <2 PRs and you can do it well → do it
- Medium competition: If 2-3 PRs and yours is clearly better → do it
- Heavy competition: If >4 PRs → skip, find another issue
- Always: Make your PR clearly better (docs, tests, clean code)
Payment Collection
After PR merges, payment typically comes via:
- USDT TRC20: Provide your wallet address in PR comment (0x...)
- GitHub Sponsors: The repo owner will reach out
- Token rewards: Check if repo has a token for rewards
Wallet for payments: 0x417fd2884CdCF751EDF351eeC07a9fdf06f8Fd32
Quick Commands
# Find all illbnm bounties
node scripts/bounty-finder.js illbnm 0
# Check competition for issue #12
node scripts/check-competition.js illbnm homelab-stack 12
# Submit PR after implementation
node scripts/pr-submitter.js [owner] [repo] [issue-num] [commit-sha] [title]
For detailed bounty platform info, see references/bounty-platforms.md.
Scan to join WeChat group