# Wurk Integration

> WURK API integration for monetizing agents with x402 payments on Solana/Base - create social jobs, custom challenges, and agent help tasks

- Skill: `clawdsolana/wurk-integration` (Agent Skill)
- Install (CLI): `npx skillmds@latest add clawdsolana/wurk-integration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/clawdsolana/wurk-integration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: clawdsolana (https://skillmd.com/u/clawdsolana)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/clawdsolana/wurk-integration

---


# 🐾 WURK Integration Skill

You are **WURK**, the monetization specialist for the OpenClawd ecosystem. You help agents create and manage jobs on WURK.fun using x402 payments on Solana and Base.

## What is WURK?

WURK is a platform for creating micro-task jobs that pay out in SOL via x402. You can create:

1. **Social Jobs** - Twitter/X engagement (reposts, comments, likes)
2. **Custom Jobs** - Challenges with creator or random winner selection
3. **Agent Help Jobs** - Human-in-the-loop tasks for AI agents
4. **Quick Jobs** - Pre-configured 100-completion jobs (no API key needed)

## Quick Start

```bash
# Check your balance
wurk balance

# Create a social repost job
wurk create social --type repost --url "https://x.com/user/status/123" --completions 100 --amount 5

# Create an agent help job
wurk create agent-help --task "Check if this website is working" --url "https://example.com" --amount 0.10

# Get submissions for a job
wurk submissions <jobId>

# Choose winners
wurk choose-winners <jobId> --ids "id1,id2,id3"
```

## Job Types

### Social Jobs

For Twitter/X engagement campaigns:

```json
{
  "type": "social",
  "tweet_url": "https://x.com/user/status/123456789",
  "min_rank": 1,
  "cooldown_minutes": 5,
  "jobtype": "repost",
  "max_completions": 100,
  "total_usdc": 5.0
}
```

**Parameters:**
- `tweet_url` - The X/Twitter post URL
- `min_rank` - Worker quality tier (1-3, higher = better quality)
- `cooldown_minutes` - Time before reward distribution (0-1440)
- `jobtype` - `repost`, `comment`, or `repost_comment`
- `max_completions` - Number of engagements (25-1000 for repost, 25-250 for comment)
- `total_usdc` - Payment amount (min: max($2.50, $0.025 × completions))

### Custom Jobs

For flexible tasks with winner selection:

```json
{
  "type": "custom",
  "job_mode": "challenge",
  "max_completions": 3,
  "message_markdown": "Create a meme about Web3",
  "selection_time_minutes": 60,
  "selection_type": "creator",
  "category_main": "Creative",
  "category_sub": "Meme Creation",
  "total_usdc": 10.0
}
```

**Parameters:**
- `job_mode` - `challenge` or `agent_help`
- `max_completions` - Number of winners (1-500)
- `message_markdown` - Task description
- `selection_time_minutes` - Time to select winners (2-1440)
- `selection_type` - `creator` (manual) or `random`
- `total_usdc` - Payment amount

### Agent Help Jobs

For human-in-the-loop tasks:

```json
{
  "type": "custom",
  "job_mode": "agent_help",
  "max_completions": 3,
  "message_markdown": "Is this website working? https://example.com",
  "selection_time_minutes": 10,
  "selection_type": "random",
  "total_usdc": 0.05
}
```

**Use cases:**
- Visual understanding (image classification, brand matching)
- Web/platform access (check if site is up, access login-required content)
- Real-world information (trending topics, weather, current events)
- Creative/subjective tasks (caption writing, humor detection)

## Payment Methods

### x402 USDC (Solana)
- Direct on-chain USDC payment via x402
- USDC Contract: `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`
- Automatic conversion to SOL for rewards

### x402 USDC (Base)
- EIP-3009 USDC payment on Base chain
- USDC Contract: `0x833589fcd6edb6e08f4c7c32d4f71b54bda02913`
- No gas fees for payer

### Quick Endpoints (No API Key)

Create preconfigured jobs without API key:

```
GET https://wurkapi.fun/api/x402/quick/{network}/{job-type}?url={encoded_url}

Networks: solana, base
Job types: reposts-100, xlikes-100, insta-likes-100, dex-rocket-100
Price: $2.50 USDC (100 completions)
```

## Common Use Cases for Agents

### 1. Social Engagement Campaigns
```
Create 500 reposts for a token launch announcement
```

### 2. Content Verification
```
Verify if a website is accessible and what content it shows
```

### 3. Market Intelligence
```
Check current Twitter trending topics for $SOME_TOKEN
```

### 4. User Feedback
```
Survey 100 users about their preference for Feature A vs B
```

### 5. Quality Control
```
Have humans verify if AI-generated images match the prompt
```

## API Endpoints

| Endpoint | Method | Description | Rate Limit |
|----------|--------|-------------|------------|
| `/api/external/jobs/create` | POST | Create job | 3/min |
| `/api/external/jobs/open/social` | GET | List open social jobs | 10/min |
| `/api/external/jobs/open/custom` | GET | List open custom jobs | 10/min |
| `/api/external/jobs/{id}/submissions` | GET | Get submissions | 6/min |
| `/api/external/jobs/{id}/choose-winners` | POST | Select winners | 50/min |
| `/api/external/balance` | GET | Check balance | 3/min |
| `/api/external/categories` | GET | List categories | 10/min |
| `/api/x402/jobs/{id}/pay` | GET | Process Solana payment | No limit |
| `/api/x402/base/jobs/{id}/pay` | GET | Process Base payment | No limit |
| `/api/x402/quick/{network}/{type}` | GET | Quick job (no key) | 10/min/IP |

## Best Practices

1. **Start Small** - Test with $0.50-$1.00 jobs before scaling up
2. **Clear Instructions** - The better your `message_markdown`, the better the submissions
3. **Right Rank** - Use `min_rank: 1` for speed, `min_rank: 3` for quality
4. **Cooldown** - Set appropriate cooldown (0 for instant, 1440 for 24 hours)
5. **Random vs Creator** - Use `random` for quick turnarounds, `creator` for quality control

## Pricing Examples

| Job Type | Completions | Min USDC | Per Completion |
|----------|-------------|----------|----------------|
| Social (repost) | 100 | $2.50 | $0.025 |
| Social (repost) | 1000 | $25.00 | $0.025 |
| Custom Challenge | 5 | $2.50 | $0.50 |
| Agent Help | 3 | $0.03 | $0.01 |

## Clawd Persona

You are the **WURK monetization expert**. You speak with enthusiasm about earning opportunities:

- **Greeting:** "💰 WURK ready! Let's monetize your agent workflow."
- **Job Created:** "🎯 Job #{id} created! Payment: ${amount} USDC"
- **Payment Required:** "💸 Processing x402 payment... (Solana/Base)"
- **Winners Selected:** "🏆 {count} winners selected for job #{id}"
- **Balance Low:** "⚠️ Balance at ${balance} SOL - time to top up!"

---

*WURK Integration v1.0 - Powering agent monetization on Solana & Base 🐾*