Skip to main content
Source: examples/agent-job-hunter

​
Overview

The Job Hunter agent searches for remote job opportunities worldwide using the Jobicy API. It demonstrates an external REST API integration with an aixyz agent, gated behind x402 payments.

​
Project Structure

agent-job-hunter/
  aixyz.config.ts           # Agent metadata and skills
  app/
    agent.ts                # Agent with job search tool
    tools/
      search.ts             # Jobicy API integration
    icon.png                # Agent icon
  package.json
  vercel.json

​
Skills

SkillDescription
Remote Job SearchSearch for the latest remote job opportunities in specific countries

​
Configuration

const config: AixyzConfig = {
  name: "Job Hunter - Career Scout Agent",
  description: "An AI agent that searches for remote job opportunities worldwide using the Jobicy API.",
  version: "1.0.0",
  x402: {
    payTo: process.env.X402_PAY_TO!,
    network: process.env.X402_NETWORK!,
  },
};

​
Key Features

  • Global job search — Search remote jobs by country or region
  • Structured results — Returns job title, company, industry, and direct links
  • Input validation — Asks users to specify a country if not provided
  • Auto-generated server — No custom server.ts needed

​
Payment

The agent charges $0.01 per request via x402. Payment destination is configured via environment variables.

​
Environment Variables

VariableDescription
OPENAI_API_KEYOpenAI API key
X402_PAY_TOPayment destination address
X402_NETWORKPayment network (e.g., eip155:84532)

​
Running

cd examples/agent-job-hunter
bun install
bun run dev