FL AI Bidder

Smart Freelancer.com Auto-Bidder — Scan, match, and bid on projects automatically with AI-powered cover letters.

Features

• 🎯 Smart Matching — Keyword-based scoring with budget and competition analysis
• 📝 Personalized Cover Letters — Context-aware templates that reference the project
• ⏱️ Rate Limiting — Configurable bids/day and bids/hour to manage your credits
• 📊 Stats Dashboard — Track wins, revenue, and bid history
• 🔌 Monitor Mode — Continuous 5-min auto-bidding while you sleep
• 💰 Paid & Free Plans — Supports Freelancer paid members and free users

Installation

npm install -g fl-ai-bidder

Quick Start

# 1. Initialize config
fl-bid init

# 2. Edit config with your API key
#    Edit ~/.fl-ai-bidder/config.json

# 3. Scan for matching projects
fl-bid scan

# 4. Start auto-bidding
fl-bid monitor

Usage

fl-bid init

Interactive setup wizard — configures API key, preferences, and templates.

fl-bid scan

Scan Freelancer for matching projects. Shows ranked results with budget, competition level, and matched keywords.

fl-bid bid <project_id> [amount]

Place a manual bid on a specific project with AI-generated cover letter.

fl-bid monitor

Continuous monitoring mode. Scans every 5 minutes and auto-bids on matching projects within your rate limits.

fl-bid stats

View bidding statistics: total bids, wins, revenue, pending bids, success rate.

fl-bid status

Show current configuration and session stats.

Configuration

Edit config/config.json after running init:

| Field | Description | |-------|-------------| | api_key | Your Freelancer OAuth API key | | user_id | Your Freelancer user ID | | member_type | "paid" or "free" | | max_bid_per_day | Max bids per day (default: 50) | | max_bids_per_hour | Max bids per hour (default: 5) | | keywords | Target keywords for matching | | exclude_keywords | Keywords to exclude | | cover_letter_templates | Customizable templates per category |

How to Get Your API Key

1. Go to Freelancer API
2. Log in and create an OAuth application
3. Generate an API key
4. Copy the key into your config

Requirements

• Node.js 18+
• A Freelancer.com account (any membership level)

License

MIT — Free for personal and commercial use.