🤖 Freelance AI Agent

freelance-agent is an autonomous AI agent for freelancers — it reads real job postings, understands them like a human, matches them to your profile, and crafts a professional, ready-to-send application.

Think of it as your personal freelance copilot:
a digital teammate who researches, analyzes, and writes proposals while you focus on your craft.

🧠 How it works

When you feed freelance-agent a freelancer profile and a job URL, it independently:

1. 🌐 Explores the page — fetches, renders, and reads the full job description.
2. 🧩 Understands context — extracts company, role, skills, and project details using reasoning models.
3. 🧠 Analyzes fit — maps your strengths, rate, and experience against the job.
4. ✍️ Writes like a pro — composes a short, authentic application in your voice and preferred language.

Every step is handled by the agent’s own pipeline — no templates, no copy-paste.
Just autonomous intelligence built for real freelance work.

💬 Example interaction

npm install
npm build
npm start

curl -X POST http://localhost:3000/execute \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/jobs/ios-freelancer",
    "locale": "de",
    "tone": "neutral",
    "detail": "standard",
    "profile": {
      "name": "John Doe",
      "title": "Senior iOS Engineer",
      "rateEuro": 110,
      "availability": "Immediately · 40 hours/week",
      "links": [
        { "label": "Portfolio", "url": "https://apps.apple.com/developer/..." },
        { "label": "GitHub", "url": "https://github.com/timokoenig" }
      ],
      "experience": "10+ years of experience building performant, user-friendly iOS apps using Swift, SwiftUI, and modern CI/CD pipelines."
    }
  }'

Input:

• Job or project URL
• Freelancer profile (JSON)
• Optional: language locale (de / en)
• Optional: agent tone (neutral / friendly / formal)
• Optional: agent detail (concise / standard / detailed)

Agent response:

{
    "project": {
        "title": "iOS Freelancer (m/w/d)",
        "company": "Muster GmbH",
        "location": "Germany",
        "remote": true,
        "contractType": "Freelance",
        "duration": "12+ month",
        "skills": ["iOS", "Swift", "SwiftUI"],
        "rateText": "85 Euro / hour",
        "summary": "3-month iOS project building internal apps…"
    },
    "proposal": {
        "subject": "iOS Freelancer – Available Immediately",
        "body": "Hallo Muster GmbH, ... (tailored message)"
    }
}

🛠 Tech stack

• 🧭 Playwright – headless page exploration
• 🧩 JSDOM + Readability – text extraction
• 🤖 OpenAI Responses API – structured reasoning & writing
• ⚙️ TypeScript + Yup – strong types, schema validation

🪪 License

MIT License © 2025

---

Created with ❤️ for freelancers who’d rather code, design, and create — and let their AI agent handle the rest.